converted man page

author Cynthia A. E. Livingston <cael@ucbvax.Berkeley.EDU>

Mon, 25 Jun 1990 10:08:55 +0000 (02:08 -0800)

committer Cynthia A. E. Livingston <cael@ucbvax.Berkeley.EDU>

Mon, 25 Jun 1990 10:08:55 +0000 (02:08 -0800)
author Cynthia A. E. Livingston <cael@ucbvax.Berkeley.EDU>
Mon, 25 Jun 1990 10:08:55 +0000 (02:08 -0800)
committer Cynthia A. E. Livingston <cael@ucbvax.Berkeley.EDU>
Mon, 25 Jun 1990 10:08:55 +0000 (02:08 -0800)
diff --git a/usr/src/bin/hostname/hostname.1 b/usr/src/bin/hostname/hostname.1

index 9cb4b92..a20d447 100644 (file)
--- a/usr/src/bin/hostname/hostname.1
+++ b/usr/src/bin/hostname/hostname.1
@@ -1,21 +1,36 @@
-.\" Copyright (c) 1983, 1988 Regents of the University of California.
+.\" Copyright (c) 1983, 1988, 1990 The Regents of the University of California.
  .\" All rights reserved.
  .\"
  .\" %sccs.include.redist.man%
  .\"
  .\" All rights reserved.
  .\"
  .\" %sccs.include.redist.man%
  .\"
-.\"    @(#)hostname.1  6.4 (Berkeley) %G%
+.\"     @(#)hostname.1 6.5 (Berkeley) %G%
  .\"
  .\"
-.TH HOSTNAME 1 ""
-.UC 5
-.SH NAME
-\fBhostname\fP \- set or print name of current host system
-.SH SYNOPSIS
-\fBhostname\fP [-s] [nameofhost]
-.SH DESCRIPTION
-\fIHostname\fP prints the name of the current host.  The super-user can
+.Dd 
+.Dt HOSTNAME 1
+.Os BSD 4.2
+.Sh NAME
+.Nm hostname
+.Nd set or print name of current host system
+.Sh SYNOPSIS
+.Nm hostname
+.Op Fl s
+.Op Ar nameofhost
+.Sh DESCRIPTION
+.Nm Hostname
+prints the name of the current host.  The super-user can
  set the hostname by supplying an argument; this is usually done in the
  set the hostname by supplying an argument; this is usually done in the
-network initialization script \fI/etc/netstart\fP, normally run at boot
-time.  The \fI-s\fP option trims any domain information from the printed
+network initialization script
+.Pa /etc/netstart ,
+normally run at boot
+time.
+.Pp
+Options:
+.Tp Fl s
+Trims off any domain information from the printed
  name.
  name.
-.SH SEE ALSO
-gethostname(2), sethostname(2)
+.Tp
+.Sh SEE ALSO
+.Xr gethostname 2 ,
+.Sh HISTORY
+.Nm Hostname
+appeared in 4.2 BSD.
diff --git a/usr/src/bin/kill/kill.1 b/usr/src/bin/kill/kill.1

index 908a12d..23b7f1a 100644 (file)
--- a/usr/src/bin/kill/kill.1
+++ b/usr/src/bin/kill/kill.1
@@ -1,70 +1,84 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
+.\" All rights reserved.
  .\"
  .\"
-.\"    @(#)kill.1      6.2 (Berkeley) %G%
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.TH KILL 1 ""
-.UC 4
-.SH NAME
-kill \- terminate a process with extreme prejudice
-.SH SYNOPSIS
-.B kill
-[
-.BR \- sig
-]
-processid ...
-.br
-.B kill
-.B \-l
-.SH DESCRIPTION
-.I Kill
-sends the TERM (terminate, 15) signal to the specified processes.
-If a signal name or number preceded by `\-' is given
-as first argument, that signal is sent instead of
-terminate
-(see
-.IR  sigvec (2)).
-The signal names are listed by
-`kill \-l', and are as given in
-.I /usr/include/signal.h,
+.\"     @(#)kill.1     6.3 (Berkeley) %G%
+.\"
+.Dd 
+.Dt KILL 1
+.Os BSD 4.4
+.Sh NAME
+.Nm kill
+.Nd terminate or signal a process
+.Sh SYNOPSIS
+.Nm kill
+.Op Fl signal_name
+.Ar pid
+\&...
+.Nm kill
+.Op Fl l
+.Sh DESCRIPTION
+The kill utility sends a signal to the process(es) specified
+by each pid operand. It is used to kill runaway or misbegotten
+processes, such as those
+.Em backgrounded
+with
+.Sq Li \&& .
+.Nm Kill
+is intelligent about who owns a process.
+.Tw Ds
+.Tp Fl signal_name
+A symbolic signal name. To find out all the possible signal names
+do a
+.Li kill -l .
+.Tp Fl l
+Available signal names are listed and are as found in
+.Pa /usr/include/signal.h ,
  stripped of the common SIG prefix.
  stripped of the common SIG prefix.
-.PP
-The terminate signal will kill processes that do not catch the signal;
-`kill \-9 ...' is a sure kill, as the KILL (9) signal cannot be caught.
-By convention, if process number 0 is specified, all members
-in the process group (i.e. processes resulting from 
-the current login) are signaled (but beware: this works only
-if you use
-.IR sh (1);
-not if you use
-.IR csh (1).)
-Negative process numbers also have special meanings; see
-.IR kill (2)
-for details.
-.PP
-The killed processes must belong
-to the current user unless
-he is the super-user.
-.PP
-The process number of an asynchronous process
-started with `&' is reported by the shell.
-Process numbers can also be found by using
-.IR ps (1).
-.I Kill
+.Tp Fl signal_number
+A (nonnegative) decimal integer, representing the signal
+to be used instead of TERM as the sig argument in
+the effective call to
+.Nm kill 1 .
+.Tp
+.Pp
+Some of the more commonly used signals with kill:
+.Ds I
+.Cw XXX TERM
+.Cl -1 -1      (broadcast to all processes, super user only)
+.Cl 0  0       (sh(1) only, signals all members of process group)
+.Cl 2  INT     (interupt)
+.Cl 3  QUIT    (quit)
+.Cl 6  ABRT    (abort)
+.Cl 9  KILL    (non-catchable non-ignorable kill)
+.Cl 14 ALRM    (alarm clock)
+.Cl 15 TERM    (software termination signal)
+.Cw
+.De
+.Pp
+.Nm Kill
  is a built-in to
  is a built-in to
-.IR csh (1);
+.Xr csh  1  ;
  it allows job specifiers of the form ``%...'' as arguments
  so process id's are not as often used as
  it allows job specifiers of the form ``%...'' as arguments
  so process id's are not as often used as
-.I kill
+.Nm kill
  arguments.
  See
  arguments.
  See
-.IR csh (1)
+.Xr csh  1
  for details.
  for details.
-.SH "SEE ALSO"
-csh(1), ps(1), kill(2), sigvec(2)
-.SH BUGS
-A replacement for ``kill 0''
+.Sh SEE ALSO
+.Xr csh 1 ,
+.Xr ps 1 ,
+.Xr kill 2 ,
+.Xr sigvec 2
+.Sh HISTORY
+A
+.Nm kill
+command appeared in Version 6 AT&T Unix.
+.Sh BUGS
+A replacement for
+.Dq Li kill 0
  for
  for
-.IR csh (1)
+.Xr csh  1
  users should be provided.
  users should be provided.
diff --git a/usr/src/bin/ln/ln.1 b/usr/src/bin/ln/ln.1

index 2dd245d..f72641b 100644 (file)
--- a/usr/src/bin/ln/ln.1
+++ b/usr/src/bin/ln/ln.1
@@ -1,81 +1,95 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
+.\" All rights reserved.
  .\"
  .\"
-.\"    @(#)ln.1        6.3 (Berkeley) %G%
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.TH LN 1 ""
-.UC 4
-.SH NAME
-ln \- make links
-.SH SYNOPSIS
-.B ln
-[
-.B \-s
-]
-sourcename [ targetname ]
-.br
-.B ln
-[
-.B \-s
-]
-sourcename1 sourcename2 [ sourcename3 ... ] targetdirectory
-.SH DESCRIPTION
-A link is a directory entry referring
-to a file; the same file (together with
-its size, all its protection
-information, etc.)
-may have several links to it.
+.\"     @(#)ln.1       6.4 (Berkeley) %G%
+.\"
+.Dd 
+.Dt LN 1
+.Os BSD 4
+.Sh NAME
+.Nm ln
+.Nd make links
+.Sh SYNOPSIS
+.Nm ln
+.Op Fl s Ar source_file
+.Op  target_file
+.Nm ln
+.Op Fl s
+.Ar source_file ... target_dir
+.Sh DESCRIPTION
+The
+.Nm ln
+utility creates a new
+directory entry (a link)
+for a file which
+inherits the same modes.
+The entry behaves in most cases as if it were the
+original file.
+It is useful for keeping groups of files together
+in directories, but with out multiple copies of the same file.
  There are two kinds of links: hard links and symbolic links.
  There are two kinds of links: hard links and symbolic links.
-.PP
+.Pp
  By default
  By default
-.I ln
-makes hard links.
+.Nm ln
+makes
+.Em hard
+links.
  A hard link to a file is indistinguishable from the
  original directory entry; any changes to a
  file are effective independent of the name used
  to reference the file.  Hard links may not refer to directories
  (unless the proper incantations are supplied) and may not span
  file systems.
  A hard link to a file is indistinguishable from the
  original directory entry; any changes to a
  file are effective independent of the name used
  to reference the file.  Hard links may not refer to directories
  (unless the proper incantations are supplied) and may not span
  file systems.
-.PP
-The
-.B \-s
-option causes
-.I ln
-to create symbolic links.
+.Pp
+Options:
+.Tp Fl s
+Create symbolic links.
  A symbolic link contains the name of the file to
  which it is linked.  The referenced file is used when an
  A symbolic link contains the name of the file to
  which it is linked.  The referenced file is used when an
-.IR open (2)
+.Xr open  2
  operation is performed on the link.
  A
  operation is performed on the link.
  A
-.IR stat (2)
+.Xr stat  2
  on a symbolic link will return the linked-to file; an
  on a symbolic link will return the linked-to file; an
-.IR lstat (2)
+.Xr lstat  2
  must be done to obtain information about the link.
  The
  must be done to obtain information about the link.
  The
-.IR readlink (2)
+.Xr readlink  2
  call may be used to read the contents of a symbolic link.
  Symbolic links may span file systems and may refer to directories.
  call may be used to read the contents of a symbolic link.
  Symbolic links may span file systems and may refer to directories.
-.PP
+.Tp
+.Pp
  Given one or two arguments,
  Given one or two arguments,
-.I ln
+.Nm ln
  creates a link to an existing file
  creates a link to an existing file
-.IR sourcename .
+.Ar source_file  .
  If
  If
-.I targetname
+.Ar target_file
  is given, the link has that name;
  is given, the link has that name;
-.I targetname
+.Ar target_file
  may also be a directory in which to place the link;
  otherwise it is placed in the current directory.
  If only the directory is specified, the link will be made
  to the last component of
  may also be a directory in which to place the link;
  otherwise it is placed in the current directory.
  If only the directory is specified, the link will be made
  to the last component of
-.IR sourcename .
-.PP
+.Ar source_file  .
+.Pp
  Given more than two arguments,
  Given more than two arguments,
-.I ln
-makes links in 
-.I targetdirectory
+.Nm ln
+makes links in
+.Ar target_dir
  to all the named source files.
  The links made will have the same name as the files being linked to.
  to all the named source files.
  The links made will have the same name as the files being linked to.
-.SH "SEE ALSO"
-rm(1), cp(1), mv(1), link(2), readlink(2), stat(2), symlink(2)
+.Sh SEE ALSO
+.Xr rm 1 ,
+.Xr cp 1 ,
+.Xr mv 1 ,
+.Xr link 2 ,
+.Xr readlink 2 ,
+.Xr stat 2 ,
+.Xr symlink 2
+.Sh HISTORY
+A
+.Nm ln
+command appeared in Version 6 AT&T Unix.
diff --git a/usr/src/old/groups/groups.1 b/usr/src/old/groups/groups.1

index 862bd8e..c146f54 100644 (file)
--- a/usr/src/old/groups/groups.1
+++ b/usr/src/old/groups/groups.1
@@ -1,33 +1,44 @@
-.\" Copyright (c) 1983 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1983 1990 The Regents of the University of California.
+.\" All rights reserved.
  .\"
  .\"
-.\"    @(#)groups.1    6.1 (Berkeley) %G%
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.TH GROUPS 1 ""
-.UC 5
-.SH NAME
-groups \- show group memberships
-.SH SYNOPSIS
-.B
-groups [user]
-.SH DESCRIPTION
+.\"     @(#)groups.1   6.2 (Berkeley) %G%
+.\"
+.Dd 
+.Dt GROUPS 1
+.Os BSD 4.2
+.Sh NAME
+.Nm groups
+.Nd show group memberships
+.Sh SYNOPSIS
+.Nm groups
+.Op Ar user
+.Sh DESCRIPTION
  The
  The
-.I groups
+.Nm groups
  command shows the groups to which you or the optionally specified
  user belong.
  Each user belongs to a group specified in the password file
  command shows the groups to which you or the optionally specified
  user belong.
  Each user belongs to a group specified in the password file
-.I /etc/passwd
+.Pa /etc/passwd
  and possibly to other groups as specified in the file
  and possibly to other groups as specified in the file
-.IR /etc/group .
+.Pa /etc/group .
  If you do not own a file but belong to the group which it is owned
  by then you are granted group access to the file.
  If you do not own a file but belong to the group which it is owned
  by then you are granted group access to the file.
-.PP
+.Pp
  When a new file is created it is given
  the group of the containing directory.
  When a new file is created it is given
  the group of the containing directory.
-.SH "SEE ALSO"
-setgroups(2)
-.SH FILES
-/etc/passwd, /etc/group
-.SH BUGS
+.Sh SEE ALSO
+.Xr group 5 ,
+.Xr setgroups 2
+.Sh FILES
+.Dw /etc/passwd
+.Di L
+.Dp Pa /etc/passwd
+.Dp Pa /etc/group
+.Dp
+.Sh HISTORY
+.Nm Group
+appeared in 4.2 BSD.
+.Sh BUGS
  More groups should be allowed.
  More groups should be allowed.
diff --git a/usr/src/old/ld/ld.1 b/usr/src/old/ld/ld.1

index 09ee5ea..81bfafb 100644 (file)
--- a/usr/src/old/ld/ld.1
+++ b/usr/src/old/ld/ld.1
@@ -1,45 +1,51 @@
-.\" Copyright (c) 1980 Regents of the University of California.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
  .\" All rights reserved.  The Berkeley software License Agreement
  .\" specifies the terms and conditions for redistribution.
  .\"
  .\" All rights reserved.  The Berkeley software License Agreement
  .\" specifies the terms and conditions for redistribution.
  .\"
-.\"    @(#)ld.1        6.2 (Berkeley) %G%
+.\"     @(#)ld.1       6.3 (Berkeley) %G%
  .\"
  .\"
-.TH LD 1 ""
-.UC 4
-.SH NAME
-ld \- link editor
-.SH SYNOPSIS
-.B ld
-[ option ] ... file ...
-.SH DESCRIPTION
-.I Ld
+.Dd 
+.Dt LD 1
+.Os BSD 4
+.Sh NAME
+.Nm ld
+.Nd link editor
+.Sh SYNOPSIS
+.Nm ld
+.Op  option
+\&...
+.Ar file ...
+.Sh DESCRIPTION
+.Nm Ld
  combines several
  object programs into one, resolves external
  references, and searches libraries.
  In the simplest case several object
  combines several
  object programs into one, resolves external
  references, and searches libraries.
  In the simplest case several object
-.I files
+.Ar files
  are given, and
  are given, and
-.I ld
+.Nm ld
  combines them, producing
  an object module which can be either executed or
  become the input for a further
  combines them, producing
  an object module which can be either executed or
  become the input for a further
-.I ld
+.Nm ld
  run.
  (In the latter case, the
  run.
  (In the latter case, the
-.B \-r
+.Fl r
  option must be given
  option must be given
-to preserve the relocation bits.)\ 
+to preserve the relocation bits.)\
  The output of
  The output of
-.I ld
+.Nm ld
  is left on
  is left on
-.BR a.out .
+.Pa a.out  .
  This file is made executable
  only if no errors occurred during the load.
  This file is made executable
  only if no errors occurred during the load.
-.PP
+.Pp
  The argument routines are concatenated in the order
  specified.  The entry point of the output is the
  The argument routines are concatenated in the order
  specified.  The entry point of the output is the
-beginning of the first routine (unless the \fB\-e\fP option is specified).
-.PP
+beginning of the first routine (unless the
+.Fl e
+option is specified).
+.Pp
  If any argument is a library, it is searched exactly once
  at the point it is encountered in the argument list.
  Only those routines defining an unresolved external
  If any argument is a library, it is searched exactly once
  at the point it is encountered in the argument list.
  Only those routines defining an unresolved external
@@ -47,7 +53,7 @@ reference are loaded.
  If a routine from a library
  references another routine in the library,
  and the library has not been processed by
  If a routine from a library
  references another routine in the library,
  and the library has not been processed by
-.IR ranlib (1),
+.Xr ranlib  1  ,
  the referenced routine must appear after the
  referencing routine in the library.
  Thus the order of programs within libraries
  the referenced routine must appear after the
  referencing routine in the library.
  Thus the order of programs within libraries
@@ -55,10 +61,10 @@ may be important.
  The first member of a library
  should be a file named `\_\^\_.SYMDEF',
  which is understood to be a dictionary for the library as produced by
  The first member of a library
  should be a file named `\_\^\_.SYMDEF',
  which is understood to be a dictionary for the library as produced by
-.IR ranlib (1);
+.Xr ranlib  1  ;
  the dictionary is searched iteratively to satisfy as many references as
  possible.
  the dictionary is searched iteratively to satisfy as many references as
  possible.
-.PP
+.Pp
  The symbols `\_etext', `\_edata' and `\_end'
  (`etext', `edata' and `end' in C)
  are reserved, and if referred to,
  The symbols `\_etext', `\_edata' and `\_end'
  (`etext', `edata' and `end' in C)
  are reserved, and if referred to,
@@ -66,81 +72,77 @@ are set to the first location above the program,
  the first location above initialized data,
  and the first location above all data respectively.
  It is erroneous to define these symbols.
  the first location above initialized data,
  and the first location above all data respectively.
  It is erroneous to define these symbols.
-.PP
-.I Ld
+.Pp
+.Nm Ld
  understands several options.
  Except for
  understands several options.
  Except for
-.BR \-l ,
+.Fl l  ,
  they should appear before the file names.
  they should appear before the file names.
-.TP
-.B \-A
+.Tw Ds
+.Tp Fl A
  This option specifies incremental loading, i.e.
  linking is to be done in a manner so that the resulting object
  may be read into an already executing program.
  The next argument is the name of a file whose symbol table will be
  taken as a basis on which to define additional symbols.
  Only newly linked material will be entered into the text and
  This option specifies incremental loading, i.e.
  linking is to be done in a manner so that the resulting object
  may be read into an already executing program.
  The next argument is the name of a file whose symbol table will be
  taken as a basis on which to define additional symbols.
  Only newly linked material will be entered into the text and
-data portions of 
-.BR a.out,
+data portions of
+.Xr a.out ,
  but the new symbol table will reflect
  every symbol defined before and after the incremental load.
  This argument must appear before any other object file in the argument list.
  The
  but the new symbol table will reflect
  every symbol defined before and after the incremental load.
  This argument must appear before any other object file in the argument list.
  The
-.B \-T
+.Fl T
  option may be used as well, and will be taken to mean that the
  newly linked segment will commence at the corresponding address
  (which must be a multiple of 1024).
  The default value is the old value of _end.
  option may be used as well, and will be taken to mean that the
  newly linked segment will commence at the corresponding address
  (which must be a multiple of 1024).
  The default value is the old value of _end.
-.TP
-.B \-D
+.Tp Fl D
  Take the next argument as a hexadecimal number and pad the data segment
  with zero bytes to the indicated length.
  Take the next argument as a hexadecimal number and pad the data segment
  with zero bytes to the indicated length.
-.TP 
-.B  \-d
+.Tp Fl d
  Force definition of common storage
  even if the
  Force definition of common storage
  even if the
-.B \-r
+.Fl r
  flag is present.
  flag is present.
-.TP
-.B \-e
+.Tp Fl e
  The following argument is taken to be the
  name of the entry point of the loaded
  program; location 0 is the default.
  The following argument is taken to be the
  name of the entry point of the loaded
  program; location 0 is the default.
-.TP
-.BI \-L dir
+.Tc Fl L
+.Ar dir
+.Cx
  Add
  Add
-.I dir
+.Ar dir
  to the list of directories in which libraries are searched for.
  to the list of directories in which libraries are searched for.
-Directories specified with 
-.B \-L
+Directories specified with
+.Fl L
  are searched before the standard directories.
  are searched before the standard directories.
-.TP 
-.BI \-l x
+.Tc Fl l
+.Ar x
+.Cx
  This
  option is an abbreviation for the library name
  This
  option is an abbreviation for the library name
