home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / txtutl / petascii.ark / PETASCII.DOC < prev    next >
Encoding:
Text File  |  1987-09-18  |  2.6 KB  |  66 lines
  1.  
  2.                             PETASCII
  3.                            Version 1.0
  4.  
  5.                           Gene Pizzetta
  6.                              9/17/87
  7.  
  8.  
  9. This program will quickly and safely translate a PETASCII (also
  10. known as Commodore ASCII) text file into standard ASCII form.  It
  11. is written in Z80 assembly language (using extended Intel
  12. mnemonics) for CP/M Plus.
  13.  
  14. USAGE:
  15.  
  16.     PETASCII {d:}<fn.ft> {d:}{<fn.ft>}
  17.  
  18. Copies the input file (first file reference) to the output file
  19. (second file reference), converting PETASCII characters to ASCII
  20. characters.  It also inserts linefeeds after carriage returns
  21. where they do not already exist (if a linefeed is already there,
  22. no additional linefeed is added).
  23.  
  24. If the drivecode (d:) of the input file is omitted the current
  25. drive is assumed.  An input filename is required.
  26.  
  27. If the output file reference is omitted, it will be given the
  28. same name as the input file.  Any file of the same name on the
  29. destination drive will be renamed to filetype .BAK, which will
  30. preserve the original input file if both input and output use the
  31. same drive.  If the output filename does not include a filetype,
  32. the output file will be given the same filetype as the input
  33. file.  If a drive specification is not given, output will default
  34. to the current drive.
  35.  
  36. If the program is run on a standard ASCII file, it will be
  37. translated to PETASCII.  Uppercase characters of the resulting
  38. will be in PETASCII low uppercase (97-122), rather than the high
  39. uppercase values (193-218) returned by the BASIC ASC function. 
  40. (You didn't know Commodore had two uppercases!)  In any case it
  41. will work the same.
  42.  
  43. This program was developed using SLRMAC from SLR Systems.  If you
  44. haven't used SLRMAC, or the same company's Z80ASM, you don't know
  45. how fast and convenient assembly can be.  This program can also
  46. be re-assembled with MAC by changing the filetype to .ASM and
  47. making sure Z80.LIB is on your default (current) drive.  (SLRMAC
  48. has Z80.LIB built-in.)
  49.  
  50. In writing this program I drew heavily from the I/O routines
  51. discussed by David E. Cortesi in his "A Programmer's Notebook: 
  52. Utilities for CP/M-80".  This is an excellent book, but a little
  53. hard to come by.  I had to special-order it from Prentice-Hall.
  54.  
  55. I hope this utility comes in handy occasionally for somebody
  56. besides myself.  Let me know if you find any bugs or have any
  57. suggestions.  I considered putting in an optional switch to allow
  58. the removal of linefeeds, but I decided that nobody would
  59. translating *into* PETASCII in CP/M mode.  Tell if I'm wrong. 
  60. Enjoy!
  61.  
  62.                     Gene Pizzetta
  63.                     Quantum-Link (GeneP)
  64.                     CompuServe (72060,505)
  65.  
  66.