home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / KAYPRO / CRHRDSFT.LBR / HRDSFT.DQC / HRDSFT.DOC
Text File  |  2000-06-30  |  4KB  |  103 lines
  1.  ****************************************************************
  2.  *                                *
  3.  *              HARDSOFT version 1.1            *
  4.  *                                *
  5.  *               by Kenneth M. Toy,            *
  6.  *             San Diego, California,            *
  7.  *         copyright (c) January 30, 1984,        *
  8.  *              all rights reserved.            *
  9.  *                                *
  10.  ****************************************************************
  11.  
  12.  
  13.     HARDSOFT is a WordStar utility program that is intended to be
  14. used to facilitate the transfer of text files, to and from
  15. WordStar, from non-WordStar format sources.  It has applications
  16. in the uploading and downloading of files from remote bulletin
  17. board systems as well.    This program is designed to either a)
  18. remove all WordStar specific characters (while setting the eighth
  19. higher order bit to zero) or b) insert soft carriage-returns into
  20. a file so that text-reformatting can be performed.
  21.  
  22.     The program has two main modules.  The text hardener (this
  23. term, as well as the idea for this program, was taken from
  24. Lindsay Woodall of San Diego, California) and the text softener
  25. (the idea for which came from Bill Spencer, also of San Diego).
  26.  
  27.  
  28. The input format can take only one of three forms:
  29.  
  30.             input               output
  31.  
  32. harden:     HARDSOFT FILENAME.EXT        FILENAME.HRD
  33.  
  34. soften:     HARDSOFT FILENAME.EXT S     FILENAME.SFT
  35.  
  36. help:        HARDSOFT            help screen
  37.  
  38.  
  39. Notes:
  40.  
  41.     1)    This version of HARDSOFT can handle only those files that
  42. will fit entirely within memory.  For a 64K system this means
  43. that the maximum input file size is approximately 48K.    A future
  44. implementation of this program may include the ability to handle
  45. larger files.  However, WordStar does not handle files of this
  46. size very well, so the utility of such an enhancement is
  47. questionable (except possibly for smaller systems).
  48.  
  49.     2)    HARDSOFT writes the output file to the default drive.
  50. Hence, it can be invoked from another drive (with the input file
  51. possibly residing on a third).
  52.  
  53.     3)    HARDSOFT does not alter the original file in any way.
  54.  
  55.     4)    The end of the input file is assumed to have been reached
  56. if a 1ah character is encountered prior to the end of the file.
  57.  
  58.  
  59.  
  60.             ** Hardening **
  61.  
  62.     Hardening a file consists of first setting all of its eighth
  63. (higher) order bits to zero and then stripping all resultant non-
  64. printing ascii characters from it.  I have taken the printing
  65. ascii characters to include all hex characters between 20h and
  66. 7fh (inclusive) as well as 0ah (line feed), 0dh (carriage-return)
  67. and 09h (tab).
  68.  
  69.  
  70.  
  71.             ** Softening **
  72.  
  73.     Softening a file inserts WordStar soft carriage-returns into
  74. the file based on the following criteria.
  75.  
  76.     A hard carriage-return is assumed to be desired if the line
  77. immediately following the carriage-return in question begins with
  78. one of the following characters:
  79.  
  80.           * a space
  81.           * a tab
  82.           * another carriage return
  83.           * or a period (this is for the dot commands).
  84.  
  85.     Alternately, a soft carriage-return is inserted if the next line
  86. begins with any other character, with the following exceptions:
  87.  
  88.   1)  If a line begins with a period it will automatically end with
  89.   a hard carriage return.
  90.  
  91.   2)  If a line consists solely of a carriage return then that
  92.   carriage return will be hard.
  93.  
  94.  
  95.  
  96.             ** NOTE **
  97.  
  98.  
  99.     Columns of numbers, if they begin at the left most margin,
  100. will be treated as reformattable text and hence WILL be
  101. reformatted (with the obvious resultant mess) if hard carriage-
  102. returns are not inserted by hand.
  103.