diff options
author | grr <grr@cvs.openbsd.org> | 1997-07-01 07:22:05 +0000 |
---|---|---|
committer | grr <grr@cvs.openbsd.org> | 1997-07-01 07:22:05 +0000 |
commit | ff382109a56e8c8217c50d652f6ef78a4e5b7155 (patch) | |
tree | e866e0ff8ca20fe8b7d0e4d0fcb3d42a078476bc /usr.bin/compile_et | |
parent | fd60a1550cb511e97d093e860e053f67d5739597 (diff) |
Updated (troff macros) manpage from FreeBSD-current. No other source
changes, our's actually looks newer/cleaner...
Diffstat (limited to 'usr.bin/compile_et')
-rw-r--r-- | usr.bin/compile_et/compile_et.1 | 74 |
1 files changed, 37 insertions, 37 deletions
diff --git a/usr.bin/compile_et/compile_et.1 b/usr.bin/compile_et/compile_et.1 index 323dae7fb1d..b03b1d86e92 100644 --- a/usr.bin/compile_et/compile_et.1 +++ b/usr.bin/compile_et/compile_et.1 @@ -1,79 +1,79 @@ .\" Copyright (c) 1988 Massachusetts Institute of Technology, .\" Student Information Processing Board. All rights reserved. .\" -.\" $OpenBSD: compile_et.1,v 1.2 1996/11/11 05:45:45 downsj Exp $ +.\" $OpenBSD: compile_et.1,v 1.3 1997/07/01 07:22:04 grr Exp $ +.\" $Header: /cvs/OpenBSD/src/usr.bin/compile_et/compile_et.1,v 1.3 1997/07/01 07:22:04 grr Exp $ .\" -.TH COMPILE_ET 1 "22 Nov 1988" SIPB -.SH NAME -compile_et \- error table compiler -.SH SYNOPSIS -.B compile_et -file -.SH DESCRIPTION -.B Compile_et +.Dd November 22, 1988 +.Os +.Dt COMPILE_ET 1 +.Sh NAME +.Nm compile_et +.Nd error table compiler +.Sh SYNOPSIS +.Nm compile_et +.Ar file +.Sh DESCRIPTION +.Nm Compile_et converts a table listing error-code names and associated messages into a C source file suitable for use with the -.IR com_err (3) +.Xr com_err 3 library. - +.Pp The source file name must end with a suffix of ``.et''; the file consists of a declaration supplying the name (up to four characters long) of the error-code table: -.B error_table -.I name +.Em error_table name followed by up to 256 entries of the form: -.B error_code -.I name, +.Em error_code name , " -.I string +.Em string " and a final -.B end +.Em end to indicate the end of the table. - +.Pp The name of the table is used to construct the name of a subroutine -.I initialize_XXXX_error_table +.Em initialize_XXXX_error_table which must be called in order for the -.I com_err +.Xr com_err 3 library to recognize the error table. - +.Pp The various error codes defined are assigned sequentially increasing numbers (starting with a large number computed as a hash function of the name of the table); thus for compatibility it is suggested that new codes be added only to the end of an existing table, and that no codes be removed from tables. - +.Pp The names defined in the table are placed into a C header file with preprocessor directives defining them as integer constants of up to 32 bits in magnitude. - +.Pp A C source file is also generated which should be compiled and linked with the object files which reference these error codes; it contains the text of the messages and the initialization subroutine. Both C files have names derived from that of the original source file, with the ``.et'' suffix replaced by ``.c'' and ``.h''. - +.Pp A ``#'' in the source file is treated as a comment character, and all remaining text to the end of the source line will be ignored. - -.SH BUGS - +.Sh BUGS Since -.B compile_et +.Nm compile_et uses a very simple parser based on -.IR yacc (1), +.Xr yacc 1 , its error recovery leaves much to be desired. - -.\" .IR for manual entries -.\" .PP for paragraph breaks - -.SH "SEE ALSO" -com_err (3). - -Ken Raeburn, "A Common Error Description Library for UNIX". +.Sh "SEE ALSO" +.Xr yacc 1 , +.Xr com_err 3 +.Pp +.Rs +.%A Ken Raeburn +.%T "A Common Error Description Library for UNIX" +.Re |