home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PASCAL / PADOUT16.ZIP / PADOUT.DOC next >
Encoding:
Text File  |  1990-07-27  |  3.3 KB  |  67 lines
  1.                             PADOUT Version 1.6
  2.  
  3. Syntax (From Command Line):
  4.  
  5. PADOUT InFile OutFile [128]
  6.  
  7. Where InFile is the Input File to be padded, and OutFile is the name you 
  8. want for the resulting padded output file. 
  9.  
  10. [128] indicates an OPTIONAL "switch". If you want the file padded with 
  11. spaces to the nearest multiple of 128 bytes, for Xmodem transfer, type
  12.  
  13. PADOUT InFile OutFile 128
  14.  
  15. Otherwise, omit the "128".
  16.  
  17. PADOUT's filenames can also be inputted from within the program. Just type 
  18. PADOUT at the DOS prompt, and PADOUT will prompt you for the filenames.
  19.  
  20. ********************************CAUTION***********************************
  21.  
  22.     The Output file name, OutFile in our example, MUST be different than 
  23. the Input file name. PADOUT cannot safely overwrite its' own input file!
  24. While some checking has been inserted to prevent duplication, it is still 
  25. possible to get around this.  USING THE SAME NAME FOR THE OUTPUT AS FOR 
  26. THE INPUT WILL DESTROY THE INPUT FILE WITHOUT PRODUCING A USABLE OUTPUT 
  27. FILE!
  28. ***************************************************************************
  29.  
  30. PADOUT is a short program written in Turbo Pascal (tm) (compiled with 
  31. Turbo Pascal 5.5) whose purpose is to "pad out" files to the nearest 1024 
  32. or 128 bytes with blanks, Hex 00 characters, to permit the files to be 
  33. cleanly transmitted using 1K Xmodem or standard Xmodem protocol. Xmodem 
  34. uses 128 byte packets, and in the event of a file that is not an integral 
  35. number of 128 byte packets, fills in the last packet with more or less 
  36. random bytes from your computer. 1K Xmodem, sometimes called "YModem", 
  37. particularly in older sources, does the same thing, but with 1024 byte 
  38. packets.  This can result in some files not functioning properly after 
  39. Xmodem transfer. The problem occurs in particular with WordPerfect (tm) 
  40. text files, where the "padding" added by Xmodem is treated as part of the 
  41. document by WordPerfect. Since the padding added by Xmodem can be 
  42. anything, it is not uncommon for WordPerfect to see the Xmodem padding as 
  43. control codes which result in the document being unusable.
  44.  
  45.  PADOUT produces a new file on your disk, with a name that you specify
  46. either on the command line, or from inside the program, which is a copy of 
  47. an original file that you specify, plus however many blank spaces (hex 00) 
  48. that are needed to build the filelength up to an even multiple of 1024 or 
  49. 128 bytes. The excess spaces are ignored from within WordPerfect version 5 
  50. and if necessary can be deleted from wordprocessors harmlessly, and you can 
  51. avoid random "noise" padding characters at the end of the file.
  52.  
  53.  PADOUT was written by Bill Larkins, sysop, Chevy Chase Board BBS,
  54.  (703) 549-5574, July 1990, and is hereby released to the Public Domain.
  55.  
  56.  Acknowledgements: I would like to thank Michael Reuben, who called my
  57. attention to the padding problem of Xmodem and 1K Xmodem transfer, with
  58. particular regard to transmitting WordPerfect files. I would like to
  59. especially thank David Seidman, who suggested major revisions in PADOUT
  60. after reviewing the first version.  The code in this version, 1.6, of
  61. PADOUT, is due more to David Seidman's kind assistance than to me.
  62.  
  63.  Disclaimer: PADOUT has not been tested on a wide range of machines,
  64.  and its' performance cannot be guaranteed. Use at your own risk.
  65.  
  66.  
  67.