From 70e18513dd8f06e4901edf42b1db665c0525098e Mon Sep 17 00:00:00 2001 From: Bill Joy Date: Wed, 18 Apr 1979 21:00:36 -0800 Subject: [PATCH] BSD 2 development Work on file man/gets.u Work on file man/pcc.u Work on file man/print.u Work on file man/pix.u Work on file man/pxp.u Work on file man/pxref.u Work on file man/whereis.u Synthesized-from: 2bsd --- man/gets.u | 24 ++++++++ man/pcc.u | 31 ++++++++++ man/pix.u | 55 +++++++++++++++++ man/print.u | 17 +++++ man/pxp.u | 167 ++++++++++++++++++++++++++++++++++++++++++++++++++ man/pxref.u | 29 +++++++++ man/whereis.u | 82 +++++++++++++++++++++++++ 7 files changed, 405 insertions(+) create mode 100644 man/gets.u create mode 100644 man/pcc.u create mode 100644 man/pix.u create mode 100644 man/print.u create mode 100644 man/pxp.u create mode 100644 man/pxref.u create mode 100644 man/whereis.u diff --git a/man/gets.u b/man/gets.u new file mode 100644 index 0000000000..e5439e37a7 --- /dev/null +++ b/man/gets.u @@ -0,0 +1,24 @@ +.TH GETS UCB 2/24/79 UCB +.SH NAME +gets \- get a string from standard input +.SH SYNOPSIS +.B gets +[ default ] +.SH DESCRIPTION +.I Gets +can be used with +.IR csh (UCB) +to read a string from the standard input. +If a +.I default +is given it is used if an error occurs. +The resultant string (either the default or as read from the standard +input is written to the standard output. +If no +.I default +is given and an error occurs, +.I gets +exits with exit status 1. +.SH "SEE ALSO" +csh (UCB) +.SH BUGS diff --git a/man/pcc.u b/man/pcc.u new file mode 100644 index 0000000000..42aef164ee --- /dev/null +++ b/man/pcc.u @@ -0,0 +1,31 @@ +.TH PCC UCB 4/8/79 UCB +.SH NAME +pcc \- interpret Pascal carriage control +.SH SYNOPSIS +.B pcc +[ name ... ] +.SH DESCRIPTION +.I Pcc +is a filter which interprets Pascal carriage control. +The first character of each line to +.I pcc +should be one of the +following carriage control characters, +indicating the action to be taken before printing: +.PP +.nf +.ta 1iC 2i + blank single space + 0 double space + 1 top of form + + no space +.fi +.PP +If the initial character is not a valid control, it is treated as if +it were a blank. +.SH SEE\ ALSO +Berkeley Pascal User's Manual +.br +pi(UCB), px(UCB) +.SH AUTHOR +William Joy diff --git a/man/pix.u b/man/pix.u new file mode 100644 index 0000000000..bf9d23b453 --- /dev/null +++ b/man/pix.u @@ -0,0 +1,55 @@ +.TH PIX UCB 4/8/79 UCB +.SH NAME +pix \- Pascal interpreter and executor +.SH SYNOPSIS +.B pix +[ +.B \-blnpstuwz +] [ +.B \-i +name ... +] +name.p +[ +argument ... +] +.SH DESCRIPTION +.I Pix +is a `load and go' version of Pascal which combines +the functions of the interpreter code translator +.I pi +and the executor +.IR px . +It uses +.I pi +to translate the program in the file +.I name.p +and, if there were no fatal errors during translation, +causes the resulting interpreter code +to be executed by +.I px +with the specified arguments. +A temporary file is used for the object code; +the file +.I obj +is neither created nor destroyed. +.SH FILES +.DT +/usr/bin/pi Pascal translator +.br +/usr/bin/px Pascal executor +.br +/tmp/pix????? temporary +.br +/usr/lib/how_pix basic explanation +.SH SEE\ ALSO +Berkeley Pascal User's Manual +.br +pi(UCB), px(UCB) +.SH DIAGNOSTICS +For a basic explanation do +.PP +.DT +.B pix +.SH AUTHORS +Susan L. Graham and William N. Joy diff --git a/man/print.u b/man/print.u new file mode 100644 index 0000000000..09457654f0 --- /dev/null +++ b/man/print.u @@ -0,0 +1,17 @@ +.TH PRINT UCB 2/24/79 UCB +.SH NAME +print \- pr to the line printer +.SH SYNOPSIS +.B print +file ... +.SH DESCRIPTION +.I Print +.I pr's +a copy of each named file on the line printer. +It is a one line shell script: +.PP +.DT + pr $* | lpr +.SH SEE\ ALSO +lpr(UCB), pr(1) +.SH BUGS diff --git a/man/pxp.u b/man/pxp.u new file mode 100644 index 0000000000..a27b308656 --- /dev/null +++ b/man/pxp.u @@ -0,0 +1,167 @@ +.TH PXP UCB 4/8/79 UCB +.SH NAME +pxp \- Pascal execution profiler +.SH SYNOPSIS +.B pxp +[ +.B \-acdefjnstuw_ +] [ +.B \-23456789 +] [ +.B \-z +[ name ... ] ] name.p +.SH DESCRIPTION +.I Pxp +can be used to obtain execution profiles of Pascal programs or +as a pretty-printer. +To produce an execution profile all that is necessary is to translate +the program specifying the +.B z +option to +.I pi +or +.I pix, +to execute the program, +and to then issue the command +.DT +.PP + \fBpxp \-z\fR name.p +.PP +A reformatted listing is output if none of the +.BR c , +.BR t , +or +.B z +options are specified; +thus +.PP + \fBpxp\fR old.p > new.p +.PP +places a pretty-printed version of the program in `old.p' in the file `new.p'. +.PP +The use of the following options of +.I pxp +is discussed in sections 2.6, 5.4, 5.5 and 5.10 of the +.IR "Berkeley Pascal User's Manual" "." +.TP 6 +.B \-a +Print the bodies of all procedures and functions in the profile; +even those which were never executed. +.TP 6 +.B \-c +Extract profile data from the file +.IR core . +.TP 6 +.B \-d +Include declaration parts in a profile. +.TP 6 +.B \-e +Eliminate +.B include +directives when reformatting a file; +the +.B include +is replaced by the reformatted contents of the specified +file. +.TP 6 +.B \-f +Fully parenthesize expressions. +.TP 6 +.B \-j +Left justify all procedures and functions. +.TP 6 +.B \-n +Eject a new page +as each file is included; +in profiles, print a blank line at the top of the page. +.TP 6 +.B \-s +Strip comments from the input text. +.TP 6 +.B \-t +Print a table summarizing +.B procedure +and +.B function +call counts. +.TP 6 +.B \-u +Card image mode; only the first 72 characters of input lines +are used. +.TP 6 +.B \-w +Suppress warning diagnostics. +.TP 6 +.B \-z +Generate an execution profile. +If no +.IR name \|s, +are given the profile is of the entire program. +If a list of names is given, then only any specified +.BR procedure s +or +.BR function s +and the contents of any specified +.B include +files will appear in the profile. +.TP 6 +.B \-\_ +Underline keywords. +.TP 6 +.BI \- d +With +.I d +a digit, 2 \(<= +.IR d "" +\(<= 9, +causes +.I pxp +to use +.IR d "" +spaces as the basic indenting unit. +The default is 4. +.SH FILES +.DT +name.p input file +.br +name.i include file(s) +.br +pmon.out profile data +.br +core profile data source with +.B \-c +.br +/usr/lib/how_pxp information on basic usage +.br +.ne 8 +.SH "SEE ALSO" +Berkeley Pascal User's Manual +.br +pi(UCB), +px(UCB) +.ne 5 +.SH DIAGNOSTICS +For a basic explanation do +.IP +.DT +.B pxp +.PP +Error diagnostics include +`No profile data in file' +with the +.B c +option if the +.B z +option was not enabled to +.I pi; +`Not a Pascal system core file' +if the core is not from a +.I px +execution; +`Program and count data do not correspond' +if the program was changed after compilation, before profiling; +or if the wrong program is specified. +.SH AUTHOR +William N. Joy +.SH BUGS +Does not place multiple statements per line. diff --git a/man/pxref.u b/man/pxref.u new file mode 100644 index 0000000000..a8f1af55bc --- /dev/null +++ b/man/pxref.u @@ -0,0 +1,29 @@ +.TH PXREF UCB 4/8/79 UCB +.SH NAME +pxref \- Pascal cross-reference program +.SH SYNOPSIS +.B pxref +[ +.BR \- "" +] +name +.SH DESCRIPTION +.I Pxref +makes a line numbered listing and a cross-reference of identifier usage +for the program in +.I name. +The optional `\fB\-\fR' argument suppresses the listing. +The keywords +.B goto +and +.B label +are treated as identifiers for the purpose of the cross-reference. +.B Include +directives are not processed, but cause the placement of an entry +indexed by `#include' in the cross-reference. +.SH "SEE ALSO" +Berkeley Pascal User's Manual +.SH AUTHOR +Niklaus Wirth +.SH BUGS +Identifiers are trimmed to 10 characters. diff --git a/man/whereis.u b/man/whereis.u new file mode 100644 index 0000000000..10965ee407 --- /dev/null +++ b/man/whereis.u @@ -0,0 +1,82 @@ +.TH WHEREIS UCB 2/24/79 UCB +.SH NAME +whereis \- locate source/binary/manual for program +.SH SYNOPSIS +.B whereis +[ +.B \-sbmu +] [ +.B \-SBM +dir ... [ -f ] +] +name ... +.SH DESCRIPTION +.I Whereis +locates source/binary and manuals sections for specified files. +The supplied names are first stripped of leading pathname components +and any (single) trailing extension of the form `.ext', e.g. `.c'. +Prefixes of `s.' resulting from use of source code control are also +dealt with. +.I Whereis +then attempts to locate the desired program in a list of standard places. +If any of the +.B \-b, +.B \-s +or +.B \-m +flags are given then +.I whereis +searches only for binaries, sources or manual sections +(or any two thereof). +.sp +The +.B \-u +flag may be used to search for unusual entries. +A file is said to be unusual if it does not have one entry of +each requested type. +Thus `whereis -m -u *' asks for those files in the current +directory which have no documentation. +.sp +Finally, the +.B \-B +.B \-M +and +.B \-S +flags may be used to change the places where +.I whereis +searches to the specified directories only. +The +.B \-f +file flags may be used to terminate the last such directory list +and signal the start of file names. +.SH EXAMPLE +The following finds all the files in /usr/ucb which are not documented +in /usr/man/mann with source in /usr/ucb/src/ucb: +.sp +.ti +5 +cd /usr/ucb +.ti +5 +whereis -u -M /usr/man/mann -S /usr/ucb/src/ucb -f * +.SH FILES +/usr/src/* +.br +/usr/ucb/src/* +.br +/usr/man/* +.br +/bin, /etc, /usr/{bin,ucb} +.SH AUTHOR +Bill Joy +.SH DIAGNOSTICS +None. +.SH BUGS +This program makes it too easy to find out what needs to be done. +.sp +Since the program uses +.IR chdir (1) +to run faster, pathnames given with the +.B \-M +.B \-S +and +.B \-B +flags should start at the root or they will not work. -- 2.20.1