JWPce version 1.

50 Copyright (C) 1997-2004, 2005, glenn rosenthal JWPce is free software; you can redistribute it and/or modify it underPublic General the terms License of the as GNU publishedFoundation; Software by the Freeeither version 2 of License, or (at your option) any later version. the This program is distributed in the hope that it will be useful, but WITHOUT even the implied ANY WARRANTY; warranty of without MERCHANTABILITY FITNESS FOR A PARTICULAR or PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. ============================================================ Supplemental Information: Windows CE version extra information This file contains additional information that is specific to Windows CE versions of JWPce. You should also read the _readme.txt file which contains information about JWPce in general ============================================================ Disclaimers: The legal stuff, or you get what you pay for. Because this program is free software, it is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. This means that if you lose millions of dollars because you used the program, tough. So there! ============================================================ Installation Requirements: What do I need to get it running? Windows CE versions of JWPce are designed to operate on HPCs (Handheld Personal Computers) and PPCs (Palm Personal Computers) running the Windows CE operating system. The program has been developed and tested under Window CE version 2.0. I have not specifically excluded Windows CE versions earlier than 2.0, but I have not tested the program under any of these versions, and would expect that it will NOT work correctly. Every attempt has been made to keep dialog boxes small enough so that 480x240 displays will be acceptable. There are a few dialog boxes that will have to be shifted for people using the smaller display (most notably the Radical Lookup dialog box, which is clearly 640x240). My Windows CE machines are a Velo 500 and an Everex Freestyle, both of which use the MIPS processor. I have extensively tested JWPce using these systems without any problems. I do not have an SH3 machine, so I cannot test JWPce using such a machine. However, JWPce has been tested by other users on both SH3 and Arm based machines without any problems.

The complete installation of JWPce with dictionaries and lookup tables but no help files takes about 5.1 MB of storage (not counting the storage compression used by Windows CE). Various files can be deleted to save space, if that is necessary (see below). JWPce will run on a machine with 8 MB of RAM (less if some of the files are removed). ============================================================ Installation Instructions for HPCs: How to get it working? Currently there will eventually Until then, the on a Windows CE is no installer for JWPce under Windows CE. I generate one, but this is a low priority. following steps can be used to install JWPce machine:

1. Obtain the distribution .zip files: One way or another obtain the distribution .zip files - the number of files will depend on where you obtain them. 2. Make a temporary directory: Create a temporary directory on your desktop machine (such as c:\temp-wince). 3. Decompress the .zip's: Decompress the .zip files into your temporary directory. Generally it is better first to decompress any general files and then to decompress files that are specific to your processor. At this point you can delete the .zip files as they are no longer necessary. 4. Make an installation directory: Create a program directory on your Windows CE machine, e.g. \Program Files\JWPce. 5. Copy the files: Copy the desired files from the temporary directory on your desktop machine to the installation directory on your Windows CE machine. You can now delete the temporary directory (and its contents) on your desktop machine, as it is no longer necessary. 6. Run the Program: Run the executable program "jwpce.exe". This program will automatically complete the installation, and prompt you for any information needed, just like the Windows 95/98/NT version. -------------------------------------Installing Help Normal Windows CE help is implemented using the Pocket Help program, and help information is stored in a reduced form of HTML format. Unfortunately, using Pocket Help requires that most of the help files reside in the Windows\System directory. One of the problems with HTML formatted files is that all Japanese text must be stored as small images in separate files1 (in total, there are around 130 files in the help system). I do not like the idea of dumping 130 or so files into the Windows\System directory, so JWPce implements its help using Pocket Internet Explorer. This has a number of advantages: first, this allows the full range of HTML to be used in the help system2; second, this allows me to place the help files in any location. There are also a few disadvantages, such as that Pocket Internet

Explorer opens files slower than Pocket Help. Overall, I believe this is the best solution. The following steps can be used to install help on a Windows CE system: 1. Obtain the distribution zip files: One way or another obtain the distribution .zip files - the number of files will depend on where you obtain them. 2. Make a temporary directory. Create a temporary directory on your desktop machine (such as c:\temp-help). 3. Decompress the .zip files: Decompress the .zip file(s) into your temporary directory. At this point you can delete the .zip files as they are no longer necessary. 4. Make an installation directory: Create a help directory on your Windows CE machine. The directory must be named help, and must be a sub-directory of wherever you installed JWPce. For example, if you installed JWPce in \Program Files\JWPce you must install help in the directory \Program Files\JWPce\help. 5. Copy the files: Copy the desired files from the temporary directory on your desktop machine to the help directory on your Windows CE machine. You can now delete the temporary directory (and its contents) on your desktop machine as it is no longer necessary. ============================================================ Installation Instructions for PPCs: How to get it working? Currently there is no installer for JWPce under Windows CE. I will eventually generate one, but this is a low priority. Until then, the following steps can be used to install JWPce on a Windows CE PPC machine. Due to the absence of any type of file manager on the PPC versions of Windows CE, you will have to attach JWPce to the Start Menu by hand to run the program. Do not worry, the steps are very straightforward. 1. Obtain the distribution .zip files: One way or another obtain the distribution .zip files - the number of files will depend on where you obtain them. 2. Make a temporary directory: Create a temporary directory on your desktop machine (such as c:\temp-wince). 3. Decompress the .zip files: Decompress the .zip files into your temporary directory. Generally it is better first to decompress any general files and then to decompress files that are specific to your processor. At this point you can delete the .zip files, as they are no longer necessary. 4. Make an installation directory: Create a program directory on your Windows CE machine, e.g. \Program Files\JWPce. 5. Copy the files: Copy the desired files from the temporary directory on your desktop machine to the installation directory on your Windows CE machine. You can now delete the temporary directory (and its contents) on your desktop machine, as it is

