home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / editors / pcwtex.arj / PCWTEX.DOC < prev    next >
Text File  |  1990-09-20  |  4KB  |  104 lines
  1.           
  2.           
  3.  
  4.                                        PCWTEX
  5.  
  6.  
  7.  
  8.                            A simple PCWRITE to TEX filter.
  9.  
  10.  
  11.                                       Copyright
  12.                                      J.W. Breen
  13.                                         1990
  14.  
  15.  
  16.           INTRODUCTION
  17.           
  18.           PCWTEX was written to meet a need:  I use a copy of PCWRITE V2.2 
  19.           at home, as do my wife and children.  It is a good, simple, easy 
  20.           to use word processor,  and it prints quite well  on  our  Epsom 
  21.           LX800. 
  22.  
  23.           In my Department (at Monash University) we have the usual clutch 
  24.           of TEX/LATEX devotees,  and both LJ+ and Postscript printers.  I 
  25.           wanted to get access to the nice parts of  the  TEX/LATEX  world 
  26.           without   having  to  re-educate  both  my  family  and  myself. 
  27.           PCWRITE's functionality is fine;  what we  wanted  was  to  type 
  28.           Alt-I  in  a  document  and  be  able to print it in typical TEX 
  29.           style. 
  30.           
  31.           Hence PCWTEX. It is bit crude but it does most of the hard work. 
  32.           I usually do a bit of fiddling by hand afterwards. 
  33.           
  34.           HOW TO RUN IT 
  35.           
  36.           Have  the  the PCWTEX.EXE and the three control files in the one 
  37.           sub-directory, probably the PCWRITE directory. Initiate with 
  38.           
  39.           pcwtex   (and it will prompt for an input file)
  40.           
  41.           or
  42.           
  43.           pcwtex filespec                                
  44.           
  45.           The output is produced in filspec.tex.
  46.                       
  47.           WHAT IT DOES 
  48.           
  49.           PCWTEX is a filter.  It reads through a PCWRITE source  document 
  50.           and  makes  appropriate  substitutions  for the embedded PCWRITE 
  51.           control characters. In summary, it: 
  52.           
  53.           (a) copies a file "pcwtex.hdr" on the front of the output file; 
  54.           
  55.           (b) copies a file "pcwtex.ftr" on the back of the output file; 
  56.           
  57.              (samples of the files I use are included.)
  58.           
  59.           (c) scans for the occurrence of the special characters LATEX  is 
  60.           senstive to, and inserts a "\" before them.  This includes $, %, 
  61.           #, etc.  It does NOT prepend for \,  { or } as I wanted to leave 
  62.           native LATEX commands untouched. 
  63.           
  64.           (d) changes alternating " to either `` or ''; 
  65.           
  66.           (e)  scans  for  PCWRITE  special  characters,  and makes either 
  67.           one-at-a-time substitutions, e.g. for hard space and soft hyphen 
  68.           characters,  or paired substitutions,  e.g.  for  bold,  italic, 
  69.           underline, etc. 
  70.           
  71.                 e.g. text becomes {\it text}
  72.                      hard·space becomes hard~space
  73.  
  74.           The  special  character substitution is based on a control file, 
  75.           "pcwtex.ctl"  which  you  can  modify  to  suit   your   PCWRITE 
  76.           conventions. As distributed, it suits V2.2. 
  77.           
  78.           SHORTCOMINGS
  79.           
  80.           PCWTEX only operates within the  one  sub-directory.  I  do  not 
  81.           search the whole path for files. 
  82.           
  83.           Multiple  PCWRITE control characters will probably upset it.  If 
  84.           you use these, fix the ".tex" output by hand. 
  85.                                             
  86.           It cant cope with tabs or PCWRITE's centre technique. PCWRITE is 
  87.           a WYSIWYG, so I can't do much about this. 
  88.           
  89.  
  90.           TECHNICAL
  91.           
  92.           PCWTEX is written in C and compiled under TurboC V2.0.
  93.  
  94.  
  95.           Jim Breen
  96.           jwb@monu6.cc.monash.edu.au
  97.           Department of Robotics & Digital Technology
  98.           Monash University
  99.           PO BOX 197
  100.           Caulfield East, Victoria 3145 Australia
  101.  
  102.  
  103.  
  104.