home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / dbarjffa.zip / README.1ST < prev    next >
Text File  |  1999-07-10  |  9KB  |  250 lines
  1. DBar Version "JFF"a
  2. (for SBCS OS/2 Warp)
  3.  
  4. Created by The Castle Production
  5. Internet E-Mail: wetcastle@hotmail.com
  6. Internet WWW: http://members.xoom.com/castlemaster
  7.  
  8.  
  9. Note:  This README.1ST file was written by Timothy Sipples to expand on the
  10. information provided in the original program distribution.  The original
  11. README.TXT file is retained.
  12.  
  13.  
  14. INTRODUCTION
  15. ------------
  16.  
  17. Welcome to DBar for OS/2 Warp!  Although IBM produces Chinese language
  18. versions of OS/2 Warp for sale in Asia, many users around the world may need
  19. to create and view Chinese language documents.  Fortunately IBM has added
  20. new Universal Language Support (ULS), Unicode, and other features to OS/2
  21. Warp which allow SBCS (Single Byte Character Set) versions of OS/2 Warp to
  22. handle DBCS (Double Byte Character Set) languages.
  23.  
  24. DBar is designed to provide basic Chinese language keyboard entry
  25. capabilities when using a SBCS version of OS/2 Warp.  Some (but not all)
  26. applications will readily accept Chinese language input, including common
  27. applications such as the OS/2 System Editor.
  28.  
  29. This "Just For Fun" version has some limitations and outright defects.
  30. However, it can provide basic Chinese language keyboard entry capabilities
  31. for OS/2 Warp users who don't happen to be using the DBCS translated
  32. editions.
  33.  
  34. Both Big5 and GB modes are supported.
  35.  
  36.  
  37. PREREQUISITES
  38. -------------
  39.  
  40. To run DBar (and view Chinese language files) you must be running any
  41. version of OS/2 Warp, Warp Server, or WorkSpace On-Demand.  You should also
  42. install a relatively recent IBM fixpack for your version of OS/2 Warp.  (For
  43. example, OS/2 Warp Version 4 requires Fixpack 5 or later.)  IBM fixpacks are
  44. available for download from IBM Software Support at
  45. http://service5.boulder.ibm.com/pspfixpk.nsf.  They are also available from
  46. BMT Micro (http://www.bmtmicro.com) and Indelible Blue
  47. (http://www.indelible-blue.com).
  48.  
  49. You should also install Java Version 1.1.4 (or later) runtime with Unicode
  50. support.  (The Unicode support provides the necessary character sets for
  51. displaying and printing the Chinese language.)  The Java runtime with
  52. Unicode can be downloaded from IBM's web site at
  53. http://www.software.ibm.com/os/warp/downloads/java.  It is also available on
  54. CD-ROM from Indelible Blue and BMT Micro.
  55.  
  56. Please be sure to read the fixpack and Java installation instructions for
  57. any other prerequisites they may require.
  58.  
  59. Note that Warp Server for e-business and WorkSpace On-Demand Version 2 do
  60. not require any fixpacks or Java updates to run DBar.
  61.  
  62. The EMX runtime should also be installed.  You can obtain the EMX runtime
  63. (usually filename EMXRT.ZIP) from "Hobbes" at http://ftp-os2.nmsu.edu.
  64.  
  65.  
  66. CODEPAGE SETUP
  67. --------------
  68.  
  69. After installing the necessary Universal Language Support and Unicode (with
  70. the fixpack and Java installation), you must make some minor changes to
  71. CONFIG.SYS to activate Chinese language support.
  72.  
  73. Edit CONFIG.SYS with a text editor (such as the OS/2 System Editor).  Locate
  74. the COUNTRY line in the file.  For example, in the U.S. English version of
  75. OS/2 Warp it may read:
  76.  
  77. COUNTRY=001,C:\OS2\SYSTEM\COUNTRY.SYS
  78.  
  79. Change it to read:
  80.  
  81. COUNTRY=088,C:\OS2\SYSTEM\COUNTRY.SYS
  82.  
  83. if you plan to use "Big5" character codes.
  84.  
  85. Then locate the CODEPAGE line in CONFIG.SYS, which may read:
  86.  
  87. CODEPAGE=437,850
  88.  
  89. and change it to read:
  90.  
  91. CODEPAGE=950,850
  92.  
  93. for "Big5."
  94.  
  95. If you plan to use GB codes, use these two lines instead:
  96.  
  97. COUNTRY=086,C:\OS2\SYSTEM\COUNTRY.SYS
  98. CODEPAGE=1381,850
  99.  
  100. Shutdown and reboot.  After making these changes you should be able to use
  101. the OS/2 System Editor (or the Enhanced Editor) to view Chinese text files,
  102. assuming you have selected an appropriate font for viewing (such as Times
  103. New Roman MT 30).
  104.  
  105. These modifications are not necessary if you only plan to view Chinese
  106. language files in Netscape Communicator or other applications which are
  107. "Locale aware."  In Netscape Communicator you will need to choose the
  108. correct character encoding (from the View -> Encoding menu) and perhaps also
  109. change the font (Edit -> Preferences -> Fonts) for any encoding(s) you may
  110. use.  (Although not always attractive at small point sizes, Times New Roman
  111. MT 30 is a good font choice.)
  112.  
  113. Other applications which can handle Chinese language display include MR/2
  114. ICE e-mail (see http://nick.secant.com) and Sun's HotJava web browser.
  115.  
  116. Some applications (particularly those which are not DBCS or Locale aware)
  117. may have difficulty with setting 950 or 1381 as the primary codepage.  If
  118. so, try making the Chinese codepage secondary.  For example:
  119.  
  120. CODEPAGE=950,850
  121.  
  122. becomes:
  123.  
  124. CODEPAGE=850,950
  125.  
  126. U.S. users may find that substituting codepage 437 for 850 works better:
  127.  
  128. CODEPAGE=437,950
  129.  
  130. When the Chinese codepage is secondary, you must use the CHCP (change
  131. codepage) command prior to starting any application which requires the
  132. Chinese codepage, including DBar.  Sample batch files (DB950.CMD and
  133. DB1381.CMD) are provided to demonstrate how to change codepages and start
  134. DBar.  The following series of commands is one example:
  135.  
  136. CHCP 950
  137. DBAR
  138. CHCP 437
  139.  
  140.  
  141. INSTALLATION
  142. ------------
  143.  
  144. Simply unzip DBar in any empty directory.  You may also wish to add this
  145. directory to the PATH in CONFIG.SYS.  And you may also wish to set up a
  146. program object for the DBar batch file you have modified (DB950.CMD or
  147. DB1381.CMD).
  148.  
  149. In other words, there's no special setup required (other than the codepage
  150. setup) to run DBar.
  151.  
  152. Note that GB code users may generate extraordinarily large Chinese
  153. characters if the correct versions of DBAR.INI, PHASE.INI, and PUNCT.INI are
  154. not used.  GB users should run the following commands in the DBar directory:
  155.  
  156. RENAME *.INI *.B5
  157. RENAME *.GB *.INI
  158.  
  159. to make use of the correct versions of these files.
  160.  
  161. If you decide to experiment and create your own character coding mechanisms,
  162. please keep a backup of the critical configuration files.  See README.TXT
  163. for details on the contents of the INI files.
  164.  
  165. DBar and Chinese Editor share a common format for their input method
  166. configuration files.
  167.  
  168.  
  169. LIMITATIONS
  170. -----------
  171.  
  172. Some of the limitations of DBar include:
  173.  
  174. 1. Abnormal switching between DBar and the target application.
  175.  
  176. 2. Slow response on certain systems, with characters skipped entirely if you
  177.    type too quickly.
  178.  
  179. 3. DBar does not work properly when trying to enter text into child dialogs
  180.    and windows.
  181.  
  182. 4. Cursor edit keys (such as Backspace and Delete) should be used directly
  183.    within the target application, not through DBar.
  184.  
  185.  
  186. PRICING
  187. -------
  188.  
  189. "If you insist" (says the author), you may send HK$50 to:
  190.  
  191. Kwan Chi Wai
  192. 1609, Fung Hei House
  193. Fung Lai Court
  194. Wong Tai Sin, KLN
  195. HONG KONG
  196.  
  197. for this "Just For Fun" version.  Improvements are not guaranteed, but your
  198. written comments are welcome.
  199.  
  200.  
  201. MORE INFORMATION
  202. ----------------
  203.  
  204. There are many resources available on the Internet for Chinese language
  205. users of OS/2 Warp.  Here are a few (as of July, 1999):
  206.  
  207. 1.  WarpMate
  208. http://www.apsy.fju.edu.tw/~os2/download/warpmate.htm
  209.  
  210. WarpMate, like DBar, is a utility designed to facilitate keyboard entry of
  211. Chinese language characters.  However, unlike DBar, WarpMate has difficulty
  212. with newer releases of OS/2 Warp.  (It probably will not work with OS/2 Warp
  213. Version 4 if any fixpacks have been installed.)
  214.  
  215. 2.  Hong Kong OS/2 Users Group
  216. http://www.os2.org.hk
  217.  
  218. 3.  Team OS/2 Taiwan
  219. http://www.apsy.fju.edu.tw/~teamos2
  220.  
  221. 4.  The Castle Production
  222. http://members.xoom.com/castlemaster
  223.  
  224. Includes DBar information plus links to Chinese Editor (utility for direct
  225. entry of Chinese characters into a basic editor, for cut and paste into
  226. other applications), and ChinER (a more professional direct entry utility).
  227.  
  228. 5.  Unionway
  229. http://www.unionway.com
  230.  
  231. There are many Chinese (and other DBCS) language utilities designed for
  232. Windows 3.1x which should work fine under Win-OS/2.  Unionway, for example,
  233. produces AsianSuite, a collection of utilities and fonts designed to provide
  234. Chinese, Japanese, and Korean language capabilities.
  235.  
  236. If you do choose a Windows product, please be sure to tell the vendor you
  237. use it under Win-OS/2.  You may also want to ask the vendor for an OS/2 Warp
  238. version (perhaps written in Java or Open32).
  239.  
  240. 6.  Internet Newsgroups
  241.  
  242. The comp.os.os2.utilities newsgroup, although an English language newsgroup,
  243. is a good place to discuss Chinese Editor and other Chinese language
  244. utilities.  If you don't have a newsreader you can visit http://www.deja.com
  245. to access this newsgroup and search its archives (as well as the archives of
  246. other newsgroups).
  247.  
  248. Deja (www.deja.com) also provides access to the tw.bbs.comp.os2 newsgroup.
  249.  
  250.