-.RI `lib x .a',
+.Sq Pa libx.a,
  where
  where
-.I x
+.Ar x
  is a string.
  is a string.
-.I Ld
+.Nm Ld
  searches for libraries first in any directories
  specified with
  searches for libraries first in any directories
  specified with
-.B \-L
+.Fl L
  options, then in the standard directories `/lib', `/usr/lib', and
  `/usr/local/lib'.
  A library is searched when its name is encountered,
  so the placement of a
  options, then in the standard directories `/lib', `/usr/lib', and
  `/usr/local/lib'.
  A library is searched when its name is encountered,
  so the placement of a
-.B  \-l
+.Fl l
  is significant.
  is significant.
-.TP
-.B \-M
+.Tp Fl M
  produce a primitive load map, listing the names of the files
  which will be loaded.
  produce a primitive load map, listing the names of the files
  which will be loaded.
-.TP
-.B \-N
+.Tp Fl N
  Do not make the text portion read only or sharable.  (Use "magic number" 0407.)
  Do not make the text portion read only or sharable.  (Use "magic number" 0407.)
-.TP 
-.B  \-n
+.Tp Fl n
  Arrange (by giving the output file a 0410 "magic number") that
  when the output file is executed,
  the text portion will be read-only and shared
  Arrange (by giving the output file a 0410 "magic number") that
  when the output file is executed,
  the text portion will be read-only and shared
@@ -148,75 +150,66 @@ among all users executing the file.
  This involves moving the data areas up to the first
  possible 1024 byte boundary following the
  end of the text.
  This involves moving the data areas up to the first
  possible 1024 byte boundary following the
  end of the text.
-.TP 
-.B  \-o
+.Tp Fl o
  The
  The
-.I name
+.Ar name
  argument after
  argument after
-.B \-o
+.Fl o
  is used as the name of the
  is used as the name of the
-.I ld
+.Nm ld
  output file, instead of
  output file, instead of
-.BR a.out .
-.TP 
-.B  \-r
+.Pa a.out  .
+.Tp Fl r
  Generate relocation bits in the output file
  so that it can be the subject of another
  Generate relocation bits in the output file
  so that it can be the subject of another
-.I ld
+.Nm ld
  run.
  This flag also prevents final definitions from being
  given to common symbols,
  and suppresses the `undefined symbol' diagnostics.
  run.
  This flag also prevents final definitions from being
  given to common symbols,
  and suppresses the `undefined symbol' diagnostics.
-.TP
-.B \-S
+.Tp Fl S
  `Strip' the output by removing all symbols except locals and globals.
  `Strip' the output by removing all symbols except locals and globals.
-.TP 
-.B  \-s
+.Tp Fl s
  `Strip' the output, that is, remove the symbol table
  and relocation bits to save space (but impair the
  usefulness of the debuggers).
  This information can also be removed by
  `Strip' the output, that is, remove the symbol table
  and relocation bits to save space (but impair the
  usefulness of the debuggers).
  This information can also be removed by
-.IR  strip (1).
-.TP
-.B \-T
+.Xr strip  1  .
+.Tp Fl T
  The next argument is a hexadecimal number which sets the text segment origin.
  The default origin is 0.
  The next argument is a hexadecimal number which sets the text segment origin.
  The default origin is 0.
-.TP
-.B \-t
+.Tp Fl t
  ("trace")  Print the name of each file as it is processed.
  ("trace")  Print the name of each file as it is processed.
-.TP 
-.B  \-u
+.Tp Fl u
  Take the following argument as a symbol and enter
  it as undefined in the symbol table.  This is useful
  for loading wholly from a library, since initially the symbol
  table is empty and an unresolved reference is needed
  to force the loading of the first routine.
  Take the following argument as a symbol and enter
  it as undefined in the symbol table.  This is useful
  for loading wholly from a library, since initially the symbol
  table is empty and an unresolved reference is needed
  to force the loading of the first routine.
-.TP 
-.B  \-X
+.Tp Fl X
  Save local symbols
  except for those whose names begin with `L'.
  This option is used by
  Save local symbols
  except for those whose names begin with `L'.
  This option is used by
-.IR cc (1)
+.Xr cc  1
  to discard internally-generated labels while
  retaining symbols local to routines.
  to discard internally-generated labels while
  retaining symbols local to routines.
-.TP 
-.B  \-x
+.Tp Fl x
  Do not preserve local
  (non-.globl) symbols in the output symbol table; only enter
  external symbols.
  This option saves some space in the output file.
  Do not preserve local
  (non-.globl) symbols in the output symbol table; only enter
  external symbols.
  This option saves some space in the output file.
-.TP
-\fB\-y\fIsym\fR
+.Tc Fl y
+.Ar sym
+.Cx
  Indicate each file in which
  Indicate each file in which
-.I sym
+.Ar sym
  appears, its type and whether the file defines or references it.
  Many such options may be given to trace many symbols.
  (It is usually necessary to begin
  appears, its type and whether the file defines or references it.
  Many such options may be given to trace many symbols.
  (It is usually necessary to begin
-.I sym
+.Ar sym
  with an `_', as external C, FORTRAN and Pascal variables begin
  with underscores.)
  with an `_', as external C, FORTRAN and Pascal variables begin
  with underscores.)
-.TP
-.B \-z
+.Tp Fl z
  Arrange for the process to be loaded on
  demand from the resulting executable file (413 format)
  rather than preloaded.
  Arrange for the process to be loaded on
  demand from the resulting executable file (413 format)
  rather than preloaded.
@@ -226,23 +219,31 @@ a text and data segment each of which have size a multiple of 1024 bytes
  (being padded out with nulls in the file if necessary).
  With this format the first few BSS segment symbols may actually appear
  (from the output of
  (being padded out with nulls in the file if necessary).
  With this format the first few BSS segment symbols may actually appear
  (from the output of
-.IR size (1))
+.Xr size  1  )
  to live in the data segment;
  this to avoid wasting the space resulting from data segment size roundup.
  to live in the data segment;
  this to avoid wasting the space resulting from data segment size roundup.
-.SH FILES
-.ta \w'/usr/local/lib/lib*.a\ \ 'u
-/lib/lib*.a    libraries
-.br
-/usr/lib/lib*.a        more libraries
-.br
-/usr/local/lib/lib*.a  still more libraries
-.br
-a.out  output file
-.SH "SEE ALSO"
-as(1), ar(1), cc(1), ranlib(1)
-.SH BUGS
+.Tp
+.Sh FILES
+.Dw /usr/local/lib/lib*.a
+.Di L
+.Dp Pa /usr/lib/lib*.a
+libraries
+.Dp Pa /usr/local/lib/lib*.a
+more libraries
+.Dp Pa a.out
+output file
+.Dp
+.Sh SEE ALSO
+.Xr as 1 ,
+.Xr ar 1 ,
+.Xr cc 1 ,
+.Xr ranlib 1
+.Sh HISTORY
+.Nm Ld
+appeared in Version 6 AT&T Unix.
+.Sh BUGS
  There is no way to force data to be page aligned.
  There is no way to force data to be page aligned.
-.I Ld
+.Nm Ld
  pads images which are to be demand loaded from
  the file system to the next
  page boundary to avoid a bug in the system.
  pads images which are to be demand loaded from
  the file system to the next
  page boundary to avoid a bug in the system.
diff --git a/usr/src/old/lisp/fp/fp.1 b/usr/src/old/lisp/fp/fp.1

index d3ec559..0f4d7e7 100644 (file)
--- a/usr/src/old/lisp/fp/fp.1
+++ b/usr/src/old/lisp/fp/fp.1
@@ -1,108 +1,107 @@
-.\" Copyright (c) 1983 The Regents of the University of California.
+.\" Copyright (c) 1983, 1990 The Regents of the University of California.
  .\" All rights reserved.
  .\"
  .\" All rights reserved.
  .\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.\"    @(#)fp.1        6.2 (Berkeley) %G%
+.\"     @(#)fp.1       6.3 (Berkeley) %G%
  .\"
  .\"
-.TH FP 1 ""
-.UC 5
+.Dd 
+.Dt FP 1
+.Os BSD 4.2
  .ds s 1
  .ds s 1
-.SH NAME
-fp \-  Functional Programming language compiler/interpreter
-.SH SYNOPSIS
-.B fp
-.SH DESCRIPTION
-.PP
-.I Fp
+.Sh NAME
+.Nm fp
+.Nd Functional Programming language compiler/interpreter
+.Sh SYNOPSIS
+.Nm fp
+.Sh DESCRIPTION
+.Nm Fp
  is an
  interpreter/compiler that implements the applicative language proposed
  by John Backus.  It is written in
  is an
  interpreter/compiler that implements the applicative language proposed
  by John Backus.  It is written in
-.SM
-.BR "FRANZ LISP" .
-.PP
+.Em FRANZ LISP .
+.Pp
  In a  functional programming language
  intent is expressed
  in  a mathematical style devoid of assignment statements
  and variables.
  Functions compute by value only; there are no side-effects
  since  the result of a computation depends solely on the inputs.
  In a  functional programming language
  intent is expressed
  in  a mathematical style devoid of assignment statements
  and variables.
  Functions compute by value only; there are no side-effects
  since  the result of a computation depends solely on the inputs.
-.PP
-.I Fp
-"programs" consist of
-.I functional expressions \-
-primitive and user-defined 
-.I fp
+.Pp
+.Nm Fp
+.Em programs
+consist of
+.Em functional expressions
+\-
+primitive and user-defined
+.Nm fp
  functions
  functions
-combined by 
-.I functional forms.
+combined by
+.Em functional forms .
  These forms take functional arguments
  and return functional results.
  For example, the composition
  These forms take functional arguments
  and return functional results.
  For example, the composition
-operator 
-.I '@'
+operator
+.Sq Ic @
  takes two functional arguments and returns a function
  which represents their composition.
  takes two functional arguments and returns a function
  which represents their composition.
-.PP
-There exists a single operation in 
-.I fp
+.Pp
+There exists a single operation in
+.Nm fp
  \&\-
  \&\-
-.I application.
+.Em application .
  This operation causes the system to evaluate the indicated function using
  This operation causes the system to evaluate the indicated function using
-the single argument 
+the single argument
  as input
  (all functions are monadic).
  as input
  (all functions are monadic).
-.SH GETTING STARTED
-.PP
-.I Fp
-invokes the system.  
-.I Fp
+.Sh GETTING STARTED
+.Pp
+.Nm Fp
+invokes the system.
+.Nm Fp
  compiles functions into
  compiles functions into
-.IR lisp (1)
+.Xr lisp  1
  source code;
  source code;
-.IR lisp (1)
+.Xr lisp  1
  interprets this code
  (the user may compile this code using the
  interprets this code
  (the user may compile this code using the
-liszt (\*s) compiler to gain a factor of 10 in performance).
-.I Control D
+.Xr liszt 1
+compiler to gain a factor of 10 in performance).
+.Ic Control D
  exits back to the shell.
  exits back to the shell.
-.I Break
+.Ic Break
  terminates any computation in progress  and resets any open file units.
  terminates any computation in progress  and resets any open file units.
-.I )help
+.Ic )help
  provides a short summary of all user commands.
  provides a short summary of all user commands.
-.SH FILES
-.DT
-/usr/ucb/lisp  the FRANZ LISP interpreter
+.Sh FILES
+.Dw liszt
+.Di L
+.Dp Pa lisp
+the FRANZ LISP interpreter
+.Dp Pa liszt
+the liszt compiler
+.\" .Dp Pa /usr/doc/fp
+.\" the User's Guide
+.Dp
+.Sh SEE ALSO
+.Xr lisp 1 ,
+.Xr liszt 1 ,
  .br
  .br
-/usr/ucb/liszt the liszt compiler
-.br
-/usr/doc/fp    the User's Guide
-.SH SEE ALSO
-.PP
-lisp(\*s), liszt(\*s).
-.PP
-.I The Berkeley FP user's manual,
+.Em The Berkeley FP user's manual ,
  available on-line.
  available on-line.
-The language is described  in  the August 1978 issue of  
-.I CACM
+The language is described  in  the August 1978 issue of
+.Em CACM
  (Turing award lecture by John Backus).
  (Turing award lecture by John Backus).
-.SH BUGS
-.PP
+.Sh BUGS
  If a non-terminating function is applied as the result of loading a file,
  then control is returned to the user immediately, everything
  after that position in the file is ignored.
  If a non-terminating function is applied as the result of loading a file,
  then control is returned to the user immediately, everything
  after that position in the file is ignored.
-.PP
-FP incorrectly marks the location of a syntax error on
+.Pp
+.Nm Fp
+incorrectly marks the location of a syntax error on
  large, multi-line function definitions or applications.
  large, multi-line function definitions or applications.
-.SH AUTHOR
+.Sh HISTORY
+.Nm Fp
+appeared in 4.2 BSD.
+.Sh AUTHOR
  Scott B. Baden
  Scott B. Baden
diff --git a/usr/src/old/lisp/man/lisp.1 b/usr/src/old/lisp/man/lisp.1

index 5660dd3..d34bfd0 100644 (file)
--- a/usr/src/old/lisp/man/lisp.1
+++ b/usr/src/old/lisp/man/lisp.1
@@ -1,56 +1,76 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
+.\" All rights reserved.
  .\"
  .\"
-.\"    @(#)lisp.1      6.1 (Berkeley) %G%
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.TH LISP 1 ""
-.UC 4
-.SH NAME
-lisp \- lisp interpreter
-.SH SYNOPSIS
-.B lisp
-.SH DESCRIPTION
-.I Lisp
+.\"     @(#)lisp.1     6.2 (Berkeley) %G%
+.\"
+.Dd 
+.Dt LISP 1
+.Os BSD 4
+.Sh NAME
+.Nm lisp
+.Nd lisp interpreter
+.Sh SYNOPSIS
+.Nm lisp
+.Sh DESCRIPTION
+.Nm Lisp
  is a lisp interpreter for a dialect which
  is a lisp interpreter for a dialect which
-closely resembles MIT's M\s-2ACLISP\s0.
-This lisp, known as F\s-2RANZ\s0\ L\s-2ISP\s0, features
+closely resembles MIT's MACLISP.
+This lisp, known as FRANZ
+LISP, features
  an I/O facility which allows the user to change the input
  and output syntax, add
  macro characters, and maintain compatibility with upper-case
  only lisp systems;
  infinite precision integer arithmetic, and
  an I/O facility which allows the user to change the input
  and output syntax, add
  macro characters, and maintain compatibility with upper-case
  only lisp systems;
  infinite precision integer arithmetic, and
-an error facility which allows the user to trap system errors in 
+an error facility which allows the user to trap system errors in
  many different ways.
  Interpreted functions may be mixed with code compiled by
  many different ways.
  Interpreted functions may be mixed with code compiled by
-.IR liszt (1)
+.Xr liszt  1
  and both may be debugged using the
  ``Joseph Lister'' trace package.
  A
  and both may be debugged using the
  ``Joseph Lister'' trace package.
  A
-.I lisp
+.Nm lisp
  containing compiled and interpreted code may be dumped into
  a file for later use.
  containing compiled and interpreted code may be dumped into
  a file for later use.
-.LP
+.Pp
  There are too many functions to list here; one should refer to the
  manuals listed below.
  There are too many functions to list here; one should refer to the
  manuals listed below.
-.SH AUTHORS
+.Sh AUTHORS
  An early version was written by Jeff Levinsky, Mike Curry, and John Breedlove.
  Keith Sklower wrote and is maintaining the current version,
  with the assistance of John Foderaro.
  The garbage collector was implemented by Bill Rowan.
  An early version was written by Jeff Levinsky, Mike Curry, and John Breedlove.
  Keith Sklower wrote and is maintaining the current version,
  with the assistance of John Foderaro.
  The garbage collector was implemented by Bill Rowan.
-.SH FILES
-.ta 2.4i
-/usr/lib/lisp/trace.l  Joseph Lister trace package
-.br
-/usr/lib/lisp/toplevel.l       top level read-eval-print loop
-.SH SEE ALSO
-liszt(1), 
-lxref(1)
+.Sh ENVIRONMENT
+.Nm Lisp
+checks these
+environment variables;
+.Ev PATH ,
+.Ev SHELL
+and
+.Ev TERM .
+.Sh FILES
+.Dw /usr/lib/lisp/toplevel.l
+.Di L
+.Dp Pa /usr/lib/lisp/trace.l
+Joseph Lister trace package
+.Dp Pa /usr/lib/lisp/toplevel.l
+top level read-eval-print loop
+.Dp
+.Sh SEE ALSO
+.Xr liszt 1 ,
+.Xr lxref 1
  .br
  .br
-`F\s-2RANZ\s0\ L\s-2ISP\s0  Manual, Version 1'
-by John K. Foderaro
+.Em FRANZ LISP  Manual,
+Version 1
+by John K.
+Foderaro
  .br
  .br
-M\s-2ACLISP\s0 Manual
-.SH "BUGS"
+MACLISP Manual
+.Sh HISTORY
+.Nm Lisp
+appeared in 3 BSD.
+.Sh BUGS
  The error system is in a state of flux and not all error messages are
  as informative as they could be.
  The error system is in a state of flux and not all error messages are
  as informative as they could be.
diff --git a/usr/src/old/lisp/man/liszt.1 b/usr/src/old/lisp/man/liszt.1

index 8b72cab..fe55296 100644 (file)
--- a/usr/src/old/lisp/man/liszt.1
+++ b/usr/src/old/lisp/man/liszt.1
@@ -1,114 +1,121 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
+.\" All rights reserved.
  .\"
  .\"
-.\"    @(#)liszt.1     6.1 (Berkeley) %G%
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.TH LISZT 1 ""
-.UC 4
-.SH NAME
-liszt \- compile a Franz Lisp program
-.SH SYNOPSIS
-.B liszt
-[
-.B \-mpqruwxCQST
-] [
-.B \-e
-form
-] [
-.B \-o
-objfile
-]  [ name ]
-.SH DESCRIPTION
-.I Liszt
-takes a file whose names ends in `.l' and compiles the F\s-2RANZ\s0 L\s-2ISP\s0
+.\"     @(#)liszt.1    6.2 (Berkeley) %G%
+.\"
+.Dd 
+.Dt LISZT 1
+.Os BSD 4
+.Sh NAME
+.Nm liszt
+.Nd compile a Franz Lisp program
+.Sh SYNOPSIS
+.Nm liszt
+.Op Fl mpqruwxCQST
+.Op Fl e Ar form
+.Op Fl o Ar objfile
+.Op Ar name
+.Sh DESCRIPTION
+.Nm Liszt
+takes a file whose names ends in `.l' and compiles the FRANZ
+LISP
  code there leaving an object program on the file whose name is that of the
  source with `.o' substituted for `.l'.
  code there leaving an object program on the file whose name is that of the
  source with `.o' substituted for `.l'.
-.PP
+.Pp
  The following options are interpreted by
  The following options are interpreted by
-.I liszt.
-.TP
-.B \-e
+.Nm liszt .
+.Tw Fl
+.Tp Fl e
  Evaluate the given form before compilation begins.
  Evaluate the given form before compilation begins.
-.TP
-.B \-m
-Compile a M\s-2ACLISP\s0 file, by changing the readtable to conform to
-\s-2MACLISP\s0 syntax and including a macro-defined compatibility package.
-.TP
-.B \-o
+.Tp Fl m
+Compile a MACLISP
+file, by changing the readtable to conform to
+MACLISP
+syntax and including a macro-defined compatibility package.
+.Tp Fl o
  Put the object code in the specified file, rather than the default `.o' file.
  Put the object code in the specified file, rather than the default `.o' file.
-.TP
-.B \-p
+.Tp Fl p
  places profiling code at the beginning of each non-local function.
  If the lisp system is also created with profiling in it, this allows
  function calling frequency to be determined (see
  places profiling code at the beginning of each non-local function.
  If the lisp system is also created with profiling in it, this allows
  function calling frequency to be determined (see
-.IR prof (1).)
-.TP
-.B \-q
+.Xr prof  1  . )
+.Tp Fl q
  Only print warning and error messages.
  Compilation statistics and notes on correct but unusual constructs
  will not be printed.
  Only print warning and error messages.
  Compilation statistics and notes on correct but unusual constructs
  will not be printed.
-.TP
-.B \-r
+.Tp Fl r
  place bootstrap code at the beginning of the object file, which when
  the object file is executed will cause a lisp system to be invoked
  and the object file fasl'ed in.
  place bootstrap code at the beginning of the object file, which when
  the object file is executed will cause a lisp system to be invoked
  and the object file fasl'ed in.
-.TP
-.B \-u
+.Tp Fl u
  Compile a UCI-lispfile, by changing the readtable to conform to
  UCI-Lisp syntax and including a macro-defined compatibility package.
  Compile a UCI-lispfile, by changing the readtable to conform to
  UCI-Lisp syntax and including a macro-defined compatibility package.
-.TP
-.B \-w
+.Tp Fl w
  Suppress warning diagnostics.
  Suppress warning diagnostics.
-.TP
-.B \-x
+.Tp Fl x
  Create a lisp cross reference file with the same name as the source
  file but with  `.x' appended.
  Create a lisp cross reference file with the same name as the source
  file but with  `.x' appended.
-The program 
-.IR lxref (1) 
+The program
+.Xr lxref  1
  reads this file and creates a human readable cross
  reference listing.
  reads this file and creates a human readable cross
  reference listing.
-.TP
-.B \-C
+.Tp Fl C
  put comments in the assembler output of the compiler. Useful
  for debugging the compiler.
  put comments in the assembler output of the compiler. Useful
  for debugging the compiler.
-.TP
-.B -Q
+.Tp Fl Q
  Print compilation statistics and warn of strange constructs.
  Print compilation statistics and warn of strange constructs.
-This is the default. 
-.TP
-.B \-S
+This is the default.
+.Tp Fl S
  Compile the named program and leave the assembler-language output on
  the corresponding file suffixed `.s'.
  This will also prevent the assembler language file from being assembled.
  Compile the named program and leave the assembler-language output on
  the corresponding file suffixed `.s'.
  This will also prevent the assembler language file from being assembled.
-.TP
-.B \-T
+.Tp Fl T
  send the assembler output to standard output.
  send the assembler output to standard output.
-.PP
-If 
+.Tp
+.Pp
+If
  no source file is specified, then the compiler will run interactively.
  no source file is specified, then the compiler will run interactively.
-You will find yourself talking to the 
-.IR lisp (1)
+You will find yourself talking to the
+.Xr lisp  1
  top-level command interpreter.
  You can compile a file by using the
  function
  top-level command interpreter.
  You can compile a file by using the
  function
-.I liszt 
+.Nm liszt
  (an nlambda) with the same arguments as you use on the command line.
  (an nlambda) with the same arguments as you use on the command line.
-For example to compile `foo', a M\s-2ACLISP\s0 file, you would use:
-.IP
-(liszt \-m foo)
-.PP
+For example to compile `foo', a MACLISP
+file, you would use:
+.Pp
+.Dl (liszt \-m foo)
+.Pp
  Note that
  Note that
-.I liszt
+.Nm liszt
  supplies the ``.l'' extension for you.
  supplies the ``.l'' extension for you.
-.SH FILES
-.ta 2.4i
-.nf
-/usr/lib/lisp/machacks.l       M\s-2ACLISP\s0 compatibility package
-/usr/lib/lisp/syscall.l        macro definitions of Unix system calls 
-/usr/lib/lisp/ucifnc.l UCI Lisp compatibility package
-.fi
-.SH AUTHOR
+.Sh FILES
+.Dw /usr/lib/lisp/machacks.l
+.Di L
+.Dp Pa /usr/lib/lisp/machacks.l
+MACLISP
+compatibility package
+.Dp Pa /usr/lib/lisp/syscall.l
+macro definitions of Unix system calls
+.Dp Pa /usr/lib/lisp/ucifnc.l
+UCI Lisp compatibility package
+.Dp
+.Sh AUTHOR
  John Foderaro
  John Foderaro
-.SH SEE ALSO
-lisp(1), lxref(1)
+.Sh SEE ALSO
+.Xr lisp 1 ,
+.Xr lxref 1
+.Sh ENVIRONMENT
+.Nm Liszt
+checks these
+environment variables;
+.Ev PATH ,
+.Ev SHELL
+and
+.Ev TERM .
+.Sh HISTORY
+.Nm Lisp
+appeared in 3 BSD.
diff --git a/usr/src/old/pcc/lint/lpass1/lint.1 b/usr/src/old/pcc/lint/lpass1/lint.1

index 8860446..069e139 100644 (file)
--- a/usr/src/old/pcc/lint/lpass1/lint.1
+++ b/usr/src/old/pcc/lint/lpass1/lint.1
@@ -1,23 +1,23 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
+.\" Copyright (c) 1980, 1990 Regents of the University of California.
+.\" All rights reserved.  The Berkeley Software License Agreement
  .\" specifies the terms and conditions for redistribution.
  .\"
  .\" specifies the terms and conditions for redistribution.
  .\"
-.\"    @(#)lint.1      6.2 (Berkeley) %G%
+.\"     @(#)lint.1     6.3 (Berkeley) %G%
  .\"
  .\"
-.TH LINT 1 ""
-.UC 4
-.SH NAME
-lint \- a C program verifier
-.SH SYNOPSIS
-.B lint
-[
-.B \-abchnpuvx
-]
-file ...
-.SH DESCRIPTION
-.I Lint
+.Dd 
+.Dt LINT 1
+.Os BSD 4
+.Sh NAME
+.Nm lint
+.Nd a C program verifier
+.Sh SYNOPSIS
+.Nm lint
+.Op Fl abchnpuvx
+.Ar file ...
+.Sh DESCRIPTION
+.Nm Lint
  attempts to detect features of the C program
  attempts to detect features of the C program
-.I files
+.Ar files
  which are
  likely to be bugs, or non-portable, or wasteful.
  It also checks the type usage of the program more strictly
  which are
  likely to be bugs, or non-portable, or wasteful.
  It also checks the type usage of the program more strictly
@@ -31,157 +31,150 @@ Moreover, the usage of functions is checked to find
  functions which return values in some places and not in others,
  functions called with varying numbers of arguments,
  and functions whose values are not used.
  functions which return values in some places and not in others,
  functions called with varying numbers of arguments,
  and functions whose values are not used.
-.PP
+.Pp
  By default, it is assumed that all the
  By default, it is assumed that all the
-.I files
+.Ar files
  are to be loaded together; they are checked for
  mutual compatibility.
  Function definitions for certain libraries are available to
  are to be loaded together; they are checked for
  mutual compatibility.
  Function definitions for certain libraries are available to
-.IR lint ;
+.Nm lint  ;
  these libraries are referred to by a
  conventional name,
  such as `\-lm', in the style of
  these libraries are referred to by a
  conventional name,
  such as `\-lm', in the style of
-.IR ld (1).
+.Xr ld  1  .
  Arguments ending in
  Arguments ending in
-.I .ln
+.Va .ln
  are also treated as library files.  To create lint libraries,
  use the
  are also treated as library files.  To create lint libraries,
  use the
-.B \-C
+.Fl C
  option:
  option:
-.IP
-lint \-Cfoo files . . .
-.PP
+.Pp
+.DL lint \-Cfoo files . . .
+.Pp
  where
  where
-.I files
+.Ar files
  are the C sources of library
  are the C sources of library
-.I foo.
+.Ar foo .
  The result is a file
  The result is a file
-.I llib-lfoo.ln
+.Em llib-lfoo .ln
  in the correct library format suitable for linting programs
  using
  in the correct library format suitable for linting programs
  using
-.I foo.
-.PP
+.Ar foo .
+.Pp
  Any number of the options in the following list
  may be used.
  The
  Any number of the options in the following list
  may be used.
  The
-.SM
-.BR \-D "\*S,"
-.SM
-.BR \-U "\*S,"
+.Fl D
+.Fl U
  and
  and
-.SM
-.B \-I
+.Fl I
  options of
  options of
-.IR cc (1)
+.Xr cc  1
  are also recognized as separate arguments.
  are also recognized as separate arguments.
-.TP
-.B p
+.Tp Fl p
  Attempt to check portability to the
  Attempt to check portability to the
-.I IBM
+.Em IBM
  and
  and
-.I GCOS
+.Em GCOS
  dialects of C.
  dialects of C.
-.TP
-.B h
+.Tp Fl h
  Apply a number of heuristic tests to attempt to
  intuit bugs, improve style, and reduce waste.
  Apply a number of heuristic tests to attempt to
  intuit bugs, improve style, and reduce waste.
-.TP
-.B b
+.Tp Fl b
  Report
  Report
-.I break
+.Ar break
  statements that cannot be reached.
  (This is not the default because, unfortunately,
  most
  statements that cannot be reached.
  (This is not the default because, unfortunately,
  most
-.I lex
+.Xr lex 1
  and many
  and many
-.I yacc
+.Xr yacc 1
  outputs produce dozens of such comments.)
  outputs produce dozens of such comments.)
-.TP
-.B v
+.Tp Fl v
  Suppress complaints about unused arguments in functions.
  Suppress complaints about unused arguments in functions.
-.TP
-.B x
+.Tp Fl x
  Report variables referred to by extern declarations,
  but never used.
  Report variables referred to by extern declarations,
  but never used.
-.TP
-.B a
+.Tp Fl a
  Report assignments of long values to int variables.
  Report assignments of long values to int variables.
-.TP
-.B c
+.Tp Fl c
  Complain about casts which have questionable portability.
  Complain about casts which have questionable portability.
-.TP
-.B u
+.Tp Fl u
  Do not complain about functions and variables used and not
  defined, or defined and not used (this is suitable for running
  Do not complain about functions and variables used and not
  defined, or defined and not used (this is suitable for running
-.I lint
+.Nm lint
  on a subset of files out of a larger program).
  on a subset of files out of a larger program).
