BSD 4_3_Net_2 release
[unix-history] / usr / src / contrib / isode / pepy / pepy.1
.TH PEPY 1 "17 May 1987"
.\" $Header: /f/osi/pepy/RCS/pepy.1,v 7.1 91/02/22 09:34:57 mrose Interim $
.\"
.\"
.\" $Log: pepy.1,v $
.\" Revision 7.1 91/02/22 09:34:57 mrose
.\" Interim 6.8
.\"
.\" Revision 7.0 89/11/23 22:11:44 mrose
.\" Release 6.0
.\"
.SH NAME
pepy \- PE parser (yacc\-based)
.SH SYNOPSIS
.in +.5i
.ti -.5i
.B pepy
\%[\-A]
\%[\-a\0advise]
\%[\-b\0prefix]
\%[\-d]
\%[\-h]
\%[\-o\0module.c]
\%[\-P]
\%[\-p]
\%[\-r]
\%[\-s]
\%[\-S\0section]
\fImodule.py\fR
.in -.5i
.sp
\fIcc\fR\0...\0\fImodule.c\fR\0\fB\-lisode\fR
.SH DESCRIPTION
The \fIpepy\fR program reads a description of a \fIpresentation\fR module
and produces \fIC\fR routines to recognize and/or build the corresponding
objects.
.PP
The `\-a' switch sets the name of the \*(lqadvise\*(rq routine.
.PP
The `\-b' switch generates a separate file for each generated routine,
using the supplied prefix.
.PP
The `\-d' switch directs \fIpepy\fR to ignore most \fIpepy\fR\-style
augmentations.
.PP
The `\-h' switch enables additional heuristics when \fIpepy\fR generates a
printer.
.PP
The `\-o' switch sets the name of the output file,
which is normally derived from the name of the input file.
The distinguished file \*(lq\-\*(rq can be used to force the use of the
standard output.
.PP
The `\-P' switch directs \fIpepy\fR not to include \fIcpp\fR-type line
number information in the output.
This is useful for debugging \fIpepy\fR (gasp!).
.PP
The `\-p' switch directs \fIpepy\fR to remove the action statements from the
description,
and print the resulting information on the standard output;
This typically results in a file suitable for pretty\-printing.
.PP
The `\-r' switch directs \fIpepy\fR to produce \*(lqrobust\*(rq code.
This tells \fIpepy\fR not to generate code to check for unknown or extraneous
objects.
This is used for extensibility purposes.
.PP
Normally, \fIpepy\fR prints the name of each type as it works.
The `\-s' switch disables this behavior.
.PP
The `\-S' switch sets the initial section\-processing mode for \fIpepy\fR.
The default is `\-S\0DECODE' which causes \fIpepy\fR to generate a decoder.
Other values are `\-S\0ENCODE' to generate an encoder;
or, `\-S\0PRINT' to generate a printer.
.PP
The `\-A' switch says that \fIpepy\fR should process all three modes.
.SH FILES
.nf
.ta \w'\fImodule\fR.ph 'u
\fImodule\fR.ph external type definitions from \fImodule\fR
.re
.fi
.SH "SEE ALSO"
psap(3n),
.br
\fIThe ISO Development Environment: User's Manual\fR,
.br
ISO 8824:
\fIInformation Processing \-\- Open Systems
Interconnection \-\- Specification of Abstract Syntax Notation One (ASN.1)\fR,
.br
CCITT Recommendation X.409:
\fIMessage Handling Systems:
Presentation Transfer Syntax and Notation\fR
.SH AUTHORS
Julian P. Onions
Nottingham University
.br
Stephen M. Easterbrook,
University College London
.br
Marshall T. Rose
.SH BUGS
This information is skeletal,
consult the \fIUser's Manual\fR for the full details.