[wxWidgets.git] / src / png / ansi2knr.1

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