-.TP
-.B n
+.Tp Fl n
  Do not check compatibility against the standard library.
  Do not check compatibility against the standard library.
-.TP
-.B z
+.Tp Fl z
  Do not complain about structures that are never defined (e.g.
  using a structure pointer without knowing its contents.).
  Do not complain about structures that are never defined (e.g.
  using a structure pointer without knowing its contents.).
-.PP
-.IR Exit (2)
+.Tp
+.Pp
+.Xr Exit  2
  and other functions which do not return
  are not understood; this causes various lies.
  and other functions which do not return
  are not understood; this causes various lies.
-.PP
+.Pp
  Certain conventional comments in the C source
  will change the behavior of
  Certain conventional comments in the C source
  will change the behavior of
-.IR lint :
-.TP
-/*NOTREACHED*/
+.Nm lint  :
+.Tw Fl
+.Tp Li /*NOTREACHED*/
  at appropriate points
  stops comments about unreachable code.
  at appropriate points
  stops comments about unreachable code.
-.TP
-.RI /*VARARGS n */
+.Tp Li /*VARARGS n */
  suppresses
  the usual checking for variable numbers of arguments
  in the following function declaration.
  The data types of the first
  suppresses
  the usual checking for variable numbers of arguments
  in the following function declaration.
  The data types of the first
-.I n
+.Ar n
  arguments are checked;
  a missing
  arguments are checked;
  a missing
-.I n
+.Ar n
  is taken to be 0.
  is taken to be 0.
-.TP
-/*NOSTRICT*/
+.Tp Li /*NOSTRICT*/
  shuts off strict type checking in the next expression.
  shuts off strict type checking in the next expression.
-.TP
-/*ARGSUSED*/
+.Tp Li /*ARGSUSED*/
  turns on the
  turns on the
-.B \-v
+.Fl v
  option for the next function.
  option for the next function.
-.TP
-/*LINTLIBRARY*/
+.Tp Li /*LINTLIBRARY*/
  at the beginning of a file shuts off complaints about
  unused functions in this file.
  at the beginning of a file shuts off complaints about
  unused functions in this file.
-.SH AUTHOR
+.Yp
+.Sh AUTHOR
  S.C. Johnson.  Lint library construction implemented by Edward Wang.
  S.C. Johnson.  Lint library construction implemented by Edward Wang.
-.SH FILES
-.ta \w'/usr/lib/lint/llib-port.ln  'u
-/usr/lib/lint/lint[12] programs
-.br
-/usr/lib/lint/llib-lc.ln       declarations for standard functions
-.br
-/usr/lib/lint/llib-lc  human readable version of above
-.br
-/usr/lib/lint/llib-port.ln     declarations for portable functions
-.br
-/usr/lib/lint/llib-port        human readable . . .
-.br
-llib-l*.ln     library created with
-.B \-C
-.SH SEE ALSO
-cc(1)
+.Sh FILES
+.Dw /usr/libdata/lint/llib-port.ln
+.Di L
+.\" Pa /usr/libdata/lint/llib.ln
+.\" .Op 12
+.\" programs
+.Dp Pa /usr/libdata/lint/llib-lc.ln
+declarations for standard functions
+.Dp Pa /usr/libdata/lint/llib-lc
+human readable version of above
+.Dp Pa /usr/lib/lintdata/llib-port.ln
+declarations for portable functions
+.Dp Pa /usr/lib/lintdata/llib-port
+human readable . . .
+.Dp Pa llib-l*.ln
+library created with
+.Fl C
+.Dp
+.Sh SEE ALSO
+.Xr cc 1
  .br
  S. C. Johnson,
  .br
  S. C. Johnson,
-.I Lint, a C Program Checker
-.SH BUGS
+.Em Lint ,
+a C Program Checker
+.Sh HISTORY
+.Nm Lint
+appeared in Version 7 AT&T Unix.
+.Sh BUGS
  There are some things you just
  There are some things you just
-.B can't
+can't
  get lint to shut up about.
  get lint to shut up about.
-.PP
+.Pp
  /*NOSTRICT*/
  is not implemented in the current version (alas).
  /*NOSTRICT*/
  is not implemented in the current version (alas).
diff --git a/usr/src/share/man/man1/intro.1 b/usr/src/share/man/man1/intro.1

index 61ad969..df7cf73 100644 (file)
--- a/usr/src/share/man/man1/intro.1
+++ b/usr/src/share/man/man1/intro.1
@@ -1,6 +1,10 @@
-.\"    @(#)intro.1     6.1 (Berkeley) %G%
+.\" Copyright (c) 1990 Regents of the University of California.
+.\" All rights reserved.  The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.
  .\"
  .\"
-.TH INTRO 1 ""
+.\"     @(#)intro.1    6.2 (Berkeley) %G%
+.\"
+.TH INTRO 1 "April 29, 1985"
  .AT 3
  .SH NAME
  intro \- introduction to commands
  .AT 3
  .SH NAME
  intro \- introduction to commands
diff --git a/usr/src/share/man/man7/hostname.7 b/usr/src/share/man/man7/hostname.7

index 35c7b40..4ceee85 100644 (file)
--- a/usr/src/share/man/man7/hostname.7
+++ b/usr/src/share/man/man7/hostname.7
@@ -1,42 +1,36 @@
-.\" Copyright (c) 1987 The Regents of the University of California.
+.\" Copyright (c) 1987, 1990 The Regents of the University of California.
  .\" All rights reserved.
  .\"
  .\" All rights reserved.
  .\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.\"    @(#)hostname.7  6.4 (Berkeley) %G%
+.\"     @(#)hostname.7 6.5 (Berkeley) %G%
  .\"
  .\"
-.TH HOSTNAME 7 ""
-.UC 5
-.SH NAME
-hostname \- host name resolution description
-.SH DESCRIPTION
+.Dd 
+.Dt HOSTNAME 7
+.Os BSD 4.2
+.Sh NAME
+.Nm hostname
+.Nd host name resolution description
+.Sh DESCRIPTION
  Hostnames are domains, where a domain is a hierarchical, dot-separated
  list of subdomains; for example, the machine monet, in the Berkeley
  subdomain of the EDU subdomain of the Internet would be represented as
  Hostnames are domains, where a domain is a hierarchical, dot-separated
  list of subdomains; for example, the machine monet, in the Berkeley
  subdomain of the EDU subdomain of the Internet would be represented as
-.br
-               monet.Berkeley.EDU
-.br
+.Pp
+.Dl monet.Berkeley.EDU
+.Pp
  (with no trailing dot).
  (with no trailing dot).
-.PP
+.Pp
  Hostnames are often used with network client and server programs,
  which must generally translate the name to an address for use.
  (This function is generally performed by the library routine
  Hostnames are often used with network client and server programs,
  which must generally translate the name to an address for use.
  (This function is generally performed by the library routine
-.IR gethostbyname (3).)
+.Xr gethostbyname  3  . )
  Hostnames are resolved by the Internet name resolver in the following
  fashion.
  Hostnames are resolved by the Internet name resolver in the following
  fashion.
-.PP
+.Pp
  If the name consists of a single component, i.e. contains no dot,
  If the name consists of a single component, i.e. contains no dot,
-and if the environment variable ``HOSTALIASES'' is set to the name of a file,
+and if the environment variable
+.Dq Ev HOSTALIASES
+is set to the name of a file,
  that file is searched for an string matching the input hostname.
  The file should consist of lines made up of two white-space separated strings,
  the first of which is the hostname alias,
  that file is searched for an string matching the input hostname.
  The file should consist of lines made up of two white-space separated strings,
  the first of which is the hostname alias,
@@ -45,11 +39,11 @@ to be substituted for that alias.
  If a case-insensitive match is found between the hostname to be resolved
  and the first field of a line in the file, the substituted name is looked
  up with no further processing.
  If a case-insensitive match is found between the hostname to be resolved
  and the first field of a line in the file, the substituted name is looked
  up with no further processing.
-.PP
+.Pp
  If the input name ends with a trailing dot,
  the trailing dot is removed,
  and the remaining name is looked up with no further processing.
  If the input name ends with a trailing dot,
  the trailing dot is removed,
  and the remaining name is looked up with no further processing.
-.PP
+.Pp
  If the input name does not end with a trailing dot, it is looked up
  by searching through a list of domains until a match is found.
  The default search list includes first the local domain,
  If the input name does not end with a trailing dot, it is looked up
  by searching through a list of domains until a match is found.
  The default search list includes first the local domain,
@@ -61,6 +55,12 @@ Lithium.CChem.EDU will not be tried, as the there is only one component
  remaining from the local domain.
  The search path can be changed from the default
  by a system-wide configuration file (see
  remaining from the local domain.
  The search path can be changed from the default
  by a system-wide configuration file (see
-.IR resolver (5)).
-.SH SEE ALSO
-gethostbyname(3), resolver(5), mailaddr(7), named(8)
+.Xr resolver  5  ) .
+.Sh SEE ALSO
+.Xr gethostbyname 3 ,
+.Xr resolver 5 ,
+.Xr mailaddr 7 ,
+.Xr named 8
+.Sh HISTORY
+.Nm Hostname
+appeared in 4.2 BSD.
diff --git a/usr/src/share/man/man7/intro.7 b/usr/src/share/man/man7/intro.7

index 67a2e0a..00cf647 100644 (file)
--- a/usr/src/share/man/man7/intro.7
+++ b/usr/src/share/man/man7/intro.7
@@ -1,27 +1,34 @@
-.\" Copyright (c) 1983 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1983, 1990 The Regents of the University of California.
+.\" All rights reserved.
  .\"
  .\"
-.\"    @(#)intro.7     6.1 (Berkeley) %G%
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.TH INTRO 7  ""
-.UC 5
-.SH NAME
-miscellaneous \- miscellaneous useful information pages
-.SH DESCRIPTION
+.\"     @(#)intro.7    6.2 (Berkeley) %G%
+.\"
+.Dd 
+.Dt INTRO 7
+.Os BSD 4.2
+.Sh NAME
+.Nm intro
+.Nd miscellaneous information pages
+.Sh DESCRIPTION
  This section contains miscellaneous documentation, mostly
  in the area of text processing macro packages for
  This section contains miscellaneous documentation, mostly
  in the area of text processing macro packages for
-.IR troff (1).
-.sp 2
-.nf
-.ta 1.25i
-ascii  map of ASCII character set
-environ        user environment
-eqnchar        special character definitions for eqn
-hier   file system hierarchy
-mailaddr       mail addressing description
-man    macros to typeset manual pages
-me     macros for formatting papers
-ms     macros for formatting manuscripts
-term   conventional names for terminals
-.fi
+.Xr troff  1  .
+.Pp
+.Ds I
+.Cw mailaddr
+.Cl ascii      map of ASCII character set
+.Cl environ    user environment
+.Cl eqnchar    special character definitions for eqn
+.Cl hier       file system hierarchy
+.Cl mailaddr   mail addressing description
+.Cl man        macros to typeset manual pages
+.Cl \&me       macros for formatting papers
+.Cl \&ms       macros for formatting manuscripts
+.Cl term       conventional names for terminals
+.Cw
+.De
+.Sh HISTORY
+.Nm intro
+appeared in 4.2 BSD.
diff --git a/usr/src/usr.bin/f77/f77.vax/f77.1 b/usr/src/usr.bin/f77/f77.vax/f77.1

index 0a7d690..8235506 100644 (file)
--- a/usr/src/usr.bin/f77/f77.vax/f77.1
+++ b/usr/src/usr.bin/f77/f77.vax/f77.1
@@ -1,198 +1,191 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
+.\" All rights reserved.
  .\"
  .\"
-.\"    @(#)f77.1       6.4 (Berkeley) %G%
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.TH F77 1 ""
-.UC 4
-.SH NAME
-f77 \- Fortran 77 compiler
-.SH SYNOPSIS
-.B f77
-[ option ] ... file ...
-.SH DESCRIPTION
-.I F77
+.\"     @(#)f77.1      6.5 (Berkeley) %G%
+.\"
+.Dd 
+.Dt F77 1
+.Os BSD 4
+.Sh NAME
+.Nm f77
+.Nd Fortran 77 compiler
+.Sh SYNOPSIS
+.Nm f77
+.Op option
+\&...
+.Ar file ...
+.Sh DESCRIPTION
+.Nm F77
  is the UNIX Fortran 77 compiler.
  It accepts several types of arguments:
  is the UNIX Fortran 77 compiler.
  It accepts several types of arguments:
-.PP
+.Pp
  Arguments whose names end with `.f' are taken to be
  Fortran 77 source programs;
  they are compiled, and
  each object program is left on the file in the current directory
  whose name is that of the source with `.o' substituted
  for '.f'.
  Arguments whose names end with `.f' are taken to be
  Fortran 77 source programs;
  they are compiled, and
  each object program is left on the file in the current directory
  whose name is that of the source with `.o' substituted
  for '.f'.
-.PP
+.Pp
  Arguments whose names end with `.F' are also taken to be Fortran 77 source
  programs; these are first processed by the C preprocessor before being
  compiled by
  Arguments whose names end with `.F' are also taken to be Fortran 77 source
  programs; these are first processed by the C preprocessor before being
  compiled by
-.I f77.
-.PP
+.Nm f77 .
+.Pp
  Arguments whose names end with `.r' or `.e' are taken to be Ratfor
  or EFL source programs respectively; these are first transformed by the
  appropriate preprocessor, then compiled by f77.
  Arguments whose names end with `.r' or `.e' are taken to be Ratfor
  or EFL source programs respectively; these are first transformed by the
  appropriate preprocessor, then compiled by f77.
-.PP
+.Pp
  Arguments whose names end with `.c' or `.s' are taken to be C or assembly
  source programs and are compiled or assembled, producing a `.o' file.
  Arguments whose names end with `.c' or `.s' are taken to be C or assembly
  source programs and are compiled or assembled, producing a `.o' file.
-.PP
+.Pp
  The following options have the same meaning as in
  The following options have the same meaning as in
-.IR cc (1).
+.Xr cc  1  .
  See
  See
-.IR ld (1)
+.Xr ld  1
  for load-time options.
  for load-time options.
-.TP
-.B \-c
-Suppress loading and produce `.o' files for each source 
+.Tw Fl
+.Tp Fl c
+Suppress loading and produce `.o' files for each source
  file.
  file.
-.TP
-.B \-g
+.Tp Fl g
  Produce additional symbol table information for
  Produce additional symbol table information for
-.IR dbx (1)
+.Xr dbx  1
  and pass the
  and pass the
-.B \-lg
+.Fl lg
  flag to
  flag to
-.IR ld (1)
+.Xr ld  1
  so that on abnormal terminations, the memory image is written
  so that on abnormal terminations, the memory image is written
-to file \fIcore\fP.
+to file
+.Pa core  .
  Incompatible with
  Incompatible with
-.BR \-O .
-.TP
-.BR \-o " output"
+.Fl O  .
+.Tc Fl o
+.Ws
+.Ar output
+.Cx
  Name the final output file
  Name the final output file
-.I output
-instead of `a.out'.
-.TP
-.B \-p
+.Ar output
+instead of
+.Sq Pa a.out .
+.Tp Fl p
  Prepare object files for profiling, see
  Prepare object files for profiling, see
-.IR  prof (1).
-.TP
-.B \-pg
+.Xr prof  1  .
+.Tp Fl pg
  Causes the compiler to produce counting code in the manner of
  Causes the compiler to produce counting code in the manner of
-.B \-p,
+.Fl p ,
  but invokes a run-time recording mechanism that keeps more extensive
  statistics and produces a
  but invokes a run-time recording mechanism that keeps more extensive
  statistics and produces a
-.I gmon.out
+.Pa gmon.out
  file at normal termination. An execution profile can then be generated
  by use of
  file at normal termination. An execution profile can then be generated
  by use of
-.IR gprof (1).
-.TP
-.BR \-w
+.Xr gprof  1  .
+.Tp Fl w
  Suppress all warning messages.
  If the option is `\-w66', only Fortran 66 compatibility warnings are suppressed.
  Suppress all warning messages.
  If the option is `\-w66', only Fortran 66 compatibility warnings are suppressed.
-.TP
-.BI \-D name=def
-.TP
-.BI \-D name
+.Tc Fl D
+.Ar name =def
+.Cx
+.Tc Fl D
+.Ar name
+.Cx
  Define the
  Define the
-.I name
+.Ar name
  to the C preprocessor, as if by `#define'. If no definition is given, the name
  is defined as "1". (`.F' suffix files only).
  to the C preprocessor, as if by `#define'. If no definition is given, the name
  is defined as "1". (`.F' suffix files only).
-.TP
-.BI \-I dir
+.Tc Fl I
+.Ar dir
+.Cx
  `#include' files whose names do not begin with `/' are always sought
  first in the directory of the
  `#include' files whose names do not begin with `/' are always sought
  first in the directory of the
-.I file
+.Ar file
  argument, then in directories named in
  argument, then in directories named in
-.B \-I
+.Fl I
  options, then in directories on a standard list. (`.F' suffix files only).
  options, then in directories on a standard list. (`.F' suffix files only).
-.TP
-.B \-O
+.Tp Fl O
  Invoke an
  object-code optimizer.
  Incompatible with
  Invoke an
  object-code optimizer.
  Incompatible with
-.BR \-g .
-.TP
-.B \-S
+.Fl g  .
+.Tp Fl S
  Compile the named programs, and leave the
  assembler-language output on corresponding files suffixed `.s'.
  (No `.o' is created.).
  Compile the named programs, and leave the
  assembler-language output on corresponding files suffixed `.s'.
  (No `.o' is created.).
-.PP
+.Pp
  The following options are peculiar to
  The following options are peculiar to
-.IR f77 .
-.TP
-.B \-d
+.Nm f77  .
+.Tp Fl d
  Used for debugging the compiler.
  Used for debugging the compiler.
-.TP
-.B \-i2
+.Tp Fl i2
  On machines which support short integers, make the default integer constants
  and variables short.
  On machines which support short integers, make the default integer constants
  and variables short.
-.RB ( \-i4
+.Fl i4
  is the standard value of this option). All logical quantities will be short.
  is the standard value of this option). All logical quantities will be short.
-.TP
-.B \-q
+.Tp Fl q
  Suppress printing of file names and program unit names during compilation.
  Suppress printing of file names and program unit names during compilation.
-.TP
-.BR \-m
+.Tp Fl m
  Apply the M4 preprocessor to each `.r' file before transforming
  it with the Ratfor or EFL preprocessor.
  Apply the M4 preprocessor to each `.r' file before transforming
  it with the Ratfor or EFL preprocessor.
-.TP
-.SM
-.BR \-onetrip
-.TP
-.BR \-1
+.Tp Fl onetrip
+.Tp Fl 1
  Compile DO loops that are performed at least once if reached.
  (Fortran 77 DO loops are not performed at all if the upper limit is smaller than the lower limit.)
  Compile DO loops that are performed at least once if reached.
  (Fortran 77 DO loops are not performed at all if the upper limit is smaller than the lower limit.)
-.TP
-.BR \-r8
+.Tp Fl r8
  Treat all floating point variables,
  constants, functions and intrinsics
  as double precision and all complex
  quantities as double complex.
  Treat all floating point variables,
  constants, functions and intrinsics
  as double precision and all complex
  quantities as double complex.
-.TP
-.BR \-u
+.Tp Fl u
  Make the default type of a variable `undefined' rather than using the default Fortran rules.
  Make the default type of a variable `undefined' rather than using the default Fortran rules.
-.TP
-.BR \-v
+.Tp Fl v
  Print the version number of the compiler, and the name of each pass as it
  executes.
  Print the version number of the compiler, and the name of each pass as it
  executes.
-.TP
-.BR \-C
+.Tp Fl C
  Compile code to check that subscripts are within declared array bounds.
  For multi-dimensional arrays, only the equivalent linear subscript is checked.
  Compile code to check that subscripts are within declared array bounds.
  For multi-dimensional arrays, only the equivalent linear subscript is checked.
-.TP
-.BR \-F
+.Tp Fl F
  Apply the C preprocessor to `.F' files, and the EFL, or Ratfor preprocessors
  to `.e' and `.r' files, put the
  result in the file with the suffix changed to `.f', but do not compile.
  Apply the C preprocessor to `.F' files, and the EFL, or Ratfor preprocessors
  to `.e' and `.r' files, put the
  result in the file with the suffix changed to `.f', but do not compile.
-.TP
-.BI \-E x
-Use the string 
-.I x
+.Tc Fl E
+.Ar x
+.Cx
+Use the string
+.Ar x
  as an EFL option in processing `.e' files.
  as an EFL option in processing `.e' files.
-.TP
-.BI \-R x
-Use the string 
-.I x
+.Tc Fl R
+.Ar x
+.Cx
+Use the string
+.Ar x
  as a Ratfor option in processing `.r' files.
  as a Ratfor option in processing `.r' files.
-.TP
-\fB\-N\fR[\fBqxscn\fR]\fInnn
+.Tc Fl N
+.Op Ar qxscn
+.Ar nnn
+.Cx
  Make static tables in the compiler bigger. The compiler will complain
  if it overflows its tables and suggest you apply one or more of these
  flags. These flags have the following meanings:
  Make static tables in the compiler bigger. The compiler will complain
  if it overflows its tables and suggest you apply one or more of these
  flags. These flags have the following meanings:
-.RS
-.TP
-.B q
+.Tw Ds
+.Tp r q
  Maximum number of equivalenced variables. Default is 150.
  Maximum number of equivalenced variables. Default is 150.
-.TP
-.B x
+.Tp Ar x
  Maximum number of external names (common block names, subroutine and
  function names). Default is 200.
  Maximum number of external names (common block names, subroutine and
  function names). Default is 200.
-.TP
-.B s
+.Tp Ar s
  Maximum number of statement numbers. Default is 401.
  Maximum number of statement numbers. Default is 401.
-.TP
-.B c
+.Tp Ar c
  Maximum depth of nesting for control statements (e.g. DO loops). Default is
  20.
  Maximum depth of nesting for control statements (e.g. DO loops). Default is
  20.
-.TP
-.B n
+.Tp Ar n
  Maximum number of identifiers. Default is 1009.
  Maximum number of identifiers. Default is 1009.
-.RE
-.TP
-.BR \-U
+.Tp
+Tp Fl U
  Do not convert upper case letters to lower case. The default is to convert
  Fortran programs to lower case except within character string constants.
  Do not convert upper case letters to lower case. The default is to convert
  Fortran programs to lower case except within character string constants.
-.PP
+.Tp
+.Pp
  Other arguments
  are taken
  to be either loader option arguments, or F77-compatible
  Other arguments
  are taken
  to be either loader option arguments, or F77-compatible
@@ -202,67 +195,95 @@ or perhaps libraries of F77-compatible routines.
  These programs, together with the results of any
  compilations specified, are loaded (in the order
  given) to produce an executable program with name
  These programs, together with the results of any
  compilations specified, are loaded (in the order
  given) to produce an executable program with name
-`a.out'.
-.PP
+.Sq Pa a.out .
+.Pp
  Programs compiled with
  Programs compiled with
-.I f77
+.Nm f77
  produce memory dumps in file
  produce memory dumps in file
-.I core
+.Pa core
  upon abnormal termination if the
  upon abnormal termination if the
