home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / misc / document / textform.txt < prev    next >
Text File  |  1992-11-05  |  9KB  |  480 lines
  1.  
  2.  
  3.  
  4.  
  5.                 XXXXXX
  6.  
  7.                  X    X
  8.  
  9.                  X    X    XXXX    XXXX
  10.  
  11.                  X    X   X    X  X
  12.  
  13.                  X    X   X    X  X
  14.  
  15.                 XXXXXX     XXXX    XXXX
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.    DOC is a Documentation preparation system similar
  26.  
  27.    to the ROFF text formatter.
  28.  
  29.  
  30.  
  31.  
  32.  
  33.    DOC was designed by Roy A. Leban and Ken Jordan.
  34.  
  35.  
  36.  
  37.    DOC was written June, 1982 by Roy A. Leban.
  38.  
  39.    Last changed September 10, 1984 by Roy A. Leban.
  40.  
  41.  
  42.  
  43.  
  44.  
  45.    (C) Copyright 1984 by SoftPlus, Inc.
  46.  
  47.  
  48.  
  49.    The DOC command line is as follows:
  50.  
  51.  
  52.  
  53.         DOC input_file[.doc] [output_file[.prn]]
  54.  
  55.  
  56.  
  57.    If no input file is given on the command line, DOC prompts
  58.  
  59.    for the input and output files.
  60.  
  61.  
  62.  
  63.  
  64.  
  65.    In the input file, DOC accepts the following requests:
  66.  
  67.  
  68.  
  69.    Function        Request     Argument    Default     Break
  70.  
  71.  
  72.  
  73.    Begin Page        .bp        pageno        +1       Yes
  74.  
  75.    Boldface          .bf         pair       none        No
  76.  
  77.    Break             .br                                Yes
  78.  
  79.    Command Char      .cc         char        "."        No
  80.  
  81.    Center            .ce       numlines        1        Yes
  82.  
  83.    Chapter           .ch      X Y name                  Yes
  84.  
  85.    Even Footer       .ef      [#] title     none        No
  86.  
  87.    Even Header       .eh      [#] title     none        No
  88.  
  89.    Fill              .fi        Yes/No       Yes        Yes
  90.  
  91.    Footer            .fo      [#] title     none        No
  92.  
  93.    Header            .he      [#] title     none        No
  94.  
  95.    Indentation       .in       numchars        0        Yes
  96.  
  97.    Ignore Chars      .ig        ccc...      none        No
  98.  
  99.    Italics           .it         pair       none        No
  100.  
  101.    Justify           .ju        Yes/No       Yes        Yes
  102.  
  103.    Linelength        .ll       numchars       60        No
  104.  
  105.    Margin 1          .m1       numlines        4        No
  106.  
  107.    Margin 2          .m2       numlines        2        No
  108.  
  109.    Margin 3          .m3       numlines        2        No
  110.  
  111.    Margin 4          .m4       numlines        4        No
  112.  
  113.    Need              .ne       numlines        0        Maybe
  114.  
  115.    No Fill           .nf                                Yes
  116.  
  117.    No Justify        .nj                                Yes
  118.  
  119.    Odd Footer        .of      [#] title     none        No
  120.  
  121.    Odd Header        .oh      [#] title     none        No
  122.  
  123.    Print Footers     .pf        Yes/No                  No
  124.  
  125.    Print Headers     .ph        Yes/No                  No
  126.  
  127.    Pagelength        .pl       numlines       66        No
  128.  
  129.    Page Offset       .po       numchars       10        No
  130.  
  131.    Sub-Section       .sb         name                   Yes
  132.  
  133.    Section           .se         name                   Yes
  134.  
  135.    Source include    .so       filename                 No
  136.  
  137.    Space             .sp       numlines        1        Yes
  138.  
  139.    Style             .st         xyz         bu-        No
  140.  
  141.    Tab Setting       .ta       numchars        8        No
  142.  
  143.    Tab Char          .tc         char       none        No
  144.  
  145.    Temp Indent       .ti       numchars        0        Yes
  146.  
  147.    Translate         .tr       ioio...                  No
  148.  
  149.    Underline blanks  .ub        Yes/No       No         No
  150.  
  151.    Underline         .ul         pair       none        No
  152.  
  153.  
  154.  
  155.    In addition, the following special requests are accepted
  156.  
  157.    to allow customization of Doc for individual printers.
  158.  
  159.  
  160.  
  161.    Function        Request     Argument    Default     Break
  162.  
  163.  
  164.  
  165.    Boldface On       .b+       sequence   overprint     No
  166.  
  167.    Boldface Off      .b-       sequence   overprint     No
  168.  
  169.    Escape Char       .ec         char       none        No
  170.  
  171.    Escape Sequence   .es   char [sequence]              No
  172.  
  173.    Italics On        .i+       sequence    use "_"      No
  174.  
  175.    Italics Off       .i-       sequence    use "_"      No
  176.  
  177.    Print Literal     .pr       sequence                 No
  178.  
  179.    Print on Quit     .qt       sequence                 No
  180.  
  181.    Underline On      .u+       sequence    use "_"      No
  182.  
  183.    Underline Off     .u-       sequence    use "_"      No
  184.  
  185.  
  186.  
  187.    Argument Specifications:
  188.  
  189.  
  190.  
  191.    # :                  The header or footer number being specified (1-9).
  192.  
  193.                                 If omitted, 1 is assumed.
  194.  
  195.  
  196.  
  197.    ccc... :             A list of characters.
  198.  
  199.  
  200.  
  201.    char :               Any single character.
  202.  
  203.  
  204.  
  205.    ioio... :    A list of character pairs.  If an odd number
  206.  
  207.                                 of characters is given, then the last character
  208.  
  209.                                 is paired with a space.
  210.  
  211.  
  212.  
  213.    filename :   Standard filename.  If the drive or suffix
  214.  
  215.                                 is omitted, then the drive or suffix of the
  216.  
  217.                                 original file is used.
  218.  
  219.  
  220.  
  221.    name :               The name of a chapter, section or subsection.
  222.  
  223.  
  224.  
  225.    numchars :   A number of characters.
  226.  
  227.  
  228.  
  229.    numlines :   A number of lines.
  230.  
  231.  
  232.  
  233.    pageno :             A new page number.
  234.  
  235.  
  236.  
  237.    pair :               Any single character (used as toggle), or
  238.  
  239.                                 a pair of characters (start and stop).
  240.  
  241.                                 Omission disables feature.
  242.  
  243.  
  244.  
  245.    sequence :   A sequence of numbers and strings.  Numbers
  246.  
  247.                                 are translated into ASCII characters; strings
  248.  
  249.                                 are taken as is.  (27 "X" 1) is "<ESC>X^A".
  250.  
  251.  
  252.  
  253.    title :              [See below]
  254.  
  255.  
  256.  
  257.    X :                  The number of the chapter when used in the
  258.  
  259.                                 chapter heading (sometimes spelled out or in
  260.  
  261.                                 Roman numerals).
  262.  
  263.  
  264.  
  265.    Y :                  The number of the chapter when used in section
  266.  
  267.                                 and subsection headings.
  268.  
  269.  
  270.  
  271.    xyz :                Three style parameters for chapter, section
  272.  
  273.                                 and subsection headings respectively.  The
  274.  
  275.                                 parameter may be "b" for boldface, "i" for
  276.  
  277.                                 italics, "u" for underlined, or "-" for normal.
  278.  
  279.                                 ("bui" means boldface chapter headings,
  280.  
  281.                                 underline section headings, and italicize
  282.  
  283.                                 subsection headings).
  284.  
  285.  
  286.  
  287.    Yes/No :             "Y" or "N".  Omission is treated as Yes.
  288.  
  289.  
  290.  
  291.    If any argument is omitted, then the default is used.
  292.  
  293.  
  294.  
  295.  
  296.  
  297.    The Margins are as follows:
  298.  
  299.  
  300.  
  301.     Margin 1    Before Headers
  302.  
  303.     Margin 2    Headers (extra lines after headers left blank)
  304.  
  305.     Margin 3    Footers (extra lines before footers left blank)
  306.  
  307.     Margin 4    After Footer
  308.  
  309.  
  310.  
  311.    A title (header or footer) has the following format:
  312.  
  313.  
  314.  
  315.        'left'center'right'
  316.  
  317.  
  318.  
  319.    where the single quote represents any non-blank delimiter,
  320.  
  321.    "left" is a string to be left-justified on the output line,
  322.  
  323.    "center" is a string to be centered on the output line, and
  324.  
  325.    "right" is a string to be right-justified on the output line.
  326.  
  327.    A '%' appearing in any of these strings will be replaced with
  328.  
  329.    the current page number on output. '%%' will become '%'.
  330.  
  331.  
  332.  
  333.    The # in header/footer requests indicates which header/footer
  334.  
  335.    line is to be set.  Header 1 is at the top of Margin 2; footer 1
  336.  
  337.    is at the bottom of Margin 3.
  338.  
  339.  
  340.  
  341.    Note the following commands are equivalent:
  342.  
  343.  
  344.  
  345.     .fi No      .nf
  346.  
  347.     .ju No      .nj
  348.  
  349.  
  350. -p -page cpr=1984
  351.  
  352. h="Doc Text Formatter" c="SoftPlus, Inc."
  353.  
  354. b="Doc"
  355.  
  356. doc.pas
  357.  
  358. docio.pas
  359.  
  360. docget.pas
  361.  
  362. docput.pas
  363.  
  364. docproc.pas
  365.  
  366. doccmd.pas
  367.  
  368. .
  369.  
  370. . Printer definitions for Okidata Microline 92 Graphics Characters
  371.  
  372. .
  373.  
  374. . This printer definition file is designed to be used
  375.  
  376. . with the file MICRO92.DOC.  It defines some Down-loadable
  377.  
  378. . characters for special symbols and graphics characters.
  379.  
  380. .
  381.  
  382. han
  383. .
  384.  
  385. . Printer definitions for Okidata Microline 92
  386.  
  387. .
  388.  
  389. . This printer definition file is set up so that
  390.  
  391. . the tear edge of the paper always stays lined up
  392.  
  393. . at the tear bar.
  394.  
  395. .
  396.  
  397. . Initialization: (Skip 61 lines)
  398.  
  399. .pr 24
  400.  
  401. .pr 27 11 "61"
  402.  
  403. . Make printer handle page offset (1" = 10 PICA Chars)
  404.  
  405. .pr 27 "%C120"
  406.  
  407. .po 0
  408.  
  409. . Boldfacing is Correspondence Mode
  410.  
  411. .b+ 27 "1"
  412.  
  413. .b- 27 "0"
  414.  
  415. . Italics Enhanced Printing
  416.  
  417. .i+ 27 "H"
  418.  
  419. .i- 27 "I"
  420.  
  421. . Underlining
  422.  
  423. .u+ 27 "C"
  424.  
  425. .u- 27 "D"
  426.  
  427. . Special Features:
  428.  
  429. .
  430.  
  431. .       \U = Shift up 1/2 line
  432.  
  433. .       \D = Shift down 1/2 line
  434.  
  435. .       \( = Switch to Down-loadable character set (for use outside of Boldfacing)
  436.  
  437. .       \) = Switch to Normal set
  438.  
  439. .       \< = Switch to Down-loadable character set (for use within Boldfacing)
  440.  
  441. .       \> = Switch to Boldface set
  442.  
  443. .       \P = Switch to 10 CPI (Pica)
  444.  
  445. .       \E = Switch to 12 CPI (Elite)
  446.  
  447. .       \C = Switch to 17 CPI (Condensed)
  448.  
  449. .
  450.  
  451. . Note that Doc does not know about character widths.
  452.  
  453. .
  454.  
  455. .es U 27 "J"
  456.  
  457. .es D 27 "L"
  458.  
  459. .es ( 27 "2"
  460.  
  461. .es ) 27 "0"
  462.  
  463. .es < 27 "2"
  464.  
  465. .es > 27 "1"
  466.  
  467. .es P 30
  468.  
  469. .es E 28
  470.  
  471. .es C 29
  472.  
  473. . Quit: Form feed, Reset
  474.  
  475. .qt 12 24 27 "%C001"
  476.  
  477. rinter definition file is set up so that
  478.  
  479. . the tear edge of the p
  480.