--- psiconv/trunk/README 2003/11/11 18:58:55 152 +++ psiconv/trunk/README 2004/02/04 15:28:56 200 @@ -2,7 +2,7 @@ ============ This package is meant to make the Psion 5 series of PDAs, as well as other -small computers running Epoc 32, more usable to non-Windows users. But even +small computers running EPOC 32, more usable to non-Windows users. But even they may profit from the data I collected. The package consists of several parts: @@ -41,22 +41,18 @@ =========== libpsiconv is a library of routines that you can link against your own -application. It allows you to read Psion 5 files. Note that it comes -under the GNU General Public License; that means that you can only link -it to programs which are also covered by that license. You can contact -me if you need other license terms. - -The following formats can be read at this moment: - Word Word processor files - TextEd OPL editor files - Sketch Picture files - MBM Alternate picture format; several pictures can be combined in it - ClipArt Internal picture format; several pictures can be combined in it - -The parser is quite good at the moment. Page layout codes are not yet -read, but almost everything that is described in the documents in the -format directory is supported by it; but it can not yet cope with -inserted objects (ie. documents in some other format). +application. It allows you to read and write Psion 5 files. Note that +it comes under the GNU General Public License; that means that you can +only link it to programs which are also covered by that license. You can +contact me if you need other license terms. + +The following formats are supported at this moment: + Word (R+W) Word processor files + TextEd (R+W) OPL editor files + Sketch (R+W) Picture files + MBM (R+W) Alternate picture format; can contain several pictures + ClipArt (R+W) Internal picture format; can contain several pictures + Sheet (R) Spreadsheet files Documentation is scarce; please examine the source code or the example psiconv program. Some things may also be found in the doc subdirectory. @@ -71,7 +67,7 @@ Please enter `psiconv --help' if you want to know about its syntax. -The current HTML3 target is not very ideal. HTML is just not made to +The current HTML4 target is not very ideal. HTML is just not made to represent detailed layout considerations: it is a document description language. Still, the output is quite readable already. Of course, headers and footers are not displayed, because there is no notion of pages in @@ -79,24 +75,19 @@ solved using tables, but it is quite hard to do it correctly. Some other things are just approximated too. -The HTML4 target uses style sheets. You need a not-too-old browser for -this to display correctly. Generally, the output of this generator is -of higher quality than the normal HTML generator's. +The XHTML target uses cascading style sheets (CSS). You need a not-too-old +browser for this to display correctly. Generally, the output of this +generator is of higher quality than the normal HTML generator's. A plain TEXT target just grabs all text, without any futher conversions. -The RTF target is not finished yet; in fact, it is no usable at all -right now. - All ImageMagick graphic output formats are supported; depending on how you compiled ImageMagick, this is betwee 20 and 50 different formats. Your favorite one should be somewhere in there... -I would very much like to add other targets, like (La)TeX, RTF (Rich Text -Format) and XML (for AbiWord). If other people want to work on this, please -let me know! Of course, you could also write your own conversion applications -just using my data format description. Native import/export filters for -some word processors would be very welcome! +In the past, my focus was on extending the number of output targets for +this program; at the moment, I belief more in import/export filters for +office applications like AbiWord, Gnumeric and the Gimp. Psiconv is licensed under the GPL. Please read the included file COPYING for exact licensing information. Please contact me if you need some other @@ -110,14 +101,14 @@ Starting with version 0.4, the conversion routines are linked into a (static or shared) library. Version 0.5 has autoconf and libtool support, and should run on many more platforms. Version 0.6 has support for -graphics. +graphics. Version 0.8 can generate files and add Sheet support. Version +0.9 uses Unicode inside, add the psiconv.conf file and has many more +enhancements. High on the TODO list are input routines for Record files. Sheet files will be next. I am running into some trouble understanding Data and Agenda files, but with a little luck, I'll figure it out after all. This is more long-term though. -On the output side, I hope RTF will soon be done. This will allow most -office tools to read the Psion files. INSTALLATION