Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

New sentence, new line. Use Aq instead of \*[Lt]\*[Gt].

This commit is contained in:
wiz 2009-05-04 20:54:16 +00:00
parent e6bed77504
commit b4562aaf07
1 changed files with 49 additions and 37 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

86
share/man/man7/release.7
View File

@ -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. .\" Copyright (c) 1997, 2000, 2005 The NetBSD Foundation, Inc.
.\" All rights reserved. .\" All rights reserved.
@ -42,14 +42,14 @@ except possibly the path that leads to the release hierarchy.
.Pp .Pp
In this document, the following special words have these definitions: In this document, the following special words have these definitions:
.Bl -tag -width "\*[Lt]machine_arch\*[Gt]" .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 The platform for which the release was built, corresponding to the
.Em hw.machine .Em hw.machine
sysctl variable, e.g. sysctl variable, e.g.
.Em i386 .Em i386
or or
.Em amiga . .Em amiga .
.It Em \*[Lt]machine_arch\*[Gt] .It Aq Em machine_arch
The architecture for which a particular installation set was built, The architecture for which a particular installation set was built,
corresponding to the corresponding to the
.Em hw.machine_arch .Em hw.machine_arch
@ -57,7 +57,7 @@ sysctl variable, e.g.
.Em i386 .Em i386
or or
.Em m68k . .Em m68k .
.It Em \*[Lt]rel\*[Gt] .It Aq Em rel
The target release. The target release.
.El .El
.Pp .Pp
@ -81,19 +81,19 @@ files are historic
.Bx .Bx
checksums for the various files in that directory, checksums for the various files in that directory,
in the format produced by the command: in the format produced by the command:
.Sy cksum -o 1 \*[Lt]file\*[Gt] . .Sy cksum -o 1 Aq Sy file .
.Pp .Pp
All All
.Sy CKSUM .Sy CKSUM
files are POSIX checksums for the various files in that directory, in the files are POSIX checksums for the various files in that directory, in the
format produced by the command: format produced by the command:
.Sy cksum \*[Lt]file\*[Gt] . .Sy cksum Aq Sy file .
.Pp .Pp
All All
.Sy MD5 .Sy MD5
files are MD5 digests for the various files in that directory, in the files are MD5 digests for the various files in that directory, in the
format produced by the command: format produced by the command:
.Sy cksum -m \*[Lt]file\*[Gt] . .Sy cksum -m Aq Sy file .
.Pp .Pp
All All
.Sy SYSVSUM .Sy SYSVSUM
@ -101,7 +101,7 @@ files are historic
.At V .At V
checksums for the various files in checksums for the various files in
that directory, in the format produced by the command: that directory, in the format produced by the command:
.Sy cksum -o 2 \*[Lt]file\*[Gt] . .Sy cksum -o 2 Aq Sy file .
.Pp .Pp
The MD5 digest is the safest checksum, followed by the POSIX checksum. 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 The other two checksums are provided only to ensure that the widest possible
@ -109,7 +109,8 @@ range of system can check the integrity of the release files.
.Pp .Pp
Files that end in Files that end in
.Sy .tgz .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 .Sy .tar.gz
because the software used to download the sets may incorrectly auto-unpack because the software used to download the sets may incorrectly auto-unpack
files ending in files ending in
@ -132,7 +133,7 @@ CD-ROM, but in all other cases it should be
.Sm off .Sm off
.Xo .Xo
.Sy .../NetBSD- .Sy .../NetBSD-
.Em \*[Lt]rel\*[Gt] .Aq Em rel
.Sy / . .Sy / .
.Xc .Xc
.Sm on .Sm on
@ -165,9 +166,9 @@ Images in this directory, unlike images in the
.Sm off .Sm off
.Xo .Xo
.Sy .../NetBSD- .Sy .../NetBSD-
.Em \*[Lt]rel\*[Gt] .Aq Em rel
.Sy / .Sy /
.Em \*[Lt]machine\*[Gt] .Aq Em machine
.Sy /installation/cdrom/ .Sy /installation/cdrom/
.Xc .Xc
.Sm on .Sm on
@ -186,41 +187,41 @@ These images are usually bootable.
.It Sy MD5 .It Sy MD5
.It Sy README .It Sy README
.It Sy SYSVSUM .It Sy SYSVSUM
.It Em \*[Lt]machine_arch\*[Gt] Ns Sy cd.iso .It Ao Em machine_arch Ac Ns Sy cd.iso
.El .El
. .
.It Sy shared/ .It Sy shared/
Files shared by two or more machine types. Files shared by two or more machine types.
.Bl -tag -width "\*[Lt]machine_arch\*[Gt]" .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 Files which may be shared by all systems of the same
.Em \*[Lt]machine_arch\*[Gt] .Aq Em machine_arch
will be located in will be located in
.Sm off .Sm off
.Xo .Xo
.Sy .../NetBSD- .Sy .../NetBSD-
.Em \*[Lt]rel\*[Gt] .Aq Em rel
.Sy /shared/ .Sy /shared/
.Em \*[Lt]machine_arch\*[Gt] .Aq Em machine_arch
.Sy / .Sy /
.Xc .Xc
.Sm on .Sm on
with symbolic links pointing to these files from the with symbolic links pointing to these files from the
.Em \*[Lt]machine\*[Gt] .Aq Em machine
subdirectory. subdirectory.
.It Sy ALL/ .It Sy ALL/
Files which are completely machine-independent will be Files which are completely machine-independent will be
located in 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 with symbolic links pointing to these files from the
.Em \*[Lt]machine\*[Gt] .Aq Em machine
subdirectory. subdirectory.
.El .El
. .
.It Sy source/ .It Sy source/
Source codes of the operating system and patches for it Source codes of the operating system and patches for it
should be put into 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: using the following layout:
.Pp .Pp
.Bl -tag -width "patches/" .Bl -tag -width "patches/"
@ -234,11 +235,12 @@ Other patches may exist for fixing critical problems.
.It Sy MD5 .It Sy MD5
.It Sy README .It Sy README
.It Sy SYSVSUM .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 Diff against the last release, usually generated by
.Ic cvs rdiff . .Ic cvs rdiff .
For patch releases, diffs against the last release 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. diff is against that patch release is included.
.El .El
.It Sy sets/ .It Sy sets/
@ -256,8 +258,10 @@ Contains sources for all GPLed and possibly other programs that
contains restrictions in their licensing that prevent others from contains restrictions in their licensing that prevent others from
using these programs in closed-source environments. using these programs in closed-source environments.
.It Sy pkgsrc.tgz .It Sy pkgsrc.tgz
Package-sources for third party software ready to compile. See Package-sources for third party software ready to compile.
pkgsrc/README for more information. See
.Pa pkgsrc/README
for more information.
.It Sy sharesrc.tgz .It Sy sharesrc.tgz
Contains machine-independent data files that can be shared across Contains machine-independent data files that can be shared across
architectures/systems. architectures/systems.
@ -269,19 +273,21 @@ Kernel sources for all architectures plus sources of the tools needed
to build kernels (like to build kernels (like
.Xr config 1 ) . .Xr config 1 ) .
.It Sy xsrc.tgz .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. Includes X clients and servers.
.El .El
.El .El
. .
.It Em \*[Lt]machine\*[Gt] Ns Pa / .It Ao Em machine Ac Ns Pa /
The binary releases in The binary releases in
.Sm off .Sm off
.Xo .Xo
.Sy .../NetBSD- .Sy .../NetBSD-
.Em \*[Lt]rel\*[Gt] .Aq Em rel
.Sy / .Sy /
.Em \*[Lt]machine\*[Gt] .Aq Em machine
.Sy / .Sy /
.Xc .Xc
.Sm on .Sm on
@ -308,16 +314,20 @@ installation sets
.It Sy MD5 .It Sy MD5
.It Sy SYSVSUM .It Sy SYSVSUM
.It Sy base.tgz .It Sy base.tgz
The base binary distribution. This set contains the base The base binary distribution.
This set contains the base
.Nx .Nx
utilities that are necessary for the system to run and be minimally utilities that are necessary for the system to run and be minimally
functional. It includes shared libraries for those architectures that functional.
support them. This set excludes all things listed in the sets It includes shared libraries for those architectures that support them.
This set excludes all things listed in the sets
described below. described below.
.It Sy comp.tgz .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 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 .Pq Pa /usr/include
, and the static system libraries. , and the static system libraries.
.It Sy etc.tgz .It Sy etc.tgz
@ -357,7 +367,8 @@ sources.
.It Sy xfont.tgz .It Sy xfont.tgz
This set includes the X11 fonts. This set includes the X11 fonts.
.It Sy xserver.tgz .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" . .Em "Note: this set may not be available on some platforms" .
.El .El
.It Sy kernel/ .It Sy kernel/
@ -371,7 +382,8 @@ suitably named, gzipped kernels
.It Sy netbsd-GENERIC.gz .It Sy netbsd-GENERIC.gz
A kernel built from the A kernel built from the
.Sy GENERIC .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. platforms may have differently named kernels.
.El .El
.El .El
@ -395,7 +407,7 @@ other components of a complete release.
.It Sy MD5 .It Sy MD5
.It Sy README .It Sy README
.It Sy SYSVSUM .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 .El
.It Sy diskimage/ .It Sy diskimage/
disk images, for those platforms that provide them disk images, for those platforms that provide them