-.B \(mig
+.Fl
  flag was specified during loading.
  If the environment variable
  flag was specified during loading.
  If the environment variable
-.I f77_dump_flag
+.Ev f77_dump_flag
  is set to a value beginning with
  is set to a value beginning with
-.B y
+.Ar y
  or
  or
-.BR n ,
+.Ar n  ,
  dumps for abnormal terminations are respectively forced or
  suppressed.
  dumps for abnormal terminations are respectively forced or
  suppressed.
-.SH FILES
-.nf
-.ta \w'/usr/lib/libF77_p.a   'u
-file.[fFresc]  input file
-file.o object file
-a.out  loaded output
-./fort[pid].?  temporary
-/usr/lib/f77pass1      compiler
-/lib/f1        pass 2
-/lib/c2        optional optimizer
-/lib/cpp       C preprocessor
-/usr/lib/libF77.a      intrinsic function library
-/usr/lib/libI77.a      Fortran I/O library
-/usr/lib/libU77.a      UNIX interface library
-/usr/lib/libm.a        math library
-/lib/libc.a    C library, see section 3
-/usr/lib/libF77_p.a    profiling intrinsic function library
-/usr/lib/libI77_p.a    profiling Fortran I/O library
-/usr/lib/libU77_p.a    profiling UNIX interface library
-/usr/lib/libm_p.a      profiling math library
-/usr/lib/libc_p.a      profiling C library, see section 3
-mon.out        file produced for analysis by prof(1).
-gmon.out       file produced for analysis by gprof(1).
-.fi
-.SH "SEE ALSO"
-S. I. Feldman,
-P. J. Weinberger,
-J. Berkman,
-.I
-A Portable Fortran 77 Compiler
-.br
-D. L. Wasley,
-J. Berkman,
-.I
-Introduction to the f77 I/O Library
+.Sh FILES
+.Dw /usr/lib/libI77_p.a
+.Di L
+.Dp file.[fFresc]
+input file
+.Dp Pa file.o
+object file
+.Dp Pa a.out
+loaded output
+.Dp Pa /usr/lib/f77pass1
+compiler
+.Dp Pa /libexec/f1
+pass 2
+.Dp Pa /libexec/c2
+optional optimizer
+.Dp Pa /usr/bin/cpp
+C preprocessor
+.Dp Pa /usr/lib/libF77.a
+intrinsic function library
+.Dp Pa /usr/lib/libI77.a
+Fortran I/O library
+.Dp Pa /usr/lib/libU77.a
+UNIX interface library
+.Dp Pa /usr/lib/libm.a
+math library
+.Dp Pa /usr/lib/libc.a
+C library, see section 3
+.Dp Pa /usr/lib/libF77_p.a
+profiling intrinsic function library
+.Dp Pa /usr/lib/libI77_p.a
+profiling Fortran I/O library
+.Dp Pa /usr/lib/libU77_p.a
+profiling UNIX interface library
+.Dp Pa /usr/lib/libm_p.a
+profiling math library
+.Dp Pa /usr/lib/libc_p.a
+profiling C library, see section 3
+.Dp Pa mon.out
+file produced for analysis by
+.Xr prof 1 .
+.Dp Pa gmon.out
+file produced for analysis by
+.Xr gprof 1 .
+.Dp
+.Sh SEE ALSO
+S. I. Feldman, P. J. Weinberger, J. Berkman,
+.Em A Portable Fortran 77 Compiler
  .br
  .br
-fpr(1), fsplit(1), ld(1), ar(1), ranlib(1), dbx(1), intro(3f)
+D. L. Wasley, J. Berkman,
+.Em Introduction to the f77 I/.Xr O Library
  .br
  .br
-efl(1), ratfor(1), struct(1), prof(1), gprof(1), cc(1)
-.SH DIAGNOSTICS
+.Xr fpr 1 ,
+.Xr fsplit 1 ,
+.Xr ld 1 ,
+.Xr ar 1 ,
+.Xr ranlib 1 ,
+.Xr dbx 1 ,
+.Xr intro 3f
+.Xr efl 1 ,
+.Xr ratfor 1 ,
+.Xr struct 1 ,
+.Xr prof 1 ,
+.Xr gprof 1 ,
+.Xr cc 1
+.Sh DIAGNOSTICS
  The diagnostics produced by
  The diagnostics produced by
-.I f77
+.Nm f77
  itself are intended to be
  self-explanatory.
  Occasional messages may be produced by the loader.
  itself are intended to be
  self-explanatory.
  Occasional messages may be produced by the loader.
-.SH BUGS
+.Sh HISTORY
+.Nm F77
+appeared in Version 7 AT&T Unix.
+.Sh BUGS
  Files longer than about 50,000 lines must be split up to be compiled.
  Files longer than about 50,000 lines must be split up to be compiled.
diff --git a/usr/src/usr.bin/false/false.1 b/usr/src/usr.bin/false/false.1

index d72a3eb..7dcfc17 100644 (file)
--- a/usr/src/usr.bin/false/false.1
+++ b/usr/src/usr.bin/false/false.1
@@ -1,35 +1,32 @@
-.\" Copyright (c) 1983 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1983, 1990 The Regents of the University of California.
+.\" All rights reserved.
  .\"
  .\"
-.\"    @(#)false.1     6.1 (Berkeley) %G%
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.TH FALSE 1 ""
-.UC 5
-.SH NAME
-false, true \- provide truth values
-.SH SYNOPSIS
-.B true
-.PP
-.B false
-.SH DESCRIPTION
-.I True
-and
-.I false
-are usually used in a Bourne shell script.
-They test for the appropriate status "true" or "false" before running 
+.\"     @(#)false.1    6.2 (Berkeley) %G%
+.\"
+.Dd 
+.Dt FALSE 1
+.Os BSD 4.2
+.Sh NAME
+.Nm false
+.Nd return false value
+.Sh SYNOPSIS
+.Nm false
+.Sh DESCRIPTION
+.Nm false
+is usually used in a Bourne shell script.
+It tests for the appropriate status "false" before running 
  (or failing to run) a list of commands.  
  (or failing to run) a list of commands.  
-.SH EXAMPLE
-.IP
-.nf
-     while false
-     do
-          command list 
-     done
-.SH "SEE ALSO"
-csh(1),
-sh(1),
-true(1)
-.SH DIAGNOSTICS
-.I False
-has exit status nonzero.
+.Pp
+The
+.Nm false
+utility always exits with a value other than zero.
+.Sh SEE ALSO
+.Xr csh 1 ,
+.Xr sh 1 ,
+.Xr true 1
+.Sh STANDARDS
+The
+.Nm false
+function is expected to be POSIX 1003.2 compatible.
diff --git a/usr/src/usr.bin/file/file.1 b/usr/src/usr.bin/file/file.1

index 375580d..2036cf0 100644 (file)
--- a/usr/src/usr.bin/file/file.1
+++ b/usr/src/usr.bin/file/file.1
@@ -1,23 +1,40 @@
-.\"    @(#)file.1      6.1 (Berkeley) %G%
+.\" Copyright (c) 1990 The Regents of the University of California.
+.\" All rights reserved.
  .\"
  .\"
-.TH FILE 1 ""
-.AT 3
-.SH NAME
-file \- determine file type
-.SH SYNOPSIS
-.B file
-file ...
-.SH DESCRIPTION
-.I File
-performs a series of tests on each argument
-in an attempt to classify it.
-If an argument appears to be ascii,
-.I file
-examines the first 512 bytes
-and tries to guess its language.
-.SH BUGS
-It often makes mistakes.
-In particular it often suggests that
-command files are C programs.
-.PP
-Does not recognize Pascal or LISP.
+.\" %sccs.include.redist.man%
+.\"
+.\"     @(#)file.1     6.2 (Berkeley) %G%
+.\"
+.Dd 
+.Dt FILE 1
+.Os BSD 4.4
+.Sh NAME
+.Nm file
+.Nd identify file content
+.Sh SYNOPSIS
+.Nm file
+.Ar
+.Sh DESCRIPTION
+.Nm File
+tests the given argument(s) and reports
+the content type(s). 
+If
+the file type is text,
+it attempts to determine
+the type of text (e.g.
+.Xr csh 1
+commands or C code)
+.Pp
+As several tests
+are used and
+.Nm file
+stops testing on the first successful one,
+it can make mistakes.
+.Pp
+.Nm File
+does not recognize Pascal or LISP.
+.\" .Sh ENVIRONMENT
+.Sh HISTORY
+A
+.Nm file
+command appeared in Version 6 AT&T UNIX.
diff --git a/usr/src/usr.bin/finger/finger.1 b/usr/src/usr.bin/finger/finger.1

index 7d607a0..9bc50ad 100644 (file)
--- a/usr/src/usr.bin/finger/finger.1
+++ b/usr/src/usr.bin/finger/finger.1
@@ -1,126 +1,136 @@
-.\" Copyright (c) 1989 The Regents of the University of California.
+.\" Copyright (c) 1989, 1990 The Regents of the University of California.
  .\" All rights reserved.
  .\"
  .\" All rights reserved.
  .\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.\"    @(#)finger.1    6.9 (Berkeley) %G%
+.\"     @(#)finger.1   6.10 (Berkeley) %G%
  .\"
  .\"
-.TH FINGER 1 ""
-.UC 4
-.SH NAME
-finger \- user information lookup program
-.SH SYNOPSIS
-.B finger
-[
-.B -lmsp
-] [user [@host] ...]
-.SH DESCRIPTION
+.Dd 
+.Dt FINGER 1
+.Os BSD 4
+.Sh NAME
+.Nm finger
+.Nd user information lookup program
+.Sh SYNOPSIS
+.Nm finger
+.Op Fl lmsp
+.Ob
+.Ar user
+.Op \&@host
+\&...
+.Oe
+.Sh DESCRIPTION
  The
  The
-.I finger
+.Nm finger
  command has two basic output formats providing essentially the same
  information.
  command has two basic output formats providing essentially the same
  information.
-.PP
-The
-.I -s
-option of
-.I finger
+.Pp
+Options are:
+.Tp Fl s
+.Nm Finger
  displays the user's login name, real name, terminal name and write
  status (as a ``*'' after the terminal name if write permission is
  denied), idle time, login time, office location and office phone
  number.
  displays the user's login name, real name, terminal name and write
  status (as a ``*'' after the terminal name if write permission is
  denied), idle time, login time, office location and office phone
  number.
-.PP
+.Pp
  Idle time is in minutes if it is a single integer, hours and minutes
  if a ``:'' is present, or days if a ``d'' is present.
  Login time is displayed as month, day, hours and minutes, unless
  more than six months ago, in which case the year is displayed rather
  than the hours and minutes.
  Idle time is in minutes if it is a single integer, hours and minutes
  if a ``:'' is present, or days if a ``d'' is present.
  Login time is displayed as month, day, hours and minutes, unless
  more than six months ago, in which case the year is displayed rather
  than the hours and minutes.
-.PP
+.Pp
  Unknown devices as well as nonexistent idle and login times are
  displayed as single asterisks.
  Unknown devices as well as nonexistent idle and login times are
  displayed as single asterisks.
-.PP
-The
-.I -l
-option produces a multi-line format displaying all of the information
+.Pp
+.Tp Fl l
+Produces a multi-line format displaying all of the information
  described for the
  described for the
-.I -s
+.Fl s
  option as well as the user's home directory, home phone number, login
  shell, and the contents of the files
  option as well as the user's home directory, home phone number, login
  shell, and the contents of the files
-.I ``.plan''
+.Dq Pa .plan
  and
  and
-.I ``.project''
+.Dq Pa .project
  from the user's home directory.
  from the user's home directory.
-.PP
+.Pp
  If idle time is at least a minute and less than a day, it is
  presented in the form ``hh:mm''.
  If idle time is at least a minute and less than a day, it is
  presented in the form ``hh:mm''.
-Idle times greater than a day are presented as ``d day[s] hh:mm''.
-.PP
+Idle times greater than a day are presented as ``d day[s]hh:mm''.
+.Pp
  Phone numbers specified as eleven digits are printed as ``+N-NNN-NNN-NNNN''.
  Numbers specified as ten or seven digits are printed as the appropriate
  subset of that string.
  Numbers specified as five digits are printed as ``xN-NNNN''.
  Phone numbers specified as eleven digits are printed as ``+N-NNN-NNN-NNNN''.
  Numbers specified as ten or seven digits are printed as the appropriate
  subset of that string.
  Numbers specified as five digits are printed as ``xN-NNNN''.
-.PP
+.Pp
  If write permission is denied to the device, the phrase ``(messages off)''
  is appended to the line containing the device name.
  One entry per user is displayed with the
  If write permission is denied to the device, the phrase ``(messages off)''
  is appended to the line containing the device name.
  One entry per user is displayed with the
-.IR -l
+.Fl l
  option; if a user is logged on multiple times, terminal information
  is repeated once per login.
  option; if a user is logged on multiple times, terminal information
  is repeated once per login.
-.PP
-The
-.I -p
-option prevents
+.Pp
+.Tp Fl p
+Prevents
  the
  the
-.I -l
+.Fl l
  option of
  option of
-.I finger
-from displaying the contents of the ``.plan'' and ``.project''
+.Nm finger
+from displaying the contents of the
+.Dq Pa .plan
+and
+.Dq Pa .project
  files.
  files.
-.PP
+.Pp
  Note that some fields may be missing, in either format, if information
  is not available for them.
  Note that some fields may be missing, in either format, if information
  is not available for them.
-.PP
-If no operands are specified,
-.I finger
-will print an entry for each user currently logged into the system.
-If no options are specified,
-.I finger
-defaults to the
-.I -l
-style output if operands are provided, otherwise to the
-.I -s
-style.
-.PP
-.I User
+.Tp Fl m
+Prevent matching of
+.Ar user
+names.
+.Ar User
  is usually a login name; however, matching will also be done on the
  users' real names, unless the
  is usually a login name; however, matching will also be done on the
  users' real names, unless the
-.I -m
+.Fl m
  option is supplied.
  All name matching performed by
  option is supplied.
  All name matching performed by
-.I finger
+.Nm finger
  is case insensitive.
  is case insensitive.
-.PP
-.I Finger
+.Tp
+.Pp
+If no options are specified,
+.Nm finger
+defaults to the
+.Fl l
+style output if operands are provided, otherwise to the
+.Fl s
+style.
+.Pp
+If no arguments are specified,
+.Nm finger
+will print an entry for each user currently logged into the system.
+.Pp
+.Nm Finger
  may be used to look up users on a remote machine.
  The format is to specify a
  may be used to look up users on a remote machine.
  The format is to specify a
-.I user
-as ``user@host'', or ``@host'', where the default output
+.Ar user
+as
+.Dq Li user@host ,
+or
+.Dq Li @host ,
+where the default output
  format for the former is the
  format for the former is the
-.I -l
+.Fl l
  style, and the default output format for the latter is the
  style, and the default output format for the latter is the
-.IR -s
+.Fl s
  style.
  The
  style.
  The
-.I -l
+.Fl l
  option is the only option that may be passed to a remote machine.
  option is the only option that may be passed to a remote machine.
-.SH "SEE ALSO"
-chpass(1), w(1), who(1), getpwent(3)
+.Sh SEE ALSO
+.Xr chpass 1 ,
+.Xr w 1 ,
+.Xr who 1 ,
+.Xr getpwent 3
+.Sh HISTORY
+.Nm Finger
+appeared in 3 BSD.
diff --git a/usr/src/usr.bin/fmt/fmt.1 b/usr/src/usr.bin/fmt/fmt.1

index 2288804..be292c0 100644 (file)
--- a/usr/src/usr.bin/fmt/fmt.1
+++ b/usr/src/usr.bin/fmt/fmt.1
@@ -1,60 +1,61 @@
-.\" Copyright (c) 1980 The Regents of the University of California.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
  .\" All rights reserved.
  .\"
  .\" All rights reserved.
  .\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.\"    @(#)fmt.1       6.3 (Berkeley) %G%
+.\"     @(#)fmt.1      6.4 (Berkeley) %G%
  .\"
  .\"
-.TH FMT 1 ""
+.Dd 
+.Dt FMT 1
  .UC
  .UC
-.SH NAME
-fmt \- simple text formatter
-.SH SYNOPSIS
-.B fmt
-[ goal [ maximum ] ]
-[
-name ...
-]
-.SH DESCRIPTION
-.I Fmt
+.Sh NAME
+.Nm fmt
+.Nd simple text formatter
+.Sh SYNOPSIS
+.Nm fmt
+.Ob
+.Ar goal
+.Op Ar maximum
+.Oe
+.Op name ...
+.Sh DESCRIPTION
+.Nm Fmt
  is a simple text formatter which reads the concatenation of input
  files (or standard input if none are given) and produces on standard
  is a simple text formatter which reads the concatenation of input
  files (or standard input if none are given) and produces on standard
-output a version of its input with lines as close to the goal length
-as possible without exceeding the maximum.  The goal length defaults
+output a version of its input with lines as close to the
+.Ar goal
+length
+as possible without exceeding the maximum.  The
+.Ar goal
+length defaults
  to 65 and the maximum to 75.  The spacing at the beginning of the
  input lines is preserved in the output, as are blank lines and
  interword spacing.
  to 65 and the maximum to 75.  The spacing at the beginning of the
  input lines is preserved in the output, as are blank lines and
  interword spacing.
-.PP
-.I Fmt
+.Pp
+.Nm Fmt
  is meant to format mail messages prior to sending, but may also be useful
  for other simple tasks.
  For instance,
  within visual mode of the
  is meant to format mail messages prior to sending, but may also be useful
  for other simple tasks.
  For instance,
  within visual mode of the
-.I ex
+.Xr ex 1
  editor (e.g.
  editor (e.g.
-.IR vi )
+.Xr vi 1 )
  the command
  the command
-.br
-       !}fmt
-.br
+.Pp
+.Dl \&!}fmt
+.Pp
  will reformat a paragraph,
  evening the lines.
  will reformat a paragraph,
  evening the lines.
-.SH "SEE ALSO"
-nroff(1), mail(1)
-.SH AUTHOR
+.Sh SEE ALSO
+.Xr nroff 1 ,
+.Xr mail 1
+.Sh HISTORY
+.Nm Fmt
+appeared in 3 BSD.
+.Sh AUTHOR
  Kurt Shoens
  .br
  Liz Allen (added goal length concept)
  Kurt Shoens
  .br
  Liz Allen (added goal length concept)
-.SH BUGS
+.Sh BUGS
  The program was designed to be simple and fast \- for more complex
  operations, the standard text processors are likely to be more appropriate.
  The program was designed to be simple and fast \- for more complex
  operations, the standard text processors are likely to be more appropriate.
diff --git a/usr/src/usr.bin/fpr/fpr.1 b/usr/src/usr.bin/fpr/fpr.1

index 690ab7c..b19fe07 100644 (file)
--- a/usr/src/usr.bin/fpr/fpr.1
+++ b/usr/src/usr.bin/fpr/fpr.1
@@ -1,198 +1,55 @@
-.\" Copyright (c) 1989 The Regents of the University of California.
+.\" Copyright (c) 1989, 1990 The Regents of the University of California.
  .\" All rights reserved.
  .\"
  .\" This code is derived from software contributed to Berkeley by
  .\" Robert Corbett.
  .\"
  .\" All rights reserved.
  .\"
  .\" This code is derived from software contributed to Berkeley by
  .\" Robert Corbett.
  .\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.\"    @(#)fpr.1       6.4 (Berkeley) %G%
+.\"     @(#)fpr.1      6.5 (Berkeley) %G%
  .\"
  .\"
-.TH FPR 1 ""
-.UC 5
+.Dd 
+.Dt FPR 1
+.Os BSD 4.2
  .ds f. fpr.tbl
  .ds f. fpr.tbl
-.SH NAME
-fpr \- print Fortran file
-.SH SYNOPSIS
-.B fpr
-.SH DESCRIPTION
-.I Fpr
+.Sh NAME
+.Nm fpr
+.Nd print Fortran file
+.Sh SYNOPSIS
+.Nm fpr
+.Sh DESCRIPTION
+.Nm Fpr
  is a filter that transforms files formatted according to
  Fortran's carriage control conventions into files formatted
  according to UNIX line printer conventions.
  is a filter that transforms files formatted according to
  Fortran's carriage control conventions into files formatted
  according to UNIX line printer conventions.
-.PP
-.I Fpr
+.Pp
+.Nm Fpr
  copies its input onto its output, replacing the carriage
  control characters with characters that will produce the intended
  effects when printed using
  copies its input onto its output, replacing the carriage
  control characters with characters that will produce the intended
  effects when printed using
-.IR lpr (1).
+.Xr lpr  1  .
  The first character of each line determines the vertical spacing as follows:
  The first character of each line determines the vertical spacing as follows:
