home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / editors / sky100.arj / SKY.HLP < prev    next >
Text File  |  1992-02-21  |  5KB  |  109 lines
  1. SKYWRITER Version 1.0 (c) 1983,1991 James J. Keene, Ph.D.
  2.  
  3. SkyWriter Language Reference
  4.  
  5. A SkyWriter program line consists of two fields:  Text  and  Command.
  6. The Text field is required only when B, C, F, M or P instructions are
  7. in the Command field.
  8.  
  9. The simplicity of SkyWriter commands may be easily appreciated.
  10. Text is supplied to the document by the P, M and F commands in programs.
  11. Text can also come from the XXX, PRINT and LIST commands
  12. and from the Function Keys, if text has been Assigned.
  13.  
  14. Program Command field instructions:
  15.  
  16.   An   ASSIGN Program Text or user-specified string n (1 to 20) for use
  17.         by the USE command below or by Function Key n (1 to 10).
  18.   B    BEGIN using Program Text as subdirectory in current path or
  19.         as new path (if Text contains a "\" or ":"), to get Files.
  20.   C    CALL SkyWriter program in File as subroutine.
  21.   D    DOUBLE SPACE (same as R2 below).
  22.   END  of program (or return from subroutine).
  23.   F    FILE specified by File inserted into document.
  24.   Gn   GO to Program Text if last menu choice B to P was n
  25.            (n = 2 to 16 for B to P respectively).
  26.   H    HEADER (menu page 1 line A) inserted before first menu choice.
  27.   In   INDENT left margin n spaces until further notice.
  28.   Jn   JUMP n program lines (n = + or - number).
  29.   K    KILL normal insertion of commas between Menu Text choices.
  30.   L    LINE output of Text overrides right margin formating.
  31.   M    MENU in File displayed.
  32.   Nn   NEXT text on document line n.
  33.   O    ONE Menu Text choice by user automatically advances program.
  34.   P    PRINT Program Text.
  35.   Q    QUIT using current subdirectory to get Files.
  36.   Rn   n carriage RETURN-line feeds inserted into document.
  37.   Sn   n SPACES inserted in document line.
  38.   Tn   TAB n spaces from left margin in document line.
  39.   Un   USE Assigned string n in next occurrence of XXX.
  40.   Wn   WIDTH of document lines set to n for right margin formatting.
  41.   XEND within any subroutine, ends program and document.
  42.   .    insert "." after menu if text selected from it.
  43.   ,    insert "," after menu if text selected from it.
  44.   ;    insert ";" after menu if text selected from it.
  45.  
  46.   NOTE:
  47.   n = 1 to 3 character integer number.
  48.   XXX = blank in Text field filled in during real-time writing.
  49.   Program Text = Text in a program line trimmed of trailing spaces.
  50.   Menu Text = Text in a menu line trimmed of trailing spaces.
  51.   File = Filename left-justified in Program Text field, followed
  52.          by a space and optional Comment, used by C, F and M.
  53.  
  54. Program Text fields contain text for the document if the P command is used.
  55. The Program Text field is a File for C, F or M, or is a Path
  56.    for the B command.
  57. The HKO.,; commands modify program lines containing a M command.
  58. The other commands further control the writing process.
  59.  
  60. The single-character commands (without the n argument) may appear in the
  61. Program Command field in any order.  However, commands with the n argument
  62. must be the last in each Command field; and only one of these may appear
  63. per program line.
  64.  
  65. The SkyWriter Language Interpreter executes commands in this order:
  66.  Q (B or C) (END) (one of AIJNRSTUW) (F or M with HKO.,; or P) LDRG
  67.  
  68. Menu Command field instructions:
  69.  On menu page 1, Line A, the first and second characters of the Command
  70.  field may be used for the H,K, O or .,; commands above.
  71.  This is often convenient for the programmer, since the desired handling
  72.  of header, commas, text choices and other punctuation is often most
  73.  easily specified when a menu itself is being edited.
  74.  
  75. Menu Text field commands:
  76.      XXX        is a "blank" to be filled in with any text.
  77.      GO TO Text tranfers control to the program line containing the Text.
  78.      PRINT file inserts file text in document with right margin reformated.
  79.      LIST file  inserts file text in document using line format in file.
  80.  
  81. Program Text field commands:
  82. Same as those for Menus if the program line includes the P (PRINT) command.
  83.  
  84. Real-time Writing commands:
  85.    B to P  Select Menu Text to write into document.
  86.    Tab     Selects menu column, if there is more than one.
  87.    1 to 9  Select menu page for screen display.
  88.    ()*+.-, Insert command character into document.
  89.    SPACE   Advances program from menu to next program line.
  90.    <-      Causes program to "backspace" to the previous menu display.
  91.    Delete  Deletes last character from document.
  92.    R       Accesses editing by user of menu text.
  93.    S       Executes SkyWriter program line written by user.
  94.    V       Positions to next line (same as carriage-return with line feed).
  95.    X       Uses XXX to write anything, including GO TO, PRINT & LIST.
  96.    Y or A  Inserts "and" into document.
  97.    Z       ZAP deletes text in document to the last "."
  98.    Ctrl E  Ends document and closes its file before the program END line.
  99.    F1-F10  Function Keys access Assigned strings, if any.
  100.  
  101.    For free technical assistance on the SKYWRITER,
  102.    call (609) 953-7205 or write
  103.  
  104.    Computer Intelligence Assets
  105.    130 Hiawatha Trail
  106.    Medford Lakes, NJ 08055 USA
  107.  
  108.    Best wishes and thanks for using the SkyWriter.
  109.