jwpce information

7/28/2019 JWPce Information

1/8

JWPce version 1.50

Copyright (C) 1997-2004, 2005, glenn rosenthal

JWPce is free software; you can redistribute it and/or modifyit under the terms of the GNUGeneral Public License aspublished by the FreeSoftware Foundation; either version 2 oftheLicense, or (at your option) any later version.

This program is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY; withouteven the implied warranty ofMERCHANTABILITY orFITNESS FOR A PARTICULAR PURPOSE. See theGNU General Public License for more details.

You should have received a copy of the GNU General PublicLicense along with this program; if not, write to the FreeSoftware 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 toWindows CE versions of JWPce. You should also read the

_readme.txt file which contains information about JWPce ingeneral

============================================================Disclaimers: The legal stuff, or you get what you pay for.

Because this program is free software, it is distributed in thehope that it will be useful, but WITHOUT ANY WARRANTY; withouteven the implied warranty of MERCHANTABILITY or FITNESS FOR APARTICULAR PURPOSE. This means that if you lose millions ofdollars 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 PersonalComputers) running the Windows CE operating system. Theprogram has been developed and tested under Window CE version2.0. I have not specifically excluded Windows CE versionsearlier than 2.0, but I have not tested the program under anyof these versions, and would expect that it will NOT workcorrectly.

Every attempt has been made to keep dialog boxes small enoughso that 480x240 displays will be acceptable. There are a few

