home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / printer / pcroff.arc / README < prev    next >
Text File  |  1988-08-28  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                              _RRR_EEE_AAA_DDD_MMM_EEE _FFF_III_LLL_EEE _FFF_OOO_RRR _PPP_CCC_RRR_OOO_FFF_FFF
  7.  
  8.  
  9.        _P_C_r_o_f_f  is  an  adaptation  of  a public-domain implementation of
  10.        _r_o_f_f, for the PC and its  clones.  _R_o_f_f  is  the  predecessor  to
  11.        nroff,  the  text  formatter  used  with  the  UNIX(tm) operating
  12.        system.  It  is  less  capable  than  nroff  in  its   formatting
  13.        capabilities,  but in return it is faster and smaller. It is fast
  14.        and small enough to be I/O-limited in performance on a  PC;  it's
  15.        unlikely  that  would  be  true of nroff. In this case, it's also
  16.        free.
  17.  
  18.        Apart from  the  smaller  instruction  set  (see  the  manual  in
  19.        PCroff.doc), its major limitations with respect to nroff are:
  20.  
  21.           - Macros  cannot  take parameters. Among other consequences of
  22.             this property is the fact that  the  "mm"  macros  can't  be
  23.             ported to roff. Sorry!
  24.  
  25.           - There are no user-settable number registers or strings.
  26.  
  27.        Any  fancier  features of nroff are also absent. What's left is a
  28.        nice little (and certainly very useful) text formatter.
  29.  
  30.        _P_C_r_o_f_f is roff,  ported  to  the  IBM  PC  and  look-alikes,  and
  31.        enhanced  just  enough  to  use  the  printer's  font control. In
  32.        addition to roff's _u_n_d_e_r_l_i_n_i_n_g (._u_l), PCroff supports bbbooolllddd  (((...bbbooo)))
  33.        and  _i_t_a_l_i_c  _(_._i_t_)_.  It  can  use  them  _ii_i_nn_n _cc_c_oo_o_mm_m_bb_b_ii_i_nn_n_aa_a_tt_t_ii_i_oo_o_nn_n,,_, too. For
  34.        previewing your document, the fonts are  displayable  on  the  PC
  35.        screen;  underline  and  bold  are screen attributes already, and
  36.        italic is represented by blinking.
  37.  
  38.        The most common ways to call PCroff are:
  39.  
  40.           - To format a file and preview it on the display, call
  41.  
  42.                 pcroff -d filename
  43.  
  44.           - To format a file and print it, call
  45.  
  46.                pcroff filename > PRN
  47.  
  48.           - If your printer does not  use  control  sequences  for  font
  49.             control  (or  if it isn't in the PRINTCAP file and you can't
  50.             add it), it may be able to do fonts by backspace-overstrike.
  51.             If so, call
  52.  
  53.                pcroff -t filename > PRN
  54.  
  55.             (Note  that  such  printers  are incapable of italics, which
  56.             will come out underlined.)
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.        PCroff                                                    8-28-88
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                      - 2 -
  70.  
  71.  
  72.                                 _C_o_n_t_e_n_t_s _o_f _D_i_s_k
  73.  
  74.        1. PCROFF.EXE - the executable code.
  75.  
  76.        2. README - the introductory file you're reading now.
  77.  
  78.        3. README.SRC - the PCroff source that  created  READ.ME,  as  an
  79.           example of roff input.
  80.  
  81.        4. PCROFF.DOC - the manual for PCroff, as a roff source file. Try
  82.           displaying and printing it.
  83.  
  84.        5. PRINTCAP - a file of printer specifications. If  your  printer
  85.           isn't  an  Epson or compatible, change the name of the default
  86.           printer in PRINTCAP, and add its font-control specification if
  87.           necessary.  (The  instructions  for making a PRINTCAP file are
  88.           part of PCROFF.DOC.) Note that PCroff must be able to find the
  89.           PRINTCAP file to use printer-specific font control.
  90.  
  91.        6. SOURCE.ARC  -  the  C  source  files.  It  contains  some code
  92.           (clearly marked) that is  specific  to  DeSmet  C.  I  haven't
  93.           bothered porting it to Turbo C, which is what I use now.
  94.  
  95.  
  96.  
  97.        My  thanks  to  the  pioneers who went before me, whose code I've
  98.        adapted here. The names I know are Col. G. L. Sicherman  and  Tim
  99.        Maroney, but there may well be others.
  100.  
  101.        Good  luck,  and let me know how you do. By all means, report any
  102.        bugs that bite you.
  103.  
  104.                                Dave Tutelman
  105.                                16 Tilton Drive
  106.                                Wayside, NJ 07712
  107.  
  108.  
  109.                                (201) 922 - 9576
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.        PCroff                                                    8-28-88
  130.  
  131.  
  132.  
  133.