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.
.\" All rights reserved.
@ -42,14 +42,14 @@ except possibly the path that leads to the release hierarchy.
.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 @@ sysctl variable, e.g.
.Em i386
or
.Em m68k .
.It Em \*[Lt]rel\*[Gt]
.It Aq Em rel
The target release.
.El
.Pp
@ -81,19 +81,19 @@ files are historic
.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 @@ files are historic
.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 @@ range of system can check the integrity of the release files.
.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 @@ CD-ROM, but in all other cases it should be
.Sm off
.Xo
.Sy .../NetBSD-
.Em \*[Lt]rel\*[Gt]
.Aq Em rel
.Sy / .
.Xc
.Sm on
@ -165,9 +166,9 @@ Images in this directory, unlike images in the
.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 @@ These images are usually bootable.
.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 @@ Other patches may exist for fixing critical problems.
.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 sources for all GPLed and possibly other programs that
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 @@ Kernel sources for all architectures plus sources of the tools needed
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 @@ installation sets
.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 @@ sources.
.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 @@ suitably named, gzipped kernels
.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 @@ other components of a complete release.
.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