home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / znode3 / uploads / z3help43.lbr / ECHOCOM.HZP / ECHOCOM.HLP
Encoding:
Text File  |  1991-10-15  |  6.4 KB  |  140 lines
  1. ;
  2.                                    ECHO.COM                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. ECHO.3OM       1k (8)    6C5F  1.4        Gene Pizzetta 10/91      Z3COM6
  6. ECHO.4OM       2k (12)   BF64  1.4        Gene Pizzetta 10/91      Z3COM6
  7. ECHO.COM       1k (8)    8A06  1.4        Gene Pizzetta 10/91      Z3COM6
  8.  
  9.   1- Usage  2- Printer Output  3- Configuration  4- Notes  5- Examples of Use 
  10.  
  11.    ECHO  allows  text entered at the command line to be typed  to  the  screen
  12. without  the  operating system acting on it.   This is useful  for  displaying
  13. messages from aliases and between commands of a multiple command line.
  14.  
  15.    ECHO  also provides a convenient way of sending escape sequences to the CRT
  16. or printer.   ECHO uses direct  BIOS calls without  any character translation,
  17. except as noted below.   Virtually any  ASCII  character  can  be sent because
  18. several escape  sequences  allow  sending characters that cannot ordinarily be
  19. entered on the command line.   Vs 1.0 (3/22/84) by  R. Conn.   Recent versions
  20. based on Carson Wilson's Z34RCP.
  21. :1
  22.     Syntax   ECHO {text}
  23.  
  24.    If no text is given,  no characters are echoed.   (Except that when printer
  25. output is selected, a CR,LF pair is sent at the end of the line).
  26.  
  27. Text may contain the following escape sequences:
  28.  
  29.      %P   Send following characters to printer.
  30.      %C   Send following characters to console.  (This is usually the default,
  31.           but ECHO can be configured to default to printer output.)
  32.      %>   Send following characters in lower-case.
  33.      %<   Send following characters  in  upper-case.   (This  is  usually  the
  34.           default, but ECHO can be configured to default to lower-case.)
  35.      ^c   Send character c as a control character.   For example, "^Z" sends a 
  36.           control-Z and "^@" sends a null.
  37.      %D   Send a delete (rubout) character.
  38.      %S   Send a semi-colon character.  Since it acts as the ZCPR command sep-
  39.           arator, an actual semi-colon cannot be included in the text string.
  40.      %^   Send a caret character.          
  41.      %%   Send a percent character.
  42.  Usage - 2/2 
  43.  
  44.    If two slashes are the first two  non-space characters on the command line,
  45. a usage message will be  displayed.   You can  begin the text display with two 
  46. slashes by merely preceding them with the per-cent sign escape character:
  47.      ECHO %// THIS LINE BEGINS WITH TWO SLASHES
  48.  
  49.    A semi-colon on the  command  line  signals  the  end  of  a command to the 
  50. command processor,  so  ECHO's text  string  cannot  contain  one.   Use  "%S"
  51. instead; it will be replaced with a semi-colon on output.
  52.  
  53.    If the "%" escape character is followed by "C", "P", "D", "S", "<", or ">",
  54. the appropriate action will be taken,  otherwise the following character  will
  55. merely be echoed as is.
  56. :2
  57.  Printer Output 
  58.  
  59.    Printer output varies slightly from console output.
  60.  
  61.    If a  form  feed is sent  during  printer  output ("^L"),  ECHO will send a
  62. carriage return and line feed first, then the form feed character.
  63.  
  64.    If a text  string  ends  while  ECHO is in  printer  output  mode,  a final
  65. carriage return and linefeed will be added to the string.   (In console mode a
  66. carriage return and line  feed is  sent by the  CPR  instead.)   If  you would
  67. rather not have  a  CR/LF pair  sent to  the  printer,  put the console output
  68. escape sequence ("%C") at  the end of the string.   For instance,  to reset an
  69. Epson printer without spacing the paper up a line:
  70.  
  71.      ECHO %P^[@^M%C
  72.  
  73. This sequence sends ESC and "@", followed by a carriage return ("^M"), but not 
  74. a final carriage return/line feed because output is redirected to the console.
  75. :3
  76.  Configuration 
  77.  
  78.    Although no configuration is necessary,  two  defaults can be changed using
  79. ZCNFG and the ECHOnn.CFG configuration file.  If you do not change the name of 
  80. the CFG file,  ZCNFG will always be  able to  find it,  even if you change the
  81. name of ECHO.
  82.  
  83.    Normally ECHO defaults to sending  upper-case characters,  but ZCNFG can be
  84. used to set the default to lower-case.   Also, output normally defaults to the
  85. console, but ECHO can be configured to default to the printer.
  86. :4
  87.  ECHO Notes - 1/2 
  88.  
  89.    a. Vs 1.4 updates (10/10/91, Gene Pizzetta):
  90.       - ECHO was sometimes exhibiting strange behavior under BYE, which Howard
  91.         Goldstein diagnosed  as  a  stack  problem.   The  stack size has been
  92.         increased.  
  93.       - Also, now uses ZSLIB GCOMNAM instead of  Z3LIB PRTNAME so correct disk
  94.         name prints on usage screen even with GO command.  
  95.       - Some code tweeking saved a few bytes.
  96.  
  97.    b. Vs 1.3 updates (11/25/90, Gene Pizzetta):
  98.       - Fixed a bug that could cause a crash under certain circumstances if no
  99.         text string was given on the command line.  
  100.       - Added %D escape sequence that  sends  a  DEL (RUB) character, the only
  101.         character ECHO could not send.  
  102.       - Converted code to Zilog.
  103.  ECHO Notes - 2/2 
  104.       
  105.    c. Vs 1.2 updates (10/21/90, Gene Pizzetta):
  106.       - I got tired of my aliases not working whenever I got rid of my RCP for
  107.         more memory.   So I decided to make the transient ECHO compatible with
  108.         Carson Wilson's Z34RCP.  Code mostly his, modified as necessary.  
  109.       - The dollar sign ($) for printer output no longer works.  
  110.       - One additional escape sequence has been added:   %S sends a semi-colon
  111.         to printer or screen; there was no other way to send one.  
  112.       - Now properly requires *two* slashes for the help message.  
  113.       - Added type-3 safety header.  
  114.       - Added type-4 version.  
  115.       - Configurable with ZCNFG.
  116.  
  117.    d. Vs 1.1 updates (09/22/87, Cameron Cotrill):
  118.       - Code from RCPECHO in z33 applied to ECHO10, resulting in a type 3 
  119.         transient echo that knows case.
  120. :5
  121.  Examples of Use 
  122.  
  123.    a. ECHO hello, world
  124.  
  125.       - sends text "HELLO, WORLD" to console 
  126.  
  127.    b. ECHO Assembling;m80 =$1;^E
  128.               if input;echo Linking;l80 /P:100,$1,A:SYSLIB/S,$1/N,/E;fi
  129.  
  130.       - a single multiple command line will print the informative messages 
  131.         "ASSEMBLING" and "LINKING" during the respective commands
  132.  
  133.    c. ECHO ^Z
  134.  
  135.       - clears CRT screen (on terminal where ^Z clears the screen)
  136.  
  137.    d. ECHO $^L
  138.  
  139.       - form feeds printer (assuming printer responds to form feed char)
  140.