Module Name: src
Committed By: wiz
Date: Mon May 4 20:54:16 UTC 2009
Modified Files:
src/share/man/man7: release.7
Log Message:
New sentence, new line. Use Aq instead of \*[Lt]\*[Gt].
To generate a diff of this commit:
cvs rdiff -u -r1.27 -r1.28 src/share/man/man7/release.7
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man7/release.7
diff -u src/share/man/man7/release.7:1.27 src/share/man/man7/release.7:1.28
--- src/share/man/man7/release.7:1.27 Thu Apr 9 03:02:21 2009
+++ src/share/man/man7/release.7 Mon May 4 20:54:16 2009
@@ -1,4 +1,4 @@
-.\" $NetBSD: release.7,v 1.27 2009/04/09 03:02:21 joerg Exp $
+.\" $NetBSD: release.7,v 1.28 2009/05/04 20:54:16 wiz Exp $
.\"
.\" Copyright (c) 1997, 2000, 2005 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -42,14 +42,14 @@
.Pp
In this document, the following special words have these definitions:
.Bl -tag -width "\*[Lt]machine_arch\*[Gt]"
-.It Em \*[Lt]machine\*[Gt]
+.It Aq Em machine
The platform for which the release was built, corresponding to the
.Em hw.machine
sysctl variable, e.g.
.Em i386
or
.Em amiga .
-.It Em \*[Lt]machine_arch\*[Gt]
+.It Aq Em machine_arch
The architecture for which a particular installation set was built,
corresponding to the
.Em hw.machine_arch
@@ -57,7 +57,7 @@
.Em i386
or
.Em m68k .
-.It Em \*[Lt]rel\*[Gt]
+.It Aq Em rel
The target release.
.El
.Pp
@@ -81,19 +81,19 @@
.Bx
checksums for the various files in that directory,
in the format produced by the command:
-.Sy cksum -o 1 \*[Lt]file\*[Gt] .
+.Sy cksum -o 1 Aq Sy file .
.Pp
All
.Sy CKSUM
files are POSIX checksums for the various files in that directory, in the
format produced by the command:
-.Sy cksum \*[Lt]file\*[Gt] .
+.Sy cksum Aq Sy file .
.Pp
All
.Sy MD5
files are MD5 digests for the various files in that directory, in the
format produced by the command:
-.Sy cksum -m \*[Lt]file\*[Gt] .
+.Sy cksum -m Aq Sy file .
.Pp
All
.Sy SYSVSUM
@@ -101,7 +101,7 @@
.At V
checksums for the various files in
that directory, in the format produced by the command:
-.Sy cksum -o 2 \*[Lt]file\*[Gt] .
+.Sy cksum -o 2 Aq Sy file .
.Pp
The MD5 digest is the safest checksum, followed by the POSIX checksum.
The other two checksums are provided only to ensure that the widest possible
@@ -109,7 +109,8 @@
.Pp
Files that end in
.Sy .tgz
-are gzipped tar archives. This is used in lieu of
+are gzipped tar archives.
+This is used in lieu of
.Sy .tar.gz
because the software used to download the sets may incorrectly auto-unpack
files ending in
@@ -132,7 +133,7 @@
.Sm off
.Xo
.Sy .../NetBSD-
-.Em \*[Lt]rel\*[Gt]
+.Aq Em rel
.Sy / .
.Xc
.Sm on
@@ -165,9 +166,9 @@
.Sm off
.Xo
.Sy .../NetBSD-
-.Em \*[Lt]rel\*[Gt]
+.Aq Em rel
.Sy /
-.Em \*[Lt]machine\*[Gt]
+.Aq Em machine
.Sy /installation/cdrom/
.Xc
.Sm on
@@ -186,41 +187,41 @@
.It Sy MD5
.It Sy README
.It Sy SYSVSUM
-.It Em \*[Lt]machine_arch\*[Gt] Ns Sy cd.iso
+.It Ao Em machine_arch Ac Ns Sy cd.iso
.El
.
.It Sy shared/
Files shared by two or more machine types.
.Bl -tag -width "\*[Lt]machine_arch\*[Gt]"
-.It Em \*[Lt]machine_arch\*[Gt] Ns Pa /
+.It Ao Em machine_arch Ac Ns Pa /
Files which may be shared by all systems of the same
-.Em \*[Lt]machine_arch\*[Gt]
+.Aq Em machine_arch
will be located in
.Sm off
.Xo
.Sy .../NetBSD-
-.Em \*[Lt]rel\*[Gt]
+.Aq Em rel
.Sy /shared/
-.Em \*[Lt]machine_arch\*[Gt]
+.Aq Em machine_arch
.Sy /
.Xc
.Sm on
with symbolic links pointing to these files from the
-.Em \*[Lt]machine\*[Gt]
+.Aq Em machine
subdirectory.
.It Sy ALL/
Files which are completely machine-independent will be
located in
-.Sy .../NetBSD- Ns Em \*[Lt]rel\*[Gt] Ns Sy /shared/ALL/
+.Sy .../NetBSD- Ns Ao Em rel Ac Ns Sy /shared/ALL/
with symbolic links pointing to these files from the
-.Em \*[Lt]machine\*[Gt]
+.Aq Em machine
subdirectory.
.El
.
.It Sy source/
Source codes of the operating system and patches for it
should be put into
-.Sy .../NetBSD- Ns Em \*[Lt]rel\*[Gt] Ns Sy /source/
+.Sy .../NetBSD- Ns Ao Em rel Ac Ns Sy /source/
using the following layout:
.Pp
.Bl -tag -width "patches/"
@@ -234,11 +235,12 @@
.It Sy MD5
.It Sy README
.It Sy SYSVSUM
-.It Sy diff- Ns Em \*[Lt]lastrel\*[Gt] Ns Sy - Ns Em \*[Lt]rel\*[Gt] Ns Sy .gz
+.It Sy diff- Ns Ao Em lastrel Ac Ns Sy - Ns Ao Em rel Ac Ns Sy .gz
Diff against the last release, usually generated by
.Ic cvs rdiff .
For patch releases, diffs against the last release
-are included. If the last release was a patch release itself, the
+are included.
+If the last release was a patch release itself, the
diff is against that patch release is included.
.El
.It Sy sets/
@@ -256,8 +258,10 @@
contains restrictions in their licensing that prevent others from
using these programs in closed-source environments.
.It Sy pkgsrc.tgz
-Package-sources for third party software ready to compile. See
-pkgsrc/README for more information.
+Package-sources for third party software ready to compile.
+See
+.Pa pkgsrc/README
+for more information.
.It Sy sharesrc.tgz
Contains machine-independent data files that can be shared across
architectures/systems.
@@ -269,19 +273,21 @@
to build kernels (like
.Xr config 1 ) .
.It Sy xsrc.tgz
-Source code of the X Window System used on all NetBSD architectures.
+Source code of the X Window System used on all
+.Nx
+architectures.
Includes X clients and servers.
.El
.El
.
-.It Em \*[Lt]machine\*[Gt] Ns Pa /
+.It Ao Em machine Ac Ns Pa /
The binary releases in
.Sm off
.Xo
.Sy .../NetBSD-
-.Em \*[Lt]rel\*[Gt]
+.Aq Em rel
.Sy /
-.Em \*[Lt]machine\*[Gt]
+.Aq Em machine
.Sy /
.Xc
.Sm on
@@ -308,16 +314,20 @@
.It Sy MD5
.It Sy SYSVSUM
.It Sy base.tgz
-The base binary distribution. This set contains the base
+The base binary distribution.
+This set contains the base
.Nx
utilities that are necessary for the system to run and be minimally
-functional. It includes shared libraries for those architectures that
-support them. This set excludes all things listed in the sets
+functional.
+It includes shared libraries for those architectures that support them.
+This set excludes all things listed in the sets
described below.
.It Sy comp.tgz
-The compiler tools distribution. This set contains the C and C++
+The compiler tools distribution.
+This set contains the C and C++
compilers, assembler, linker, other toolchain components, and their
-manual pages. It also includes the system include files
+manual pages.
+It also includes the system include files
.Pq Pa /usr/include
, and the static system libraries.
.It Sy etc.tgz
@@ -357,7 +367,8 @@
.It Sy xfont.tgz
This set includes the X11 fonts.
.It Sy xserver.tgz
-This set includes the X servers and manual pages for \*[Lt]machine\*[Gt].
+This set includes the X servers and manual pages for
+.Aq machine .
.Em "Note: this set may not be available on some platforms" .
.El
.It Sy kernel/
@@ -371,7 +382,8 @@
.It Sy netbsd-GENERIC.gz
A kernel built from the
.Sy GENERIC
-kernel configuration file. This is meant as an example only; different
+kernel configuration file.
+This is meant as an example only; different
platforms may have differently named kernels.
.El
.El
@@ -395,7 +407,7 @@
.It Sy MD5
.It Sy README
.It Sy SYSVSUM
-.It Sy netbsd- Ns Em \*[Lt]machine_arch\*[Gt] Ns Sy .iso
+.It Sy netbsd- Ns Ao Em machine_arch Ac Ns Sy .iso
.El
.It Sy diskimage/
disk images, for those platforms that provide them
