gnu/dist/grep/src/ansi2knr.1

   1 .\"     $NetBSD$
   2 .\"
   3 .TH ANSI2KNR 1 "19 Jan 1996"
   4 .SH NAME
   5 ansi2knr \- convert ANSI C to Kernighan & Ritchie C
   6 .SH SYNOPSIS
   7 .I ansi2knr
   8 [--varargs] input_file [output_file]
   9 .SH DESCRIPTION
  10 If no output_file is supplied, output goes to stdout.
  11 .br
  12 There are no error messages.
  13 .sp
  14 .I ansi2knr
  15 recognizes function definitions by seeing a non-keyword identifier at the left
  16 margin, followed by a left parenthesis, with a right parenthesis as the last
  17 character on the line, and with a left brace as the first token on the
  18 following line (ignoring possible intervening comments).  It will recognize a
  19 multi-line header provided that no intervening line ends with a left or right
  20 brace or a semicolon.  These algorithms ignore whitespace and comments, except
  21 that the function name must be the first thing on the line.
  22 .sp
  23 The following constructs will confuse it:
  24 .br
  25      - Any other construct that starts at the left margin and follows the
  26 above syntax (such as a macro or function call).
  27 .br
  28      - Some macros that tinker with the syntax of the function header.
  29 .sp
  30 The --varargs switch is obsolete, and is recognized only for
  31 backwards compatibility.  The present version of
  32 .I ansi2knr
  33 will always attempt to convert a ... argument to va_alist and va_dcl.
  34 .SH AUTHOR
  35 L. Peter Deutsch <ghost@aladdin.com> wrote the original ansi2knr and
  36 continues to maintain the current version; most of the code in the current
  37 version is his work.  ansi2knr also includes contributions by Francois
  38 Pinard <pinard@iro.umontreal.ca> and Jim Avera <jima@netcom.com>.