home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 2 / goldfish_vol2_cd1.bin / files / util / cli / cout / english / cout.doc < prev    next >
Encoding:
Text File  |  1993-08-26  |  2.5 KB  |  132 lines
  1.  
  2.  
  3.                           cout V1.00
  4.  
  5.                   Copyright © 1993 Harald Pehl
  6.                        All rights reserved
  7.  
  8.                             FREEWARE
  9.  
  10.                        With Documentation
  11.  
  12.  
  13.  
  14.  
  15.  
  16. Preface
  17. -------
  18.  
  19. This program is freeware, this means that you can copy it
  20. freely as long as you don't ask any more money for it than a
  21. nominal fee for copying.  If you want to distribute this program
  22. you should keep this document with it.  This program cannot be
  23. used for commercial purposes without written permission from the
  24. author.
  25.  
  26. If you have suggestions or remarks about this program, or if you
  27. find any bugs, please let me know. Naturaly I won't refuse any
  28. gifts. When sending in bug reports, please state exactly under what
  29. circumstances the bug occurred, what equipment was used and what
  30. happened.  If possible also try to give me enough information to
  31. reproduce the bug.  It is very difficult to find bugs when you
  32. don't know exactly what happened.
  33.  
  34. Write to the following address:
  35.  
  36.         Harald Pehl
  37.         Equarhofen 8
  38.         97215 Uffenheim
  39.         Germany - Europe
  40.  
  41.  
  42.  
  43.  
  44.  
  45. Introduction
  46. ------------
  47.  
  48. cout is a simple CLI-command that should replace the Echo command by Commodore.
  49. Due to the fact that I regulary code in C and C++ and because in my opinion the
  50. control-characters used by printf() and cout are an very efficient way of
  51. formatting a text, I decided to program a command that uses these
  52. control-characters and beyond that some more.
  53.  
  54.  
  55.  
  56.  
  57. Usage
  58. -----
  59.  
  60. cout can only be started from the CLI and requires at least on argument:
  61.  
  62.    cout [String]
  63.  
  64. if <String> contains spaces you have to enclose it into " ".
  65.  
  66. Fallowing control-characters are supported:
  67.  
  68.      \a: Beep
  69.      \b: Backspace
  70.      \f: Form Feed
  71.      \n: New Line
  72.      \r: carrage return
  73.      \t: Tab
  74.      \v: Vertical-Tab
  75.      \\: The '\' itsself
  76.      \d: Bold on
  77.      \k: Italic on
  78.      \u: Underlined on
  79.      \i: Inversiv on
  80.      \x: Reset to defaults
  81.  
  82. If theres no argument cout prints an emtpy line
  83.  
  84.  
  85. Example:
  86.  
  87.      cout "\n\nThis is \dbold\x, \kitalic\x and \uunderlined\x text!\n\n"
  88.  
  89.  
  90.  
  91.  
  92. Description
  93. -----------
  94.  
  95. cout was created with MaxonC++. It uses the dynamic store managment of C++ (new)
  96. and simply copies the inputstring to a reserved area and adds some characters
  97. just depending on the given control-characters (e.g "\x9b""1m" for bold on or
  98. '\n' for a new line).
  99.  
  100.  
  101.  
  102. © 1993 cout V1.00 written by Harald Pehl
  103.                   Greetings to Florian Derks and Martin Gleiß.
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.