═══ 1. About JList ═══ JList is a program to display text files which contain japanese characters (Kana and Kanji). To load a file, either specify the file's name on the command line or use the Open choice in the File menu. Related information: Supported file formats Choosing a kanji font Planed features License Acknowledgments Contacting the author Known bugs History ═══ 1.1. Supported File Formats ═══ JList supports files in the following formats: o ASCII o Old-JIS o New-JIS o NEC-JIS o Shift-JIS o EUC When a file is opened, JList tries to detect the format. If none of the supported japanese formats is found, the file is treated as an ASCII file. If this automatic detection failes (this especially can happen with Shift-JIS and EUC files), you have to set the format explicitly. Related information: Setting the file format ═══ 1.2. Choosing the Kanji Font ═══ To display the japanese characters a kanji font is needed. JList supports the fonts that come with the free japanese word processor JWP by Stephen Chung. JWP comes with 16x16, 24x24 and 48x48 fonts. Packaged with JList is only the 16x16 font, which should be suitable for common display resolutions. If you nevertheless want to use one of the bigger fonts, you have to get JWP and use the ones provided with it. To select the font that should be used for display, use the choice Fonts in the Options menu. ═══ 1.3. Planed Features ═══ This version of JList is more or less a test release. Currently it lacks many features i would like to see in this program. Things i plan to add: o Printing o Search function o Interface to EDICT o Better integration into the Workplace Shell This is in order of my personal priority. Please feel free to mail additional features you would like to see to me. The same applies of course to bug reports and comments in general. Related information: Contacting the author ═══ 1.4. License ═══ JList is Copyright (C) 1994 by Martin Thierer. All rights reserved. JList is Freeware. If you want to use it, you have to agree to the following conditions: o You may use JList free of charge. o You may copy and distribute JList as long as all files included in the original archive are distributed and all of these files are unmodified. o JList is provided `as is'. There is NO WARRANTY. You use JList completly at your own risk. The copyright holder of JList won't be liable for any damage and/or loss caused by any function or malfunction of JList. ═══ 1.5. Acknowledgments ═══ I would like to thank Eberhard Mattes for his excellent emx Development System which was used to write JList. The information about the various japanese file formats was found in Ken R. Lunde's JAPAN.INF. Many good ideas where snatched from the source code for Stephen Chung's JWP. The kanji font used for display also comes from the JWP distribution. I found no clue who is the copyright holder of the fonts provided with JWP, but as JWP is distributed under the GNU General Public License i hope it's ok to include this font here. ═══ 1.6. History ═══ Version 0.1 October 94 Initial release ═══ 1.7. Known Bugs ═══ o The format of the kanji file sometimes could not be detected if the format is Shift-JIS or EUC. In this case the file is treated as an ASCII file. The remedy is to set the format explicitly. See Setting the file format. o If a window is moved or sized while JList is painting its window, the kanji are not drawn. I think this is due to a bug in OS/2. I'm currently investigating this, but i didn't want to delay the release of JList for this minor error. The quick fix is simple: Don't move or size a window while JList is updating its window. ═══ Help for Keys ═══ In JList the keys can be used in accordance with the OS/2 system conventions. Please refer to your OS/2 manual or the OS/2 online help for further information. In addition to that, the following keys have a special meaning: F3 Open a file ═══ Setting the File Type ═══ To set the file type for a data file you have to open the settings view of that file. There - in the Type section - you can remove the current type and add the new one. If you don't know how to open the settings view for a file, please refer to your OS/2 documentation. ═══ Setting the File Format ═══ The format of a kanji file can be set explicitly by including the format specification as a key phrase in the File section of the settings for the file. The format can be one of: ASCII, Old-JIS, New-JIS, NEC-JIS, Shift-JIS and EUC. In case you don't know how to open the settings view of a file, please refer to your OS/2 documentation. ═══ Contacting the Author ═══ I can be reached on internet: zc0a1121@rpool1.rus.uni-stuttgart.de ═══ File Menu ═══ The File menu contains the following choices: Open ═══ Open ═══ The Open choice brings up the File - Open dialog. Use this dialog to open a file that should be displayed by JList. ═══ Options Menu ═══ The Options menu contains the following choices: Fonts ═══ Fonts ═══ The Fonts choice brings up the Font Options dialog where you can choose the ASCII and Kanji fonts for displaying the file. ═══ Help Menu ═══ The Help menu contains the following choices: Help index General help Using help Product information ═══ Help index ═══ The Help index choice provides an index for help topics available in JList. ═══ General help ═══ The General help choice provides a brief overview over the purpose of JList. ═══ Using help ═══ The Using help choice provides help for the help function in general. ═══ Product information ═══ The Product information choice opens a window displaying copyright and version information about JList. ═══ File - Open Dialog ═══ Use this dialog to choose a file that should be displayed by JList. If the file you want to open has the `Kanji File' file type set, you may want to select this type from the Type of file listbox. This makes it easier to spot the file if it is in a directory together with files of other types. Related information: Setting the file type ═══ File - Type of file ═══ With this list box you can select if you want all or only the files of type `Kanji File' to be displayed. As files normally don't have this type, the default is `'. You can however set the file type yourself. This should be considered at least if you want to open a file often. Related information: Setting the file type ═══ Load Progress - Status Window ═══ This window shows the progress while loading a file. It pops up when the loading takes longer than 5 seconds. Close Close the window and keep on loading the file. Stop Stop loading the file and close the window. ═══ Font Options Dialog ═══ This dialog shows the fonts that are currently selected. The ASCII font is the font used for non-japanese characters; the Kanji font the one used for Kana and Kanji. You can use the pushbuttons to open the Ascii Font - Choose dialog and the Kanji Font - Open dialog. ═══ ASCII Font - Choose Dialog ═══ Use this dialog to choose a font for the non-japanese characters in the text. Note: You can't change the size of the font. The ASCII Font is always scaled to the same height as the Kanji Font. This is also the reason why only outline fonts can be selected. The size shown is the actual size with the selected kanji font for display. ═══ Kanji Font - Open Dialog ═══ Use this dialog to open a Kanji fontfile. If the file you want to open hasn't the file type `Kanji Font' set, then you won't see the file until you select `' from the File Type listbox. Related information: Setting the file type ═══ Kanji Font - Type of file ═══ Here you can select if you want all or only the files of type `Kanji Font' to be displayed. The font distributed with JList is of type `Kanji Font'. If you however want to use fonts you got from other sources, for example together with JWP, this type may not be set. In this case you have to select `' to see the file. You should consider to set the file type for the font file to `Kanji Font'. Related information: Setting the file type ═══ Kanji Font - Open Failed ═══ The Kanji Font that JList tried to load was not found. Now you have the following choices: Open The Kanji Font - Open dialog comes up so you can open a kanji font. Continue The error is ignored and JList starts up as normal. You will however be unable to display anything, until you specify a Kanji Font with the coice Fonts in the Options menu. Cancel The execution of JList is aborted. ═══ Kanji Font Open - No Kanji Font ═══ The file you selected is no kanji font. Perhaps you accidently choose the wrong file or it became corrupted. In the latter case you have to install the font file again. ═══ Product Information ═══ Related information: License Acknowledgments History ═══ Thread failed ═══ This is an internal error that should not occur. If you can reproduce this error, please contact me; perhaps we find the error. ═══ ═══ JWP is a free japanese word processor for Windows 3.1. It was written by Stephen Chung and is distributed under the terms of the GNU General Public License. You can get it by anonymous ftp for example from ftp.monash.edu.au (130.194.11.1) in the directory /pub/nihongo. It comes in the following files: jwpedict.zip jwpfonts.zip jwpk48x48.zip jwpkinfo.zip jwpprog.zip jwpsrc.zip jwpwnn.zip If you want only the fonts - they are in jwpfonts.zip (16x16 and 24x24 fonts) and jwpk48x48.zip (48x48 font). ═══ ═══ EDICT is a electronic japanese dictionary maintained by Jim Breen. EDICT is available for anonymous ftp for example from ftp.monash.edu.au (130.194.11.1) in /pub/nihongo. The archive name is EDICT.ZIP. Other archive formats are also available. In addition to EDICT you should consider getting JDIC24.ZOO. JDIC is a program written by Jim Breen for easy access to the dictionary under DOS. Viewers for Macintosh and Windows 3.1 are also available. ═══ ═══ emx is a free package by Eberhard Mattes for the development of C, C++ and Objective-C programs for DOS and OS/2 2.x. It is based on GCC. If you are interested in development for DOS and/or OS/2 2.x - try it! The whole emx package can be obtained by anonymous ftp for example from ftp.uni-stuttgart.de (129.69.8.13) in the directory /pub/systems/os2/emx-0.8h. ═══ ═══ JAPAN.INF is a text file written by Ken R. Lunde that explains various aspects of japanese text on computers. It is available by anonymous ftp from ftp.monash.edu.au (130.194.11.1) in /pub/nihongo.