dialog boxes that will have to be shifted for people usingthe smaller display (most notably the Radical Lookup dialogbox, 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 extensivelytested JWPce using these systems without any problems. I donot have an SH3 machine, so I cannot test JWPce using such amachine. However, JWPce has been tested by other users onboth SH3 and Arm based machines without any problems.


2/8

The complete installation of JWPce with dictionaries andlookup 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 isnecessary (see below). JWPce will run on a machine with 8 MBof RAM (less if some of the files are removed).

============================================================Installation Instructions for HPCs: How to get it working?

Currently there is no installer for JWPce under Windows CE. Iwill eventually generate one, but this is a low priority.Until then, the following steps can be used to install JWPceon a Windows CE machine:

1. Obtain the distribution .zip files: One way or anotherobtain the distribution .zip files - the number of fileswill depend on where you obtain them.

2. Make a temporary directory: Create a temporary directoryon 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 todecompress any general files and then to decompress filesthat are specific to your processor. At this point you candelete the .zip files as they are no longer necessary.

4. Make an installation directory: Create a program directoryon your Windows CE machine, e.g. \Program Files\JWPce.

5. Copy the files: Copy the desired files from the temporarydirectory on your desktop machine to the installationdirectory on your Windows CE machine. You can now deletethe temporary directory (and its contents) on your desktopmachine, 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 theWindows 95/98/NT version.

--------------------------------------Installing Help

Normal Windows CE help is implemented using the Pocket Helpprogram, and help information is stored in a reduced form ofHTML format. Unfortunately, using Pocket Help requires thatmost of the help files reside in the Windows\System directory.

One of the problems with HTML formatted files is that all Japanesetext 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 theWindows\System directory, so JWPce implements its help using PocketInternet Explorer. This has a number of advantages: first, thisallows 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


3/8


4/8

no longer necessary.

6. Select the Program: Now you will need to generate a link in thestart menu so you can execute the program. Find the fileJWPce.exe on the PPC device (since you just copied the files, Iam 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 onExplorer. 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 alink to JWPce in the programs menu. Activate this link. Theprogram will automatically complete the installation, and promptyou for any necessary information, just like the Windows95/98/NT/2000 version.

============================================================

Updating JWPce:

If you are installing an updated version of JWPce, you caneither get an updated package or install a complete version ofJWPce 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 acertain version of JWPce to update from. `This was done tokeep 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 maindictionaries. 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 ofJWPce I am now distributing a small program called UPDATE.EXEwith each version of JWPce. This program will check your versionof JWPce and update any necessary files to the current version.You run this program by simply double clicking on it. After youhave run UPDATE.EXE you can simply delete the program, as it willno longer be necessary. You can run UPDATE.EXE as often as youlike, it will not hurt any of the files.

--------------------------------------Windows CE Updates

I have not generated a version of UPDATE.EXE for each of theWindows CE versions. I believe that most people who are using theCE versions also have a version on their desktop. You can simplycopy the updated files from your desktop to your CE machine. Alsothe next section contains a list of things that have changed fromversion to version so you can see what UPDATE.EXE would be doing.


5/8

--------------------------------------Update History

This section contains a history of major file changes in thevarious versions of JWPce. If you are updating from an olderversion of JWPce you can see what files have been modified.

Version 1.33:

Due to changes in the kana->kanji conversion system, the filesWNN.DCT and WNN.IDX have been replaced with the files WNN.DAT andWNN.DIX. Additionally, the format of the user kana->kanjiconversion file (USER.CNV) has changed to match the format used byWNN.DAT. UPDATE.EXE will update the format USER.CNV, as well asoffer 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 theWindows 95/98/NT/2000 version; however, a number of decisions weremade 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 (justUNICODETEXT). These formats are not supported by most otherWindows CE programs.

* Multi-file selects are not supported. Windows CE does notsupport this feature.

* Printing is not supported in Windows CE. This may be addedat some later date.

* Some items were removed from the Edit menu, because the menuwas too long for the Windows CE display. The removed itemsare Insert page break, and the mode settings.

* Network startup options are not supported in Windows CE. Theuser cannot edit the command line arguments that are passedto a program.

* Some visual changes were made because of the types of buttonsor 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 ofJWPce can be run at a time on a PPC. If you attempt to startanother version, the currently running version will bebrought to the foreground.

============================================================International Support:

The appearance of JWPce's interface can be changed by the use ofa language or localization file (JWPCE_LANG.DLL). These files can

replace virtually all the text strings used by the program, aswell as menus and dialog boxes. This system was designed to allowcreation of alternative interface modules in different languages.

If a language support file is available for a language you areinterested in, you can simply copy the support file to the samelocation as JWPCE.EXE. During startup JWPce will detect thelanguage file and switch interfaces. There is an internal check tomake sure the language support file matches the version of JWPceyou are using.


6/8

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 beimplemented.

If you are interested in translating JWPce's interface to anotherlanguage please contact me or obtain the translation kit(jwpcetra.zip). This kit contains instructions, notes and toolsused to generate a translation file. (Please don't underestimatethe amount of effort that this will take, JWPce contains around300 message strings, 50 dialog boxes, a two menus containingnearly 100 items. Most of these will require translation. Thisis not even considering the manual, help, or adjustmentsnecessary 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, adelete command has been added. In addition, backup filesare not created by default, since they are difficult todelete.

2. Open file dialog on the PPC's does not support multiplefile types, so the default file type has been changed toJWPce native (.jce).

3. True Type fonts are not supported on PPC's, thus JWPcewill allow the use of bitmapped fonts.

4. Remember that the open and close dialog boxes will onlylook for files located in subdirectories or the\My Documents directory. This limits were supplementaldictionaries 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 droppedfrom the Character Information dialog.

7. Because determining which programs are running, andchanging the active program is difficult JWPce will onlyallow one version of the program to run. If you attemptto start a second version, the current version will simplybe brought to the foreground.

8. I did not adhere to Microsoft's nonsense idea that PPCprograms 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 packagedthe files. I distribute the program in a specific way, butsince it is freeware, the copy you get may not be packaged byme. The following section describes what files should be there,what files may be there, and what they are used for. Any other


7/8


8/8

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 byJWPce, and thus may be included with the files you receive):

colkanji.lst -- Kanji list used by the color-kanji feature.jwpce.cfg -- JWPce configuration file, this will be generated

when you run JWPce.jwpce.dic -- JWPce dictionary configuration file. This file

contains information about supplemental dictionariesyou have installed.

jwpce_lang.dll -- Localization (language support) file, causesJWPce to change the system interface toanother language.

user.cnv -- User kana->kanji conversion. This is your ownconversion 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 thusare no longer necessary.

Files made obsolete in version 1.33:

wnn.dct - replaced with wnn.datwnn.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 WindowsCE, you will need to use the program version designed for olderversions of the operating system. This version of JWPce usesfixed file locations, since early versions of Windows CE did notsupport variable file locations.