From c893a4f0a279a0a4e35d6376a21929245290605f Mon Sep 17 00:00:00 2001 From: harlekin Date: Sat, 09 Aug 2003 14:40:52 +0000 Subject: updated to usermanual by Clement Seveillac , changelog on http://handhelds.org/hypermail/opie/current/7412.html --- diff --git a/docs/usermanual/gettingaround.sgm b/docs/usermanual/gettingaround.sgm index 34ef403..68210de 100644 --- a/docs/usermanual/gettingaround.sgm +++ b/docs/usermanual/gettingaround.sgm @@ -14,9 +14,8 @@ Once the screen has been calibrated, &opie; will now start up. If the opie-logi package is installed (which is installed with the default installation), a screen will appear requiring a person to log in before any applications can be accessed. The standard &opie; installation currently requires the user to log in as the -'root' user in order for all functions to work correctly. Refer to the Familiar -website (http://familiar.handhelds.org) for the default password for the version -installed. +'root' user in order for all functions to work correctly. Refer to the Familiar +FAQ for the default password for the version installed. @@ -25,8 +24,7 @@ rebooted however, &opie; will start automatically. To install and remove applications, the "Packages" application (located on the Settings tab) or the command line ipkg application can be used. There are several task-opie packages which allow the installation of whole categories (e.g. games, PIM, settings, etc.) -of software at once. It also might be helpful to install either opie-embeddedkonsole -or opie-console first to allow access a command line from within &opie;. +of software at once. diff --git a/docs/usermanual/installation.sgm b/docs/usermanual/installation.sgm index ce1d07b..d636c3c 100644 --- a/docs/usermanual/installation.sgm +++ b/docs/usermanual/installation.sgm @@ -1,80 +1,44 @@ -Installation -
&ipaq; - -To install &opie; on an &ipaq;, a recent Familiar installation will be needed. Go to -the Familiar project homepage (http://familiar.handhelds.org) to download the latest -version of the "bootstrap" image (do not install the bootstrap-opie or bootstrap-gpe -images). Follow the instructions on the Familiar website to install the image. Do not -install the task-complete or task-x packages as they are not needed to run &opie; and -will unnecessarily occupy space on the &ipaq;. - + + Installation +
+ &ipaq; + To have &opie; 1.0 on an &ipaq;, you have to install a Familiar + &opie; image on your &ipaq;. An image is in fact a file, containing the memory image of an &ipaq; with Familiar (the linux distribution) and &opie; (the graphical platform) installed. You can download it from the Internet, then load it in your &ipaq; through a Compact Flash card, serial port or USB. - -A network connection needs to be configured on the &ipaq; in order to download the -&opie; packages from the feed. The Familiar site provides instructions for connecting -to the Internet in a variety of ways. - + + To start with, go to the Familiar download page. + Put the model of you &ipaq; under Please select your hardware, choose testing, v0.7.1 as the Familiar version, and Opie as the set of files, and press Download. + Follow the Familiar installation instructions then, to know how to upload this image file on your &ipaq;. + - -&opie; requires the libpng3 package to be installed. Prior to installing &opie;, ensure -that this package is installed. It is available in the Familiar feed and can be installed -by running this command: - - - ipkg install libpng3 - - - + Configuring a network connection for the &ipaq; is then very useful, in order to install new packages, or upgrade existing ones (to get new features or bugfixes, for example). The Familiar site provides instructions for connecting the &ipaq; to the Internet in a variety of ways. See this &ipaq; networking tutorial to have information on configuring PPP or USB, and masquerading (giving access to the Internet through your PC), for example. Setting up masquerading is even simpler on Windows, if you can adapt this kind of tutorial for Windows. - - -If you had QPE/QTopia installed previously, completely remove -it, and then remove the source line for that feed from your /etc/ipkg.conf file before -attempting to install &opie;. - - - -Once you have Familiar installed (including libpng3), and the network connection -between the &ipaq; and the outside world, run the following command: - - - echo src opie "http://opie.handhelds.org/feed/ipaq/unstable/" \ - >> /etc/ipkg.conf - - -then, run: - - - ipkg update && ipkg install task-opie - - -If you have a 3100 or 3800 series &ipaq;, run: - - - ipkg install libqt2-emb-fonts - - -finally, start &opie; with: - - - /etc/init.d/opie start - - - -
+ When your &ipaq; is connected to Internet, you can and should do several things, in command line, using Familiar, as noted in the Familiar post-install page, or using Opie applications. + + For example you can synchronize the &ipaq; clock with network time servers. There is a graphical way to do that through the Settings / Date/Time Opie application, or you can also run as root the following command: + + ntpdate -b time.handhelds.org + + + To teach to your &ipaq; what are the new packages or updated packages it can dowload, run the command (as root again): + + ipkg update + + Or use the Settings / Packages Opie graphical application. + + To download and install automatically new versions, if they exist, of your installed packages, + + ipkg upgrade + + Or use the Package Opie application again. + + +
-
&zaurus; - -&opie; applications will install and run on the default &zaurus; ROM with no problems, -except for Launcher. It is not compatible with the default ROM, and should not be -installed. - +
+ Zaurus + &opie; applications will install and run on the default &zaurus; ROM (Linux-based distribution, as well as Familiar) with no problems,except for Launcher. It is not compatible with the default ROM, and should not be installed. You should be able to find the fine &opie; packages for you &zaurus; default ROM at this feed address: http://opie.handhelds.org/feed/sharprom/. + + Another option is to replace the default &zaurus; ROM with the OpenZaurus ROM image. OpenZaurus is a openly developed Linux distribution designed to run on the &zaurus;, and uses &opie; as its default user interface. For more information and installation instructions, please visit OpenZaurus.org web site. Notice you will access the Opie 1.0 feeds at the address http://opie.handhelds.org/feed/openzaurus/. +
- -Another option is to replace the default &zaurus; ROM with the OpenZaurus -ROM image. OpenZaurus is a openly developed Linux distribution designed to run on the -&zaurus;, and uses &opie; as its default user interface. For more information and -installation instructions, please visit their site, http://www.openzaurus.org/. - -
 diff --git a/docs/usermanual/upgrading.sgm b/docs/usermanual/upgrading.sgm index 787d4dd..a0667ab 100644 --- a/docs/usermanual/upgrading.sgm +++ b/docs/usermanual/upgrading.sgm @@ -7,16 +7,6 @@ Normally, simply running ipkg update && ipkg upgrade -will upgrade &opie;. However, if you currently have a version with the 1.5.0 -version number, you will have to upgrade it differently, because &opie; now uses a -different version number (the 1.5.0 was Qtopia's version number, we now use our -own). To upgrade from one of these older versions, run: - - - ipkg update - ipkg install opie-update - - -&opie; should then be upgraded. +will upgrade &opie;. - \ No newline at end of file + diff --git a/docs/usermanual/usermanual.sgm b/docs/usermanual/usermanual.sgm index 7c457d7..fb4669f 100644 --- a/docs/usermanual/usermanual.sgm +++ b/docs/usermanual/usermanual.sgm @@ -1,103 +1,117 @@ -"> - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +"> + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - + + + + + + ]> -&opie; User Manual - -The &opie; Team - -Getting Started -&whatis; -&installation; -&gettingaround; -&upgrading; - -Applications -&contacts; -&calendar; -&todo; -&today; -&filemanager; -&embeddedkonsole; -&keypebble; -&helpbrowser; -&login; -&citytime; -&textedit; -&reader; -&sheet; -&write; -&sysinfo; -&tableviewer; -&qpdf; -&drawpad; -&player2; -&showimg; - -Settings -&software; -&lightpower; -&calibrate; -&rotation; -&appearance2; -&language; -&sshkeys; -&appskey; - -Applets -&irda; - -Inputmethods -&kjumpx; -&handwriting; -&multikey; -&pickboard; - -Technical Details -&i18n; - + + &opie; User Manual + + + + The &opie; Team + + + + &preface; + + Getting Started + &whatis; + &installation; + &gettingaround; + &upgrading; + + + Applications + &contacts; + &calendar; + &todo; + &today; + &filemanager; + &embeddedkonsole; + &keypebble; + &helpbrowser; + &login; + &citytime; + &textedit; + &reader; + &sheet; + &write; + &sysinfo; + &tableviewer; + &qpdf; + &drawpad; + &player2; + &showimg; + + + Settings + &software; + &lightpower; + &calibrate; + &rotation; + &appearance2; + &language; + &sshkeys; + &appskey; + + + Applets + &irda; + + + Inputmethods + &kjumpx; + &handwriting; + &multikey; + &pickboard; + + + Technical Details + &i18n; + diff --git a/docs/usermanual/whatisopie.sgm b/docs/usermanual/whatisopie.sgm index 583a9f8..ada07c0 100644 --- a/docs/usermanual/whatisopie.sgm +++ b/docs/usermanual/whatisopie.sgm @@ -1,10 +1,19 @@ What is &opie;? + +
&opie; logo + + + + + +
+ -&opie; is a GUI (Graphical User Interface) for the Linux operating system (and +&opie; is a GUI (Graphical User Interface) for the Linux operating system (and might work on other OSes as well). It was originally designed for handheld computers (such as the Compaq/HP &ipaq; and the Sharp &zaurus;), but could -probably function well in other environments requiring a light GUI, such as an -old laptop, or an internet kiosk. It is based upon &qt;/Embedded from Trolltech, +function well in other environments requiring a light GUI, such as an +old laptop, or an internet kiosk. It is based upon &qt;/Embedded from Trolltech, which is in turn a graphical environment designed for embedded applications, based upon the &qt; toolkit. -- cgit v0.9.0.2