#include <stdio.h>

void rps_print_man () {
	puts ("");
	puts ("");
	puts ("");
	puts ("L2P(1)              CAO-VLSI Reference Manual              L2P(1)");
	puts ("");
	puts ("");
	puts ("NNAAMMEE");
	puts ("       l2p    -  Creates a PostScript file from a symbolic layout");
	puts ("              file,or from a physical layout file.");
	puts ("");
	puts ("SSYYNNOOPPSSIISS");
	puts ("       ll22pp    [--ccoolloorr] [--ddrraawwiinnggssiizzee==<<ww>>xx<<hh>>]  [--ffAA33]  [--ffLLEETTTTEERR]");
	puts ("              [--ffLLEEGGAALL]  [--ggiivveebbwwddiicctt]  [--ggiivveeccoolloorrddiicctt]  [--hheellpp]");
	puts ("              [--nnoohheeaaddeerr]            [--ppaappeerrssiizzee==<<xx>>xx<<yy>>xx<<ww>>xx<<hh>>]");
	puts ("              [--ppaaggeess==<<xx>>xx<<yy>>]  [--ttssiizzee==<<ss>>]  [--nnrrnnaammee] [--nnccnnaammee]");
	puts ("              [--nnrrffnnaammee]  [--nniinnaammee]  [--nnssnnaammee]  [--mmffeeeedd]  [--rreeaall]");
	puts ("              [--rreessooll==<<xx>>]    [--rrffllaatttteennccaattaall]   [--rrffllaatttteennttrraannss]");
	puts ("              [--rroottaattee] [--ssccaallee==<<ff..ff>>] [--uusseeddiicctt==<<ff>>] _c_e_l_l_n_a_m_e");
	puts ("");
	puts ("DDEESSCCRRIIPPTTIIOONN");
	puts ("       Two main kind of cells can be used as inputs for l2p :");
	puts ("       First, you can use l2p to  print  symbolic  layout  cells.");
	puts ("       File formats can be .ap or .cp . This is given by an envi-");
	puts ("       ronment variable MMBBKK__IINN__PPHH that gives the appropriate sym-");
	puts ("       bolic layout file format.");
	puts ("       Second,  you  can use l2p to print real layout cells whose");
	puts ("       file formats can be .cif or .gds .  This is  given  by  an");
	puts ("       environment  variable  RRDDSS__IINN  that  gives the appropriate");
	puts ("       real layout file format.");
	puts ("       The path to the input file is set up  by  two  environment");
	puts ("       variables:    MMBBKK__WWOORRKK__LLIIBB(3)    and    if    not    found");
	puts ("       MMBBKK__CCAATTAA__LLIIBB(3).  The output of _l_2_p is a  PPoossttSSccrriipptt  file");
	puts ("       in  the  current directory. The drawing size and the paper");
	puts ("       size can be specified by the user. So, you can split  your");
	puts ("       drawing in as many pages as wanted. The resulting file can");
	puts ("       be then used on any adequat PPoossttccrriipptt printer.");
	puts ("       l2p will generate in the current directory, either a  sin-");
	puts ("       gle  file  called _<_c_e_l_l_n_a_m_e_>_._p_s, either several files suf-");
	puts ("       fixed by _-_<_x_>_x_<_y_>_._p_s, depending on wether you've asked for");
	puts ("       a  monopage plot or for a drawing that will be splitted on");
	puts ("       several pages.  If you do something  like  _l_2_p  _-_p_a_g_e_s_=_2_x_1");
	puts ("       _c_e_l_l,  it  will generate two files called _c_e_l_l_-_1_x_1_._p_s, and");
	puts ("       _c_e_l_l_-_2_x_1_._p_s.");
	puts ("");
	puts ("OOPPTTIIOONNSS");
	puts ("       With no options, l2p generate a 'standard file', with  all");
	puts ("       options off.  This is ok for leaf cells, but not for large");
	puts ("       circuits.");
	puts ("");
	puts ("       -color generates a color  PostScript  file  for  use  with");
	puts ("              color  interpreters.   The  default  value  gives a");
	puts ("              black and white PPoossttCCrriipptt file.");
	puts ("");
	puts ("       -drawingsize=<width>x<height>");
	puts ("              specifies the drawing area in centh  of  inch.   By");
	puts ("              default, wide = 725 and height = 1068 for french A4");
	puts ("              paper. If the drawing size is bigger than the paper");
	puts ("              area,  then the drawing will be splitted on several");
	puts ("              pages.");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("ASIM/LIP6                October 1, 1997                        1");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("L2P(1)              CAO-VLSI Reference Manual              L2P(1)");
	puts ("");
	puts ("");
	puts ("       -fA3   The drawing is done on A3 format paper.");
	puts ("");
	puts ("       -fLETTER");
	puts ("              The drawing is done on LETTER format paper.");
	puts ("");
	puts ("       -fLEGAL");
	puts ("              The drawing is done on LEGAL format paper.");
	puts ("");
	puts ("       -givebwdict");
	puts ("              give the Black & White internal PostScript diction-");
	puts ("              nary.  See below.");
	puts ("");
	puts ("       -givecolordict");
	puts ("              This  option  must be unique on the  command  line.");
	puts ("              When used  as  in   'l2p   -givebwdict',  l2p  then");
	puts ("              gives  on  the  standard  output  its Black & White");
	puts ("              internal   Postscript  dictionnary.   A  PostScript");
	puts ("              dictionnary  is a set of mac- ros that will be used");
	puts ("              during  interpretation  of  your  PostScript  file.");
	puts ("              The macros in the internal PostScript dictionnaries");
	puts ("              of l2p allows you to control which  layer to   out-");
	puts ("              put,   how   to   plot  rectangles, and specify the");
	puts ("              colors of the rectangles. You get the standard dic-");
	puts ("              tion- nary  by  a  line  of  the  form  'l2p -give-");
	puts ("              colordict > dict.ps'. You  can  then  edit  it,  in");
	puts ("              order  to  reuse  it  with  l2p, see the '-usedict'");
	puts ("              option below.");
	puts ("");
	puts ("       -help  gives you this man page that explains  how  to  use");
	puts ("              l2p.");
	puts ("");
	puts ("       -noheader");
	puts ("              prevents  the border and various info, as the cell-");
	puts ("              name and the position of the page in  the  drawing,");
	puts ("              from being printed.");
	puts ("");
	puts ("       -papersize=<x_low_left>x<y_low_left>x<width>x<height>");
	puts ("              specifies  the  paper  area  in  centh  of inch. By");
	puts ("              default, 50x50x726x1069 for a4 paper.");
	puts ("");
	puts ("       -pages=<number_of_x_pages>x<number_of_y_pages>");
	puts ("              specifies the drawing area in pages. It can be use-");
	puts ("              ful,  instead  of  having  to calculate the size in");
	puts ("              cenths of inch of the drawing, to give it  in  num-");
	puts ("              bers of pages. It takes care of the resizing of the");
	puts ("              paper and whether there is a header.");
	puts ("");
	puts ("       -tsize=<s>");
	puts ("              Available sizes:6,8,10,12,14.The default  value  is");
	puts ("              8.");
	puts ("");
	puts ("       -nrname");
	puts ("              No name at all will be displayed.");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("ASIM/LIP6                October 1, 1997                        2");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("L2P(1)              CAO-VLSI Reference Manual              L2P(1)");
	puts ("");
	puts ("");
	puts ("       -ncname");
	puts ("              The  external connector's names won't be displayed.");
	puts ("");
	puts ("       -nrfname");
	puts ("              The references's names won't be displayed.");
	puts ("");
	puts ("       -niname");
	puts ("              The instances's names won't be displayed.");
	puts ("");
	puts ("       -nsname");
	puts ("              The segments's names won't be displayed.");
	puts ("");
	puts ("       -mfeed Manualfeed:if set,informs the printer that it  will");
	puts ("              be fed by the user himself,for each printing .");
	puts ("");
	puts ("       -real  uses  real  file  (cif, gds). By default, uses sym-");
	puts ("              bolic layout file (ap, cp).");
	puts ("");
	puts ("       -resol=<x>");
	puts ("              is the resolution of the  file  in  dots  per  inch");
	puts ("              (dpi).  This value has been introducted to limitate");
	puts ("              the size of the generated  PostScript  files.  Each");
	puts ("              rectangle  whose  width and height are smaller than");
	puts ("              the resolution will not  be  printed.  The  default");
	puts ("              value  is  72dpi.  It should only be changed in one");
	puts ("              specifical case : when you want to produce  a  plot");
	puts ("              of several meter large. Usually, you must provide a");
	puts ("              PostScript file sized for A4 paper with a much bet-");
	puts ("              ter  resolution  than  72dpi. You can then increase");
	puts ("              that value to up to 1000dpi, but be aware that  the");
	puts ("              size  of  the  file  will probably be bigger than a");
	puts ("              44Mb SyQuest cartridge that  is  used  in  PAO  for");
	puts ("              exchanging data files.");
	puts ("");
	puts ("       -rflattencatal");
	puts ("              flattens   the  cell  to  the  catalog  level.  see");
	puts ("              catal(5) for more details on the use of the catalog");
	puts ("              file.  Be  careful,  this  option requires a lot of");
	puts ("              memory...");
	puts ("");
	puts ("       -rflattentrans");
	puts ("              flattens the cell to the  transistor  level  before");
	puts ("              printing.  Be  careful,  this option requires a lot");
	puts ("              more memory...");
	puts ("");
	puts ("       -rotate");
	puts ("              rotate the cell from 90 degree. This is  useful  if");
	puts ("              you  have  a  wide  cell,  and  you want to have it");
	puts ("              printed in landscape mode.");
	puts ("");
	puts ("       -scale=<f.f>");
	puts ("              forces the cell to be printed with a certain  scale");
	puts ("              (a  floating-point  number).   This is very useful,");
	puts ("              when you are printing a whole library of cells, and");
	puts ("");
	puts ("");
	puts ("");
	puts ("ASIM/LIP6                October 1, 1997                        3");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("L2P(1)              CAO-VLSI Reference Manual              L2P(1)");
	puts ("");
	puts ("");
	puts ("              you want all cells to be printed to the same scale.");
	puts ("              You can find at which scale a cell was  printed  by");
	puts ("              looking  at  the  beginning  of  the  file  : 'head");
	puts ("              n1_y-1x1.ps' will show  you  a  PostScript  comment");
	puts ("              beginning by '%SCALE=3.78435' for example.");
	puts ("");
	puts ("       -usedict=<filename>");
	puts ("              The output Postcript file contains a Postcript dic-");
	puts ("              tionnary of macros.");
	puts ("              There are two standard dictionnaries  used  by  l2p");
	puts ("              for  black  and white or color prints.  This allows");
	puts ("              you to use a PostScript dictionnary different  from");
	puts ("              the  two  internally encoded into l2p. By modifying");
	puts ("              one of the standard l2p dictionnary, you can choose");
	puts ("              which  layer  to output, how to fill the rectangles");
	puts ("              (empty, hashed, filled), which color to choose, ...");
	puts ("              and  lots  of  other possibilities. The rest of the");
	puts ("              generated postscript file is mainly orders of draw-");
	puts ("              ing  rectangles.  PostScript  is  a  reverse polish");
	puts ("              notation langage, that is easy to read  for  simple");
	puts ("              programs.");
	puts ("              If you use this functionnality, and think that your");
	puts ("              dictionnaries are worth it,  please  mail  them  to");
	puts ("              alliance-users@asim.lip6.fr,  in  order to submit");
	puts ("              them  for  inclusion  in  future  version  of   l2p");
	puts ("              (Thanks).");
	puts ("");
	puts ("");
	puts ("EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS::");
	puts ("       for symbolic file(s) :");
	puts ("              sseetteennvv MMBBKK__IINN__PPHH aapp");
	puts ("              sseetteennvv MMBBKK__WWOORRKK__LLIIBB ..");
	puts ("              sseetteennvv MMBBKK__CCAATTAA__LLIIBB //llaabboo//cceellllss//ssccrr");
	puts ("              sseetteennvv MMBBKK__CCAATTAALL__NNAAMMEE CCAATTAALL");
	puts ("              sseetteennvv RRDDSS__TTEECCHHNNOO__NNAAMMEE ccmmooss__11..rrddss");
	puts ("");
	puts ("       for real file(s) :");
	puts ("              sseetteennvv RRDDSS__IINN cciiff");
	puts ("              sseetteennvv MMBBKK__CCAATTAALL__NNAAMMEE CCAATTAALL__RROOUUTT");
	puts ("              sseetteennvv RRDDSS__TTEECCHHNNOO__NNAAMMEE pprrooll1122__11..rrddss");
	puts ("");
	puts ("");
	puts ("EEXXAAMMPPLLEESS::");
	puts ("       _l_2_p _-_c_o_l_o_r _n_1___y");
	puts ("              will  create  a colored nn11__yy..ppss file in the current");
	puts ("              directory : the 'standard' way.");
	puts ("");
	puts ("       _l_2_p _-_r_e_a_l _c_e_l_l");
	puts ("              will create a cceellll..ppss file in the current directory");
	puts ("              from  cell.cif or cell.gds, depending on the RDS_IN");
	puts ("              environment variable.");
	puts ("");
	puts ("       _l_2_p _-_p_a_g_e_s_=_3_x_2 _n_a_2___y");
	puts ("              size of the created  drawing:3  horizontal  pages,2");
	puts ("");
	puts ("");
	puts ("");
	puts ("ASIM/LIP6                October 1, 1997                        4");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("L2P(1)              CAO-VLSI Reference Manual              L2P(1)");
	puts ("");
	puts ("");
	puts ("              vertical ones;");
	puts ("");
	puts ("");
	puts ("");
	puts ("       SSEEEE AALLSSOO");
	puts ("              mmbbkk((11)),,   rrddss((11)),,   MMBBKK__IINN__PPHH((33)),,  MMBBKK__CCAATTAA__LLIIBB((33)),,");
	puts ("              MMBBKK__WWOORRKK__LLIIBB((33)),,                 MMBBKK__CCAATTAALL__NNAAMMEE((33)),,");
	puts ("              RRDDSS__TTEECCHHNNOO__NNAAMMEE((33)),,       ppaaggeevviieeww((11)),,       ggss((11)),,");
	puts ("              gghhoossttvviieeww((11)),, llpprr((11))..");
	puts ("");
	puts ("");
	puts ("DDIIAAGGNNOOSSTTIICCSS");
	puts ("       You will not be able to generate more than  approximativly");
	puts ("       30  pages  at  the  same time (because of the FOPEN_MAX of");
	puts ("       your environment). In this case, see the  option  that  is");
	puts ("       not implemented yet.");
	puts ("       The  generated  PPoossttSSccrriipptt  is  Level  1  for black& white");
	puts ("       plots.  When you use color,  it  generates  Level  1  with");
	puts ("       color  extensions.   It  may  not  run with strict Level 1");
	puts ("       interpreters, although it runs here with our Apple Person-");
	puts ("       nal  LaserWriter, Sun Sparcprinters, and Canon CLC-300-PS.");
	puts ("       It follows the Adobe Document Structuring  Conventions  1,");
	puts ("       and  as there is a fake bitmap image inside each generated");
	puts ("       files, you can re-use them  in  your  word-processors,  or");
	puts ("       publishing  software,  because  the PostScript is EPSF-1.2");
	puts ("       compliant.");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("");
	puts ("ASIM/LIP6                October 1, 1997                        5");
	puts ("");
	puts ("");
}
