diff options
author | Aaron Campbell <aaron@cvs.openbsd.org> | 1998-11-28 03:38:03 +0000 |
---|---|---|
committer | Aaron Campbell <aaron@cvs.openbsd.org> | 1998-11-28 03:38:03 +0000 |
commit | 4beb28910871edfcdf5dce787bb0f0a7a9cf17a9 (patch) | |
tree | 3417b4419d3c8a80852a1e84b4620e3deef3e883 | |
parent | 9bb6028fe02a280e61b8f862f447486ce6b5f72a (diff) |
share/man/man7/ man page repairs
-rw-r--r-- | share/man/man7/environ.7 | 93 | ||||
-rw-r--r-- | share/man/man7/hier.7 | 354 | ||||
-rw-r--r-- | share/man/man7/hostname.7 | 13 | ||||
-rw-r--r-- | share/man/man7/intro.7 | 25 | ||||
-rw-r--r-- | share/man/man7/mailaddr.7 | 80 | ||||
-rw-r--r-- | share/man/man7/ports.7 | 12 |
6 files changed, 319 insertions, 258 deletions
diff --git a/share/man/man7/environ.7 b/share/man/man7/environ.7 index 38cae40a7ee..97d12602b24 100644 --- a/share/man/man7/environ.7 +++ b/share/man/man7/environ.7 @@ -1,3 +1,4 @@ +.\" $OpenBSD: environ.7,v 1.4 1998/11/28 03:38:01 aaron Exp $ .\" $NetBSD: environ.7,v 1.4 1995/07/03 19:45:07 jtc Exp $ .\" .\" Copyright (c) 1983, 1990, 1993 @@ -43,11 +44,11 @@ .Ar extern char **environ ; .Sh DESCRIPTION An array of strings called the -.Ar environment +.Dq environment is made available by -.Xr execve 2 +.Xr execve 2 when a process begins. By convention these strings have the form -.Dq Ar name=value . +.Dq Ar name Ns No = Ns Ar value . The following names are used by various commands: .Bl -tag -width BLOCKSIZE .It Ev BLOCKSIZE @@ -56,44 +57,58 @@ The size of the block units used by several commands, most notably .Xr du 1 and .Xr ls 1 . -BLOCKSIZE may be specified in units of a byte by specifying a number, -in units of a kilobyte by specifying a number followed by ``K'' or -``k'', in units of a megabyte by specifying a number followed by ``M'' -or ``m'' and in units of a gigabyte by specifying a number followed -by ``G'' or ``g''. +.Ev BLOCKSIZE +may be specified in units of a byte by specifying a number, +in units of a kilobyte by specifying a number followed by +.Dq K +or +.Dq k , +in units of a megabyte by specifying a number followed by +.Dq M +or +.Dq m +and in units of a gigabyte by specifying a number followed +by +.Dq G +or +.Dq g . Sizes less than 512 bytes or greater than a gigabyte are ignored. .It Ev EXINIT A startup list of commands read by -.Xr ex 1 , -.Xr edit 1 , +.Xr ex 1 , +.Xr edit 1 , and -.Xr vi 1 . +.Xr vi 1 . .It Ev HOME A user's login directory, set by -.Xr login 1 +.Xr login 1 from the password file -.Xr passwd 5 . +.Xr passwd 5 . .It Ev PATH The sequence of directories, separated by colons, searched by -.Xr csh 1 , -.Xr sh 1 , -.Xr system 3 , -.Xr execvp 3 , -etc, when looking for an executable file. -PATH is set to ``/usr/bin:/bin'' initially by -.Xr login 1 . +.Xr csh 1 , +.Xr sh 1 , +.Xr system 3 , +.Xr execvp 3 , +etc. when looking for an executable file. +Initially, +.Ev PATH +is set to +.Dq /usr/bin:/bin +by +.Xr login 1 . .It Ev PRINTER The name of the default printer to be used by -.Xr lpr 1 , -.Xr lpq 1 , +.Xr lpq 1 , +.Xr lpr 1 , and -.Xr lprm 1 . +.Xr lprm 1 . .It Ev SHELL The full pathname of the user's login shell. .It Ev TERM The kind of terminal for which output is to be prepared. -This information is used by commands, such as -.Xr nroff 1 +This information is used by commands such as +.Xr nroff 1 or .Xr plot 1 which may exploit special terminal capabilities. See @@ -102,13 +117,15 @@ which may exploit special terminal capabilities. See for a list of terminal types. .It Ev TERMCAP The string describing the terminal in TERM, or, if -it begins with a '/', the name of the termcap file. +it begins with a +.Dq / , +the name of the termcap file. See .Ev TERMPATH below, -.Xr termcap 5 , +.Xr termcap 5 , and -.Xr termcap . +.Xr termcap . .It Ev TERMPATH A sequence of pathnames of termcap files, separated by colons or spaces, which are searched for terminal descriptions in the order listed. Having @@ -117,7 +134,7 @@ no is equivalent to a .Ev TERMPATH of -.Dq Pa $HOME/.termcap:/etc/termcap . +.Dq $HOME/.termcap:/etc/termcap . .Ev TERMPATH is ignored if .Ev TERMCAP @@ -125,16 +142,16 @@ contains a full pathname. .It Ev TMPDIR The directory in which to store temporary files. Most applications use either -.Dq /tmp +.Pa /tmp or -.Dq /var/tmp . +.Pa /var/tmp . Setting this variable will make them use another directory. .It Ev TZ The timezone to use when displaying dates. The normal format is a pathname relative to -.Dq /usr/share/zoneinfo . +.Pa /usr/share/zoneinfo . For example, the command -.Dq env TZ=US/Pacific date +.Ic env TZ=US/Pacific date displays the current time in California. See .Xr tzset 3 @@ -150,15 +167,15 @@ Deprecated synonym of Further names may be placed in the environment by the .Xr export command and -.Ar name=value +.Ar name Ns No = Ns Ar value arguments in -.Xr sh 1 , +.Xr sh 1 , or by the .Xr setenv command if you use -.Xr csh 1 . +.Xr csh 1 . It is unwise to change certain -.Xr sh 1 +.Xr sh 1 variables that are frequently exported by .Pa .profile files, such as @@ -180,6 +197,6 @@ unless you know what you are doing. .Xr termcap 5 .Sh HISTORY The -.Nm environ +.Nm manual page appeared in .Bx 4.2 . diff --git a/share/man/man7/hier.7 b/share/man/man7/hier.7 index 435fea5afda..a9d0d3d4551 100644 --- a/share/man/man7/hier.7 +++ b/share/man/man7/hier.7 @@ -1,4 +1,4 @@ -.\" $OpenBSD: hier.7,v 1.7 1998/06/28 02:38:50 art Exp $ +.\" $OpenBSD: hier.7,v 1.8 1998/11/28 03:38:01 aaron Exp $ .\" $NetBSD: hier.7,v 1.7 1994/11/30 19:07:10 jtc Exp $ .\" .\" Copyright (c) 1990, 1993 @@ -44,212 +44,213 @@ A sketch of the filesystem hierarchy. .Bl -tag -width "/stand/" .It Li / -root directory of the filesystem +Root directory. .It Li /bin/ -user utilities fundamental to both single-user and multi-user environments +User utilities fundamental to both single and multi-user environments. .It Li /bsd -pure kernel executable (the operating system loaded into memory -at boot time). +Pure kernel executable (the operating system loaded into memory +at boot-time). .It Li /dev/ -block and character device files +Block and character device files. .Pp .Bl -tag -width MAKEDEV -compact .It Li MAKEDEV -script for creating device files; -see -.Xr makedev 8 +Script for creating device files (see +.Xr makedev 8 ) . .It Li fd/ -file descriptor files; -see -.Xr \&fd 4 +File descriptor files (see +.Xr fd 4 ) . .El .It Li /emul/ -base directory for alternate areas searched first when system call -emulation is in effect; see +Base directory for alternate areas searched first when system call +emulation is in effect (see +.Xr compat_bsdos 8 , .Xr compat_freebsd 8 , .Xr compat_linux 8 , .Xr compat_sunos 8 , -.Xr compat_svr4 8 . +.Xr compat_svr4 8 ) . .It Li /etc/ -system configuration files and scripts +System configuration files and scripts. .Pp .Bl -tag -width "disklabels/" -compact .It Li localtime -local timezone information; -see -.Xr ctime 3 +Local timezone information (see +.Xr ctime 3 ) . .It Li disklabels/ -backup disklabels; -see -.Xr disklabel 8 +Backup disklabels (see +.Xr disklabel 8 ) . .It Li kerberosIV/ -configuration files for the kerberos version IV; -see -.Xr kerberos 1 +Configuration files for the Kerberos version IV system (see +.Xr kerberos 1 ) . .It Li mtree/ -mtree configuration files; -see -.Xr mtree 1 +.Xr mtree +configuration files (see +.Xr mtree 8 ) . .It Li namedb/ -named configuration files; -see -.Xr named 8 +.Xr named +configuration files (see +.Xr named 8 ) . .It Li uucp/ -UUCP configuration files; +.Xr uucp +configuration files (see +.Xr uucp 1 ) . .El +.It Li /home/ +User home directories. +.It Li /lost+found/ +I don't know. .It Li /mnt/ -empty directory commonly used by -system administrators as a temporary mount point +Empty directory commonly used by +system administrators as a temporary mount point. +.It Li /root/ +Default home directory for the super-user. .It Li /sbin/ -system programs and administration utilities -fundamental to both single-user and multi-user environments +System programs and administration utilities +fundamental to both single and multi-user environments. .It Li /stand/ -programs used in a standalone environment +Programs used in a stand-alone environment. .It Li /tmp/ -temporary files, usually a +Temporary files, usually an .Xr mfs 8 memory-based filesystem (the contents -of /tmp are usually NOT preserved across a system reboot) +of +.Pa /tmp +are usually +.Em not +preserved across a system reboot). .It Li /usr/ -contains the majority of user utilities and applications +Contains the majority of user utilities and applications. .Pp .Bl -tag -width "libdata/" -compact .It Li bin/ -common utilities, programming tools, and applications +Common utilities, programming tools, and applications. .It Li games/ -useful and semi-frivolous programs +Useful and semi-frivolous programs. .It Li include/ -standard C include files +Standard C include files. .Pp .Bl -tag -width "kerberosIV/" -compact .It Li X11/ -C include files for X11 window system +C include files for X11 window system. .It Li arpa/ -C include files for Internet service protocols +C include files for Internet service protocols. .It Li kerberosIV/ -C include files for kerberos authentication package; -see -.Xr kerberos 1 +C include files for Kerberos authentication package (see +.Xr kerberos 1 ) . .It Li machine/ -machine specific C include files +Machine specific C include files. .It Li net/ -misc network C include files +Miscellaneous network C include files. .It Li netimp/ -C include files for IMP protocols; -see -.Xr imp 4 +C include files for IMP protocols (see +.Xr imp 4 ) . .It Li netinet/ -C include files for Internet standard protocols; -see -.Xr inet 4 +C include files for Internet standard protocols (see +.Xr inet 4 ) . .It Li netiso/ -C include files for ISO standard protocols; -see -.Xr iso 4 +C include files for ISO standard protocols (see +.Xr iso 4 ) . .It Li netns/ -C include files for XNS standard protocols; -see -.Xr \&ns 4 +C include files for XNS standard protocols (see +.Xr ns 4 ) . .It Li nfs/ -C include files for NFS (Network File System) +C include files for NFS (Network File System). .It Li pascal/ -include files for pc 1 +Include files for +.Xr pc 1 . .It Li protocols/ -C include files for Berkeley service protocols +C include files for Berkeley service protocols. .It Li sys/ -system C include files (kernel data structures) +System C include files (kernel data structures). .It Li ufs/ -C include files for UFS (The U-word File System) +C include files for UFS (the U-word File System). .El .Pp .It Li lib/ -archive libraries +Archive libraries. .It Li libdata/ -misc. utility data files +Miscellaneous utility data files. .It Li libexec/ -system daemons & system utilities (executed by other programs) +System daemons and utilities (executed by other programs). .It Li local/ -local executables, libraries, etc. +Local executables, libraries, etc. .It Li obj/ -architecture-specific target tree produced by building the /usr/src tree +Architecture specific target tree produced by building the +.Pa /usr/src +tree. .It Li old/ -programs from past lives of BSD which may disappear in future -releases +Programs from past lives of BSD which may disappear in future +releases. .It Li sbin/ -system daemons & system utilities (executed by users) +System daemons and utilities (executed by users). .It Li share/ -architecture-independent data files +Architecture independent data files. .Pp .Bl -tag -width "calendar/" -compact .It Li calendar/ -a variety of pre-fab calendar files; -see -.Xr calendar 1 +Variety of pre-fab calendar files (see +.Xr calendar 1 ) . .It Li dict/ -word lists; -see -.Xr look 1 +Word lists (see +.Xr look 1 ) . .Pp .Bl -tag -width Fl -compact .It Li words -common words +Common words. .It Li web2 -words from Webster's 2nd International +Words from Webster's 2nd International. .It Li papers/ -reference databases; -see -.Xr refer 1 +Reference databases (see +.Xr refer 1 ) . .It Li special/ -custom word lists; -see -.Xr spell 1 +Custom word lists. .El .Pp .It Li doc/ -misc documentation; -src for most of the printed +Miscellaneous documentation; +source for most of the printed .Bx 4.3 manuals (available from the .Tn USENIX -association) +association). .It Li games/ -ascii text files used by various games +ASCII text files used by various games. .It Li man/ -manual pages +Manual pages. .It Li me/ -macros for use with the me macro package +Macros for use with the me macro package. .It Li misc/ -misc system-wide ascii text files -.Bl -tag -width Fl -compact +Miscellaneous system-wide ASCII text files. +.Bl -tag -width Fl .It Li termcap -terminal characteristics database; -see -.Xr termcap 5 +Terminal characteristics database (see +.Xr termcap 5 ) . .El +.Pp .It Li mk/ -templates for make; -see -.Xr make 1 +Templates for +.Xr make +(see +.Xr make 1 ) . .It Li ms/ -macros for use with the ms macro package +Macros for use with the ms macro package. .It Li skel/ -example . (dot) files for new accounts +Example +.Dq \&. +(dot) files for new accounts. .It Li tabset/ -tab description files for a variety of terminals; used in -the termcap file; -see -.Xr termcap 5 +Tab description files for a variety of terminals; used in +the termcap file (see +.Xr termcap 5 ) . .It Li tmac/ -text processing macros; -see +Text processing macros (see .Xr nroff 1 and -.Xr troff 1 +.Xr troff 1 ) . .It Li zoneinfo/ -timezone configuration information; -see -.Xr tzfile 5 +Timezone configuration information (see +.Xr tzfile 5 ) . .El .Pp .It Li src/ @@ -257,130 +258,137 @@ BSD and/or local source files .Pp .Bl -tag -width "kerberosIV/" -compact .It Li bin/ -src for files in /bin +Source for files in +.Pa /bin . .It Li etc/ -src for files in /etc +Source for files in +.Pa /etc . .It Li games/ -src for files in /usr/games +Source for files in +.Pa /usr/games . .It Li gnu/ -src for files with GPL license +Source for files with GPL license. .It Li include/ -src for files in /usr/include +Source for files in +.Pa /usr/include . .It Li kerberosIV/ -src for kerberos version IV +Source for Kerberos version IV. .It Li lib/ -src for files in /usr/lib +Source for files in +.Pa /usr/lib . .It Li libexec/ -src for files in /usr/libexec +Source for files in +.Pa /usr/libexec . .It Li lkm/ -src for files in /usr/lkm +Source for files in +.Pa /usr/lkm . .It Li sbin/ -src for files in /sbin +Source for files in +.Pa /sbin . .It Li share/ -src for files in /usr/share +Source for files in +.Pa /usr/share . .It Li sys/ -kernel src files +Kernel source files. .It Li usr.bin/ -src for files in /usr/bin +Source for files in +.Pa /usr/bin . .It Li usr.sbin/ -src for files in /usr/sbin +Source for files in +.Pa /usr/sbin . .El .El .It Li /var/ -multi-purpose log, temporary, transient, and spool files +Multi-purpose log, temporary, transient, and spool files. .Pp .Bl -tag -width "preserve/" -compact .It Li account/ -system accounting files +System accounting files. .Pp .Bl -tag -width Fl -compact .It Li acct -execution accounting file; -see -.Xr acct 5 +Execution accounting file (see +.Xr acct 5 ) . .El .Pp .It Li at/ -timed command scheduling files; -see -.Xr \&at 1 +.Xr timed 8 +command scheduling files (see +.Xr at 1 ) . .It Li backups/ -misc. backup files +Miscellaneous backup files. .It Li db/ -misc. automatically generated system-specific database files +Miscellaneous automatically generated system-specific database files. .It Li games/ -misc. game status and log files +Miscellaneous game status and log files. .It Li log/ -misc. system log files +Miscellaneous system log files. .Pp .Bl -tag -width Fl -compact .It Li wtmp -login/logout log; -see -.Xr wtmp 5 +Login/logout log (see +.Xr wtmp 5 ) . .El .Pp .It Li mail/ -user mailbox files +User mailbox files. .It Li preserve/ -temporary home of files preserved after an accidental death -of an editor; -see -.Xr \&ex 1 +Temporary home of files preserved after an accidental death +of an editor (see +.Xr ex 1 ) . .It Li quotas/ -filesystem quota information files +Filesystem quota information files. .It Li run/ -system information files describing various info about -system since it was booted +System information files describing various info about the +system since it was booted. .Pp .Bl -tag -width Fl -compact .It Li utmp -database of current users; -see -.Xr utmp 5 +Database of current users (see +.Xr utmp 5 ) . .El .Pp .It Li rwho/ -rwho data files; -see +.Xr rwho +data files (see .Xr rwhod 8 , .Xr rwho 1 , and -.Xr ruptime 1 +.Xr ruptime 1 ) . .It Li spool/ -misc. printer and mail system spooling directories +Miscellaneous printer and mail system spooling directories. .Pp .Bl -tag -width Fl -compact .It Li ftp/ -commonly ~ftp; the anonymous ftp root directory +Commonly ~ftp; the anonymous ftp root directory. .It Li mqueue/ -undelivered mail queue; -see -.Xr sendmail 8 +Undelivered mail queue (see +.Xr sendmail 8 ) . .It Li output/ -line printer spooling directories +Line printer spooling directories. .It Li uucp/ -uucp spool directory +.Xr uucp +spool directory. .It Li uucppublic/ -commonly ~uucp; public uucp temporary directory +Commonly ~uucp; public uucp temporary directory. .El .Pp .It Li tmp/ -temporary files that are kept between system reboots +Temporary files that are kept between system reboots. .El .El .Sh SEE ALSO -.Xr \&ls 1 , .Xr apropos 1 , -.Xr whatis 1 , -.Xr whereis 1 , .Xr finger 1 , -.Xr which 1 , .Xr find 1 , .Xr grep 1 , +.Xr ls 1 , +.Xr whatis 1 , +.Xr whereis 1 , +.Xr which 1 , .Xr fsck 8 .Sh HISTORY A -.Nm hier +.Nm manual page appeared in .At v7 . diff --git a/share/man/man7/hostname.7 b/share/man/man7/hostname.7 index 3323b4c10ec..c31c82dbe8e 100644 --- a/share/man/man7/hostname.7 +++ b/share/man/man7/hostname.7 @@ -1,3 +1,4 @@ +.\" $OpenBSD: hostname.7,v 1.3 1998/11/28 03:38:02 aaron Exp $ .\" $NetBSD: hostname.7,v 1.4 1994/11/30 19:07:14 jtc Exp $ .\" .\" Copyright (c) 1987, 1990, 1993 @@ -51,13 +52,13 @@ subdomain of the EDU subdomain of the Internet would be represented as 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 -.Xr gethostbyname 3 . ) +.Xr gethostbyname 3 . ) Hostnames are resolved by the Internet name resolver in the following fashion. .Pp If the name consists of a single component, i.e. contains no dot, and if the environment variable -.Dq Ev HOSTALIASES +.Ev HOSTALIASES is set to the name of a file, that file is searched for any string matching the input hostname. The file should consist of lines made up of two white-space separated strings, @@ -83,12 +84,14 @@ Lithium.CChem.EDU will not be tried, as 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 -.Xr resolv.conf 5 ) . +.Xr resolv.conf 5 ) . .Sh SEE ALSO .Xr gethostbyname 3 , .Xr resolv.conf 5 , .Xr mailaddr 7 , .Xr named 8 .Sh HISTORY -.Nm Hostname -appeared in 4.2 BSD. +A +.Nm +manual page appeared in +.Bx 4.2 . diff --git a/share/man/man7/intro.7 b/share/man/man7/intro.7 index 00471c03745..0ea3b730ee7 100644 --- a/share/man/man7/intro.7 +++ b/share/man/man7/intro.7 @@ -1,3 +1,4 @@ +.\" $OpenBSD: intro.7,v 1.3 1998/11/28 03:38:02 aaron Exp $ .\" $NetBSD: intro.7,v 1.3 1994/11/30 19:07:15 jtc Exp $ .\" .\" Copyright (c) 1983, 1990, 1993 @@ -44,22 +45,26 @@ This section contains miscellaneous documentation. .Pp .Bl -tag -width "mdoc.samples(7) " -compact .It Xr ascii -map of ASCII character set +Map of ASCII character set. .It Xr environ -user environment +User environment. .It Xr hier -file system hierarchy +File system hierarchy. .It Xr hostname -hostname resolution rules +Hostname resolution rules. .It Xr mailaddr -mail addressing description +Mail addressing description. .It Xr mdoc -macros to typeset manual pages +Macros to typeset manual pages. .It Xr mdoc.samples -guide to writing manual pages +Guide to writing manual pages. .It Xr operator -C operator precedence +C operator precedence. +.It Xr ports +Contributed applications. .El .Sh HISTORY -.Nm intro -appeared in 4.2 BSD. +An +.Nm +manual page appeared in +.Bx 4.2 . diff --git a/share/man/man7/mailaddr.7 b/share/man/man7/mailaddr.7 index 86b0a9ed3fb..ad2bba6afd6 100644 --- a/share/man/man7/mailaddr.7 +++ b/share/man/man7/mailaddr.7 @@ -1,3 +1,4 @@ +.\" $OpenBSD: mailaddr.7,v 1.3 1998/11/28 03:38:02 aaron Exp $ .\" $NetBSD: mailaddr.7,v 1.3 1994/11/30 19:07:17 jtc Exp $ .\" .\" Copyright (c) 1983, 1987, 1990, 1993 @@ -56,15 +57,19 @@ travel by an alternate route if that were more convenient or efficient. For example, at Berkeley, the associated message would probably go directly to CS over the Ethernet rather than going via the Berkeley Internet gateway. -.Ss Abbreviation. +.Ss Abbreviation Under certain circumstances it may not be necessary to type the entire domain name. In general, anything following the first dot may be omitted if it is the same as the domain from which you are sending the message. -For example, a user on ``calder.berkeley.edu'' could send to ``eric@CS'' -without adding the ``berkeley.edu'' since it is the same on both sending +For example, a user on +.Dq calder.berkeley.edu +could send to +.Dq eric@CS +without adding the +.Dq berkeley.edu +since it is the same on both sending and receiving hosts. -.Ss Compatibility. -.Pp +.Ss Compatibility Certain old address formats are converted to the new format to provide compatibility with the previous mail system. In particular, .Pp @@ -89,54 +94,69 @@ is converted to .Pp .Dl user@host.UUCP .Pp -This is normally converted back to the ``host!user'' form before being sent +This is normally converted back to the +.Dq host!user +form before being sent on for compatibility with older UUCP hosts. .Pp -.Ss Case Distinctions. -.Pp -Domain names (i.e., anything after the ``@'' sign) may be given in any mixture +.Ss Case distinctions +Domain names (i.e., anything after the +.Dq @ +sign) may be given in any mixture of upper and lower case with the exception of UUCP hostnames. Most hosts accept any combination of case in user names, with the notable exception of MULTICS sites. -.Ss Route-addrs. -.Pp +.Ss Route-addrs Under some circumstances it may be necessary to route a message through several hosts to get it to the final destination. Normally this routing is done automatically, but sometimes it is desirable to route the message -manually. Addresses which show these relays are termed ``route-addrs.'' +manually. Addresses which show these relays are termed +.Dq route-addrs . These use the syntax: .Pp .Dl <@hosta,@hostb:user@hostc> .Pp -This specifies that the message should be sent to hosta, from there to hostb, -and finally to hostc. This path is forced even if there is a more efficient -path to hostc. +This specifies that the message should be sent to +.Dq hosta , +from there to +.Dq hostb , +and finally to +.Dq hostc . +This path is forced even if there is a more efficient +path to +.Dq hostc . .Pp Route-addrs occur frequently on return addresses, since these are generally augmented by the software at each host. It is generally possible to ignore -all but the ``user@hostc'' part of the address to determine the actual -sender. +all but the +.Dq user@hostc +part of the address to determine the actual sender. .Pp -[Note: the route-addr syntax is officially deprecated +[Note: The route-addr syntax is officially deprecated in RFC 1123 and should not be used.] .Pp -Many sites also support the ``percent hack'' for simplistic routing: +Many sites also support the +.Dq percent hack +for simplistic routing: .Pp .Dl user%hostc%hostb@hosta .Pp is routed as indicated in the previous example. -.Ss Postmaster. -.Pp -Every site is required to have a user or user alias designated ``postmaster'' +.Ss Postmaster +Every site is required to have a user or user alias designated +.Dq postmaster to which problems with the mail system may be addressed. -.Ss Other Networks. -.Pp +.Ss Other networks Some other networks can be reached by giving the name of the network as the last component of the domain. .Em This is not a standard feature and may not be supported at all sites. For example, messages to CSNET or BITNET sites -can often be sent to ``user@host.CSNET'' or ``user@host.BITNET'' respectively. +can often be sent to +.Dq user@host.CSNET +or +.Dq user@host.BITNET , +respectively. .Sh SEE ALSO .Xr mail 1 , .Xr sendmail 8 @@ -145,11 +165,15 @@ Crocker, D. H., .Em Standard for the Format of Arpa Internet Text Messages, RFC822. .Sh HISTORY -.Nm Mailaddr +.Nm appeared in 4.2 BSD. .Sh BUGS -The RFC822 group syntax (``group:user1,user2,user3;'') is not supported -except in the special case of ``group:;'' because of a conflict with old +The RFC822 group syntax +.Pq Dq group:user1,user2,user3; +is not supported +except in the special case of +.Dq group:; +because of a conflict with old berknet-style addresses. .Pp Route-Address syntax is grotty. diff --git a/share/man/man7/ports.7 b/share/man/man7/ports.7 index fac238d7414..3a0abd6234c 100644 --- a/share/man/man7/ports.7 +++ b/share/man/man7/ports.7 @@ -23,7 +23,7 @@ .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" -.\" $OpenBSD: ports.7,v 1.2 1998/09/05 17:41:49 deraadt Exp $ +.\" $OpenBSD: ports.7,v 1.3 1998/11/28 03:38:02 aaron Exp $ .\" $FreeBSD: ports.7,v 1.7 1998/06/23 04:38:50 hoek Exp $ .\" .Dd January 25, 1998 @@ -44,7 +44,7 @@ application source code compile and run on BSD. Compiling an application is as simple as typing .Ic make in the port directory! The -.Ql Pa Makefile +.Pa Makefile automatically fetches the application source code, either from a local disk or via ftp, unpacks it on your system, applies the patches, and compiles it. If all goes well, @@ -87,7 +87,11 @@ You will usually only target .Bl -tag -width configure .It Ar fetch Fetch all of the files needed to build this port from the site(s) -listed in MASTER_SITES and PATCH_SITES. See +listed in +.Ev MASTER_SITES +and +.Ev PATCH_SITES . +See .Ev FETCH_CMD and .Ev MASTER_SITE_OVERRIDE . @@ -253,7 +257,7 @@ The big Kahuna. .Xr pkg_add 1 , .Xr pkg_create 1 , .Xr pkg_delete 1 , -.Xr pkg_info 1 . +.Xr pkg_info 1 .Pp The FreeBSD handbook. .Sh AUTHORS |