no longer necessary. 6. Select the Program: Now you will need to generate a link in the start menu so you can execute the program. Find the file JWPce.exe on the PPC device (since you just copied the files, I am assuming that you are exploring your PPC), and click on it once. 7. Copy the Program: Select Copy from the Edit menu on Explorer. 8. Change Directories: Change the Explorer directory to /Windows/Start Menu/Programs. 9. Make the Shortcut: Choose Paste Shortcut from the Edit menu on Explorer. If you would like a shorter name in your start menu, you can edit the name from "shortcut to JWPce.exe" to "JWPce", or whatever you like 10. Run the Program: On your PPC machine there should now be a link to JWPce in the programs menu. Activate this link. The program will automatically complete the installation, and prompt you for any necessary information, just like the Windows 95/98/NT/2000 version. ============================================================ Updating JWPce: If you are installing an updated version of JWPce, you can either get an updated package or install a complete version of JWPce over your existing version. Update packages are smaller and faster to download and install. If you get an update package, please check the instructions, since the update versions now require that you have at lease a certain version of JWPce to update from. `This was done to keep the size of the update versions small. Reinstalling JWPce over your existing version has some advantages too. In particular you will get the newest copy of the main dictionaries. These are not included in the update packages, because this would defeat the purpose of the updates. Because there have been internal changes in the versions of JWPce I am now distributing a small program called UPDATE.EXE with each version of JWPce. This program will check your version of JWPce and update any necessary files to the current version. You run this program by simply double clicking on it. After you have run UPDATE.EXE you can simply delete the program, as it will no longer be necessary. You can run UPDATE.EXE as often as you like, it will not hurt any of the files. -------------------------------------Windows CE Updates I have not generated a version of UPDATE.EXE for each of the Windows CE versions. I believe that most people who are using the CE versions also have a version on their desktop. You can simply copy the updated files from your desktop to your CE machine. Also the next section contains a list of things that have changed from version to version so you can see what UPDATE.EXE would be doing.

-------------------------------------Update History This section contains a history of major file changes in the various versions of JWPce. If you are updating from an older version of JWPce you can see what files have been modified. Version 1.33: Due to changes in the kana->kanji conversion system, the files WNN.DCT and WNN.IDX have been replaced with the files WNN.DAT and WNN.DIX. Additionally, the format of the user kana->kanji conversion file (USER.CNV) has changed to match the format used by WNN.DAT. UPDATE.EXE will update the format USER.CNV, as well as offer to delete the obsolete files. ============================================================ Implementation Decisions: What is different from Windows 95/98/NT/2000 Generally Windows CE versions of JWPce are almost identical to the Windows 95/98/NT/2000 version; however, a number of decisions were made when implementing JWPce on Windows CE platforms: * The BITMAP clipboard format is not supported (section 5.5.3). * Clipboard formats TEXT and OEMTEXT are not supported (just UNICODETEXT). These formats are not supported by most other Windows CE programs. * Multi-file selects are not supported. Windows CE does not support this feature. * Printing is not supported in Windows CE. This may be added at some later date. * Some items were removed from the Edit menu, because the menu was too long for the Windows CE display. The removed items are Insert page break, and the mode settings. * Network startup options are not supported in Windows CE. The user cannot edit the command line arguments that are passed to a program. * Some visual changes were made because of the types of buttons or controls supported by Windows CE. * Due to the difficulties in determining what tasks are running on PPCs and in switching between tasks, only one copy of JWPce can be run at a time on a PPC. If you attempt to start another version, the currently running version will be brought to the foreground. ============================================================ International Support: The appearance of JWPce's interface can be changed by the use of a language or localization file (JWPCE_LANG.DLL). These files can replace virtually all the text strings used by the program, as well as menus and dialog boxes. This system was designed to allow creation of alternative interface modules in different languages. If a language support file is available for a language you are interested in, you can simply copy the support file to the same location as JWPCE.EXE. During startup JWPce will detect the language file and switch interfaces. There is an internal check to make sure the language support file matches the version of JWPce you are using.

Currently JWPce supports only one interface language at a time. Further the language is set when JWPce starts. At a later date, support for switching interface languages on the fly may be implemented. If you are interested in translating JWPce's interface to another language please contact me or obtain the translation kit (jwpcetra.zip). This kit contains instructions, notes and tools used to generate a translation file. (Please don't underestimate the amount of effort that this will take, JWPce contains around 300 message strings, 50 dialog boxes, a two menus containing nearly 100 items. Most of these will require translation. This is not even considering the manual, help, or adjustments necessary for Windows CE PPCs and HPCs.) ============================================================ Implementation Decisions: What is different on PPC's from HPC's 1. Since there is no file management system on the PPC's, a delete command has been added. In addition, backup files are not created by default, since they are difficult to delete. 2. Open file dialog on the PPC's does not support multiple file types, so the default file type has been changed to JWPce native (.jce). 3. True Type fonts are not supported on PPC's, thus JWPce will allow the use of bitmapped fonts. 4. Remember that the open and close dialog boxes will only look for files located in subdirectories or the \My Documents directory. This limits were supplemental dictionaries and other things can be located. 5. Due to screen space limitations, many labels had to be abbreviated. 6. Due to screen limitations, some information was dropped from the Character Information dialog. 7. Because determining which programs are running, and changing the active program is difficult JWPce will only allow one version of the program to run. If you attempt to start a second version, the current version will simply be brought to the foreground. 8. I did not adhere to Microsoft's nonsense idea that PPC programs not allow the user to exit. JWPce has a close box and an exit item on the menu. ============================================================ Files: What should be there, and what may be there. Exactly what files you get with JWPce depends on who packaged the files. I distribute the program in a specific way, but since it is freeware, the copy you get may not be packaged by me. The following section describes what files should be there, what files may be there, and what they are used for. Any other

files, you can probably delete if you want to. Additionally, you can save space on a Windows CE machine by selectively not installing all of the files. JWPce minimum installation includes the following files: jwpce.exe changes.txt -- JWPce executable (this is the program). REQUIRED FILE -- Changes for this version. OPTIONAL -- If not installed you cannot view the changes in the program from your Windows CE machine. -- Copyright notice. OPTIONAL -- Not necessary for JWPce to run. -- Looks like you found this one. OPTIONAL -- Not necessary for JWPce to run. -- Jim Breen's Japanese-English dictionary OPTIONAL -- If not installed, you will not have access to the Japanese <--> English dictionary. -- Index file for edict OPTIONAL -- Required if you include EDICT -- GNU public license. OPTINAL -- Not necessary for JWPce to run. -- 16x16 bitmapped kanji font. REQUIRED FILE -- Kanji information database.** OPTIONAL -- If not installed the Character Information Dialog box will not function, and some features in the Radical Lookup Dialog will be disabled. -- Radical lookup data file. OPTIONAL -- If not installed the Radical Lookup Dialog box will not be able to lookup kanji by radical. -- Radical lookup stroke data file.* OPTIONAL -- If not installed the Radical Lookup Dialog box will not be able to lookup kanji by stroke count only. -- Additional Windows CE information OPTIONAL -- Not necessary for JWPce to run. -- Kana-to-kanji conversion dictionary REQUIRED FILE -- Index to wnn.dat. REQUIRED FILE

_cpright.txt _readme.txt edict

edict.jdx gnugpl.txt k16x16.f00 kanjinfo.dat

radical.dat

stroke.dat

wince.txt wnn.dat wnn.dix

*These files are slated to be replaced in a later version of JWPce. The new versions will have added functionally or be significantly smaller, or both. **JWPce for Windows CE is distributed with a smaller version of kanjinfo.dat that does not contain the nanori, or pin yin data. You can obtain the full version kanjiifo.dat from the web site if you wish to have the additional data. JWPce full installation files: (these are all technically optional files).

classical -- Classical Japanese dictionary. classical.euc -- Documentation for CLASSICAL. enamdic -- Japanese name dictionary. enamdic.jdx -- Index file for Japanese name dictionary. jwpce.doc -- Documentation (in Word 97 format). k24x24.f00 -- 24x24 bitmapped kanji font (if you have a good printer you can delete this one). K48x48.f00 -- 48x48 bitmapped kanji font. Files that may be in your installation: (these are files generated by JWPce, and thus may be included with the files you receive): colkanji.lst jwpce.cfg -- Kanji list used by the color-kanji feature. -- JWPce configuration file, this will be generated when you run JWPce. jwpce.dic -- JWPce dictionary configuration file. This file contains information about supplemental dictionaries you have installed. jwpce_lang.dll -- Localization (language support) file, causes JWPce to change the system interface to another language. user.cnv -- User kana->kanji conversion. This is your own conversion dictionary. user.dct -- User dictionary file. user.sel -- Holds user selections for kana->kanji conversions. ============================================================ Obsolete Files: Files that are no longer required These files have been replaced with updated files, and thus are no longer necessary. Files made obsolete in version 1.33: wnn.dct - replaced with wnn.dat wnn.idx - replaced with wnn.dix ============================================================ Older Windows CE Versions: What to do if you have an older machine. If you get an error starting JWPce on older versions of Windows CE, you will need to use the program version designed for older versions of the operating system. This version of JWPce uses fixed file locations, since early versions of Windows CE did not support variable file locations.