INTRODUCTION
============
This is the Amiga port of PsiConv, the utility to convert files from Psion
PDAs to some format usable on desktop machine.
INSTALLATION
============
Ordinary user will need just one executable: 'bin/psiconv'. Just copy it
anywhere you wish, and you're done. Other utilities from 'bin' directory was
written by PsiConv's author for testing purposes, you can learn more about them
from their source code. Also i've included a compiled version of libpsiconv
library which can be used to write your own applications which will suport
Psion files.
LIMITATIONS
===========
This program is in rather beta state, so it has too many limitations itself.
You can read about them in the original documentation in 'src' directory.
Unfortunately one more limitation was introduced by Amiga environment. Original
PsiConv can be compiled to support image (Sketch, MBM and ClipArt) formats, but
only when ImageMagick program installed. There is no ImageMagick port for
Amiga, so i coudln't make use of this feature. Probably this will change in
future.
COMPILING
=========
This archive contains an already configured source code. Unfortunately there
seem to be a lot of problems with shared (#?.ixlibrary) libs on Amiga, i've
managed to compile PsiConv with shared libraries support after a large number
of corrections in compiling scripts and makefiles, but the code was completely
non-working (it crashed even when i typed 'psiconv --help'). So this version
uses static libraries (#?.a) instead. If you will wish to reconfigure the
package, you should do the following sequence (here i assume that you work in
AmigaShell, not the ADE shell like ksh):
1. Run command 'sh Configure --without-imagemagick --disable-shared'.
2. Edit makefiles in directories 'program/psiconv' and 'extra'. Change
LDFLAGS definition in them to: 'LDFLAGS = -all-static'. My gcc didn't link
the libpsiconv library properly without it. Probably it's a bug in my
version of gcc.
The package is self-testing, after compiling it converts the supplied files
format documentation from Psion Word format fo HTML format.
AUTHOR
======
This work was done by me, Pavel Fedin <sonic_amiga@rambler.ru>. Unfortunately
i don't have much time, i serve in Russian Army at the moment, so i have
Internet access only on holidays and can't offer much support, but you still
can write something to me. Please read the original documentation in 'src'
directory, it is very poor but still contains some important information about
known bugs and limitations, so please don't send bug reports to me, instead of
it you can send them to the original author, or even help him to track down
the problem and fix it.
|
aminet net>