home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / txtutl / hardsoft.arc / HARDSOFT.DOC next >
Text File  |  1988-08-11  |  7KB  |  149 lines
  1.                               HardSoft
  2.                     WordStar Document Converter
  3.                    (c) 1988, All Rights Reserved
  4.                                  by 
  5.                              Craig Miller
  6.                              Honolulu, HI
  7.  
  8.                            August 10, 1988
  9.  
  10.      -WHY YOU WANT THIS PROGRAM-
  11. This program is for Wordstar (TM) users, who have on occasion a
  12. need to convert their Wordstar files to plain (vanilla)
  13. textfiles.  There are other programs which will do this
  14. conversion, WS2ASCII for example.  HardSoft will also convert
  15. plain textfiles into Wordstar files, which will then have a
  16. single Return at the end of the Paragraph, instead of at the end
  17. of each line.  I know of no other program in the MS-DOS world
  18. that will convert files in this direction.  For example, suppose
  19. you write up a quick note with SideKick (TM) (or similar
  20. program), and later you want to integrate that quick note into a
  21. larger Wordstar file.  You can do a ^KR (Control K R) to read in
  22. the file, but there will be a return at the end of each line.  In
  23. order to reformat the text with ^B, you will have to take out all
  24. those returns by hand, or use HardSoft.
  25.  
  26.      -HISTORY-
  27. There is a CP/M program which will do the conversion mentioned
  28. above in both directions.  I have never seen the program, but I
  29. know that it is called HardSoft.  The reason it is called
  30. HardSoft, is because it changes the Returns at the end of each
  31. line into a Hard or Soft Return.  While editing in Wordstar, a
  32. Hard Return has a '<' at the right hand side of the screen, while
  33. a Soft Return shows nothing at the right.
  34.  
  35.      -WHAT WORDSTAR DOES-
  36. Wordstar not only inserts soft returns when it automatically word
  37. wraps for you, but it also modifies the last character in each
  38. word, so that it can micro justify you text for you.  All this
  39. happens without the user knowing it takes place.  Until, you go
  40. to send this file across the phone lines on your modem, then you
  41. see some really strange gibberish, which is barely recognizable
  42. as your file.
  43.  
  44.      -WHAT HARDSOFT DOES-
  45. HardSoft 'looks' at your plain text file (that you created with
  46. SideKick, for example) and sets the hi bit in the last character
  47. of each word, just like Wordstar does, and it sets the hi bit of
  48. the returns at the end of each line (making them into soft
  49. returns) until HardSoft 'detects' the end of a paragraph where it
  50. leaves the return alone.
  51.  
  52. Going from a Wordstar file to a plain text file is the easy part,
  53. HardSoft, merely resets all the hi bits in the characters that
  54. are in the file.
  55.  
  56.      -HOW TO USE HARDSOFT-
  57. MS-DOS has an ability called I/O redirection.  At the Command
  58. line, the user can specify what file the program will 'see', and
  59. what file the program will create and 'write' to.  MS-DOS uses
  60. the '<' and '>' characters to specify the input file, and the
  61. output file using I/O redirection.  (for more info regarding I/O
  62. redirection look in your MS-DOS manual.  SORT uses I/O
  63. redirection, for example)
  64.  
  65. HardSoft also uses I/O redirection, it makes writing utilities
  66. easier, and the resulting program is smaller.  In order to use
  67. HardSoft, you must type the following EXACTLY:
  68. A>HARDSOFT <WSFILE.DOC >TEXTFILE.TXT -H
  69.  
  70. Note there is a space between hardsoft, and the '<' character,
  71. and another between the Wordstar file name, and the '>', and
  72. still another between the textfile name, and the '-H'.  You NEED
  73. 3 (three) spaces on the command line in the above positions, or
  74. it won't work!
  75.  
  76. To make the conversion in the other direction, that is to create
  77. a Wordstar file from a plain text file, type the following:
  78. A>HARDSOFT <TEXTFILE.TXT >WSFILE.DOC -S
  79.  
  80. Note the 3 (three) strategically placed spaces!
  81.  
  82. If you type:
  83. A>HARDSOFT
  84. by itself, hardsoft will display the above examples in a concise
  85. manner, and give you the ShareWare info.
  86.  
  87.      -ABOUT THE PROGRAM AND THE AUTHOR-
  88. HardSoft is written in Turbo Pascal v 4.0.  Credit, therefore,
  89. must go to Borland International for their fine implementation of
  90. Pascal.  The entire source code was written by me, and I have no
  91. one else to blame for any of it's shortcomings.
  92.  
  93. I chose to use I/O redirection in this program, because I wanted
  94. to write a quick and dirty, but fast and effect program.  I/O
  95. redirection, means that this program will take up less room on
  96. your disk.  The -H and -S switches are standard UNIX (TM) type
  97. format.  I've only dabbled in UNIX, but I do try to adhere to
  98. standards.
  99.  
  100. Should the responce to this utility be great enough, that is I
  101. can quit my regular job, and do full time programming (so send in
  102. your $2 today), I can consider making this utility more user
  103. friendly in a future version.
  104.  
  105.  
  106. The author, that's me, has been a resident of Honolulu for the
  107. past 12 years, and has been working with computers for an equal
  108. amount of time.  The first digital computer (yes the Navy still
  109. had analog computers in the mid '70's) I worked on was a Navy CDC
  110. computer that had a whole 8K of ferrite core memory, and not a
  111. single IC in the whole computer!  I have been interested in
  112. Mircocomputers since 1983, when I bought a Commodore VIC 20.  I
  113. out grew that in 2 weeks, and bought an Apple ][+.  I have since
  114. owned an Apple //c with CP/M and a Meg of RAM, a Toshiba 1100+, a
  115. Mac SE, and a Mac Plus.  I still own the last three computers.
  116.  
  117.      -SHAREWARE INFO-
  118. Programmers are people too. We like to eat, go to the theater,
  119. send our kids to school and even buy new computer equipment now
  120. and then. A good deal of time goes into the writing and debugging
  121. of programs such as this and we do like to know that our efforts
  122. are appreciated.
  123.  
  124. I am an enthusiastic believer in the concept of shareware. Paying
  125. the shareware fee is tangible positive feed back for the author.
  126. Everyone benefits from shareware, the user, who gets to use good
  127. software, and the author, who receives support thru the shareware
  128. fee.
  129.  
  130. If you use this program and feel that it has saved YOU some
  131. labor, you can express your appreciation very simply by putting
  132. two one-dollar bills, one two-dollar bill, or even eight
  133. twenty-five cent stamps into an envelope and mailing it to me,
  134. postage pre-paid, of course. I will accept a check, but I hardly
  135. think anyone will rob the post office for two bucks.
  136.  
  137.  
  138. Please send the envelope (with two (2) dollars in it) to:
  139.  
  140.     Craig Miller
  141.     2115 Haena Drive
  142.     Honolulu, HI 96822
  143.  
  144. Should you have any problems or questions regarding this
  145. shareware you can write to me at the above address, or leave me
  146. mail on GEnie, I am CVMILLER there.
  147.  
  148. Aloha...
  149.