home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / jlist01.zip / jlist.hlp (.txt) < prev    next >
OS/2 Help File  |  1994-10-09  |  39KB  |  404 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. About JList ΓòÉΓòÉΓòÉ
  3.  
  4. JList is a program to display text files which contain japanese characters 
  5. (Kana and Kanji). To load a file, either specify the file's name on the command 
  6. line or use the Open choice in the File menu. 
  7.  
  8. Related information: 
  9.  
  10. Supported file formats 
  11. Choosing a kanji font 
  12. Planed features 
  13. License 
  14. Acknowledgments 
  15. Contacting the author 
  16. Known bugs 
  17. History 
  18.  
  19.  
  20. ΓòÉΓòÉΓòÉ 1.1. Supported File Formats ΓòÉΓòÉΓòÉ
  21.  
  22. JList supports files in the following formats: 
  23.  
  24. o ASCII 
  25. o Old-JIS 
  26. o New-JIS 
  27. o NEC-JIS 
  28. o Shift-JIS 
  29. o EUC 
  30.  
  31. When a file is opened, JList tries to detect the format. If none of the 
  32. supported japanese formats is found, the file is treated as an ASCII file. 
  33.  
  34. If this automatic detection failes (this especially can happen with Shift-JIS 
  35. and EUC files), you have to set the format explicitly. 
  36.  
  37. Related information: 
  38.  
  39. Setting the file format 
  40.  
  41.  
  42. ΓòÉΓòÉΓòÉ 1.2. Choosing the Kanji Font ΓòÉΓòÉΓòÉ
  43.  
  44. To display the japanese characters a kanji font is needed. JList supports the 
  45. fonts that come with the free japanese word processor JWP by Stephen Chung. JWP 
  46. comes with 16x16, 24x24 and 48x48 fonts. 
  47.  
  48. Packaged with JList is only the 16x16 font, which should be suitable for common 
  49. display resolutions. If you nevertheless want to use one of the bigger fonts, 
  50. you have to get JWP and use the ones provided with it. 
  51.  
  52. To select the font that should be used for display, use the choice Fonts in the 
  53. Options menu. 
  54.  
  55.  
  56. ΓòÉΓòÉΓòÉ 1.3. Planed Features ΓòÉΓòÉΓòÉ
  57.  
  58. This version of JList is more or less a test release. Currently it lacks many 
  59. features i would like to see in this program. 
  60.  
  61. Things i plan to add: 
  62.  
  63. o Printing 
  64. o Search function 
  65. o Interface to EDICT 
  66. o Better integration into the Workplace Shell 
  67.  
  68. This is in order of my personal priority. Please feel free to mail additional 
  69. features you would like to see to me. The same applies of course to bug reports 
  70. and comments in general. 
  71.  
  72. Related information: 
  73.  
  74. Contacting the author 
  75.  
  76.  
  77. ΓòÉΓòÉΓòÉ 1.4. License ΓòÉΓòÉΓòÉ
  78.  
  79. JList is Copyright (C) 1994 by Martin Thierer. All rights reserved. 
  80.  
  81. JList is Freeware. If you want to use it, you have to agree to the following 
  82. conditions: 
  83.  
  84. o You may use JList free of charge. 
  85.  
  86. o You may copy and distribute JList as long as all files included in the 
  87.   original archive are distributed and all of these files are unmodified. 
  88.  
  89. o JList is provided `as is'. There is NO WARRANTY. You use JList completly at 
  90.   your own risk. The copyright holder of JList won't be liable for any damage 
  91.   and/or loss caused by any function or malfunction of JList. 
  92.  
  93.  
  94. ΓòÉΓòÉΓòÉ 1.5. Acknowledgments ΓòÉΓòÉΓòÉ
  95.  
  96. I would like to thank Eberhard Mattes for his excellent emx Development System 
  97. which was used to write JList. 
  98.  
  99. The information about the various japanese file formats was found in Ken R. 
  100. Lunde's JAPAN.INF. 
  101.  
  102. Many good ideas where snatched from the source code for Stephen Chung's JWP. 
  103.  
  104. The kanji font used for display also comes from the JWP distribution. I found 
  105. no clue who is the copyright holder of the fonts provided with JWP, but as JWP 
  106. is distributed under the GNU General Public License i hope it's ok to include 
  107. this font here. 
  108.  
  109.  
  110. ΓòÉΓòÉΓòÉ 1.6. History ΓòÉΓòÉΓòÉ
  111.  
  112. Version 
  113.  
  114. 0.1       October 94 
  115.           Initial release 
  116.  
  117.  
  118. ΓòÉΓòÉΓòÉ 1.7. Known Bugs ΓòÉΓòÉΓòÉ
  119.  
  120. o The format of the kanji file sometimes could not be detected if the format is 
  121.   Shift-JIS or EUC. In this case the file is treated as an ASCII file. The 
  122.   remedy is to set the format explicitly. See Setting the file format. 
  123.  
  124. o If a window is moved or sized while JList is painting its window, the kanji 
  125.   are not drawn. I think this is due to a bug in OS/2. I'm currently 
  126.   investigating this, but i didn't want to delay the release of JList for this 
  127.   minor error. The quick fix is simple: Don't move or size a window while JList 
  128.   is updating its window. 
  129.  
  130.  
  131. ΓòÉΓòÉΓòÉ <hidden> Help for Keys ΓòÉΓòÉΓòÉ
  132.  
  133. In JList the keys can be used in accordance with the OS/2 system conventions. 
  134. Please refer to your OS/2 manual or the OS/2 online help for further 
  135. information. 
  136.  
  137. In addition to that, the following keys have a special meaning: 
  138.  
  139. F3        Open a file 
  140.  
  141.  
  142. ΓòÉΓòÉΓòÉ <hidden> Setting the File Type ΓòÉΓòÉΓòÉ
  143.  
  144. To set the file type for a data file you have to open the settings view of that 
  145. file. There - in the Type section - you can remove the current type and add the 
  146. new one. 
  147.  
  148. If you don't know how to open the settings view for a file, please refer to 
  149. your OS/2 documentation. 
  150.  
  151.  
  152. ΓòÉΓòÉΓòÉ <hidden> Setting the File Format ΓòÉΓòÉΓòÉ
  153.  
  154. The format of a kanji file can be set explicitly by including the format 
  155. specification as a key phrase in the File section of the settings for the file. 
  156.  
  157. The format can be one of: ASCII, Old-JIS, New-JIS, NEC-JIS, Shift-JIS and EUC. 
  158.  
  159. In case you don't know how to open the settings view of a file, please refer to 
  160. your OS/2 documentation. 
  161.  
  162.  
  163. ΓòÉΓòÉΓòÉ <hidden> Contacting the Author ΓòÉΓòÉΓòÉ
  164.  
  165. I can be reached on internet: 
  166.  
  167. zc0a1121@rpool1.rus.uni-stuttgart.de 
  168.  
  169.  
  170. ΓòÉΓòÉΓòÉ <hidden> File Menu ΓòÉΓòÉΓòÉ
  171.  
  172. The File menu contains the following choices: 
  173.  
  174. Open 
  175.  
  176.  
  177. ΓòÉΓòÉΓòÉ <hidden> Open ΓòÉΓòÉΓòÉ
  178.  
  179. The Open choice brings up the File - Open dialog. Use this dialog to open a 
  180. file that should be displayed by JList. 
  181.  
  182.  
  183. ΓòÉΓòÉΓòÉ <hidden> Options Menu ΓòÉΓòÉΓòÉ
  184.  
  185. The Options menu contains the following choices: 
  186.  
  187. Fonts 
  188.  
  189.  
  190. ΓòÉΓòÉΓòÉ <hidden> Fonts ΓòÉΓòÉΓòÉ
  191.  
  192. The Fonts choice brings up the Font Options dialog where you can choose the 
  193. ASCII and Kanji fonts for displaying the file. 
  194.  
  195.  
  196. ΓòÉΓòÉΓòÉ <hidden> Help Menu ΓòÉΓòÉΓòÉ
  197.  
  198. The Help menu contains the following choices: 
  199.  
  200. Help index 
  201. General help 
  202. Using help 
  203. Product information 
  204.  
  205.  
  206. ΓòÉΓòÉΓòÉ <hidden> Help index ΓòÉΓòÉΓòÉ
  207.  
  208. The Help index choice provides an index for help topics available in JList. 
  209.  
  210.  
  211. ΓòÉΓòÉΓòÉ <hidden> General help ΓòÉΓòÉΓòÉ
  212.  
  213. The General help choice provides a brief overview over the purpose of JList. 
  214.  
  215.  
  216. ΓòÉΓòÉΓòÉ <hidden> Using help ΓòÉΓòÉΓòÉ
  217.  
  218. The Using help choice provides help for the help function in general. 
  219.  
  220.  
  221. ΓòÉΓòÉΓòÉ <hidden> Product information ΓòÉΓòÉΓòÉ
  222.  
  223. The Product information choice opens a window displaying copyright and version 
  224. information about JList. 
  225.  
  226.  
  227. ΓòÉΓòÉΓòÉ <hidden> File - Open Dialog ΓòÉΓòÉΓòÉ
  228.  
  229. Use this dialog to choose a file that should be displayed by JList. 
  230.  
  231. If the file you want to open has the `Kanji File' file type set, you may want 
  232. to select this type from the Type of file listbox. This makes it easier to spot 
  233. the file if it is in a directory together with files of other types. 
  234.  
  235. Related information: 
  236.  
  237. Setting the file type 
  238.  
  239.  
  240. ΓòÉΓòÉΓòÉ <hidden> File - Type of file ΓòÉΓòÉΓòÉ
  241.  
  242. With this list box you can select if you want all or only the files of type 
  243. `Kanji File' to be displayed. As files normally don't have this type, the 
  244. default is `<All Files>'. 
  245.  
  246. You can however set the file type yourself. This should be considered at least 
  247. if you want to open a file often. 
  248.  
  249. Related information: 
  250.  
  251. Setting the file type 
  252.  
  253.  
  254. ΓòÉΓòÉΓòÉ <hidden> Load Progress - Status Window ΓòÉΓòÉΓòÉ
  255.  
  256. This window shows the progress while loading a file. It pops up when the 
  257. loading takes longer than 5 seconds. 
  258.  
  259. Close 
  260.           Close the window and keep on loading the file. 
  261.  
  262. Stop 
  263.           Stop loading the file and close the window. 
  264.  
  265.  
  266. ΓòÉΓòÉΓòÉ <hidden> Font Options Dialog ΓòÉΓòÉΓòÉ
  267.  
  268. This dialog shows the fonts that are currently selected. The ASCII font is the 
  269. font used for non-japanese characters; the Kanji font the one used for Kana and 
  270. Kanji. 
  271.  
  272. You can use the pushbuttons to open the Ascii Font - Choose dialog and the 
  273. Kanji Font - Open dialog. 
  274.  
  275.  
  276. ΓòÉΓòÉΓòÉ <hidden> ASCII Font - Choose Dialog ΓòÉΓòÉΓòÉ
  277.  
  278. Use this dialog to choose a font for the non-japanese characters in the text. 
  279.  
  280. Note:  You can't change the size of the font. The ASCII Font is always scaled 
  281. to the same height as the Kanji Font. This is also the reason why only outline 
  282. fonts can be selected. The size shown is the actual size with the selected 
  283. kanji font for display. 
  284.  
  285.  
  286. ΓòÉΓòÉΓòÉ <hidden> Kanji Font - Open Dialog ΓòÉΓòÉΓòÉ
  287.  
  288. Use this dialog to open a Kanji fontfile. 
  289.  
  290. If the file you want to open hasn't the file type `Kanji Font' set, then you 
  291. won't see the file until you select `<All Files>' from the File Type listbox. 
  292.  
  293. Related information: 
  294.  
  295. Setting the file type 
  296.  
  297.  
  298. ΓòÉΓòÉΓòÉ <hidden> Kanji Font - Type of file ΓòÉΓòÉΓòÉ
  299.  
  300. Here you can select if you want all or only the files of type `Kanji Font' to 
  301. be displayed. The font distributed with JList is of type `Kanji Font'. 
  302.  
  303. If you however want to use fonts you got from other sources, for example 
  304. together with JWP, this type may not be set. In this case you have to select 
  305. `<All Files>' to see the file. 
  306.  
  307. You should consider to set the file type for the font file to `Kanji Font'. 
  308.  
  309. Related information: 
  310.  
  311. Setting the file type 
  312.  
  313.  
  314. ΓòÉΓòÉΓòÉ <hidden> Kanji Font - Open Failed ΓòÉΓòÉΓòÉ
  315.  
  316. The Kanji Font that JList tried to load was not found. Now you have the 
  317. following choices: 
  318.  
  319. Open 
  320.           The Kanji Font - Open dialog comes up so you can open a kanji font. 
  321.  
  322. Continue 
  323.           The error is ignored and JList starts up as normal. You will however 
  324.           be unable to display anything, until you specify a Kanji Font with 
  325.           the coice Fonts in the Options menu. 
  326.  
  327. Cancel 
  328.           The execution of JList is aborted. 
  329.  
  330.  
  331. ΓòÉΓòÉΓòÉ <hidden> Kanji Font Open - No Kanji Font ΓòÉΓòÉΓòÉ
  332.  
  333. The file you selected is no kanji font. 
  334.  
  335. Perhaps you accidently choose the wrong file or it became corrupted. In the 
  336. latter case you have to install the font file again. 
  337.  
  338.  
  339. ΓòÉΓòÉΓòÉ <hidden> Product Information ΓòÉΓòÉΓòÉ
  340.  
  341. Related information: 
  342.  
  343. License 
  344. Acknowledgments 
  345. History 
  346.  
  347.  
  348. ΓòÉΓòÉΓòÉ <hidden> Thread failed ΓòÉΓòÉΓòÉ
  349.  
  350. This is an internal error that should not occur. If you can reproduce this 
  351. error, please contact me; perhaps we find the error. 
  352.  
  353.  
  354. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  355.  
  356. JWP is a free japanese word processor for Windows 3.1. It was written by 
  357. Stephen Chung and is distributed under the terms of the GNU General Public 
  358. License. 
  359.  
  360. You can get it by anonymous ftp for example from ftp.monash.edu.au 
  361. (130.194.11.1) in the directory /pub/nihongo. It comes in the following files: 
  362.  
  363. jwpedict.zip
  364. jwpfonts.zip
  365. jwpk48x48.zip
  366. jwpkinfo.zip
  367. jwpprog.zip
  368. jwpsrc.zip
  369. jwpwnn.zip
  370.  
  371. If you want only the fonts - they are in jwpfonts.zip (16x16 and 24x24 fonts) 
  372. and jwpk48x48.zip (48x48 font). 
  373.  
  374.  
  375. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  376.  
  377. EDICT is a electronic japanese dictionary maintained by Jim Breen. 
  378.  
  379. EDICT is available for anonymous ftp for example from ftp.monash.edu.au 
  380. (130.194.11.1) in /pub/nihongo. The archive name is EDICT.ZIP. Other archive 
  381. formats are also available. 
  382.  
  383. In addition to EDICT you should consider getting JDIC24.ZOO. JDIC is a program 
  384. written by Jim Breen for easy access to the dictionary under DOS. Viewers for 
  385. Macintosh and Windows 3.1 are also available. 
  386.  
  387.  
  388. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  389.  
  390. emx is a free package by Eberhard Mattes for the development of C, C++ and 
  391. Objective-C programs for DOS and OS/2 2.x. It is based on GCC. 
  392.  
  393. If you are interested in development for DOS and/or OS/2 2.x - try it! The 
  394. whole emx package can be obtained by anonymous ftp for example from 
  395. ftp.uni-stuttgart.de (129.69.8.13) in the directory /pub/systems/os2/emx-0.8h. 
  396.  
  397.  
  398. ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ
  399.  
  400. JAPAN.INF is a text file written by Ken R. Lunde that explains various aspects 
  401. of japanese text on computers. 
  402.  
  403. It is available by anonymous ftp from ftp.monash.edu.au (130.194.11.1) in 
  404. /pub/nihongo.