home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / text / jonix_1 / !Jonix / !Help next >
Text File  |  1996-07-18  |  3KB  |  71 lines
  1. Jonix manual
  2. 0.01/16.07.96/Chris Rutter
  3. =============================================================================
  4.  
  5. 0. RISC OS version
  6.  
  7.   I have taken the command-line Jonix and added in a polling bit of code
  8.   into the C source and put a window front end. All the command-line
  9.   options are now specified in the Jonix window. Here follows the original
  10.   Jonix manual.
  11.  
  12. 1. Overview
  13.  
  14.   Jonix is a utility that will take input formatted for a certain width (ie.
  15.   where linebreaks have been inserted at the end of every line) and join
  16.   continuing lines together. It's main purpose is transcription of text
  17.   files for use in DTP documents/LaTeX etc.
  18.  
  19. 2. Syntax
  20.  
  21.   Jonix can be invoked like this:
  22.  
  23.       jonix <input file> <output file> <options>
  24.  
  25.   Briefly, it takes all lines ending with "." and assumes that they are
  26.   paragraph ends. Any line with a string of identical non-alphanumeric
  27.   characters over <rowlength> long is counted as a paragraph end. Any
  28.   other line is assumed to be continuing if it is within <distance> of
  29.   the <width> of the page. If a line starts with a lower case letter then
  30.   the previous linebreak (if any) is removed.
  31.  
  32. 3. Options
  33.  
  34.       --width,-w <width>
  35.           Allows you to specify the width of the document -- useful in
  36.           conjuction with distance. If not specified, a width of 80 is
  37.           assumed.
  38.  
  39.       --distance,-d <distance>
  40.           This specifies the minimum distance away from the right hand edge
  41.           of the page a line must finish to qualify as being continuing.
  42.           If not specified, a distance of 10 is assumed.
  43.  
  44.       --rowlength,-r <length>
  45.           This specifies the minimum length of a string of identical non-
  46.           alphanumeric characters that must occur to make that line into
  47.           a paragraph end. If not specified, jonix defaults to 6.
  48.  
  49.       --newline,-n <newline character>
  50.           This specifies the newline character used. If not specified, jonix
  51.           will pick up the first newline character from the in file and
  52.           treat that as the newline character. Jonix cannot cope with
  53.           composite newline characters (ie. <LF><CR> or <CR><LF>).
  54.  
  55.       --remove,-v <0=false, non-0=true>
  56.           This specifies whether to remove lines containing just non-alpha
  57.           numeric characters (eg. a row of dashes <width> long).
  58.  
  59. 4. Contact
  60.  
  61.   Snail-mail: Old Laceys,
  62.               St John’s Street,
  63.               Duxford,
  64.               Cambridge,
  65.               CB2 4RA,
  66.               United Kingdom.
  67.       E-mail: chris@colegium.demon.co.uk (preferred address)
  68.       Arcade: ‘Chris Rutter’ (#745)
  69.        Phone: +44 1 223 832474 (in UK: 01223-832474)
  70.          Fax: +44 1 223 836723 (in UK: 01223-836723)
  71.