-
-.if t \{\
-.\"    tbl input for vertical spacing table
-.\"    .TS
-.\"    center box;
-.\"    c | l.
-.\"    Character       Vertical Space Before Printing
-.\"    _
-.\"    Blank   One line
-.\"    0       Two lines
-.\"    1       To first line of next page
-.\"    +       No advance
-.\"    .TE
-.\"    end of tbl input for vertical spacing table
-.\"    tbl output for vertical spacing table
-.TS
-.if \n+(b.=1 .nr d. \n(.c-\n(c.-1
-.de 35
-.ps \n(.s
-.vs \n(.vu
-.in \n(.iu
-.if \n(.u .fi
-.if \n(.j .ad
-.if \n(.j=0 .na
-..
-.nf
-.nr #~ 0
-.if n .nr #~ 0.6n
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.fc
-.nr 33 \n(.s
-.rm 80 81
-.nr 80 0
-.nr 38 \w\ 2Character\ 2
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\ 2Blank\ 2
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\ 20\ 2
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\ 21\ 2
-.if \n(80<\n(38 .nr 80 \n(38
-.nr 38 \w\ 2+\ 2
-.if \n(80<\n(38 .nr 80 \n(38
-.80
-.rm 80
-.nr 81 0
-.nr 38 \w\ 2Vertical Space Before Printing\ 2
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w\ 2One line\ 2
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w\ 2Two lines\ 2
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w\ 2To first line of next page\ 2
-.if \n(81<\n(38 .nr 81 \n(38
-.nr 38 \w\ 2No advance\ 2
-.if \n(81<\n(38 .nr 81 \n(38
-.81
-.rm 81
-.nr 38 1n
-.nr 79 0
-.nr 40 \n(79+(1*\n(38)
-.nr 80 +\n(40
-.nr 41 \n(80+(3*\n(38)
-.nr 81 +\n(41
-.nr TW \n(81
-.nr TW +1*\n(38
-.if t .if (\n(TW+\n(.o)>7.65i .tm Table at line 45 file fpr.tbl is too wide - \n(TW units
-.ne 5v+2p
-.nr #I \n(.i
-.in +(\n(.lu-\n(TWu-\n(.iu)/2u
-.fc \ 2 \ 3
-.nr #T 0-1
-.nr #a 0-1
-.nr #a 0-1
-.eo
-.de T#
-.ds #d .d
-.if \(ts\n(.z\(ts\(ts .ds #d nl
-.mk ##
-.nr ## -1v
-.ls 1
-.if \n(#T>=0 .nr #a \n(#T
-.if \n(T. .vs \n(.vu-\n(.sp
-.if \n(T. \h'|0'\s\n(33\l'|\n(TWu\(ul'\s0
-.if \n(T. .vs
-.if \n(#a>=0 .sp -1
-.if \n(#a>=0 \h'|0'\s\n(33\h'-\n(#~u'\L'|\n(#au-1v'\s0\v'\n(\*(#du-\n(#au+1v'\h'|\n(TWu'
-.if \n(#a>=0 .sp -1
-.if \n(#a>=0 \h'(|\n(41u+|\n(80u)/2u'\s\n(33\h'-\n(#~u'\L'|\n(#au-1v'\s0\v'\n(\*(#du-\n(#au+1v'\h'|\n(TWu'
-.if \n(#a>=0 .sp -1
-.if \n(#a>=0 \h'|\n(TWu'\s\n(33\h'-\n(#~u'\L'|\n(#au-1v'\s0\v'\n(\*(#du-\n(#au+1v'
-.ls
-..
-.ec
-.nr 36 \n(.v
-.vs \n(.vu-\n(.sp
-\h'|0'\s\n(33\l'|\n(TWu\(ul'\s0
-.vs \n(36u
-.mk #a
-.ta \n(80u \n(81u 
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\ 2\ 3Character\ 3\ 2\h'|\n(41u'\ 2Vertical Space Before Printing\ 3\ 2
-.nr 36 \n(.v
-.vs \n(.vu-\n(.sp
-\h'|0'\s\n(33\l'|\n(TWu\(ul'\s0
-.vs \n(36u
-.ta \n(80u \n(81u 
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\ 2\ 3Blank\ 3\ 2\h'|\n(41u'\ 2One line\ 3\ 2
-.ta \n(80u \n(81u 
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\ 2\ 30\ 3\ 2\h'|\n(41u'\ 2Two lines\ 3\ 2
-.ta \n(80u \n(81u 
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\ 2\ 31\ 3\ 2\h'|\n(41u'\ 2To first line of next page\ 3\ 2
-.ta \n(80u \n(81u 
-.nr 31 \n(.f
-.nr 35 1m
-\&\h'|\n(40u'\ 2\ 3+\ 3\ 2\h'|\n(41u'\ 2No advance\ 3\ 2
-.fc
-.nr T. 1
-.T# 1
-.in \n(#Iu
-.35
-.nr #a 0
-.TE
-.if \n-(b.=0 .nr c. \n(.c-\n(d.-9
-.\"    end of tbl output for vertical spacing table
-.\}
-.if n \{\
-.nf
-    +---------------+--------------------------------+
-    |   Character   | Vertical Space Before Printing |
-    |---------------+--------------------------------|
-    |     Blank     | One line                       |
-    |       0       | Two lines                      |
-    |       1       | To first line of next page     |
-    |       +       | No advance                     |
-    +---------------+--------------------------------+
-.fi
-.\}
-
-.PP
+.Ds I
+.Cw Character
+.Cl Blank      One line
+.Pp
+.Cl 0  Two lines
+.Cl 1  To first line of next page
+.Cl +  No advance
+.Cw
+.De
+.Pp
  A blank line is treated as if its first
  character is a blank. A blank that appears as a carriage control
  character is deleted. A zero is changed to a newline.  A one is
  changed to a form feed. The effects of a "+" are simulated using
  backspaces.
  A blank line is treated as if its first
  character is a blank. A blank that appears as a carriage control
  character is deleted. A zero is changed to a newline.  A one is
  changed to a form feed. The effects of a "+" are simulated using
  backspaces.
-.SH EXAMPLES
-a.out | fpr | lpr
-.PP
-fpr < f77.output | lpr
-.SH BUGS
+.Sh EXAMPLES
+.Dl a.out \&| fpr \&| lpr
+.Pp
+.Dl fpr \&< f77.output \&| lpr
+.Sh HISTORY
+.Nm Fpr
+appeared in 4.2 BSD.
+.Sh BUGS
  Results are undefined for input lines longer than 170 characters.
  Results are undefined for input lines longer than 170 characters.
diff --git a/usr/src/usr.bin/from/from.1 b/usr/src/usr.bin/from/from.1

index 9e6b9ac..e835611 100644 (file)
--- a/usr/src/usr.bin/from/from.1
+++ b/usr/src/usr.bin/from/from.1
@@ -1,45 +1,61 @@
-.\" Copyright (c) 1980 The Regents of the University of California.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
  .\" All rights reserved.
  .\"
  .\" All rights reserved.
  .\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.\"    @(#)from.1      6.3 (Berkeley) %G%
+.\"     @(#)from.1     6.4 (Berkeley) %G%
  .\"
  .\"
-.TH FROM 1 ""
-.UC 4
-.SH NAME
-from \- who is mail from?
-.SH SYNOPSIS
-.B from
-[
-.B \-s
-sender
-][
-.B \-f
-file ] [ user ]
-.SH DESCRIPTION
-.I From
-prints out the mail header lines from your mailbox.
-If either
-.I file
-or
-.I user
-is specified, then the supplied file, or \fIuser\fP's mailbox, is
-examined instead of your mailbox.
-.PP
-If the -s option is given, then only mail from addresses containing
-the supplied string are printed.
-.SH FILES
-/usr/spool/mail/*
-.SH "SEE ALSO"
-biff(1), mail(1)
+.Dd 
+.Dt FROM 1
+.Os BSD 4
+.Sh NAME
+.Nm from
+.Nd tell who is mail from?
+.Sh SYNOPSIS
+.Nm from
+.Op Fl s Ar sender
+.Op Fl f Ar file
+.Op Ar user
+.Sh DESCRIPTION
+.Nm From
+prints
+out the mail header lines from your mailbox.
+.Pp
+Options:
+.Tw Fl
+.Tc Fl f
+.Ws
+.Ar file
+.Cx
+The supplied file
+is examined instead of the your mailbox.
+If the
+.Fl f
+option is used, the
+.Ar user
+argument should not be used.
+.Tc Fl s
+.Ws
+.Ar sender
+.Cx
+Only mail from addresses containing
+the
+supplied string are printed.
+.Tp
+.Pp
+If
+.Ar user
+is given, the
+.Sf Ar user 's
+mailbox, is examined instead of your own mailbox.
+.Sh FILES
+.Dw /var/mail/*
+.Di L
+.Dp Pa /var/mail/*
+.Dp
+.Sh SEE ALSO
+.Xr biff 1 ,
+.Xr mail 1
+.Sh HISTORY
+.Nm From
+appeared in 3 BSD.
diff --git a/usr/src/usr.bin/fsplit/fsplit.1 b/usr/src/usr.bin/fsplit/fsplit.1

index a8c91e8..2bb144a 100644 (file)
--- a/usr/src/usr.bin/fsplit/fsplit.1
+++ b/usr/src/usr.bin/fsplit/fsplit.1
@@ -1,78 +1,78 @@
-.\" Copyright (c) 1983 The Regents of the University of California.
+.\" Copyright (c) 1983, 1990 The Regents of the University of California.
  .\" All rights reserved.
  .\"
  .\" This code is derived from software contributed to Berkeley by
  .\" Asa Romberger and Jerry Berkman.
  .\"
  .\" All rights reserved.
  .\"
  .\" This code is derived from software contributed to Berkeley by
  .\" Asa Romberger and Jerry Berkman.
  .\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.\"    @(#)fsplit.1    6.2 (Berkeley) %G%
+.\"     @(#)fsplit.1   6.3 (Berkeley) %G%
  .\"
  .\"
-.TH FSPLIT 1 ""
-.UC 5
-.SH NAME
-fsplit \- split a multi-routine Fortran file into individual files
-.SH SYNOPSIS
-.B fsplit
-[ 
-.B -e 
-efile] ... [ file ]
-.SH DESCRIPTION
-.B Fsplit
+.Dd 
+.Dt FSPLIT 1
+.Os BSD 4.2
+.Sh NAME
+.Nm fsplit
+.Nd split a multi-routine Fortran file into individual files
+.Sh SYNOPSIS
+.Nm fsplit
+.Op Fl e Ar efile
+\&...
+.Op Ar file
+.Sh DESCRIPTION
+.Nm Fsplit
  takes as input either a file or standard input containing Fortran source code.
  It attempts to split the input into separate routine files of the
  form
  takes as input either a file or standard input containing Fortran source code.
  It attempts to split the input into separate routine files of the
  form
-.I name.f,
+.Ar name.f ,
  where
  where
-.I name
+.Ar name
  is the name of the program unit (e.g. function, subroutine, block data or
  program).  The name for unnamed block data subprograms has the form
  is the name of the program unit (e.g. function, subroutine, block data or
  program).  The name for unnamed block data subprograms has the form
-.I blkdtaNNN.f
+.Ar blkdtaNNN.f
  where NNN is three digits and a file of this name does not already exist.
  For unnamed main programs the name has the form
  where NNN is three digits and a file of this name does not already exist.
  For unnamed main programs the name has the form
-.I mainNNN.f.
+.Ar mainNNN.f .
  If there is an error in classifying a program unit, or if
  If there is an error in classifying a program unit, or if
-.I name.f
+.Ar name.f
  already exists,
  already exists,
-the program unit will be put in a file of the form 
-.I zzzNNN.f
-where 
-.I zzzNNN.f 
+the program unit will be put in a file of the form
+.Ar zzzNNN.f
+where
+.Ar zzzNNN.f
  does not already exist.
  does not already exist.
-.PP
+.Pp
+.Tw Ar
+.Tc Fl e
+.Ws
+.Ar efile
+.Cx
  Normally each subprogram unit is split into a separate file.  When the
  Normally each subprogram unit is split into a separate file.  When the
-.I -e
+.Fl e
  option is used, only the specified subprogram units are split into separate
  files.  E.g.:
  option is used, only the specified subprogram units are split into separate
  files.  E.g.:
-.nf
-       fsplit -e readit -e doit prog.f
-.fi
+.Pp
+.Dl fsplit -e readit -e doit prog.f
+.Pp
  will split readit and doit into separate files.
  will split readit and doit into separate files.
-.SH DIAGNOSTICS
-If names specified via the 
-.I -e
-option are not found, a diagnostic is written to 
-.I standard 
-.I error.
-.SH AUTHOR
+.Tp
+.Sh DIAGNOSTICS
+If names specified via the
+.Fl e
+option are not found, a diagnostic is written to
+standard error.
+.Sh HISTORY
+.Nm Fsplit
+appeared in 4.2 BSD.
+.Sh AUTHORS
  Asa Romberger and Jerry Berkman
  Asa Romberger and Jerry Berkman
-.SH BUGS
-.I Fsplit
+.Sh BUGS
+.Nm Fsplit
  assumes the subprogram name is on the first noncomment line of the subprogram
  assumes the subprogram name is on the first noncomment line of the subprogram
-unit.  Nonstandard source formats may confuse 
-.I fsplit.
-.PP
-It is hard to use 
-.I -e
-for unnamed main programs and block data subprograms since you must 
+unit.  Nonstandard source formats may confuse
+.Nm fsplit .
+.Pp
+It is hard to use
+.Fl e
+for unnamed main programs and block data subprograms since you must
  predict the created file name.
  predict the created file name.
diff --git a/usr/src/usr.bin/gcore/gcore.1 b/usr/src/usr.bin/gcore/gcore.1

index f0867c6..efed763 100644 (file)
--- a/usr/src/usr.bin/gcore/gcore.1
+++ b/usr/src/usr.bin/gcore/gcore.1
@@ -1,28 +1,38 @@
-.\" Copyright (c) 1983 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1983, 1990 The Regents of the University of California.
+.\" All rights reserved.
  .\"
  .\"
-.\"    @(#)gcore.1     6.1 (Berkeley) %G%
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.TH GCORE 1 ""
-.UC 5
-.SH NAME
-gcore \- get core images of running processes
-.SH SYNOPSIS
-.B gcore
-process-id ...
-.SH DESCRIPTION
-.I Gcore
+.\"     @(#)gcore.1    6.2 (Berkeley) %G%
+.\"
+.Dd 
+.Dt GCORE 1
+.Os BSD 4.2
+.Sh NAME
+.Nm gcore
+.Nd get core images of running processes
+.Sh SYNOPSIS
+.Nm gcore
+.Ar process\-id ...
+.Sh DESCRIPTION
+.Nm Gcore
  creates a core image of each specified process,
  suitable for use with
  creates a core image of each specified process,
  suitable for use with
-.IR adb (1)
+.Xr adb  1
  or
  or
-.IR dbx (1).
-.SH FILES
-core.<process-id>      core images
-.SH BUGS
+.Xr dbx  1  .
+.Sh FILES
+.Dw core.<process-id>
+.Di L
+.Dp Pa core.<process-id>
+core images
+.Dp
+.Sh HISTORY
+.Nm Gcore
+appeared in 4.2 BSD.
+.Sh BUGS
  Paging activity that occurs while
  Paging activity that occurs while
-.I gcore
+.Nm gcore
  is running may cause the program
  to become confused.
  For best results,
  is running may cause the program
  to become confused.
  For best results,
diff --git a/usr/src/usr.bin/gprof/gprof.1 b/usr/src/usr.bin/gprof/gprof.1

index b56be7e..7827501 100644 (file)
--- a/usr/src/usr.bin/gprof/gprof.1
+++ b/usr/src/usr.bin/gprof/gprof.1
@@ -1,47 +1,53 @@
-.\" Copyright (c) 1983 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1983, 1990 The Regents of the University of California.
+.\" All rights reserved.
  .\"
  .\"
-.\"    @(#)gprof.1     6.4 (Berkeley) %G%
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.TH GPROF 1 ""
-.UC 5
-.SH NAME
-gprof \- display call graph profile data
-.SH SYNOPSIS
-.B gprof
-[ options ] [ a.out [ gmon.out ... ] ]
-.SH DESCRIPTION
-.I gprof
+.\"     @(#)gprof.1    6.5 (Berkeley) %G%
+.\"
+.Dd 
+.Dt GPROF 1
+.Os BSD 4.2
+.Sh NAME
+.Nm gprof
+.Nd display call graph profile data
+.Sh SYNOPSIS
+.Nm gprof
+.Op options
+.Op Ar a.out Op Ar gmon.out ...
+.Sh DESCRIPTION
+.Nm gprof
  produces an execution profile of C, Pascal, or Fortran77 programs.
  The effect of called routines is incorporated in the profile of each caller.
  The profile data is taken from the call graph profile file
  produces an execution profile of C, Pascal, or Fortran77 programs.
  The effect of called routines is incorporated in the profile of each caller.
  The profile data is taken from the call graph profile file
-.RI ( gmon.out
+.Pf \&( Pa gmon.out
  default) which is created by programs
  default) which is created by programs
-that are compiled with the 
-.B \-pg
-option of 
-.IR cc ,
-.IR pc ,
+that are compiled with the
+.Fl pg
+option of
+.Xr cc 1 ,
+.Xr pc 1 ,
  and
  and
-.IR f77 .
+.Xr f77 1 .
  The
  The
-.B \-pg
-option also links in versions of the library routines 
+.Fl pg
+option also links in versions of the library routines
  that are compiled for profiling.
  that are compiled for profiling.
-The symbol table in the named object file
-.RI ( a.out
-default)
-is read and correlated with the call graph profile file.
+.Nm Gprof
+reads the given object file (the default is
+.Pa a.out)
+and establishes the relation between it's symbol table
+and the call graph profile from
+.Pa gmon.out .
  If more than one profile file is specified,
  the
  If more than one profile file is specified,
  the
-.I gprof
+.Nm gprof
  output shows the sum of the profile information in the given profile files.
  output shows the sum of the profile information in the given profile files.
-.PP
-.I Gprof
+.Pp
+.Nm Gprof
  calculates the amount of time spent in each routine.
  Next, these times are propagated along the edges of the call graph.
  calculates the amount of time spent in each routine.
  Next, these times are propagated along the edges of the call graph.
-Cycles are discovered, and calls into a cycle are made to share the time 
+Cycles are discovered, and calls into a cycle are made to share the time
  of the cycle.
  The first listing shows the functions
  sorted according to the time they represent
  of the cycle.
  The first listing shows the functions
  sorted according to the time they represent
@@ -50,161 +56,175 @@ Below each function entry is shown its (direct) call graph children,
  and how their times are propagated to this function.
  A similar display above the function shows how this function's time and the
  time of its descendents is propagated to its (direct) call graph parents.
  and how their times are propagated to this function.
  A similar display above the function shows how this function's time and the
  time of its descendents is propagated to its (direct) call graph parents.
-.PP
+.Pp
  Cycles are also shown, with an entry for the cycle as a whole and
  a listing of the members of the cycle and their contributions to the
  time and call counts of the cycle.
  Cycles are also shown, with an entry for the cycle as a whole and
  a listing of the members of the cycle and their contributions to the
  time and call counts of the cycle.
-.PP
+.Pp
  Second, a flat profile is given,
  similar to that provided by
  Second, a flat profile is given,
  similar to that provided by
-.IR prof (1).
+.Xr prof  1  .
  This listing gives the total execution times, the call counts,
  This listing gives the total execution times, the call counts,
-the number of milliseconds per call in the routine itself, and
-the number of milliseconds per call in the routine itself including
+the time in milleseconds the call spent in the routine itself, and
+the time in milleseconds the call spent in the routine itself including
  its descendents.
  its descendents.
-.PP
+.Pp
  Finally, an index of the function names is provided.
  Finally, an index of the function names is provided.
-.PP
+.Pp
  The following options are available:
  The following options are available:
-.TP
-.B \-a
+.Tw Fl
+.Tp Fl a
  suppresses the printing of statically declared functions.
  If this option is given, all relevant information about the static function
  suppresses the printing of statically declared functions.
  If this option is given, all relevant information about the static function
-.RI ( e.g.,
-time samples, calls to other functions, calls from other functions)
+(e.g., time samples, calls to other functions, calls from other functions)
  belongs to the function loaded just before the static function in the
  belongs to the function loaded just before the static function in the
-.I a.out
+.Pa a.out
  file.
  file.
-.TP
-.B \-b
+.Tp Fl b
  suppresses the printing of a description of each field in the profile.
  suppresses the printing of a description of each field in the profile.
-.TP
-.B \-c
+.Tp Fl c
  the static call graph of the program is discovered by a heuristic
  that examines the text space of the object file.
  Static-only parents or children are shown
  with call counts of 0.
  the static call graph of the program is discovered by a heuristic
  that examines the text space of the object file.
  Static-only parents or children are shown
  with call counts of 0.
-.TP
-.BI \-e " name"
+.Tc Fl e
+.Ws
+.Ar name
+.Cx
  suppresses the printing of the graph profile entry for routine
  suppresses the printing of the graph profile entry for routine
-.I name
+.Ar name
  and all its descendants
  (unless they have other ancestors that aren't suppressed).
  More than one
  and all its descendants
  (unless they have other ancestors that aren't suppressed).
  More than one
-.B \-e
+.Fl e
  option may be given.
  Only one
  option may be given.
  Only one
-.I name
+.Ar name
  may be given with each
  may be given with each
-.B \-e
+.Fl e
  option.
  option.
-.TP
-.BI \-E " name"
+.Tc Fl E
+.Ws
+.Ar name
+.Cx
  suppresses the printing of the graph profile entry for routine
  suppresses the printing of the graph profile entry for routine
-.I name
-(and its descendants) as 
-.BR \-e ,
+.Ar name
+(and its descendants) as
+.Fl e  ,
  above, and also excludes the time spent in
  above, and also excludes the time spent in
-.I name
+.Ar name
  (and its descendants) from the total and percentage time computations.
  (For example,
  (and its descendants) from the total and percentage time computations.
  (For example,
-.B \-E
-.I mcount
-.B \-E
-.I mcleanup
+.Fl E
+.Ar mcount
+.Fl E
+.Ar mcleanup
  is the default.)
  is the default.)
-.TP
-.BI \-f " name"
+.Tc Fl f
+.Ws
+.Ar name
+.Cx
  prints the graph profile entry of only the specified routine
  prints the graph profile entry of only the specified routine
-.I name
+.Ar name
  and its descendants.
  More than one
  and its descendants.
  More than one
-.B \-f
+.Fl f
  option may be given.
  Only one
  option may be given.
  Only one
-.I name
+.Ar name
  may be given with each
  may be given with each
-.B \-f
+.Fl f
  option.
  option.
-.TP
-.BI \-F " name"
+.Tc Fl F
+.Ws
+.Ar name
+.Cx
  prints the graph profile entry of only the routine
  prints the graph profile entry of only the routine
-.I name
-and its descendants (as 
-.BR \-f,
+.Ar name
+and its descendants (as
+.Fl f ,
  above) and also uses only the times of the printed routines
  in total time and percentage computations.
  More than one
  above) and also uses only the times of the printed routines
  in total time and percentage computations.
  More than one
-.B \-F
+.Fl F
  option may be given.
  Only one
  option may be given.
  Only one
-.I name
+.Ar name
  may be given with each
  may be given with each
-.B \-F
+.Fl F
  option.
  The
  option.
  The
-.B \-F
+.Fl F
  option
  overrides
  the
  option
  overrides
  the
-.B \-E
+.Fl E
  option.
  option.
-.TP
-.BI \-k " fromname toname"
+.Tc Fl k
+.Ws
+.Ar fromname
+.Ws
+.Ar toname
+.Cx
  will delete any arcs from routine
  will delete any arcs from routine
-.I fromname
+.Ar fromname
  to routine
  to routine
-.IR toname .
+.Ar toname  .
  This can be used to break undesired cycles.
  More than one
  This can be used to break undesired cycles.
  More than one
-.B \-k
+.Fl k
  option may be given.
  Only one pair of routine names may be given with each
  option may be given.
  Only one pair of routine names may be given with each
-.B \-k
+.Fl k
  option.
  option.
-.TP
-.B \-s
+.Tp Fl s
  a profile file
  a profile file
-.I gmon.sum
+.Pa gmon.sum
  is produced that represents
  the sum of the profile information in all the specified profile files.
  This summary profile file may be given to later
  executions of gprof (probably also with a
  is produced that represents
  the sum of the profile information in all the specified profile files.
  This summary profile file may be given to later
  executions of gprof (probably also with a
-.BR \-s )
+.Fl s  )
  to accumulate profile data across several runs of an
  to accumulate profile data across several runs of an
-.I a.out
+.Pa a.out
  file.
  file.
-.TP
-.B \-z
+.Tp Fl z
  displays routines that have zero usage (as shown by call counts
  and accumulated time).
  displays routines that have zero usage (as shown by call counts
  and accumulated time).
-This is useful with the 
-.B \-c
+This is useful with the
+.Fl c
  option for discovering which routines were never called.
  option for discovering which routines were never called.
-.SH FILES
-.ta 1.5i
-.I a.out       
+.Tp
+.Sh FILES
+.Dw gmon.sum
+.Di L
+.Dp Pa a.out
  the namelist and text space.
  the namelist and text space.
-.br
-.I gmon.out    
+.Dp Pa gmon.out
  dynamic call graph and profile.
  dynamic call graph and profile.
-.br
-.I gmon.sum    
+.Dp Pa gmon.sum
  summarized dynamic call graph and profile.
  summarized dynamic call graph and profile.
-.SH "SEE ALSO"
-monitor(3), profil(2), cc(1), prof(1)
+.Dp
+.Sh SEE ALSO
+.Xr monitor 3 ,
+.Xr profil 2 ,
+.Xr cc 1 ,
+.Xr prof 1
  .br
  .br
-``An Execution Profiler for Modular Programs'', by
+.Em An Execution Profiler for Modular Programs ,
+by
  S. Graham, P. Kessler, M. McKusick;
  S. Graham, P. Kessler, M. McKusick;
-\fISoftware - Practice and Experience, Vol 13\fP,
-pp 671-685, 1983.
+Software  - Practice and Experience,
+Vol. 13, pp. 671-685, 1983.
  .br
  .br
-``gprof: A Call Graph Execution Profiler'', by
-S. Graham, P. Kessler, M. McKusick;
-.IR "Proceedings of the SIGPLAN '82 Symposium on Compiler Construction" ,
-SIGPLAN Notices, Vol. 17, No. 6, pp. 120-126, June 1982.
-.SH BUGS
-Beware of quantization errors.
+.Em gprof: A Call Graph Execution Profiler ,
+by S. Graham, P. Kessler, M. McKusick;
+Proceedings of the SIGPLAN '82 Symposium on Compiler Construction,
+SIGPLAN Notices, Vol. 17, No  6, pp. 120-126, June 1982.
+.Sh HISTORY
+.Nm Gprof
+appeared in 4.2 BSD.
+.Sh BUGS
  The granularity of the sampling is shown, but remains
  statistical at best.
  We assume that the time for each execution of a function
  The granularity of the sampling is shown, but remains
  statistical at best.
  We assume that the time for each execution of a function
@@ -213,18 +233,20 @@ by the number of times the function is called.
  Thus the time propagated along the call graph arcs to the function's
  parents is directly proportional to the number of times that
  arc is traversed.
  Thus the time propagated along the call graph arcs to the function's
  parents is directly proportional to the number of times that
  arc is traversed.
-.PP
-Parents that are not themselves profiled will have the time of 
+.Pp
+Parents that are not themselves profiled will have the time of
  their profiled children propagated to them, but they will appear
  to be spontaneously invoked in the call graph listing, and will
  not have their time propagated further.
  Similarly, signal catchers, even though profiled, will appear
  to be spontaneous (although for more obscure reasons).
  Any profiled children of signal catchers should have their times
  their profiled children propagated to them, but they will appear
  to be spontaneously invoked in the call graph listing, and will
  not have their time propagated further.
  Similarly, signal catchers, even though profiled, will appear
  to be spontaneous (although for more obscure reasons).
  Any profiled children of signal catchers should have their times
-propagated properly, unless the signal catcher was invoked during 
+propagated properly, unless the signal catcher was invoked during
  the execution of the profiling routine, in which case all is lost.
  the execution of the profiling routine, in which case all is lost.
-.PP
-The profiled program must call 
-.IR exit (2)
+.Pp
+The profiled program must call
+.Xr exit  2
  or return normally for the profiling information to be saved
  or return normally for the profiling information to be saved
-in the gmon.out file.
+in the
+.Pa gmon.out
+file.
diff --git a/usr/src/usr.bin/graph/graph.1 b/usr/src/usr.bin/graph/graph.1

index 9a5748d..3eb25ba 100644 (file)
--- a/usr/src/usr.bin/graph/graph.1
+++ b/usr/src/usr.bin/graph/graph.1
@@ -1,23 +1,30 @@
-.\"    @(#)graph.1     6.1 (Berkeley) %G%
+.\" Copyright (c) 1990 Regents of the University of California.
+.\" All rights reserved.  The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.
  .\"
  .\"
-.TH GRAPH 1G ""
-.AT 3
-.SH NAME
-graph \- draw a graph
-.SH SYNOPSIS
-.B graph
-[ option ] ...
-.SH DESCRIPTION
-.I Graph
+.\"     @(#)graph.1    6.2 (Berkeley) %G%
+.\"
+.Dd 
+.Dt GRAPH 1
+.Os ATT 7th
+.Sh NAME
+.Nm graph
+.Nd draw a graph
+.Sh SYNOPSIS
+.Nm graph
+.Op option
+\&...
+.Sh DESCRIPTION
+.Nm Graph
  with no options takes pairs of numbers from the
  standard input as abscissas and
  ordinates of a graph.
  Successive points are connected by straight lines.
  The graph is encoded on the standard output
  for display by the
  with no options takes pairs of numbers from the
  standard input as abscissas and
  ordinates of a graph.
  Successive points are connected by straight lines.
  The graph is encoded on the standard output
  for display by the
-.IR  plot (1G)
+.Xr plot 1
  filters.
  filters.
-.PP
+.Pp
  If the coordinates of a point are followed by
  a nonnumeric string, that string is printed as a
  label beginning on the point.
  If the coordinates of a point are followed by
  a nonnumeric string, that string is printed as a
  label beginning on the point.
@@ -25,91 +32,89 @@ Labels may be surrounded with quotes "...", in
  which case they may be empty or contain blanks
  and numbers;
  labels never contain newlines.
  which case they may be empty or contain blanks
  and numbers;
  labels never contain newlines.
-.PP
+.Pp
  The following options are recognized,
  each as a separate argument.
  The following options are recognized,
  each as a separate argument.
-.TP
-.B  \-a
+.Tw Fl
+.Tp Fl a
  Supply abscissas automatically (they are missing from
  the input); spacing is given by the next
  argument (default 1).
  A second optional argument is the starting point for
  automatic abscissas (default 0 or lower limit given by
  Supply abscissas automatically (they are missing from
  the input); spacing is given by the next
  argument (default 1).
  A second optional argument is the starting point for
  automatic abscissas (default 0 or lower limit given by
-.BR \-x ).
-.TP
-.B  \-b
+.Fl x  ) .
+.Tp Fl b
  Break (disconnect) the graph after each label in the input.
  Break (disconnect) the graph after each label in the input.
-.TP
-.B  \-c
+.Tp Fl c
  Character string given by next argument
  is default label for each point.
  Character string given by next argument
  is default label for each point.
-.TP
-.B  \-g
+.Tp Fl g
  Next argument is grid style,
  0 no grid, 1 frame with ticks, 2 full grid (default).
  Next argument is grid style,
  0 no grid, 1 frame with ticks, 2 full grid (default).
-.TP
-.B  \-l
+.Tp Fl l
  Next argument is label for graph.
  Next argument is label for graph.
-.TP
-.B  \-m
+.Tp Fl m
  Next argument is mode (style)
  of connecting lines:
  0 disconnected, 1 connected (default).
  Some devices give distinguishable line styles
  for other small integers.
  Next argument is mode (style)
  of connecting lines:
  0 disconnected, 1 connected (default).
  Some devices give distinguishable line styles
  for other small integers.
-.TP
-.B  \-s
+.Tp Fl s
  Save screen, don't erase before plotting.
  Save screen, don't erase before plotting.
-.TP
-\fB\-x\fR [ \fBl\fR ]
+.Tc Fl x
+.Ws
+.Op Ar l
+.Cx
  If
  If
-.B l
+.Ar l
  is present, x axis is logarithmic.
  Next 1 (or 2) arguments are lower (and upper)
  is present, x axis is logarithmic.
  Next 1 (or 2) arguments are lower (and upper)
-.IR x ""
+.Ar x
  limits.
  limits.
-Third argument, if present, is grid spacing on 
-.I x
+Third argument, if present, is grid spacing on
+.Ar x
  axis.
  Normally these quantities are determined automatically.
  axis.
  Normally these quantities are determined automatically.
-.TP
-\fB\-y\fR [ \fBl\fR ]
+.Tc Fl y
+.Ws
+.Op Ar l
+.Cx
  Similarly for
  Similarly for
-.IR y .
-.TP
-.B  \-h
+.Ar y  .
+.Tp Fl h
  Next argument is fraction of space for height.
  Next argument is fraction of space for height.
-.TP
-.B  \-w
+.Tp Fl w
  Similarly for width.
  Similarly for width.
-.TP
-.B  \-r
+.Tp Fl r
  Next argument is fraction of space to move right before plotting.
  Next argument is fraction of space to move right before plotting.
-.TP
-.B  \-u
+.Tp Fl u
  Similarly to move up before plotting.
  Similarly to move up before plotting.
-.TP
-.B  \-t
+.Tp Fl t
  Transpose horizontal and vertical axes.
  (Option
  Transpose horizontal and vertical axes.
  (Option
-.B \-x
+.Fl x
  now applies to the vertical axis.)
  now applies to the vertical axis.)
-.PP
+.Tp
+.Pp
  A legend indicating grid range is produced
  with a grid unless the
  A legend indicating grid range is produced
  with a grid unless the
-.B \-s
+.Fl s
  option is present.
  option is present.
-.PP
+.Pp
  If a specified lower limit exceeds the upper limit,
  the axis
  is reversed.
  If a specified lower limit exceeds the upper limit,
  the axis
  is reversed.
-.SH "SEE ALSO"
-spline(1G), plot(1G)
-.SH BUGS
-.I Graph
+.Sh SEE ALSO
+.Xr spline 1 ,
+.Xr plot 1
+.Sh HISTORY
+.Nm Plot
+appeared in Version 6 AT&T Unix.
+.Sh BUGS
+.Nm Graph
  stores all points internally and drops those for which
  there isn't room.
  stores all points internally and drops those for which
  there isn't room.
-.br
+.Pp
  Segments that run out of bounds are dropped, not windowed.
  Segments that run out of bounds are dropped, not windowed.
-.br
+.Pp
  Logarithmic axes may not be reversed.
  Logarithmic axes may not be reversed.
diff --git a/usr/src/usr.bin/grep/egrep/grep.1 b/usr/src/usr.bin/grep/egrep/grep.1

index ee2cae1..e3d8077 100644 (file)
--- a/usr/src/usr.bin/grep/egrep/grep.1
+++ b/usr/src/usr.bin/grep/egrep/grep.1
@@ -1,162 +1,222 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
+.\" All rights reserved.
  .\"
  .\"
-.\"    @(#)grep.1      6.3 (Berkeley) %G%
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.TH GREP 1 ""
-.UC 4
-.SH NAME
-grep, egrep, fgrep \- search a file for a pattern
-.SH SYNOPSIS
-.B grep
-[ option ] ...
-expression [ file ] ...
-.LP
-.B egrep 
-[ option ] ...
-[ expression ]
-[ file ] ...
-.LP
-.B fgrep
-[ option ] ...
-[ strings ]
-[ file ]
-.SH DESCRIPTION
-Commands of the
-.I grep
-family search the input
-.I files
-(standard input default) for lines matching a pattern.
-Normally, each line found is copied to the standard output.
-.I Grep
-patterns are limited regular expressions in the style of
-.IR ex (1);
-it uses a compact nondeterministic algorithm.
-.I Egrep
-patterns are full regular expressions; it uses a fast deterministic
-algorithm that sometimes needs exponential space.
-.I Fgrep
-patterns are fixed strings; it is fast and compact.
-The following options are recognized.
-.TP
-.B \-v
-All lines but those matching are printed.
-.TP
-.B \-x
-(Exact) only lines matched in their entirety are printed
-.RI ( fgrep
+.\"     @(#)grep.1     6.4 (Berkeley) %G%
+.\"
+.Dd 
+.Dt GREP 1
+.Os BSD 4.4
+.Sh NAME
+.Nm grep
+.Nd file pattern searcher
+.Sh SYNOPSIS
+.Nm grep
+.Op Fl bchilnosvw
+.Op Fl e Ar pattern
+.Ar
+.Nm egrep
+.Op Fl bchilnosv
+.Op Fl e Ar pattern
+.Op Fl f Ar pattern_file
+.Ar
+.Nm fgrep
+.Op Fl bchilnosvx
+.Op Fl e Ar pattern
+.Op Fl f Ar pattern_file
+.Ar
+.Sh DESCRIPTION
+The
+.Nm grep
+utilities search the given input files selecting lines
+which match one or more patterns; the type of patterns is controlled
+by the options specified.
+By default, a pattern
+matches an input line if any regular expression (RE) in the
+pattern matches the input line without its trailing <new-line>.
+A null RE matches every line.
+Each input line that matches at
+least one of the patterns is written to the standard output.
+.Pp
+For simple patterns or
+.Xr ex 1
+or
+.Xr ed 1
+style regular expressions, the
+.Nm grep
+utility is used.
+The
+.Nm egrep
+utility
+can handle extended regular expressions and
+embedded <newline>s in pattern
+.Nm Fgrep
+is quick but is designed to handle fixed strings.
+A fixed string
+is a string of characters,
+each character
+is matched only by itself.
+The pattern
+value can consist of multiple lines with
+embedded <newline>s.
+In this case, the <newline>s
+act as alternation characters, allowing any of the
+pattern lines to match a portion of the input.
+.Pp
+The following options are available:
+.Pp
+.Tw Fl
+.Tp Fl b
+The block number on the disk in which a matched pattern is located
+is displayed in front of the respective matched line.
+.Tp Fl c
+Only a count of selected lines is written to standard
+output.
+.Tc Fl e
+.Ws
+.Ar expression
+.Cx
+Specify a pattern used during the search of the
+input.
+Multiple
+.Fl e
+options can be used to specify
+multiple patterns; an input line is selected of it
+matches any of the specified patterns.
+.Tc Fl f
+.Ws
+.Ar pattern_file
+.Cx
+The pattern is read from the file named by the
+pathname pattern_file.
+Trailing newlines
+in the pattern_file are ignored.
+.Pf \&( Nm egrep
+and
+.Nm fgrep
  only).
  only).
-.TP
-.B \-c
-Only a count of matching lines is printed.
-.TP
-.B \-l
-The names of files with matching lines are listed (once) separated by newlines.
-.TP
-.B \-n
-Each line is preceded by its relative line number in the file.
-.TP
-.B \-b
-Each line is preceded by the block number on which it was found.
-This is sometimes useful in locating disk block numbers by context.
-.TP
-.B \-h
+.Tp Fl h
  Never print filename headers with output lines.
  Never print filename headers with output lines.
-.TP
-.B \-o
-Always print filename headers with output lines.
-.TP
-.B \-i
-The case of letters is ignored in making comparisons \(em that is, upper and
+.Tp Fl i
+The case of letters is ignored in making comparisons \- that is, upper and
  lower case are considered identical.
  lower case are considered identical.
-.TP
-.B \-s
+.Tp Fl l
+Only the names of files containing selected lines
+are written to standard output.
+Pathnames are
+listed once per file searched.
+If the standard
+input is searched, the pathname
+.Fl
+is written.
+.Tp Fl n
+Each output line is preceded by its relative line
+number in the file; each file starting at line 1.
+The line number counter is reset for each file processed.
+This option is ignored if
+.Fl c ,
+.Fl l ,
+or
+.Fl s
+is
+specified.
+.Tp Fl o
+Always print filename headers with output lines.
+.Tp Fl s
  Silent mode.  Nothing is printed (except error messages).
  This is useful for checking the error status.
  Silent mode.  Nothing is printed (except error messages).
  This is useful for checking the error status.
-.TP
-.B \-w
+.Tp Fl v
+Selected lines are those
+.Em not
+matching the specified
+patterns.
+.Tp Fl x
+Only input lines selected against an entire fixed
+string or regular expression are considered to be
+matching lines.
+.Pf \&( Nm fgrep
+only).
+.Tp Fl w
  The expression is searched for as a word
  (as if surrounded by `\e<' and `\e>', see
  The expression is searched for as a word
  (as if surrounded by `\e<' and `\e>', see
-.IR ex (1).)
-(\fIgrep\fR\| only)
-.TP
-.BI \-e " expression"
-Same as a simple
-.I expression 
-argument, but useful when the
-.I expression
-begins with a \-.
-.TP
-.BI \-f " file"
-The regular expression (\fIegrep\fP) or string list
-.RI ( fgrep ) 
-is taken from the
-.I file.
-.LP
-In all cases the file name is shown if there is more than one input file.
-Care should be taken when using the characters $ * [ ^ | ( ) and \\ in the
-.I expression
-as they are also meaningful to the Shell.  It is safest to enclose the entire
-.I expression
-argument in single quotes \' \'.
-.LP
-.I Fgrep
-searches for lines that contain one of the (newline-separated)
-.I strings.
-.LP
-.I Egrep
-accepts extended regular expressions.
-In the following description `character' excludes newline:
-.IP
-A \e followed by a single character other than newline matches that character.
-.IP
-The character ^ matches the beginning of a line.
-.IP
-The character $ matches the end of a line.
-.IP
-A 
-.B .
-(period) matches any character.
-.IP
-A single character not otherwise endowed with special
-meaning matches that character.
-.IP
-A string enclosed in brackets [\|] matches any single character from the string.
-Ranges of ASCII character codes may be abbreviated as in `a\-z0\-9'.
-A ]
-may occur only as the first character of the string.
-A literal \- must be placed where it can't be mistaken as a range indicator.
-.IP
-A regular expression followed by an * (asterisk) matches a sequence of 0
-or more matches of the regular expression.
-A regular expression followed by a + (plus) matches a sequence of 1 or more
-matches of the regular expression.
-A regular expression followed by a ? (question mark) matches a sequence of
-0 or 1 matches of the regular expression.
-.IP
-Two regular expressions concatenated match a match of the first followed
-by a match of the second.
-.IP
-Two regular expressions separated by | or newline
-match either a match for the first or a match for the second.
-.IP
-A regular expression enclosed in parentheses
-matches a match for the regular expression.
-.LP
-The order of precedence of operators at the same parenthesis level
-is [\|] then *+? then concatenation then | and newline.
-.LP
-Ideally there should be only one
-.I grep,
-but we don't know a single algorithm that spans a wide enough
-range of space-time tradeoffs.
-.SH "SEE ALSO"
-ex(1),
-sed(1),
-sh(1)
-.SH DIAGNOSTICS
-Exit status is 0 if any matches are found,
-1 if none, 2 for syntax errors or inaccessible files.
-.SH BUGS
+.Xr ex  1  . )
+.Pf \&( Nm grep
+only)
+.Pp
+.Tp
+If no file arguments are specified, the
+standard input is used.
+.Pp
+The
+.Nm grep
+utility exits with one of the following values:
+.Tw Ds
+.Tp Li \&0
+One or more lines were selected.
+.Tp Li \&1
+No lines were selected.
+.Tp Li \&>1
+An error occurred.
+.Tp
+.Sh EXTENDED REGULAR EXPRESSIONS
+The following characters are interpreted by
+.Nm egrep :
+.Tw Ds
+.Tp Cm \&$
+Align the match from the end of the line.
+.Tp Cm \&^
+Align the match from the beginning of the line.
+.Tp Cm \&|
+Add another pattern (see example below).
+.Tp Cm \&?
+Match 1 or less sequential repetitions of the pattern.
+.Tp Cm \&+
+Match 1 or more sequential repetitions of the pattern.
+.Tp Cm \&*
+Match 0 or more sequential repetitions of the pattern.
+.Tp Cm \&[]
+Match any single character or range of characters
+enclosed in the brackets.
+.Tp Cm \&\e
+Escape special characters which have meaning to
+.Nm egrep ,
+the set of {$,.,^,[,],|,?,+,*,(,)}.
+.Tp
+.Sh EXAMPLES
+To find all occurances of the word patricia in a file:
+.Dl grep patricia myfile
+.Pp
+To find all occurences to the pattern
+.Sq Li \&.Pp
+at the beginning of a line:
+.Dl grep '^\e.Pp'
+.Pp
+The apostrophys assure the entire expression is evaluated by
+.Nm grep
+instead of by the
+users shell.
+The carat or hat
+.Sq Li \&^
+means
+.Em from the beginning of a line ,
+and the
+.Sq Li \&\e
+escapes the
+.Sq Li \&.
+which would otherwise match any character.
+.Pp
+A simple example of an extended regular expression:
+.Dl egrep '19|20|25' calendar
+.Pp
+Peruses the file calendar looking for either 19, 20
+or 25.
+.Sh SEE ALSO
+.Xr ed 1 ,
+.Xr ex 1 ,
+.Xr sed 1
+.Sh HISTORY
+.Nm Grep
+appeared in Version 6 AT&T Unix.
+.Sh BUGS
  Lines are limited to 256 characters; longer lines are truncated.
  Lines are limited to 256 characters; longer lines are truncated.
diff --git a/usr/src/usr.bin/head/head.1 b/usr/src/usr.bin/head/head.1

index 688e864..5f8c714 100644 (file)
--- a/usr/src/usr.bin/head/head.1
+++ b/usr/src/usr.bin/head/head.1
@@ -1,39 +1,32 @@
-.\" Copyright (c) 1980 The Regents of the University of California.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
  .\" All rights reserved.
  .\"
  .\" All rights reserved.
  .\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.\"    @(#)head.1      6.2 (Berkeley) %G%
+.\"     @(#)head.1     6.3 (Berkeley) %G%
  .\"
  .\"
-.UC 7
-.TH HEAD 1 ""
-.UC
-.SH NAME
-head \- give first few lines
-.SH SYNOPSIS
-.B head
-[
-.BR \- count
-] [
-file ...
-]
-.SH DESCRIPTION
+.Dd 
+.Os BSD 4.4
+.Dt HEAD 1
+.Sh NAME
+.Nm head
+.Nd give first few lines
+.Sh SYNOPSIS
+.Nm head
+.Oo
+.Op Fl Ar count
+.Oo
+.Ar
+.Sh DESCRIPTION
  This filter gives the first
  This filter gives the first
-.I count
+.Ar count
  lines of each of the specified files, or of the standard input.
  If
  lines of each of the specified files, or of the standard input.
  If
-.I count
+.Ar count
  is omitted it defaults to
  10.
  is omitted it defaults to
  10.
-.SH SEE\ ALSO
-tail(1)
+.Sh SEE ALSO
+.Xr tail 1
+.Sh HISTORY
+.Nm head
+appeared in 3 BSD.
diff --git a/usr/src/usr.bin/hexdump/hexdump.1 b/usr/src/usr.bin/hexdump/hexdump.1

index 0ebdbfe..b89eee2 100644 (file)
--- a/usr/src/usr.bin/hexdump/hexdump.1
+++ b/usr/src/usr.bin/hexdump/hexdump.1
@@ -1,3 +1,11 @@
+.\" Copyright (c) 1990 The Regents of the University of California.
+.\" All rights reserved.
+.\"
+.\" %sccs.include.redist.man%
+.\"
+.\"     @(#)hexdump.1  5.7 (Berkeley) %G%
+.\"
+.Dd 
  .\" Copyright (c) 1989 The Regents of the University of California.
  .\" All rights reserved.
  .\"
  .\" Copyright (c) 1989 The Regents of the University of California.
  .\" All rights reserved.
  .\"
@@ -13,179 +21,168 @@
  .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
  .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  .\"
  .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
  .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  .\"
-.\"    @(#)hexdump.1   5.6 (Berkeley) %G%
+.\"    @(#)hex.1       5.6 (Berkeley) 5/8/90
  .\"
  .\"
-.TH HEXDUMP 1 ""
-.UC 7
-.SH NAME
-hexdump - ascii, decimal, hexadecimal, octal dump
-.SH SYNOPSIS
-hexdump
-.ft B
-[
-.I -bcdovx
-.ft B
-] [
-.I -e format_string
-.ft B
-] [
-.I -f format_file
-.ft B
-] [
-.I -n length
-.ft B
-] [
-.I -s skip
-.ft B
-] [
-.I file ...
-.ft B
-]
-.ft R
-.SH DESCRIPTION
+.Dt HEXDUMP 1
+.Os BSD 4.4
+.Sh NAME
+.Nm hexdump
+.Nd ascii, decimal, hexadecimal, octal dump
+.Sh SYNOPSIS
+.Ar hexdump
+.Op Fl bcdovx
+.Op Fl e format_string
+.Op Fl f format_file
+.Op Fl n length
+.Op Fl s skip
+.Op
+.Ar file  . . .
+.Sh DESCRIPTION
  The hexdump utility is a filter that displays the specified files, or
  the standard input, if no files are specified, in a user specified
  format.
  The hexdump utility is a filter that displays the specified files, or
  the standard input, if no files are specified, in a user specified
  format.
-.PP
+.Pp
  The options are as follows:
  The options are as follows:
-.TP
+.Tp
  -b
  One-byte octal display.
  -b
  One-byte octal display.
-.sp
+.Pp
  Display the input offset in hexadecimal, followed by sixteen
  space-separated, three column, zero-filled, bytes of input data,
  in octal, per line.
  Display the input offset in hexadecimal, followed by sixteen
  space-separated, three column, zero-filled, bytes of input data,
  in octal, per line.
-.TP
+.Tp
  -c
  One-byte character display.
  -c
  One-byte character display.
-.sp
+.Pp
  Display the input offset in hexadecimal, followed by sixteen
  space-separated, three column, space-filled, characters of input
  data per line.
  Display the input offset in hexadecimal, followed by sixteen
  space-separated, three column, space-filled, characters of input
  data per line.
-.TP
+.Tp
  -d
  Two-byte decimal display.
  -d
  Two-byte decimal display.
-.sp
+.Pp
  Display the input offset in hexadecimal, followed by eight
  space-separated, five column, zero-filled, two-byte units
  of input data, in unsigned decimal, per line.
  Display the input offset in hexadecimal, followed by eight
  space-separated, five column, zero-filled, two-byte units
  of input data, in unsigned decimal, per line.
-.TP
+.Tp
  -e
  Specify a format string to be used for displaying data.
  -e
  Specify a format string to be used for displaying data.
-.TP
+.Tp
  -f
  Specify a file that contains one or more newline separated format strings.
  Empty lines and lines whose first non-blank character is a hash mark
  (#) are ignored.
  -f
  Specify a file that contains one or more newline separated format strings.
  Empty lines and lines whose first non-blank character is a hash mark
  (#) are ignored.
-.TP
+.Tp
  -n
  Interpret only
  -n
  Interpret only
-.I length
+.Ar length
  bytes of input.
  bytes of input.
-.TP
+.Tp
  -o
  Two-byte octal display.
  -o
  Two-byte octal display.
-.sp
+.Pp
  Display the input offset in hexadecimal, followed by eight
  space-separated, six column, zero-filled, two byte quantities of
  input data, in octal, per line.
  Display the input offset in hexadecimal, followed by eight
  space-separated, six column, zero-filled, two byte quantities of
  input data, in octal, per line.
-.TP
+.Tp
  -s
  Skip
  -s
  Skip
-.I offset
+.Ar offset
  bytes from the beginning of the input.
  By default,
  bytes from the beginning of the input.
  By default,
-.I offset
+.Ar offset
  is interpreted as a decimal number.
  With a leading ``0x'' or ``0X'',
  is interpreted as a decimal number.
  With a leading ``0x'' or ``0X'',
-.I offset
+.Ar offset
  is interpreted as a hexadecimal number,
  otherwise, with a leading ``0'',
  is interpreted as a hexadecimal number,
  otherwise, with a leading ``0'',
-.I offset
+.Ar offset
  is interpreted as an octal number.
  Appending the character ``b'', ``k'', or ``m'' to
  is interpreted as an octal number.
  Appending the character ``b'', ``k'', or ``m'' to
-.I offset
+.Ar offset
  causes it to be interpreted as a multiple of 512, 1024, or 1048576,
  respectively.
  causes it to be interpreted as a multiple of 512, 1024, or 1048576,
  respectively.
-.TP
+.Tp
  -v
  The
  -v
  The
-.I -v
+.Fl v
  option causes hexdump to display all input data.
  Without the
  option causes hexdump to display all input data.
  Without the
-.I -v
+.Fl v
  option, any number of groups of output lines, which would be
  identical to the immediately preceding group of output lines (except
  for the input offsets), are replaced with a line comprised of a
  single asterisk.
  option, any number of groups of output lines, which would be
  identical to the immediately preceding group of output lines (except
  for the input offsets), are replaced with a line comprised of a
  single asterisk.
-.TP
+.Tp
  -x
  Two-byte hexadecimal display.
  -x
  Two-byte hexadecimal display.
-.sp
+.Pp
  Display the input offset in hexadecimal, followed by eight, space
  separated, four column, zero-filled, two-byte quantities of input
  data, in hexadecimal, per line.
  Display the input offset in hexadecimal, followed by eight, space
  separated, four column, zero-filled, two-byte quantities of input
  data, in hexadecimal, per line.
-.PP
+.Pp
  For each input file,
  For each input file,
-.I hexdump
+.Nm hexdump
  sequentially copies the input to standard output, transforming the
  data according to the format strings specified by the
  sequentially copies the input to standard output, transforming the
  data according to the format strings specified by the
-.I -e
+.Fl e
  and
  and
-.I -f
+.Fl f
  options, in the order that they were specified.
  options, in the order that they were specified.
-.PP
+.Pp
  A format string contains any number of format units, separated by
  whitespace.
  A format unit contains up to three items: an iteration count, a byte
  count, and a format.
  A format string contains any number of format units, separated by
  whitespace.
  A format unit contains up to three items: an iteration count, a byte
  count, and a format.
-.PP
+.Pp
  The iteration count is an optional positive integer, which defaults to
  one.
  Each format is applied iteration count times.
  The iteration count is an optional positive integer, which defaults to
  one.
  Each format is applied iteration count times.
-.PP
+.Pp
  The byte count is an optional positive integer.
  If specified it defines the number of bytes to be interpreted by
  each iteration of the format.
  The byte count is an optional positive integer.
  If specified it defines the number of bytes to be interpreted by
  each iteration of the format.
-.PP
+.Pp
  If an iteration count and/or a byte count is specified, a single slash
  must be placed after the iteration count and/or before the byte count
  to disambiguate them.
  Any whitespace before or after the slash is ignored.
  If an iteration count and/or a byte count is specified, a single slash
  must be placed after the iteration count and/or before the byte count
  to disambiguate them.
  Any whitespace before or after the slash is ignored.
-.PP
+.Pp
  The format is required and must be surrounded by double quote
  (" ") marks.
  It is interpreted as a fprintf-style format string, with the
  following exceptions:
  The format is required and must be surrounded by double quote
  (" ") marks.
  It is interpreted as a fprintf-style format string, with the
  following exceptions:
-.TP
-.B \(bu
+.Tp
+.Ar \ (bu
  An asterisk (*) may not be used as a field width or precision.
  An asterisk (*) may not be used as a field width or precision.
-.TP
-.B \(bu
+.Tp
+.Ar \ (bu
  A byte count or field precision is required for each ``s'' conversion
  character.
  A byte count or field precision is required for each ``s'' conversion
  character.
-.TP
-.B \(bu
+.Tp
+.Ar \ (bu
  The conversion characters ``h'', ``n'', and ``p'' are not
  supported.
  The conversion characters ``h'', ``n'', and ``p'' are not
  supported.
-.TP
-.B \(bu
+.Tp
+.Ar \ (bu
  The single character escape sequences (\ea, \eb, \ef, \en, \er,
  \et, and \ev) described in the C standard are supported.
  The single character escape sequences (\ea, \eb, \ef, \en, \er,
  \et, and \ev) described in the C standard are supported.
-.PP
+.Pp
  Hexdump also supports the the following additional conversion strings:
  Hexdump also supports the the following additional conversion strings:
-.PP
-.TP
-_a[dox]
+.Pp
+.Tp
+_a
+.Op dox
  Display the input offset, cumulative across input files, of the
  next byte to be displayed.
  The appended characters ``d'', ``o'', and ``x'' specify the display base
  as decimal, octal or hexadecimal respectively.
  Display the input offset, cumulative across input files, of the
  next byte to be displayed.
  The appended characters ``d'', ``o'', and ``x'' specify the display base
  as decimal, octal or hexadecimal respectively.
-.TP
-_A[dox]
+.Tp
+_A
+.Op dox
  Identical to the _a conversion string except that it is only performed
  once, when all of the input data has been processed.
  Identical to the _a conversion string except that it is only performed
  once, when all of the input data has been processed.
-.TP
+.Tp
  _c
  Output characters in the default character set.
  Nonprinting characters are displayed in three character, zero-padded
  _c
  Output characters in the default character set.
  Nonprinting characters are displayed in three character, zero-padded
@@ -203,43 +200,42 @@ NUL       \e0
  <tab>  \et
  <vertical tab> \ev
  .TE
  <tab>  \et
  <vertical tab> \ev
  .TE
-.TP
+.Tp
  _p
  Output characters in the default character set.
  Nonprinting characters are displayed as a single ``.''.
  _p
  Output characters in the default character set.
  Nonprinting characters are displayed as a single ``.''.
-.TP
+.Tp
  _u
  Output US ASCII characters, with the exception that control characters are
  displayed using the following, lower-case, names.
  Characters greater than 0xff, hexadecimal, are displayed as hexadecimal
  strings.
  _u
  Output US ASCII characters, with the exception that control characters are
  displayed using the following, lower-case, names.
  Characters greater than 0xff, hexadecimal, are displayed as hexadecimal
  strings.
-.sp
-.RS
+.Pp
+.Tp
  000 nul  001 soh  002 stx  003 etx  004 eot  005 enq
  006 ack  007 bel  008  bs  009  ht  00A  lf  00B  vt
  00C  ff  00D  cr  00E  so  00F  si  010 dle  011 dc1
  012 dc2  013 dc3  014 dc4  015 nak  016 syn  017 etb
  018 can  019  em  01A sub  01B esc  01C  fs  01D  gs
  01E rs   01F  us  0FF del
  000 nul  001 soh  002 stx  003 etx  004 eot  005 enq
  006 ack  007 bel  008  bs  009  ht  00A  lf  00B  vt
  00C  ff  00D  cr  00E  so  00F  si  010 dle  011 dc1
  012 dc2  013 dc3  014 dc4  015 nak  016 syn  017 etb
  018 can  019  em  01A sub  01B esc  01C  fs  01D  gs
  01E rs   01F  us  0FF del
-.RE
-.PP
+.Tp Pp
  The default and supported byte counts for the conversion characters
  are as follows:
  The default and supported byte counts for the conversion characters
  are as follows:
-.TP
+.Tp
  "%_c, %_p, %_u, %c"
  One byte counts only.
  "%_c, %_p, %_u, %c"
  One byte counts only.
-.TP
+.Tp
  "%d, %i, %o, %u, %X, %x"
  Four byte default, one and two byte counts supported.
  "%d, %i, %o, %u, %X, %x"
  Four byte default, one and two byte counts supported.
-.TP
+.Tp
  "%E, %e, %f, %G, %g"
  Eight byte default, four byte counts supported.
  "%E, %e, %f, %G, %g"
  Eight byte default, four byte counts supported.
-.PP
+.Pp
  The amount of data interpreted by each format string is the sum of the
  data required by each format unit, which is the iteration count times the
  byte count, or the iteration count times the number of bytes required by
  the format if the byte count is not specified.
  The amount of data interpreted by each format string is the sum of the
  data required by each format unit, which is the iteration count times the
  byte count, or the iteration count times the number of bytes required by
  the format if the byte count is not specified.
-.PP
+.Pp
  The input is manipulated in ``blocks'', where a block is defined as the
  largest amount of data specified by any format string.
  Format strings interpreting less than an input block's worth of data,
  The input is manipulated in ``blocks'', where a block is defined as the
  largest amount of data specified by any format string.
  Format strings interpreting less than an input block's worth of data,
@@ -247,23 +243,23 @@ whose last format unit both interprets some number of bytes and does
  not have a specified iteration count, have the the interation count
  incremented until the entire input block has been processed or there
  is not enough data remaining in the block to satisfy the format string.
  not have a specified iteration count, have the the interation count
  incremented until the entire input block has been processed or there
  is not enough data remaining in the block to satisfy the format string.
-.PP
+.Pp
  If, either as a result of user specification or hexdump modifying
  the iteration count as described above, an iteration count is
  greater than one, no trailing whitespace characters are output
  during the last iteration.
  If, either as a result of user specification or hexdump modifying
  the iteration count as described above, an iteration count is
  greater than one, no trailing whitespace characters are output
  during the last iteration.
-.PP
+.Pp
  It is an error to specify a byte count as well as multiple conversion
  characters or strings unless all but one of the conversion characters
  or strings is ``_a'' or ``_A''.
  It is an error to specify a byte count as well as multiple conversion
  characters or strings unless all but one of the conversion characters
  or strings is ``_a'' or ``_A''.
-.PP
+.Pp
  If, as a result of the specification of the
  If, as a result of the specification of the
-.I -n
+.Fl n
  option or end-of-file being reached, input data only partially
  satisfies a format string, the input block is zero-padded sufficiently
  to display all available data (i.e. any format units overlapping the
  end of data will display some number of the zero bytes).
  option or end-of-file being reached, input data only partially
  satisfies a format string, the input block is zero-padded sufficiently
  to display all available data (i.e. any format units overlapping the
  end of data will display some number of the zero bytes).
-.PP
+.Pp
  Further output by such format strings is replaced by an equivalent
  number of spaces.
  An equivalent number of spaces is defined as the number of spaces
  Further output by such format strings is replaced by an equivalent
  number of spaces.
  An equivalent number of spaces is defined as the number of spaces
@@ -271,30 +267,38 @@ output by an ``s'' conversion character with the same field width
  and precision as the original conversion character or conversion
  string but with any ``+'', `` '', or ``#'' conversion flag characters
  removed, and referencing a NULL string.
  and precision as the original conversion character or conversion
  string but with any ``+'', `` '', or ``#'' conversion flag characters
  removed, and referencing a NULL string.
-.PP
+.Pp
  If no format strings are specified, the default display is equivalent
  to specifying the
  If no format strings are specified, the default display is equivalent
  to specifying the
-.I -x
+.Fl x
  option.
  option.
-.PP
-.I Hexdump
+.Pp
+.Nm Hexdump
  exits 0 on success and >0 if an error occurred.
  exits 0 on success and >0 if an error occurred.
-.SH EXAMPLES
+.Sh EXAMPLES
  Display the input in perusal format:
  Display the input in perusal format:
-.sp
-.RS
-"%06.6_ao "  12/1 "%3_u "
+.Pp
+.Tp
+"%06.6_ao
+.Ar 12/1 "%3_u "
  .br
  "\et\et" "%_p "
  .br
  "\en"
  .br
  "\et\et" "%_p "
  .br
  "\en"
-.RE
-.PP
+.Tp Pp
  Implement the \-x option:
  Implement the \-x option:
-.sp
-.RS
+.Pp
+.Tp
  "%07.7_Ax\en"
  .br
  "%07.7_Ax\en"
  .br
-"%07.7_ax  " 8/2 "%04x " "\en"
-.RE
-
+"%07.7_ax
+.Ar 8/2 "%04x
+.Ar "\en"
+.Tp
+-PTXX FROM- 4.3
+-ENV USAGE-
+-MANPAGE HISTORY-
+/usr/src/usr.bin/hexdump/odsyntax.c:   while ((ch = getopt(argc, argv, "aBbcDdeFfHhIiLlOoPpswvXx")) != EOF)
+/usr/src/usr.bin/hexdump/hexsyntax.c:  while ((ch = getopt(argc, argv, "bcde:f:n:os:vx")) != EOF)
+/usr/src/usr.bin/hexdump/odsyntax.c:   while ((ch = getopt(argc, argv, "aBbcDdeFfHhIiLlOoPpswvXx")) != EOF)
+/usr/src/usr.bin/hexdump/hexsyntax.c:  while ((ch = getopt(argc, argv, "bcde:f:n:os:vx")) != EOF)
diff --git a/usr/src/usr.bin/join/join.1 b/usr/src/usr.bin/join/join.1

index 8464e2c..a99e42f 100644 (file)
--- a/usr/src/usr.bin/join/join.1
+++ b/usr/src/usr.bin/join/join.1
@@ -1,107 +1,184 @@
-.\"    @(#)join.1      6.1 (Berkeley) %G%
+.\" Copyright (c) 1990 The Regents of the University of California.
+.\" All rights reserved.
  .\"
  .\"
-.TH JOIN 1 ""
-.AT 3
-.SH NAME
-join \- relational database operator
-.SH SYNOPSIS
-.B join
-[
-options
-]
-file1 file2
-.SH DESCRIPTION
-.I Join
-forms, on the standard output,
-a join
-of the two relations specified by the lines of
-.I file1
+.\" %sccs.include.redist.man%
+.\"
+.\"     @(#)join.1     6.2 (Berkeley) %G%
+.\"
+.Dd 
+.Dt JOIN 1
+.Os BSD 4.4
+.Sh NAME
+.Nm join
+.Nd relational database operator
+.Sh SYNOPSIS
+.Nm join
+.Op Fl a Ar file_number
+.Op Fl e Ar string
+.Op Fl j Ar file_number field
+.if n .br
+.Op Fl o Ar list
+.Op Fl t Ar char
+.Op Fl v Ar file_number
+.Ob
+.Fl \&1
+.Ar field
+.Oe
+.Ob
+.Fl \&2
+.Ar field
+.Oe
+.Ar file1
+.if n .br
+.Ar file2
+.Sh DESCRIPTION
+The join utility performs an ``equality join'' on the files
+.Ar file1
+and
+.Ar file2 .
+The joined files are written to the standard
+output.
+.Pp
+The ``join field'' is a field in each file on which the
+files are compared.
+There is one line in the output for
+each pair of lines in
+.Ar file1
  and
  and
-.IR file2 .
-If
-.I file1
-is `\-', the standard input is used.
-.PP
-.I File1
-and 
-.I file2
-must be sorted in increasing ASCII collating
-sequence on the fields
-on which they are to be joined,
-normally the first in each line.
-.PP
-There is one line in the output 
-for each pair of lines in 
-.I file1 
-and 
-.I file2
-that have identical join fields.
-The output line normally consists of the common field,
-then the rest of the line from 
-.IR file1 ,
-then the rest of the line from
-.IR file2 .
-.PP
-Fields are normally separated by blank, tab or newline.
-In this case, multiple separators count as one, and
-leading separators are discarded.
-.PP
-These options are recognized:
-.TP
-.BI \-a n
-In addition to the normal output,
-produce a line for each unpairable line in file
-.IR n ,
-where
-.I n
-is 1 or 2.
-.TP
-.BI \-e \ s
-Replace empty output fields by string
-.IR s .
-.TP
-.BI \-j n\ m
-Join on the
-.IR m th
-field of file
-.IR n .
-If
-.I n
-is missing, use the
-.IR m th
-field in each file.
-.TP
-.BI \-o \ list
+.Ar file2
+which have identical
+join fields.
+The output line by default consists of the
+join field, then the remaining fields from
+.Ar file1 ,
+then the
+remaining fields from
+.Ar file2 .
+This format can be changed by
+using the
+.Fl o
+option (see below).
+.Pp
+The files file1 and file2 should be ordered in the collating
+sequence of
+.Li sort -b
+on the fields on which they are to be
+joined, by default the first in each line; Otherwise, all
+join field matches need not be reported.
+.Pp
+The default input field separators are <blank>s.
+In this
+case, multiple separators count as one field separator, and
+leading separators are ignored.
+The default output field
+separator is a <space>.
+.Pp
+The following options are available:
+.Tw Fl
+.Tc Fl a
+.Ws
+.Ar file_number
+.Cx
+In addition to the default output, produce a line
+for each unpairable line in file file_number, where
+file_number is 1 or 2.
+.Tc Fl e
+.Ws
+.Ar string
+.Cx
+Replace empty output fields by string string.
+.Tc Fl j
+.Ws
+.Ar file_number field
+.Cx
+Join on the fieldth field of file
+file_number.
+If file_number is missing, (i.e., the
+first digit of the option argument is neither 1 nor
+2), use the fieldth field in each file.
+Fields are
+decimal integers starting with 1.
+.Tc Fl o
+.Ws
+.Ar list
+.Cx
  Each output line comprises the fields specified in
  Each output line comprises the fields specified in
-.IR list ,
-each element of which has the form
-.IR n . m ,
-where
-.I n
-is a file number and
-.I m
-is a field number.
-.PP
-.TP
-.BI \-t c
-Use character
-.I c
-as a separator (tab character).
-Every appearance of
-.I c
-in a line is significant.
-.SH "SEE ALSO"
-sort(1), comm(1), awk(1)
-.SH BUGS
-With default field separation,
-the collating sequence is that of
-.IR sort\ \-b ;
-with
-.BR \-t ,
-the sequence is that of a plain sort.
-.PP
+list, each element of which has the form
+file_number.field, where file_number is a file
+number and field is a decimal integer field number.
+The elements of list are either comma or <space> separated.
+The list is written only for lines with matching join fields,
+and is not output unless specifically requested.
+.Tc Fl t
+.Ws
+.Ar char
+.Cx
+Use character char as a separator, for both input
+and output.
+Every appearance of char in a line is
+significant.
+When this option is specified, the
+collating sequence should be the same as sort
+without the -b option.
+.Tc Fl v
+.Ws
+.Ar file_number
+.Cx
+Instead of the default output, produce a line only
+for each unpairable line in file_number, where
+file_number is 1 or 2.
+.Tc Fl 1
+.Ws
+.Ar field
+.Cx
+Join on the fieldth field of file 1.
+Fields are
+decimal integers starting with 1.
+.Tc Fl 2
+.Ws
+.Ar field
+.Cx
+Join on the fieldth field of file 2.
+Fields are
+decimal integers starting with 1.
+.Tp
+.Pp
+If both -a 1 and -a 2 are specified, both sets of information
+are output, -a 2 always first, regardless of the specified
+order.
+.Pp
+The following arguments are required:
+.Tw Fl
+.Tp Ar file1
+.Tp Ar file2
+A pathname of a file to be joined.
+If either of
+the file1 or file2 arguments is
+.Fl
+the standard
+input is used in its place.
+.Pp
+The
+.Nm join
+utility exits 0 on success, and >0 if an error occurs.
+.Sh STANDARDS
+The
+.Nm join
+function is expected to be POSIX 1003.2 compatible.
+.Sh SEE ALSO
+.Xr awk 1
+.Xr comm 1 ,
+.Xr look 1
+.Xr sort 1 ,
+.Xr uniq 1 ,
+.Sh BUGS
  The conventions of
  The conventions of
-.I join, sort, comm, uniq, look
+.Nm
+.Xr join 1 ,
+.Xr comm 1 ,
+.Xr sort 1 ,
+.Xr uniq 1 ,
+.Xr look 1
  and
  and
-.IR awk (1)
+.Xr awk  1
  are wildly incongruous.
  are wildly incongruous.
diff --git a/usr/src/usr.bin/last/last.1 b/usr/src/usr.bin/last/last.1

index 580c0fe..c07ca8a 100644 (file)
--- a/usr/src/usr.bin/last/last.1
+++ b/usr/src/usr.bin/last/last.1
@@ -1,54 +1,98 @@
-.\" Copyright (c) 1980 The Regents of the University of California.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
  .\" All rights reserved.
  .\"
  .\" All rights reserved.
  .\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.\"    @(#)last.1      6.4 (Berkeley) %G%
+.\"     @(#)last.1     6.5 (Berkeley) %G%
  .\"
  .\"
-.TH LAST 1 ""
-.UC 4
-.SH NAME
-last \- indicate last logins of users and ttys
-.SH SYNOPSIS
-\fBlast\fP [-#] [-f file] [-h host] [-t tty] [user ...]
-.SH DESCRIPTION
-\fILast\fP will list the sessions of specified \fIusers,\fP \fIttys,\fP
-and \fIhosts,\fP in reverse time order.  Each line of output contains
+.Dd 
+.Dt LAST 1
+.Os BSD 4
+.Sh NAME
+.Nm last
+.Nd indicate last logins of users and ttys
+.Sh SYNOPSIS
+.Nm last
+.Oo
+.Op Fl Ar \&#
+.Oo
+.Op Fl f Ar file
+.Op Fl h Ar host
+.Op Fl t Ar tty
+.Op user ...
+.Sh DESCRIPTION
+.Nm Last
+will list the sessions of specified
+.Ar users ,
+.Ar ttys ,
+and
+.Ar hosts ,
+in reverse time order.  Each line of output contains
  the user name, the tty from which the session was conducted, any
  hostname, the start and stop times for the session, and the duration
  of the session.  If the session is still continuing or was cut short by
  the user name, the tty from which the session was conducted, any
  hostname, the start and stop times for the session, and the duration
  of the session.  If the session is still continuing or was cut short by
-a crash or shutdown, \fIlast\fP will so indicate.
-.PP
-\fILast\fP reads the file \fIfile\fP, or by default, \fI/usr/adm/wtmp\fP.
-The \fB-#\fP option limits the report to \fB#\fP lines.
-.PP
-Other arguments specify \fIusers,\fP \fIttys\fP or \fIhosts\fP of interest.
+a crash or shutdown,
+.Nm last
+will so indicate.
+.Pp
+.Nm Last
+reads the file
+.Ar file  ,
+or by default,
+.Pa /var/log/wtmp .
+.Tw Ds
+.Tc Fl
+.Ar \&#
+.Cx
+option limits the report to
+.Ar \&#
+lines.
+.Tc Fl t
+.Ws
+.Ar tty
+.Cx
+Specify the
+.Ar tty .
  Tty names may be given fully or abbreviated, e.g., ``last -t 03'' is
  Tty names may be given fully or abbreviated, e.g., ``last -t 03'' is
-equivalent to ``last -t tty03''.  Host names may be internet numbers.  If
+equivalent to ``last -t tty03''.
+.Tc Fl h
+.Ws
+.Ar host
+.Cx
+.Ar Host
+names may be names or internet numbers.
+.Tp
+.Pp
+If
  multiple arguments are given, the information which applies to any of the
  arguments is printed, e.g., ``last root -t console'' would list all of
  ``root's'' sessions as well as all sessions on the console terminal. If no
  multiple arguments are given, the information which applies to any of the
  arguments is printed, e.g., ``last root -t console'' would list all of
  ``root's'' sessions as well as all sessions on the console terminal. If no
-users, hostnames or terminals are specified, \fIlast\fP prints a record of
+users, hostnames or terminals are specified,
+.Nm last
+prints a record of
  all logins and logouts.
  all logins and logouts.
-.PP
-The pseudo-user \fBreboot\fP logs in at reboots of the system, thus
+.Pp
+The pseudo-user
+.Ar reboot
+logs in at reboots of the system, thus
  ``last reboot'' will give an indication of mean time between reboot.
  ``last reboot'' will give an indication of mean time between reboot.
-.PP
-If \fIlast\fP is interrupted, it indicates to what date the search has
-progressed.  If interrupted with a quit signal \fIlast\fP indicates how
+.Pp
+If
+.Nm last
+is interrupted, it indicates to what date the search has
+progressed.  If interrupted with a quit signal .Nm last
+indicates how
  far the search has progressed and then continues.
  far the search has progressed and then continues.
-.SH FILES
-/usr/adm/wtmp          login data base
-.br
-.SH "SEE ALSO"
-lastcomm(1), utmp(5), ac(8)
+.Sh FILES
+.Dw /var/log/wtmp
+.Di L
+.Dp Pa /var/log/wtmp
+login data base
+.Dp
+.Sh SEE ALSO
+.Xr lastcomm 1 ,
+.Xr utmp 5 ,
+.Xr ac 8
+.Sh HISTORY
+.Nm Last
+appeared in 3 BSD.
diff --git a/usr/src/usr.bin/lastcomm/lastcomm.1 b/usr/src/usr.bin/lastcomm/lastcomm.1

index e6b2566..0399ff5 100644 (file)
--- a/usr/src/usr.bin/lastcomm/lastcomm.1
+++ b/usr/src/usr.bin/lastcomm/lastcomm.1
@@ -1,78 +1,87 @@
-.\" Copyright (c) 1980 The Regents of the University of California.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
  .\" All rights reserved.
  .\"
  .\" All rights reserved.
  .\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.\"    @(#)lastcomm.1  6.4 (Berkeley) %G%
+.\"     @(#)lastcomm.1 6.5 (Berkeley) %G%
  .\"
  .\"
-.TH LASTCOMM 1 ""
+.Dd 
+.Dt LASTCOMM 1
  .UC
  .UC
-.SH NAME
-lastcomm \- show last commands executed in reverse order
-.SH SYNOPSIS
-.B lastcomm
-[ -f file ]
-[ command name ] ... [user name] ... [terminal name] ...
-.SH DESCRIPTION
-.I Lastcomm
+.Sh NAME
+.Nm lastcomm
+.Nd show last commands executed in reverse order
+.Sh SYNOPSIS
+.Nm lastcomm
+.Op Fl f Ar file
+.Op Ar command name
+\&...
+.Op Ar user name
+\&...
+.Op Ar terminal name
+\&...
+.Sh DESCRIPTION
+.Nm Lastcomm
  gives information on previously executed commands.
  With no arguments,
  gives information on previously executed commands.
  With no arguments,
-.I lastcomm
+.Nm lastcomm
  prints information about all the commands recorded
  prints information about all the commands recorded
-during the current accounting file's lifetime.  The \fI-f\fP option
-causes \fIlastcomm\fP to read from a file other than the default
+during the current accounting file's lifetime.
+.Tw Ds
+.Tp Fl f
+option
+causes
+.Nm lastcomm
+to read from a file other than the default
  accounting file.
  accounting file.
+.Tp
+.Pp
  If called with arguments, only accounting entries with a
  If called with arguments, only accounting entries with a
-matching command
-name, user name, or terminal name are printed.
-So, for example,
-.ti +0.5i
-lastcomm a.out root ttyd0
-.br
+matching
+.Ar command name ,
+.Ar user name ,
+or
+.Ar terminal name
+are printed.
+So, for example:
+.Dl lastcomm a.out root ttyd0
+.Pp
  would produce a listing of all the
  executions of commands named
  would produce a listing of all the
  executions of commands named
-.I a.out
+.Pa a.out
  by user
  by user
-.I root
+.Ar root
  on the terminal
  on the terminal
-.IR ttyd0 .
-.PP
+.Ar ttyd0  .
+.Pp
  For each process entry, the following are printed.
  For each process entry, the following are printed.
-.in +0.5i
+.Ds I
  The name of the user who ran the process.
  The name of the user who ran the process.
-.br
  Flags, as accumulated by the accounting facilities in the system.
  Flags, as accumulated by the accounting facilities in the system.
-.br
  The command name under which the process was called.
  The command name under which the process was called.
-.br
  The amount of cpu time used by the process (in seconds).
  The amount of cpu time used by the process (in seconds).
-.br
  The time the process exited.
  The time the process exited.
-.in -0.5i
-.PP
+.De
+.Pp
  The flags are encoded as follows: ``S'' indicates the command was
  executed by the super-user, ``F'' indicates the command ran after
  The flags are encoded as follows: ``S'' indicates the command was
  executed by the super-user, ``F'' indicates the command ran after
-a fork, but without a following 
-.IR exec ,
+a fork, but without a following
+.Xr exec ,
  ``C'' indicates the command was run in PDP-11 compatibility mode
  (VAX only),
  ``D'' indicates the command terminated with the generation of a
  ``C'' indicates the command was run in PDP-11 compatibility mode
  (VAX only),
  ``D'' indicates the command terminated with the generation of a
-.I core
+.Pa core
  file, and ``X'' indicates the command was terminated with a signal.
  file, and ``X'' indicates the command was terminated with a signal.
-.SH FILES
-/usr/adm/acct
-.SH "SEE ALSO"
-last(1),
-sigvec(2),
-acct(8),
-core(5)
+.Sh FILES
+.Dw /var/account/acct
+.Di L
+.Dp Pa /var/account/acct
+.Dp
+.Sh SEE ALSO
+.Xr last 1 ,
+.Xr sigvec 2 ,
+.Xr acct 5 ,
+.Xr core 5
+.Sh HISTORY
+.Nm Lastcomm
+appeared in 3 BSD.
diff --git a/usr/src/usr.bin/learn/learn/learn.1 b/usr/src/usr.bin/learn/learn/learn.1

index d8acc1a..a4350ac 100644 (file)
--- a/usr/src/usr.bin/learn/learn/learn.1
+++ b/usr/src/usr.bin/learn/learn/learn.1
@@ -1,59 +1,68 @@
-.\"    @(#)learn.1     6.3 (Berkeley) %G%
+.\" Copyright (c) 1990 Regents of the University of California.
+.\" All rights reserved.  The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.
  .\"
  .\"
-.TH LEARN 1 ""
-.AT 3
-.SH NAME
-learn \- computer aided instruction about UNIX
-.SH SYNOPSIS
-.B learn
-[
-.BR \- directory
-]
-[ subject [ lesson ] ]
-.SH DESCRIPTION
-.I Learn
+.\"     @(#)learn.1    6.4 (Berkeley) %G%
+.\"
+.Dd 
+.Dt LEARN 1
+.Os ATT 7th
+.Sh NAME
+.Nm learn
+.Nd computer aided instruction about UNIX
+.Sh SYNOPSIS
+.Nm learn
+.Oo
+.Op Fl Ar directory
+.Oo
+.Ob Ar subject
+.Op Ar lesson
+.Oe
+.Sh DESCRIPTION
+.Nm Learn
  gives Computer Aided Instruction courses and
  practice in the use of UNIX, the C Shell,
  and the Berkeley text editors.
  To get started simply type
  gives Computer Aided Instruction courses and
  practice in the use of UNIX, the C Shell,
  and the Berkeley text editors.
  To get started simply type
-.BR learn .
+.Nm learn  .
  If you had used
  If you had used
-.I learn
+.Nm learn
  before and left your last session without completing a subject,
  before and left your last session without completing a subject,
-the program will use information in $HOME/.learnrc to start you up
+the program will use information in
+.Pa $HOME/.learnrc
+to start you up
  in the same place you left off.
  Your first time through,
  in the same place you left off.
  Your first time through,
-.I learn
+.Nm learn
  will ask questions to find out what you want to do.
  Some questions may be bypassed by naming a
  will ask questions to find out what you want to do.
  Some questions may be bypassed by naming a
-.IR subject ,
+.Ar subject  ,
  and more yet by naming a
  and more yet by naming a
-.IR lesson .
+.Ar lesson  .
  You may enter the
  You may enter the
-.I lesson
+.Ar lesson
  as a number that
  as a number that
-.I learn
+.Nm learn
  gave you in a previous session.
  If you do not know the lesson number,
  you may enter the
  gave you in a previous session.
  If you do not know the lesson number,
  you may enter the
-.I lesson
+.Ar lesson
  as a word, and
  as a word, and
-.I learn
+.Nm learn
  will look for the first lesson containing it.
  If the
  will look for the first lesson containing it.
  If the
-.I lesson
-is `\fB\-\fP',
-.I learn
+.Ar lesson
+is
+.Sq Fl ,
+.Nm learn
  prompts for each lesson;
  this is useful for debugging.
  prompts for each lesson;
  this is useful for debugging.
-.PP
+.Pp
  The
  The
-.IR subject \|'s
+.Sf Ar subject  \'s
  presently handled are
  presently handled are
-.if n .sp 1v
-.if t .sp .5v
-.nf
-.in +0.5i
+.Pp
+.Ds I
  files
  editor
  vi
  files
  editor
  vi
@@ -61,68 +70,78 @@ morefiles
  macros
  eqn
  C
  macros
  eqn
  C
-.in -0.5i
-.fi
-.PP
+.De
+.Pp
  There are a few special commands.
  There are a few special commands.
-The command `bye' terminates a 
-.I learn
+The command `bye' terminates a
+.Nm learn
  session and `where' tells you of your progress,
  with `where\0m' telling you more.
  The command `again' re-displays the text of the lesson
  session and `where' tells you of your progress,
  with `where\0m' telling you more.
  The command `again' re-displays the text of the lesson
-and `again\0\fIlesson\fP' lets you review
-.IR lesson .
+and `again\0
+.Sf Ar lesson \&'
+lets you review
+.Ar lesson  .
  There is no way for
  There is no way for
-.I learn
+.Nm learn
  to tell you the answers it expects in English, however,
  the command `hint' prints the last part of the lesson script
  used to evaluate a response, while `hint m' prints the
  whole lesson script.
  This is useful for debugging
  lessons and might possibly give you an idea about what it expects.
  to tell you the answers it expects in English, however,
  the command `hint' prints the last part of the lesson script
  used to evaluate a response, while `hint m' prints the
  whole lesson script.
  This is useful for debugging
  lessons and might possibly give you an idea about what it expects.
-.PP
+.Pp
  Normally, lesson scripts are found in the directory /usr/lib/learn.
  The
  Normally, lesson scripts are found in the directory /usr/lib/learn.
  The
-.BI \- directory
+.Fl  directory
  option allows one to specify a nonstandard place to look for scripts.
  option allows one to specify a nonstandard place to look for scripts.
-.SH FILES
-/usr/lib/learn subtree for all dependent directories and files
-.br
-/usr/tmp/pl\(**        playpen directories
-.br
-$HOME/.learnrc startup information
-.SH SEE ALSO
-csh(1), ex(1)
+.Sh FILES
+.Dw /usr/libdata/learn
+.Di L
+.Dp Pa /usr/lib/learn
+subtree for all dependent directories and files
+.Dp Pa /usr/tmp/pl\(**
+playpen directories
+.Dp $HOME/.learnrc
+startup information
+.Dp
+.Sh SEE ALSO
+.Xr csh 1 ,
+.Xr ex 1
  .br
  .br
-B. W. Kernighan and M. E. Lesk, \fILEARN \- Computer-Aided Instruction on UNIX\fR
-.SH BUGS
+B. W. Kernighan and M. E. Lesk,
+.Em LEARN \- Computer-Aided Instruction on UNIX
+.Sh BUGS
  The main strength of
  The main strength of
-.I learn,
+.Nm learn ,
  that it asks the student to use the real UNIX,
  also makes possible baffling mistakes.
  It is helpful, especially for nonprogrammers,
  to have a UNIX initiate near at hand during the first
  sessions.
  that it asks the student to use the real UNIX,
  also makes possible baffling mistakes.
  It is helpful, especially for nonprogrammers,
  to have a UNIX initiate near at hand during the first
  sessions.
-.PP
+.Pp
  Occasionally lessons are incorrect, sometimes because the local version
  of a command operates in a non-standard way.
  Occasionally a lesson script does not recognize all the different
  correct responses, in which case the `hint' command may be useful.
  Such lessons may be skipped with the `skip' command,
  but it takes some sophistication to recognize the situation.
  Occasionally lessons are incorrect, sometimes because the local version
  of a command operates in a non-standard way.
  Occasionally a lesson script does not recognize all the different
  correct responses, in which case the `hint' command may be useful.
  Such lessons may be skipped with the `skip' command,
  but it takes some sophistication to recognize the situation.
-.PP
+.Pp
  To find a
  To find a
-.I lesson
+.Ar lesson
  given as a word,
  given as a word,
-.I learn
+.Nm learn
  does a simple
  does a simple
-.IR fgrep (1)
+.Xr fgrep  1
  through the lessons.
  It is unclear whether this sort
  of subject indexing is better than none.
  through the lessons.
  It is unclear whether this sort
  of subject indexing is better than none.
-.PP
+.Pp
  Spawning a new shell is required for each of many
  user and internal functions.
  Spawning a new shell is required for each of many
  user and internal functions.
-.PP
+.Pp
  The `vi' lessons are provided separately from the others.
  To use them see your system administrator.
  The `vi' lessons are provided separately from the others.
  To use them see your system administrator.
+.Sh HISTORY
+.Nm Learn
+appeared in Version 32 AT&T Unix.
diff --git a/usr/src/usr.bin/leave/leave.1 b/usr/src/usr.bin/leave/leave.1

index a7a3c22..30ffef5 100644 (file)
--- a/usr/src/usr.bin/leave/leave.1
+++ b/usr/src/usr.bin/leave/leave.1
@@ -1,49 +1,57 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
+.\" All rights reserved.
  .\"
  .\"
-.\"    @(#)leave.1     6.2 (Berkeley) %G%
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.TH LEAVE 1 ""
-.UC
-.SH NAME
-leave \- remind you when you have to leave
-.SH SYNOPSIS
-.B leave
-[ [+]hhmm ]
-.SH DESCRIPTION
-.I Leave
+.\"     @(#)leave.1    6.3 (Berkeley) %G%
+.\"
+.Dd 
+.Dt LEAVE 1
+.Sh NAME
+.Nm leave
+.Nd remind you when you have to leave
+.Sh SYNOPSIS
+.Nm leave
+.Op Op \&+ Ar hhmm
+.Sh DESCRIPTION
+.Nm Leave
  waits until the specified time, then reminds you that you
  have to leave.
  You are reminded 5 minutes and 1 minute before the actual
  time, at the time, and every minute thereafter.
  When you log off,
  waits until the specified time, then reminds you that you
  have to leave.
  You are reminded 5 minutes and 1 minute before the actual
  time, at the time, and every minute thereafter.
  When you log off,
-.I leave
+.Nm leave
  exits just before it would have
  printed the next message.
  exits just before it would have
  printed the next message.
-.PP
+.Pp
  The time of day is in the form hhmm where hh is a time in
  hours (on a 12 or 24 hour clock).
  All times are converted to a 12 hour clock, and assumed to
  be in the next 12 hours.
  The time of day is in the form hhmm where hh is a time in
  hours (on a 12 or 24 hour clock).
  All times are converted to a 12 hour clock, and assumed to
  be in the next 12 hours.
-.PP
+.Tw Ds
+.Tp Ic \&+
  If the time is preceeded by `+', the alarm will go off in hours and minutes
  from the current time.
  If the time is preceeded by `+', the alarm will go off in hours and minutes
  from the current time.
-.PP
+.Tp
+.Pp
  If no argument is given,
  If no argument is given,
-.I leave
+.Nm leave
  prompts with "When do you
  have to leave?". A reply of newline causes
  prompts with "When do you
  have to leave?". A reply of newline causes
-.I leave
+.Nm leave
  to exit,
  otherwise the reply is assumed to be a time.
  This form is suitable for inclusion in a
  to exit,
  otherwise the reply is assumed to be a time.
  This form is suitable for inclusion in a
-.I .login
+.Pa .login
  or
  or
-.I .profile.
-.PP
+.Pa .profile.
+.Pp
  Leave ignores interrupts, quits, and terminates.
  Leave ignores interrupts, quits, and terminates.
-To get rid of it you should either log off or use ``kill \-9''
+To get rid of it you should either log off or use
+.Dq Li kill \-9
  giving its process id.
  giving its process id.
-.SH SEE ALSO
-calendar(1)
+.Sh SEE ALSO
+.Xr calendar 1
+.Sh HISTORY
+.Nm Leave
+appeared in 3 BSD.
diff --git a/usr/src/usr.bin/locate/locate/locate.1 b/usr/src/usr.bin/locate/locate/locate.1

index 32a8fd4..0951e98 100644 (file)
--- a/usr/src/usr.bin/locate/locate/locate.1
+++ b/usr/src/usr.bin/locate/locate/locate.1
@@ -1,50 +1,49 @@
-.\" Copyright (c) 1989 The Regents of the University of California.
+.\" Copyright (c) 1990 The Regents of the University of California.
  .\" All rights reserved.
  .\"
  .\" All rights reserved.
  .\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.\"    @(#)locate.1    5.1 (Berkeley) %G%
+.\"     @(#)locate.1   5.2 (Berkeley) %G%
  .\"
  .\"
-.TH LOCATE 1 ""
-.UC 7
-.SH NAME
-locate \- find files
-.SH SYNOPSIS
-.ft B
-locate pattern
-.ft R
-.SH DESCRIPTION
-.I Locate
+.Dd 
+.Dt LOCATE 1
+.Os BSD 4.4
+.Sh NAME
+.Nm locate
+.Nd find files
+.Sh SYNOPSIS
+.Ar locate
+pattern
+.Sh DESCRIPTION
+.Nm Locate
  searches a database for all pathnames which match the specified
  searches a database for all pathnames which match the specified
-.IR pattern .
+.Ar pattern  .
  The database is recomputed periodically, and contains the pathnames
  of all files which are publicly accessible.
  The database is recomputed periodically, and contains the pathnames
  of all files which are publicly accessible.
-.PP
-Shell globbing and quoting characters (``*'', ``?'', ``\e'', ``['', and
-``]'') may be used in
-.IR pattern ,
+.Pp
+Shell globbing and quoting characters (``*'', ``?'', ``\e'', ``[''
+and ``]'')
+may be used in
+.Ar pattern  ,
  although they will have to be escaped from the shell.
  Preceding any character with a backslash (``\e'') eliminates any special
  meaning which it may have.
  The matching differs in that no characters must be matched explicitly,
  including slashes (``/'').
  although they will have to be escaped from the shell.
  Preceding any character with a backslash (``\e'') eliminates any special
  meaning which it may have.
  The matching differs in that no characters must be matched explicitly,
  including slashes (``/'').
-.PP
+.Pp
  As a special case, a pattern containing no globbing characters (``foo'')
  is matched as though it were ``*foo*''.
  As a special case, a pattern containing no globbing characters (``foo'')
  is matched as though it were ``*foo*''.
-.SH FILES
-/var/db/locate.database
-.SH "SEE ALSO"
-find(1), fnmatch(3)
+.Sh FILES
+.Dw /var/db/locate.database
+.Di L
+.Dp Pa /var/db/locate.database
+.Dp
+.Sh SEE ALSO
+.Xr find 1 ,
+.Xr fnmatch 3
  .br
  .br
-Paper in February, 1983 issue of the USENIX publication
-.I ;login:.
+Paper in February,
+1983 issue of the USENIX publication
+.Sy ;login: .
+.Sh HISTORY
+4.4 BSD.
diff --git a/usr/src/usr.bin/lock/lock.1 b/usr/src/usr.bin/lock/lock.1

index 9fcad52..9e6272e 100644 (file)
--- a/usr/src/usr.bin/lock/lock.1
+++ b/usr/src/usr.bin/lock/lock.1
@@ -1,47 +1,43 @@
-.\" Copyright (c) 1987 The Regents of the University of California.
+.\" Copyright (c) 1987, 1990 The Regents of the University of California.
  .\" All rights reserved.
  .\"
  .\" All rights reserved.
  .\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.\"    @(#)lock.1      6.5 (Berkeley) %G%
+.\"     @(#)lock.1     6.6 (Berkeley) %G%
  .\"
  .\"
-.TH LOCK 1 ""
-.UC
-.SH NAME
-lock \- reserve a terminal
-.SH SYNOPSIS
-.B lock
-[
-.B -p
-] [
-.B -t timeout
-]
-.br
-.SH DESCRIPTION
-.I Lock
+.Dd 
+.Dt LOCK 1
+.Sh NAME
+.Nm lock
+.Nd reserve a terminal
+.Sh SYNOPSIS
+.Nm lock
+.Op Fl p
+.Op Fl t Ar timeout
+.Sh DESCRIPTION
+.Nm Lock
  requests a password from the user, reads it again for verification
  and then will normally not relinquish the terminal until the password is
  repeated.
  There are two other conditions under which it will terminate: it
  will timeout after some interval of time and it may be killed by someone
  with the appropriate permission.
  requests a password from the user, reads it again for verification
  and then will normally not relinquish the terminal until the password is
  repeated.
  There are two other conditions under which it will terminate: it
  will timeout after some interval of time and it may be killed by someone
  with the appropriate permission.
-The default time limit is 15 minutes, which may be changed with the
-.I -t
-option where
-.I timeout
-is the time limit in minutes.
-The
-.I -p
-option causes
-.I lock
+.Po
+Options:
+.Pp
+.Tw Fl
+.Tc Fl t
+.Ws
+.Ar timeout
+.Cx
+The time limit (default 15 minutes) is changed to
+.Ar timeout
+minutes.
+.Tp Fl p
+Causes
+.Nm lock
  to use the user's current password instead of requesting another one.
  to use the user's current password instead of requesting another one.
+.Tp
+.Sh HISTORY
+.Nm Lock
+appeared in 3 BSD.
diff --git a/usr/src/usr.bin/pascal/eyacc/eyacc.1 b/usr/src/usr.bin/pascal/eyacc/eyacc.1

index 5317ad3..5a3dcc3 100644 (file)
--- a/usr/src/usr.bin/pascal/eyacc/eyacc.1
+++ b/usr/src/usr.bin/pascal/eyacc/eyacc.1
@@ -1,47 +1,50 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980, 1990 The Regents of the University of California.
+.\" All rights reserved.
  .\"
  .\"
-.\"    @(#)eyacc.1     6.1 (Berkeley) %G%
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.TH EYACC 1 "%G%"
-.UC 4
-.SH NAME
-eyacc \- modified yacc allowing much improved error recovery
-.SH SYNOPSIS
-.B eyacc
-[
-.B \-v
-]
-[ grammar ]
-.SH DESCRIPTION
-.I Eyacc
+.\"     @(#)eyacc.1    6.2 (Berkeley) %G%
+.\"
+.Dd 
+.Dt EYACC 1
+.Os BSD 4
+.Sh NAME
+.Nm eyacc
+.Nd modified yacc allowing much improved error recovery
+.Sh SYNOPSIS
+.Nm eyacc
+.Op Fl v
+.Op Ar grammar
+.Sh DESCRIPTION
+.Nm Eyacc
  is an old version of
  is an old version of
-.IR yacc (1),
+.Xr yacc  1  ,
  which produces tables used by the Pascal system and its error recovery
  routines.
  which produces tables used by the Pascal system and its error recovery
  routines.
-.I Eyacc
+.Nm Eyacc
  fully enumerates test actions in its parser when an error token
  is in the look-ahead set.
  This prevents the parser from making undesirable reductions
  when an error occurs before the error is detected.
  The table format is different in
  fully enumerates test actions in its parser when an error token
  is in the look-ahead set.
  This prevents the parser from making undesirable reductions
  when an error occurs before the error is detected.
  The table format is different in
-.I eyacc
+.Nm eyacc
  than it was in the old
  than it was in the old
-.I yacc,
+.Xr yacc 1 ,
  as minor changes had been made for efficiency reasons.
  as minor changes had been made for efficiency reasons.
-.SH "SEE ALSO"
-yacc(1)
+.Sh SEE ALSO
+.Xr yacc 1
  .br
  .br
-``Practical LR Error Recovery'' by Susan L. Graham, Charles B. Haley
-and W. N. Joy; SIGPLAN Conference on Compiler Construction, August 1979.
-.SH AUTHOR
+.Em Practical LR Error Recovery
+by Susan L.  Graham, Charles B. Haley and W. N. Joy;
+SIGPLAN Conference on Compiler Construction,
+August 1979.
+.Sh AUTHORS
  S. C. Johnson
  S. C. Johnson
-.PP
-.I Eyacc
+.Pp
+.Nm Eyacc
  modifications by Charles Haley and William Joy.
  modifications by Charles Haley and William Joy.
-.SH BUGS
-.I Pc
+.Sh BUGS
+.Xr Pc 1
  and its error recovery routines should be made into a library
  of routines for the new
  and its error recovery routines should be made into a library
  of routines for the new
-.I yacc.
+.Xr yacc 1 .
diff --git a/usr/src/usr.bin/xinstall/install.1 b/usr/src/usr.bin/xinstall/install.1

index ed3bdb3..0106508 100644 (file)
--- a/usr/src/usr.bin/xinstall/install.1
+++ b/usr/src/usr.bin/xinstall/install.1
@@ -1,75 +1,76 @@
-.\" Copyright (c) 1987 Regents of the University of California.
+.\" Copyright (c) 1987, 1990 The Regents of the University of California.
  .\" All rights reserved.
  .\"
  .\" All rights reserved.
  .\"
-.\" Redistribution and use in source and binary forms are permitted
-.\" provided that the above copyright notice and this paragraph are
-.\" duplicated in all such forms and that any documentation,
-.\" advertising materials, and other materials related to such
-.\" distribution and use acknowledge that the software was developed
-.\" by the University of California, Berkeley.  The name of the
-.\" University may not be used to endorse or promote products derived
-.\" from this software without specific prior written permission.
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
-.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\" %sccs.include.redist.man%
  .\"
  .\"
-.\"    @(#)install.1   6.7 (Berkeley) %G%
+.\"     @(#)install.1  6.8 (Berkeley) %G%
  .\"
  .\"
-.TH INSTALL 1 ""
-.UC 5
-.SH NAME
-install \- install binaries
-.SH SYNOPSIS
-.B install
-[
-.B \-cs
-] [
-.B \-m
-mode ] [
-.B \-o
-owner ] [
-.B \-g
-group ] file1 file2; or file1 ... fileN directory
-.SH DESCRIPTION
+.Dd 
+.Dt INSTALL 1
+.Os BSD 4.2
+.Sh NAME
+.Nm install
+.Nd install binaries
+.Sh SYNOPSIS
+.Nm install
+.Op Fl cs
+.Op.Fl m Ar mode
+.Op Fl o Ar owner
+.Op Fl g Ar group
+.Ar file1 file2 ;
+or
+.if n .br
+.Ar file1
+\&...
+.Ar fileN directory
+.Sh DESCRIPTION
  The file(s) are moved (or copied if the
  The file(s) are moved (or copied if the
-.I -c
+.Fl c
  option is specified) to the target file or directory.
  If the destination is a directory, then the
  option is specified) to the target file or directory.
  If the destination is a directory, then the
-.I file
+.Ar file
  is moved into
  is moved into
-.I directory
+.Ar directory
  with its original filename.
  If the target file already exists, it is overwritten if permissions
  allow.
  with its original filename.
  If the target file already exists, it is overwritten if permissions
  allow.
-.PP
-The mode is set to 755; the
-.I -m
+.Pp
+.Tw Ds
+.Tp Fl m
  option may be used to specify an alternate mode.
  option may be used to specify an alternate mode.
+The default mode is set to 755.
  The specified mode may be either an octal or symbolic value; see
  The specified mode may be either an octal or symbolic value; see
-.IR chmod (1)
+.Xr chmod  1
  for a description of possible mode values.
  for a description of possible mode values.
-.PP
-The
-.I -o
-and
-.I -g
-options may be used to specify an owner and/or group, respectively.
-.PP
-The
-.I -s
-option causes the file to be stripped.
-.I Install
+.Tp Fl o
+Specify an owner.
+.Tp Fl g
+Specify a group.
+.Tp Fl s
+.Nm Install
  exec's the command
  exec's the command
-.IR strip (1)
+.Xr strip  1
  to strip binaries so that install can be portable over a large
  number of systems and binary types.
  to strip binaries so that install can be portable over a large
  number of systems and binary types.
-.PP
-.I Install
+.Tp
+.Pp
+.Nm Install
  refuses to move a file onto itself.
  refuses to move a file onto itself.
-.PP
-Installing ``/dev/null'' creates an empty file.
-.SH "RETURN VALUE"
+.Pp
+Installing
+.Pa dev/null
+creates an empty file.
+.Pp
  Upon successful completion a value of 0 is returned.
  Otherwise, a value of 1 is returned.
  Upon successful completion a value of 0 is returned.
  Otherwise, a value of 1 is returned.
-.SH "SEE ALSO"
-chgrp(1), chmod(1), cp(1), mv(1), strip(1), a.out(5), chown(8)
+.Sh SEE ALSO
+.Xr chgrp 1 ,
+.Xr chmod 1 ,
+.Xr cp 1 ,
+.Xr mv 1 ,
+.Xr strip 1 ,
+.Xr a.out 5 ,
+.Xr chown 8
+.Sh HISTORY
+.Nm Install
+appeared in 4.2 BSD.
author	Cynthia A. E. Livingston <cael@ucbvax.Berkeley.EDU>
	Mon, 25 Jun 1990 10:08:55 +0000 (02:08 -0800)
committer	Cynthia A. E. Livingston <cael@ucbvax.Berkeley.EDU>
	Mon, 25 Jun 1990 10:08:55 +0000 (02:08 -0800)
usr/src/bin/hostname/hostname.1		patch \| blob \| blame \| history
usr/src/bin/kill/kill.1		patch \| blob \| blame \| history
usr/src/bin/ln/ln.1		patch \| blob \| blame \| history
usr/src/old/groups/groups.1		patch \| blob \| blame \| history
usr/src/old/ld/ld.1		patch \| blob \| blame \| history
usr/src/old/lisp/fp/fp.1		patch \| blob \| blame \| history
usr/src/old/lisp/man/lisp.1		patch \| blob \| blame \| history
usr/src/old/lisp/man/liszt.1		patch \| blob \| blame \| history
usr/src/old/pcc/lint/lpass1/lint.1		patch \| blob \| blame \| history
usr/src/share/man/man1/intro.1		patch \| blob \| blame \| history
usr/src/share/man/man7/hostname.7		patch \| blob \| blame \| history
usr/src/share/man/man7/intro.7		patch \| blob \| blame \| history
usr/src/usr.bin/f77/f77.vax/f77.1		patch \| blob \| blame \| history
usr/src/usr.bin/false/false.1		patch \| blob \| blame \| history
usr/src/usr.bin/file/file.1		patch \| blob \| blame \| history
usr/src/usr.bin/finger/finger.1		patch \| blob \| blame \| history
usr/src/usr.bin/fmt/fmt.1		patch \| blob \| blame \| history
usr/src/usr.bin/fpr/fpr.1		patch \| blob \| blame \| history
usr/src/usr.bin/from/from.1		patch \| blob \| blame \| history
usr/src/usr.bin/fsplit/fsplit.1		patch \| blob \| blame \| history
usr/src/usr.bin/gcore/gcore.1		patch \| blob \| blame \| history
usr/src/usr.bin/gprof/gprof.1		patch \| blob \| blame \| history
usr/src/usr.bin/graph/graph.1		patch \| blob \| blame \| history
usr/src/usr.bin/grep/egrep/grep.1		patch \| blob \| blame \| history
usr/src/usr.bin/head/head.1		patch \| blob \| blame \| history
usr/src/usr.bin/hexdump/hexdump.1		patch \| blob \| blame \| history
usr/src/usr.bin/join/join.1		patch \| blob \| blame \| history
usr/src/usr.bin/last/last.1		patch \| blob \| blame \| history
usr/src/usr.bin/lastcomm/lastcomm.1		patch \| blob \| blame \| history
usr/src/usr.bin/learn/learn/learn.1		patch \| blob \| blame \| history
usr/src/usr.bin/leave/leave.1		patch \| blob \| blame \| history
usr/src/usr.bin/locate/locate/locate.1		patch \| blob \| blame \| history
usr/src/usr.bin/lock/lock.1		patch \| blob \| blame \| history
usr/src/usr.bin/pascal/eyacc/eyacc.1		patch \| blob \| blame \| history
usr/src/usr.bin/xinstall/install.1		patch \| blob \| blame \| history