home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / dizzy103.zip / DIZZY.DOC next >
Text File  |  1994-03-09  |  3KB  |  79 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                             DIZZY, v1.03
  7.            DOS utility: FILE_ID.DIZ off-line reformatter
  8.               Freeware, copyright (c) 1994 [94/03/09]
  9.                                  by
  10.                        David Daniel Anderson
  11.                              Reign Ware
  12.  
  13.            ** READ REIGNWAR.TXT FOR LEGAL MUMBO JUMBO **
  14.  
  15.  
  16.  
  17.  
  18. DIZZY reformats any text file (with lines up to 255 characters long)
  19. into 44 (or an alternate length) character lines, preparing it for
  20. use as a FILE_ID.DIZ (a BBS .ZIP file contents descriptor).
  21.  
  22. PCBoard BBS's typically use the FILE_ID.DIZ (if it exists as a file within
  23. the .ZIP file) as the upload description, and require that description to
  24. be a maximum of 8 lines at up to 44 characters each.  DIZZY won't remove
  25. extra lines: it is up to the user to edit, and up to DIZZY to reformat what
  26. the user has written.
  27.  
  28.      *** WARNING!!!  DIZZY OVERWRITES THE INPUT FILE, SO MAKE SURE
  29.      THAT YOU EITHER WORK ON A COPY OF YOUR FILES OR YOU KNOW WHAT
  30.      YOU ARE DOING BEFORE YOU START. ***
  31.  
  32. It will be impossible to have your file returned be to its original
  33. state, but you may be able to retrieve the original with an undelete
  34. program.
  35.  
  36. However, DIZZY does not remove text, so no matter what happens, you
  37. will still have everything that you started with.
  38.  
  39. Usage:  DIZZY <file_id.diz> [line_length]
  40.  
  41. DIZZY takes one or two parameters on the command line: the name of the
  42. file(s) to reformat and the line length desired.
  43.  
  44. The file name may contain wildcards, for example: "DIZZY *.diz" (without the
  45. quotes) would reformat all files with the extension ".diz".
  46.  
  47. The line length must be a number between 40 and 127.  The default (used if
  48. none is specified) is 44 characters.
  49.  
  50. Note: DIZZY removes leading and trailing spaces from all lines, and changes
  51. all occurrences of multiple spaces into single spaces.  It leaves hard tabs
  52. and ASCII 255 (a blank character that is not a space) intact.
  53.  
  54. Finally, I have noticed a couple of FILE_ID.DIZ editors available, but have
  55. not tried them.  I wrote (and use) DIZZY because I don't want to learn how to
  56. use another editor - especially if the author is asking for a registration
  57. fee.  I like DIZZY because, like most of my programs, it is small, simple,
  58. fast, and free.  I really do not need or want a mule of a GUI like Microsoft
  59. Windows (tm).
  60.  
  61.            ** READ REIGNWAR.TXT FOR LEGAL MUMBO JUMBO **
  62.  
  63. {------------------------------------------------------------------------------
  64.  
  65.                                 REVISION HISTORY
  66.  
  67. v1.00  : 1993/07/14.  First public release.  DDA
  68. v1.01  : 1993/08/27.  Fixed bug: would not properly process files in
  69.                             directories other than the current one.  DDA
  70. v1.01a : 1993/09/24.  Added ability to set line length.  DDA
  71.                       Improved the "showhelp" procedure.  DDA
  72. v1.02  : 1994/01/24.  Now formats 'file_id.diz' if no parameters found on
  73.                       the command line.  DDA
  74. v1.03  : 1994/03/09.  Fixed problem with solid lines exceeding line length.
  75.                       Error pointed out by Mark Shadley, fixed by DDA.
  76.  
  77. ------------------------------------------------------------------------------}
  78.  
  79.