home *** CD-ROM | disk | FTP | other *** search
/ Dream 48 / Amiga_Dream_48.iso / Atari / c / cpp.zoo / cpp.man < prev    next >
Text File  |  1993-06-03  |  9KB  |  265 lines
  1.  
  2.  
  3. CPP (1)                       30 May 1993                        CPP (1)
  4.  
  5.  
  6.  
  7.  
  8. pNAMEq pq pq pq pq pq pq pq pq 
  9.         cpp - a stand-alone C preprocessor 
  10.  
  11. pSYNOPSISq pq pq pq pq pq pq pq pq 
  12.         pcppq [ p-CTVq ] [ p-Pq[012]pqpq ] [ p-Dqnamepqpq ] 
  13.              [ p-Dqnamep=qdefpq ] [ p-Iqdirectorypqpq ] [ p-Uqnamepqpq ] 
  14.              [ p-ansiq ] [ p-fq[no-]pc++-commentsqpq ] [ p-Wq[no-]pbad-charsqpq ] 
  15.              [ p-Wq[no-]pnested-commentsqpq ] [ pinput-fileq [ poutput-fileq ] ] 
  16.  
  17. pDESCRIPTIONq pq pq pq pq pq pq pq pq 
  18.  
  19.         pcppq  is  a  stand-alone  C preprocessor, intended for use with C
  20.         compilers  such  as  HSC  which  do  not  provided   access   to
  21.         preprocessor output.    It  implements as closely as possible an
  22.         ANSI standard C preprocessor, including trigraphs, token pasting 
  23.         and stringizing.  
  24.  
  25.         pcppq optionally accepts two filenames as arguments.    pinput-fileq
  26.         and  poutput-fileq  are,  respectively, the input and output files
  27.         for the preprocessor.  If not specified, or  if  given  as  `-',
  28.         they  default  to  the  standard  input and the standard output,
  29.         respectively.  
  30.  
  31. pOPTIONSq pq pq pq pq pq pq pq pq 
  32.  
  33.         p-Cq  
  34.                 Pass all comments (except those  that  appear  on    pcppq
  35.                 directive lines)  through the preprocessor.  By default,
  36.                 pcppq strips out C-style comments.  
  37.  
  38.         p-Pq[012]  
  39.                 Preprocess the input without producing the line  control
  40.                 information used  by the next pass of the C compiler.  A
  41.                 numeric argument can be passed to -P: 0  specifies  that
  42.                 no line control information control is generated, and is 
  43.                 equivalent  to  -P; 1 specifies that normal line control
  44.                 information is generated, which is the  default;  and  2
  45.                 specifies  that line control information is generated in
  46.                 the form of preprocessor  p#lineq directives.  
  47.  
  48.         p-Tq  
  49.                 Translate trigraphs in the input file.  This behavior is 
  50.                 implied by the p-ansiq option.  
  51.  
  52.         p-Dq name  
  53.                 Define pnameq as 1 (one).   This  is  the  same  as  if  a
  54.                 p-Dqnamep=1qpq option appeared on the  pcppq command line, or as 
  55.                 if a 
  56.  
  57.          
  58.                 p#defineq name p1qpq 
  59.  
  60.          
  61.  
  62.  
  63.  
  64. Thu Jun 3 18:58:15 1993                                           Page 1
  65.  
  66.  
  67.  
  68.  
  69. CPP (1)                       30 May 1993                        CPP (1)
  70.  
  71.  
  72.  
  73.                 line   appeared   in  the  source  file  that    pcppq  is
  74.                 processing.  
  75.  
  76.         p-Dqnamep=qdef  
  77.                 Define pnameq as if by a p#defineq directive.  This  is  the
  78.                 same as if a 
  79.  
  80.          
  81.                 p#defineq name pdefqpq 
  82.  
  83.          
  84.                 line   appeared   in  the  source  file  that    pcppq  is
  85.                 processing.  The p-Dq option has lower precedence than the 
  86.                 p-Uq option; that is, if the same name is used in  both  a
  87.                 p-Uq  option  and  a p-Dq option, the name will be undefined
  88.                 regardless of the order of the options.  
  89.  
  90.         p-Iqdirectory  
  91.                 Insert  pdirectoryq into  the  search  path  for  p#includeq
  92.                 files with names not beginning with q`p/q', `p\q║,pq or a drive 
  93.                 specifier.   pdirectoryq is inserted ahead of the standard
  94.                 list of ``include'' directories.  Thus,  p#includeq  files
  95.                 with  names  enclosed  in double-quotes (p"q) are searched
  96.                 for first in the directory of the file with the p#includeq 
  97.                 line, then in directories named  with  p-Iq  options,  and
  98.                 lastly, in  directories  from  the  standard  list.  For
  99.                 p#includeq files with  names  enclosed  in  angle-brackets
  100.                 q(p<>q),pqpq  the  directory of the file with the p#includeq line
  101.                 is not searched.  See pUSAGEq below for exact  details  of
  102.                 this search order.  
  103.  
  104.         p-Uqname  
  105.                 Remove  any  initial definition of pnameq,pqpq where pnameq is a
  106.                 symbol that is predefined by the preprocessor.  
  107.  
  108.         p-Vq  
  109.                 Print version information to pstderrq.pqpq 
  110.  
  111.         p-ansiq  
  112.                 Define the preprocessor token p__STDC__q to have value  1,
  113.                 and enable   trigraph  translation.    To  get  p__STDC__q
  114.                 without  trigraph  translation,  you  can  specify   the
  115.                 options p-ansiq p-Tq.pqpq 
  116.  
  117.         The  following  p-fq and p-Wq options can be negated by adding a pno-q
  118.         before the option name.  Some are on by default.  
  119.  
  120.         p-fc++-commentsq  
  121.                 Support the C++ comment indicator q`p//q║.pqpq With this option 
  122.                 active, everything on the line after the p//q  is  treated
  123.                 as a comment.  Off by default.  
  124.  
  125.         p-Wbad-charsq  
  126.                 Issue  a  warning  if  a  character  that cannot legally
  127.  
  128.  
  129.  
  130. Thu Jun 3 18:58:15 1993                                           Page 2
  131.  
  132.  
  133.  
  134.  
  135. CPP (1)                       30 May 1993                        CPP (1)
  136.  
  137.  
  138.  
  139.                 appear in a C program appears  in  the  input.    On  by
  140.                 default.  
  141.  
  142.         p-Wnested-commentsq  
  143.                 Issue  a  warning  if a comment-start character sequence
  144.                 q(`p/*q║,pqpq and q`p//q║pqpq if p-fc++-commentsq is active) appears  in
  145.                 a comment.  Off by default.  
  146.  
  147. pUSAGEq pq pq pq pq pq pq pq pq 
  148.         If  you  are  familiar with C, you should already know about the
  149.         basic  workings  of  pcppq.pqpq  We  will  not  go  into  a   detailed
  150.         description  here,  since  any  good  book on C could do better;
  151.         instead,  we  will   describe   details   particular   to   this
  152.         implementation.  
  153.  
  154.         ppDirectory Search Orderqq pq pq pq pq pq pq pq pq 
  155.  
  156.  
  157.         A  file  specified in an p#includeq directive will be searched for
  158.         in the following directories, in order: 
  159.  
  160.         1.  
  161.                 The directory of the file that contains  the    p#includeq
  162.                 directive,  if  the  directive  is of the form `p#includeq
  163.                 "filename"'.  
  164.  
  165.         2.  
  166.                 The directories specified by p-Iq options,  in  the  order
  167.                 they were specified.  
  168.  
  169.         3.  
  170.                 The   list  of  directories  specified  in  the  pINCLUDEq
  171.                 environment variable, in order.  
  172.  
  173.         ppSpecial Namesqq pq pq pq pq pq pq pq pq 
  174.  
  175.  
  176.         The following macros are predefined by pcppq:pqpq 
  177.  
  178.         p__STDC__q  
  179.                 Expands to 1 if the p-ansiq option is specified.  
  180.  
  181.         p__LINE__q  
  182.                 Expands to an integer constant representing the  current
  183.                 line number in the current input file.  
  184.  
  185.         p__FILE__q  
  186.                 Expands  to  a  string constant representing the name of
  187.                 the current input file.  
  188.  
  189.         p__DATE__q  
  190.                 Expands to a string constant of the form "Mmm  dd  yyyy"
  191.                 representing   the   date  on  which  preprocessing  was
  192.                 initiated.  
  193.  
  194.  
  195.  
  196. Thu Jun 3 18:58:15 1993                                           Page 3
  197.  
  198.  
  199.  
  200.  
  201. CPP (1)                       30 May 1993                        CPP (1)
  202.  
  203.  
  204.  
  205.         p__TIME__q  
  206.                 Expands to a string  constant  of  the  form  "hh:mm:ss"
  207.                 representing  the system time at which preprocessing was
  208.                 initiated.  
  209.  
  210.         p__INCLUDE_LEVEL__q  
  211.                 Expands to an integer constant representing the  current
  212.                 depth of nested p#includeq files.  
  213.  
  214. pSEEq pALSOq pq pq pq pq pq pq pq 
  215.         Documentation for your C compiler 
  216.  
  217.         Any good book on C.  
  218.  
  219. pDIAGNOSTICSq pq pq pq pq pq pq pq pq 
  220.  
  221.         The   error   messages  produced  by  pcppq  are  intended  to  be
  222.         self-explanatory.  The line number and filename where the  error
  223.         occurred are printed along with the diagnostic.  
  224.  
  225. pBUGSq pq pq pq pq pq pq pq pq 
  226.         None that I know of, but there's almost always One More Bug(TM). 
  227.         If you should find one, please report it to me, Scott Bigham, at 
  228.         dsb@cs.duke.edu.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262. Thu Jun 3 18:58:15 1993                                           Page 4
  263.  
  264.  
  265.