home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / utility / pecho11.zip / PECHO.DOC < prev    next >
Text File  |  1991-08-22  |  4KB  |  91 lines
  1. PECHO - Copyright 1991; All rights reserved. Created by Edward W. Jajko.
  2.     Version 1.1
  3.  
  4. The docs for this program should be small; the only people who will understand
  5. how to use this program already know PRINTF and C constant syntax.
  6. Run the program without any arguments and the following will appear:
  7.  
  8.  ╔═════════════════════════════════════════════════════════════════════════╗
  9.  ║ PECHO - Printf version of msdos ECHO command with C extended characters ║
  10.  ║         Created 8/11/1991 by Edward W. Jajko                            ║
  11.  ║         All rights reserved.                                            ║
  12.  ║         This program may not be sold under any circumstances.           ║
  13.  ║         Report bugs/suggestions to ejajko@nike.calpoly.edu              ║
  14.  ║                                                                         ║
  15.  ║ Usage:  PECHO [declarations] string...                                  ║
  16.  ║   where "string..." can contain spaces.                                 ║
  17.  ║                                                                         ║
  18.  ║   options: /b#[###...] use binary number #[###...]                      ║
  19.  ║            /o#[###...] use octal number #[###...]                       ║
  20.  ║            /d#[###...] use decimal number #[###...]                     ║
  21.  ║            /h#[###...] use hexidecimal number #[###...]                 ║
  22.  ║   where each number is used in the order presented on the command line. ║
  23.  ║                                                                         ║
  24.  ║   Any legal printf format string is acceptable.                         ║
  25.  ║   To use environmental or batch command line variables, include         ║
  26.  ║   them in the string as you would for any other action.                 ║
  27.  ║     EX: "integer %mine%: %d"                                            ║
  28.  ║   If problems occur using the % sign, use \045 instead.                 ║
  29.  ╚═════════════════════════════════════════════════════════════════════════╝
  30.  
  31.  
  32.                            .,;*************;,.
  33.                         ***HELPFUL INFORMATION***
  34.                            `'"*************"'`
  35.  
  36. Those C constants already supported:
  37.     \a    bell            \b    backspace
  38.     \f    form feed        \n    newline (carriage+linefeed)
  39.     \r    carriage return        \t    tab
  40.     \v    vertical tab        \'    single quote
  41.     \"    double quote        \\    backslash
  42.     \ddd    octal number        \0    ASCII NULL
  43.     \?    question mark
  44.  
  45. Quick rundown on PRINTF() numerical syntax: (not everything, though!)
  46.   overall format:
  47.     %[flags][width][conversion chars]
  48.   flags:
  49.     -    left justification
  50.     +    signed conversions
  51.   width:
  52.     w    width in characters
  53.     *    take width from argument list (next number)
  54.   conversion characters:
  55.     %d    decimal
  56.     %c    character
  57.     %o    octal
  58.     %x    hexidecimal (lowercase ABCDEF)
  59.     %X    hexidecimal (uppercase ABCDEF)
  60.  
  61. NOW, THE BAD NEWS:
  62.   The interface is extremely simple: I didn't add floating point or mathematical
  63. expression support; only numebers up to 65535 can be used (%ld can be used, but
  64. only by combining two bytes together, such as "pecho /d255/d255 %ld").
  65.   All in all, this program is exactly as I desgined it (besides the bug fixes,
  66. of course): a cheap, simple DOS 'echo' clone that allows things like appending
  67. text to files without return sequences and number conversions.
  68.  
  69. NOW, THE GOOD NEWS: (sort of)
  70.   I don't think this program is worth anything; use it and keep you piece of
  71. mind. If you feel guilty about getting something for free, send me a thank-you
  72. note over the Internet. You can even put a few ASCII drawn flowers at the
  73. bottom.
  74.  
  75. Well, that's it. Remember:
  76.     SUGGESTIONS???
  77.     COMPLAINTS??? (on second thought, don't...)
  78.  
  79. email me at 'ejajko@nike.calpoly.edu'. ALL helpful input accepted.
  80. (Flames, etc... incinerated.)
  81.  
  82.  
  83.                           .,;**************;,.
  84.                        ***HISTORY OF THE THING***
  85.                           `'"**************"'`
  86.  
  87. Version:
  88.     1.0    first release
  89.     1.1    minor bug fix ('\\' was neglected)
  90.  
  91.