home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d09xx / d0943.lha / JIStoJi / Readme < prev    next >
Text File  |  1993-12-20  |  9KB  |  213 lines
  1. JIStoJi version 1.5 (1993/10/30)
  2.  
  3.     JIStoJi automatically identifies electronic texts written
  4. in Old-JIS, New-JIS, Shift-JIS, or EUC-JIS (as well as, of course,
  5. ASCII) and displays them on screen, or prints them to dot-matix
  6. printers.
  7.  
  8.     JIStoJi.LZH may be freely distributed in its current form to, 
  9. and its unarchived contents freely used by, anyone, but neither the
  10. package nor any part of it is to be sold for profit.  The programmer
  11. retains copyright.
  12.  
  13.     JIStoJi will run on Kickstart 1.3 and up.  On 2.04 and up it
  14. will use the ASL requesters, and set screen size to the user's Overscan
  15. Text setting (up to 700 X 500), allowing longer, and more, lines.
  16.  
  17. Installation and Running
  18. ========================
  19.  
  20.     The file JJ16.fnt must be on a disk or disk partition named
  21.     Nihongo:, or in a directory assigned to Nihongo:  (i.e., from 
  22.     the CLI, type
  23.  
  24.              :> copy JJ16.fnt <name of chosen directory or volume>
  25.              :> assign Nihongo:  <name of chosen directory or volume>)
  26.  
  27.     I think it should probably NOT be the Fonts: directory--how would
  28.     Fixfonts react?
  29.  
  30.     The assignment needs to have been made each time you load JIStoJi;
  31.     it may be worthwhile to add the assignment statement to your
  32.     startup sequence.
  33.  
  34.     Ideally, JJ16.fnt and JIStoJi would go in a directory on a
  35.     hard disk.  Second best might be to load them to RAM: each 
  36.     time.      Alternatively, one could use a floppy disk named 
  37.     Nihongo.  A single floppy system will load slowly, and require
  38.     some initial disk switching, but once loaded, the program runs
  39.     reasonably fast.  
  40.  
  41.         If you have 24X24-bit fonts (they must be named JIS24.fnt), 
  42.     they should go in the same directory as JJ16fnt.  (On a floppy 
  43.     there is barely room for the program and 16-dot and 24-dot fonts.  
  44.     In this case it would be best to keep only the fonts on a disk
  45.     named Nihongo, and put JIStoJi on a WorkBench disk.)
  46.         Put JIStoJi anywhere you like.  Feel free to
  47.     rename it "JJ," to make it easier to call from the CLI, providing 
  48.     there is no other file named JJ in the same directory.
  49.  
  50.     To run from the CLI prompt, type
  51.     
  52.           [run] jistoji (or jj?) [properly addressed file name]
  53.  
  54.     where items in [] are optional.  If you do not give a file
  55.     argument in the command line, you will need to use the
  56.     "Open" requester later (see below).
  57.  
  58.     To run from WorkBench, double-click on the JIStoJi icon
  59.     and use the Open menu item to call up the desired text, or
  60.     click once on the JIStoJi icon, hold down the shift-key, and
  61.     click twice on the desired text icon (Kickstart 2+ users can
  62.     employ the Window menu's "Show >>> All Files" item if the file
  63.     has no icon of its own), or be sure that the file's icon infor-
  64.     mation has proper reference to JIStoJi as the default tool,
  65.     and click twice on the file icon only.
  66.  
  67.     Once a text is called up, to scroll one line down, or up, use 
  68.     the up/down arrow keys.
  69.     To scroll just less than one screenful down or up, use shifted
  70.     arrow keys.
  71.  
  72.     To go to the end or beginning of the text: Alt-downarrow/uparrow.
  73.     Hot keys (with Right_Amiga) for menu items are available.
  74.     Left_Amiga with "M" and "N" have their normal functions of
  75.     cycling screens.
  76.  
  77. Menu items
  78. ==========
  79.  
  80.     Open    Under AmigaDOS 1.3, this calls up a string gadget for
  81.         the name and path of the text file.  It may be neces-
  82.         to leave the program temporarily to hunt for a file if
  83.         its path is not known (a good reason to use the "run 
  84.         JIStoJi" command).  If the user happens to have
  85.         Khalid Aldoseri's kd_freq.library (version 2.0 or
  86.         higher) in libs:, then "Open" will summon that high-tech
  87.         file requester.  Under AmigaDOS 2+, Open calls up the
  88.         ASL requester.  Those who prefer kd_freq may, of
  89.         course, simply run FR_Bypass before choosing Open.
  90.  
  91.     Print    If JIS24.fnt is available in Nihongo:, those fonts
  92.         will be used for printing.  (Be sure a printer that
  93.         emulates Epson's 24-bit graphics is attached to the
  94.         parallel port!)  Otherwise, the JJ16.fnt file will be
  95.         used.  Since 24X24 printing is faster than 16X16 (the
  96.         latter requires a double pass), there is no reason
  97.         to make this user-selectable.  (Of course, the user
  98.         CAN select, by temporarily renaming the 24-bit fonts.
  99.         This might possibly be necessary if, for example, your
  100.         printer does not support the <ESC>k0 command to use
  101.         letter quality Roman font.)
  102.             To stop printing, click the window Close
  103.         gadget once.  If your printer has a buffer, it may
  104.         take a while to react (turn it off to clear buffer?).
  105.         This is kind of sloppy, but...  (Right^Amiga-Q will
  106.         have no effect on printing, incidentally.)
  107.  
  108.     ID Code    Identifies the type of the most recently handled
  109.         JIS code, if any.
  110.  
  111.     Quit    An alternative to the window Close gadget (except
  112.         for quitting printing).  
  113.  
  114.     About    How to get in touch with me.
  115.  
  116.  
  117. Shortcomings
  118. ============
  119.  
  120.     Character spacing is not properly balanced between ASCII
  121.     and Japanese, so that mixed lines, including "typewriter" 
  122.     graphics made with mixed characters, will not come out right.  
  123.     The proportions are, furthermore, different between the screen 
  124.     and the printer.  JIStoJi, as of vers. 1.5, uses the fonts
  125.     set in Preferences.  This could cause overlapping text because
  126.     Topaz 8 was assumed in measuring ASCII character spacing.  The
  127.     next update will specifically assign a font.
  128.         Half-width katakana is not implemented yet.  Code for
  129.     half-width (hankaku) katakana will be misinterpreted, most often
  130.     as unusual kanji (I have knowingly encountered only one example 
  131.     of such in 1 1/2 years of looking at Japanese texts.  See 
  132.     Shift.sample)
  133.         Hard-copy margins are not adjustable.  Top and bottom
  134.     margins are set to approximately one inch on 11" paper.  There
  135.     is no left margin; look for a one-inch margin to be implemented
  136.     in the next(?) update.  The amount of right margin depends on the 
  137.     line lengths in the original document.
  138.         If there are wrapped lines on a screen, scrolling up
  139.     by single lines will sometimes result in line repetitions.  The
  140.     workaround is to refresh the screen with full-screen up and down
  141.     (or vice-versa).
  142.  
  143.     Note: the program prints to par:, not to prt:.  It knows nothing
  144.     about your choice of Preference printers.  If I hear that this is
  145.     a problem, I will find out how to fix it.
  146.     
  147. Acknowledgments
  148. ===============
  149.  
  150.     Much of what is right about this program owes to helpful
  151.     responses to my E-mail questions from Shraddhan, Larry Phillips, 
  152.     John Foust, Steve Goddard, Khalid Aldoseri, Brian J. Bartlett and
  153.     Freddy Portargent in the AmigaTech forum of CompuServe.  Correction
  154.     of bad code in versions 1.4 and 1.5 owes much to Baron K. Fujimoto at
  155.     the University of Hawaii computer center who has checked the program
  156.     with Enforcer and sent me the "hit lists."  I only wish I could find 
  157.     someone to blame for the remaining defects.   :-)
  158.  
  159. Changes
  160. =======
  161.  
  162.     Version 1.5 (19931030)
  163.         Fixed WorkBench version of the potential crash-on-loading
  164.         problem fixed for CLI in 1.4 (trying to load un-requested
  165.         text files).  Fixed bug introduced with change in About
  166.         requester in 1.4.
  167.     Version 1.4 (19931007)
  168.         Repaired bad instructions that caused loading (from CLI) 
  169.         crashes on some machines (but miraculously not on others, 
  170.         including mine).
  171.         Corrected oversight that allowed non-JIS <ESC>'s (such as 
  172.         ANSI escape sequences) to crash program.
  173.         Fixed bug introduced with vers. 1.2 that left line-wrapped
  174.         New/Old JIS code unconverted on one-line scroll downs.
  175.         Fixed bug that changed characters to frownies when looking 
  176.         at two different 8-bit-coded documents in succession.
  177.  
  178.     Version 1.3 (First general release, 19930905)
  179.           Added WorkBench access.  Fixed scrolling problem that 
  180.         sometimes caused repeated lines when scrolling one line up.  
  181.         Fixed bug that cost 32 bytes of memory when calling text file 
  182.         from CLI.  Removed the weird "color adjuster."
  183.  
  184.     Version 1.2 (not released): Fixed bug causing dirty characters in
  185.         24X24 matrix hard copy.  Fixed major bug that resulted in
  186.         failure to display half of JIS level 2 from a Shift JIS
  187.         text.
  188.  
  189.     Version 1.1 (not released): Made sensitive to overscan text size,
  190.         as set by user in Preferences.
  191.  
  192.     Version 1.0 (not released): Added ASL requester for users of OS 2+.
  193.  
  194.     Version 0.9: Released with known bugs to individuals by request.
  195.  
  196. For temperate complaints, criticisms and suggestions, please contact:
  197.           ======================================
  198.  
  199.           Bart Mathias               (808) 372-3061 (home)
  200.           EALL, Moore 382            (808) 956-2074 (work, voice mail)
  201.           1890 East-West Road        (808) 956-9515 (fax) 
  202.                University of Hawaii
  203.           Honolulu  HI 96816
  204.  
  205.                              mathias@uhunix.uhcc.hawaii.edu
  206.                              mathias@uhunix.uhcc.bitnet
  207.                              (Compuserve) 72017,1005
  208.  
  209. If you wish to be informed of any updates that might be forthcoming, you
  210. should be sure I have a valid address for you.  (This applies to version
  211. 0.9 users as well.  I am discarding the old list and starting a new one.)
  212.  
  213.