 |
 |
|
Overview
Technically minded users may find details of the Calculon install and uninstall processes useful. The standard Sharp ROM and OpenZaurus distributions are not compliant as regards their internal ipkg installation process. Maintaining compatibility so that Calculon will install flawlessly on both systems (and both to RAM or CF card) is quite tricky. The install process has been thoroughly tested on both systems and should present no problems to normal users. However, if installing Calculon has proved problematic (perhaps due to a non-standard ROM set up) the information here may help you to get Calculon working.
Location of Installed Files
A standard installation to 'RAM' on the Sharp ROM and 'root' on OpenZaurus installs the following files:
/opt/QtPalmtop/apps/Applications/calculon.desktop
/opt/QtPalmtop/bin/calculon
/opt/QtPalmtop/help/html/calculon.html
/opt/QtPalmtop/pics/Calculon.png
/opt/QtPalmtop/pics/CalculonFile.png
/opt/QtPalmtop/tmp/calculon_temp.tar
/home/root/Documents/application/x-calculon/Introduction.cpk
/home/root/Documents/application/x-calculon/Help.cpk
In addition, on a Sharp ROM system these files will also be installed (see the note above):
/home/root/Documents/application/x-calculon/Introduction.desktop
/home/root/Documents/application/x-calculon/Help.desktop
The file /opt/QtPalmtop/tmp/calculon_temp.tar is a zero length file left over from the installation process. The Sharp ROM ipkg installer won't allow this file to be deleted during installation, but it can safely be deleted by hand afterwards.
Installation to Compact Flash
When another location is selected for install (Compact Flash, SD, or 'ram' on OpenZaurus) the executable and its '.desktop' file are installed to the selected location, but the additional files are always installed to root. This behaviour is required to get around a 'feature' of the Sharp ROM which seems to interpret all other files installed to CF as document files (i.e. after install they appear under the Documents tab). Installing to CF on the Sharp ROM installs the files in the following locations:
/mnt/cf/QtPalmtop/apps/Applications/calculon.desktop
/mnt/cf/QtPalmtop/bin/calculon
/mnt/cf/QtPalmtop/tmp/calculon_temp.tar
/opt/QtPalmtop/help/html/calculon.html
/opt/QtPalmtop/pics/Calculon.png
/opt/QtPalmtop/pics/CalculonFile.png
/home/root/Documents/application/x-calculon/Introduction.cpk
/home/root/Documents/application/x-calculon/Help.cpk
/home/root/Documents/application/x-calculon/Introduction.desktop
/home/root/Documents/application/x-calculon/Help.desktop
The Calculon package files 'Introduction' and 'Help' can be moved to CF after the install using the Qtopia file management tools (i.e. hold down stylus on file under Documents tab, and then select location).
The image files and help file will remain under the root system, but these files are very small so this shouldn't present a problem.
Uninstallation and Calculon Package Files
Currently, uninstalling the Calculon ipkg does not uninstall any Calculon package files, this includes the Help and Introduction packages which are installed with Calculon. These files can easily be removed manually under the Documents tab in the Qtopia system.
Files Remaining After Uninstallation
After Calculon is uninstalled four small files remain on the Zaurus. This is an unfortunate consequence of the mechanisms required to maintain compatibilty between the Sharp ROM, OpenZaurus, and RAM and CF installs. These files are very small, so their persistance should not cause any problems to normal users. For those who are interested or would like to remove these files, they are:
/home/root/.calculon
/opt/QtPalmtop/help/html/calculon.html
/opt/QtPalmtop/pics/Calculon.png
/opt/QtPalmtop/pics/CalculonFile.png
The files will be in these locations regardless of the install target (i.e. RAM, CF etc.).
Brute Force Install
If you have a very non-standard system for which the ipkg install doesn't work at all, it is possible to manually extract the required files from the Calculon ipk and transfer them to your PDA by whatever means is possible. The ipk file is actually a recursively tarred and gzipped archive of the installation files. These can be extracted under Linux as follows:
#tar xvzf calculon_1.0.1_arm.ipk
./debian-binary
./data.tar.gz
./control.tar.gz
#tar xvzf data.tar.gz
./
./opt/
./opt/QtPalmtop/
./opt/QtPalmtop/apps/
./opt/QtPalmtop/apps/Applications/
./opt/QtPalmtop/apps/Applications/calculon.desktop
./opt/QtPalmtop/bin/
./opt/QtPalmtop/bin/calculon
./opt/QtPalmtop/tmp/
./opt/QtPalmtop/tmp/calculon_temp.tar
#tar xvf opt/QtPalmtop/tmp/calculon_temp.tar
home/
home/root/
home/root/Documents/
home/root/Documents/application/
home/root/Documents/application/x-calculon/
home/root/Documents/application/x-calculon/Help.cpk
home/root/Documents/application/x-calculon/Help.desktop
home/root/Documents/application/x-calculon/Introduction.cpk
home/root/Documents/application/x-calculon/Introduction.desktop
opt/
opt/QtPalmtop/
opt/QtPalmtop/help/
opt/QtPalmtop/help/html/
opt/QtPalmtop/help/html/calculon.html
opt/QtPalmtop/pics/
opt/QtPalmtop/pics/CalculonFile.png
opt/QtPalmtop/pics/Calculon.png
Under Windows, WinZip or PowerArchiver can be used to do the same thing (though you may need to change the '.ipk' file extension to '.tar.gz' or '.tgz' first). In fact, currently, the only file which is actually required to run Calculon is the binary executable itself:
./opt/QtPalmtop/bin/calculon
Transfer this file to the PDA and try to run it from a command line prompt. The file 'calculon.desktop' might be useful to setup a menu item or icon for the program (in which case the *.png files found within calculon_temp.tar might also be useful). If you've got this far you probably know how to do this stuff anyway...
Of course, PLEASE DO NOT DISTRIBUTE the files from within ipk file, the same as you would not distribute the Calculon ipk itself.
If you're still having installation problems, email: calculon@vaagmaer.com.
|
|
|
|
|
