home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / misc / foreignl / mackc093.sit / ReadMe < prev   
Encoding:
Text File  |  1990-10-21  |  4.8 KB  |  117 lines
  1. [ About MacKc V0.93 ]  10/20/90 (C) Masato Hirose
  2.  
  3. Name of Software: MacKc version 0.93 (Japanese Kanji Code Converter)
  4. Type of Software: freeware
  5. Distribution: free for non-commercial use
  6. Author: Masato Hirose
  7. Machine: Macintosh Plus and up
  8. OS: Macintosh System 6.0 or KanjiTalk6.0.4
  9.  
  10. This is a program which converts textfiles encoded with Japanese Kanji codes
  11. to/from Shift-JIS, JIS, and EUC. This program can
  12.  
  13.      (1) automatically recognize the input file's Kanji code,
  14.      (2) convert all the files within a folder,
  15.      (3) convert input files, combine, and save as another name,
  16.      (4) set the file's 'Type/Creator',
  17.      (5) and convert a textfile's line termination code (Mac/Unix/DOS).
  18.  
  19.  
  20. - Introduction
  21.  
  22.  MacKc is a utility to convert Japanese Kanji codes on a Macintosh.
  23.  It can automatically recognize the input Kanji code, so please select
  24.  ONLY output code in the menu. It can simultaneously convert CR/LF/CRLF
  25.  too, and also automatically recognizes the line termination code of the
  26.  input text, so please select ONLY for the output in the menu.
  27.  
  28.  This program is freeware. It may be freely distributed except for
  29.  commercial purposes.
  30.  
  31.  
  32. - How to use
  33.  
  34. Open as
  35.  Used to start conversion and save as a new file. First select the output
  36.  file, and next, select the input file. Once you have selected a file, again
  37.  the same window will appear. You can select the next input file, or
  38.  cancel to start conversion. All converted data is stored in the first file
  39.  selected as output. If you have selected 'No Conversion' in the menu 'Output
  40.  Code' and 'Text', the data fork of the input files will be concatinated and
  41.  stored in the output file.
  42.  
  43. Open and Open Folder
  44.  'Open' is to start conversion of a file. 'Open Folder' is to
  45.  start conversion of every file in a folder (hierarchically), so select
  46.  the folder which includes all the files you wish to convert. If you want
  47.  to abort conversion, type command + '.'. (CAUTION: If you start conversion
  48.  with 'Open' or 'Open Folder', the input files *themselves* will be
  49.  converted!)
  50.  
  51. Options: Set Creator/Type
  52.  To set 'Creator' and 'Type' of the converted files.
  53.  
  54. Options: Beep when done
  55.  Will beep when all done if checked.
  56.  
  57. Options: Logging
  58.  To start/end a log of the status while converting.
  59.  
  60. Options: When Can't decide
  61.  MacKc automatically recognizes the input file's Kanji code, but in some cases
  62.  (very rarely), it can't recognize what code the file uses. Shift-JIS's half-
  63.  size kana and EUC kanji can be ambiguous when trying to recognize the input
  64.  file's Kanji code. This menu lets you choose what code should be selected in
  65.  such a case. 'SJIS half-kana' is Shift-JIS code, 'EUC kanji' is EUC code, or
  66.  no check is no conversion.
  67.  
  68. Options: Set FileName
  69.  To rename the converted file's name to lower case or upper case. No check
  70.  means no renaming of the file.
  71.  
  72. Text
  73.  MacKc is a program to convert Kanji code, but also can convert the
  74.  line termination code of the text, CR(MacOS)/LF(Unix)/CRLF(DOS),
  75.  simultaneously. The line termination code of the input text is
  76.  automatically recognized, so please select ONLY the output type.
  77.  'No Conversion' means no conversion of the file's line termination code.
  78.  
  79. Output Code
  80.  To select the output Kanji code, 'SJIS', 'EUC', or 'JIS'. If 'JIS' has
  81.  selected, you can also select its JIS type (old1/old2/new1/new2) and
  82.  8bit or not (7bit) in the submenu 'Set JIS Type'. In its submenu, there
  83.  are some characters, such as '$@' and '(H'. They show the Kanji-in/out
  84.  characters of its JIS type. If you want to send Japanese text as a
  85.  mail to your Japanese friend via Internet, 'JIS Old2 (NOT 8bit)' is
  86.  recommended eventhough Shift-JIS is the standard Kanji code in KanjiTalk...
  87.  'No Conversion' means no conversion of the file's Kanji code.
  88.  
  89.  
  90. - About an error in converting
  91.  
  92.  If any errors have occurred during conversion, MacKc shows it with its line
  93.  number (the first error's) in the window. This happens when the input
  94.  file has some illegal characters. In such a case, MacKc outputs them as
  95.  is. There is *probably* no problem, but you had better check it.
  96.  
  97.  
  98. - Conclusion
  99.  
  100.  This program is not perfect (few are!). It may have some bugs, so please
  101.  convert your important files only after making backup copies. And if you
  102.  find any bugs or have any suggestions, please send an e-mail message
  103.  telling me about it so that future versions will be better.
  104.  
  105.  MacKc uses 'kc1.3' as the kernel code for Kanji code conversion.
  106.  'kc1.3' was posted in JUNET and has been used widely in Japan. I liked it
  107.  very much, so I ported it to the Macintosh. Its author is Mukawa (NTT).
  108.  I'm deeply indebted to Mr. Mukawa for his permission to adopt 'kc1.3'.
  109.  And I'm deeply indebted to Mr. Ken R. Lunde (University of Wisconsin-
  110.  Madison) for his bug reports, too.
  111.  
  112. --
  113. Masato Hirose
  114. NiftyServe: NBD01017
  115. CompuServe: 72131,1017
  116. Internet: hirose@sws.cpd.mei.co.jp
  117.