[src/trunk]: src/distrib/notes Move common/contents file into MD dirs again.

[tsutsui <tsutsui%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/d75a007f654c
branches:  trunk
changeset: 765481:d75a007f654c
user:      tsutsui <tsutsui%NetBSD.org@localhost>
date:      Sat May 28 06:00:05 2011 +0000

description:
Move common/contents file into MD dirs again.
I know it isn't a good thing to have many copy-and-pasted contents
(set file descriptions etc) in all MD files, but it's much more annoying
to maintain a bunch of .if \n [${MACHINE}] conditionals for all ports
and maintainers rarely notice that they also have to prepare or update
MD contents in MI content file with messy ifdefs.

XXX: of course common text should be shared by mdoc macro etc.
     but I doubt playing mdoc(7) is really worth...

diffstat:

 distrib/notes/acorn26/contents     |  263 ++++++++++++++++++++++
 distrib/notes/acorn32/contents     |  259 +++++++++++++++++++++
 distrib/notes/alpha/contents       |  314 ++++++++++++++++++++++++++
 distrib/notes/amd64/contents       |  251 +++++++++++++++++++++
 distrib/notes/amiga/contents       |  274 +++++++++++++++++++++++
 distrib/notes/arc/contents         |  250 +++++++++++++++++++++
 distrib/notes/atari/contents       |  439 +++++++++++++++++++++++++++++++++++++
 distrib/notes/bebox/contents       |  260 +++++++++++++++++++++
 distrib/notes/cats/contents        |  258 +++++++++++++++++++++
 distrib/notes/common/main          |    4 +-
 distrib/notes/emips/contents       |  255 +++++++++++++++++++++
 distrib/notes/evbarm/contents      |  265 ++++++++++++++++++++++
 distrib/notes/evbppc/contents      |  355 +++++++++++++++++++++++++++++
 distrib/notes/ews4800mips/contents |  258 +++++++++++++++++++++
 distrib/notes/hp300/contents       |  293 ++++++++++++++++++++++++
 distrib/notes/hp700/contents       |  256 +++++++++++++++++++++
 distrib/notes/hpcarm/contents      |  255 +++++++++++++++++++++
 distrib/notes/hpcmips/contents     |  342 ++++++++++++++++++++++++++++
 distrib/notes/hpcsh/contents       |  258 +++++++++++++++++++++
 distrib/notes/i386/contents        |  278 +++++++++++++++++++++++
 distrib/notes/landisk/contents     |  256 +++++++++++++++++++++
 distrib/notes/mac68k/contents      |  346 +++++++++++++++++++++++++++++
 distrib/notes/macppc/contents      |  294 ++++++++++++++++++++++++
 distrib/notes/mmeye/contents       |  255 +++++++++++++++++++++
 distrib/notes/mvme68k/contents     |  391 ++++++++++++++++++++++++++++++++
 distrib/notes/news68k/contents     |  259 +++++++++++++++++++++
 distrib/notes/newsmips/contents    |  260 +++++++++++++++++++++
 distrib/notes/next68k/contents     |  256 +++++++++++++++++++++
 distrib/notes/pmax/contents        |  257 +++++++++++++++++++++
 distrib/notes/prep/contents        |  258 +++++++++++++++++++++
 distrib/notes/rs6000/contents      |  255 +++++++++++++++++++++
 distrib/notes/sandpoint/contents   |  276 +++++++++++++++++++++++
 distrib/notes/sgimips/contents     |  333 ++++++++++++++++++++++++++++
 distrib/notes/shark/contents       |  260 +++++++++++++++++++++
 distrib/notes/sparc/contents       |  350 +++++++++++++++++++++++++++++
 distrib/notes/sparc64/contents     |  299 +++++++++++++++++++++++++
 distrib/notes/sun2/contents        |  289 ++++++++++++++++++++++++
 distrib/notes/sun3/contents        |  284 +++++++++++++++++++++++
 distrib/notes/vax/contents         |  263 ++++++++++++++++++++++
 distrib/notes/x68k/contents        |  264 ++++++++++++++++++++++
 40 files changed, 11090 insertions(+), 2 deletions(-)

diffs (truncated from 11263 to 300 lines):

diff -r 33240b3427a6 -r d75a007f654c distrib/notes/acorn26/contents
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/acorn26/contents    Sat May 28 06:00:05 2011 +0000
@@ -0,0 +1,263 @@
+.\"    $NetBSD: contents,v 1.1 2011/05/28 06:00:05 tsutsui Exp $
+.\"
+.\" Copyright (c) 1999-2005 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.
+.Ss2 NetBSD/\*M subdirectory structure
+The \*M-specific portion of the
+.Nx
+\*V release is found in the
+.Pa \*M
+subdirectory of the distribution:
+.ie \n[FOR_RELEASE] .Pa \&.../NetBSD-\*V/\*M/ .
+.el .Pa Pf \&.../arch/\*M/snapshot/ Ar yyyymmdd/ .
+It contains the following files and directories:
+.Pp
+.(tag INSTALL.html -compact \" top level
+.      It Pa INSTALL.html
+.      It Pa INSTALL.ps
+.      It Pa INSTALL.txt
+.      It Pa INSTALL.more
+Installation notes in various file formats, including this file.
+The
+.Pa \&.more
+file contains underlined text using the
+.Xr more 1
+conventions for indicating italic and bold display.
+.
+.\" MD binary and installation directories ---------------------------
+.
+.      It Pa binary/
+.
+.      (tag kernel/ -compact \" binary/
+.
+.              It Pa kernel/
+.
+.              (tag netbsd.gz -compact \" binary/kernel
+.
+.                      It Pa netbsd-GENERIC.gz
+.
+A gzipped
+.Nx
+kernel containing code for everything supported in this release.
+.
+.                      It Pa netbsd-FOURMEG.gz
+.
+A somewhat smaller kernel, intended to be usable on systems with
+four megabytes of RAM.
+.
+.              tag) \" binary/kernel/
+.              It Pa sets/
+\*M binary distribution sets;
+see below.
+.      tag) \" binary/
+.      It Pa installation/
+.
+.      (tag miniroot/ -compact \" installation/
+.
+.              It Pa misc/
+.
+Miscellaneous \*M installation utilities; see
+installation section below.
+.
+.      tag) \" installation/
+.
+.tag) \" top level
+.
+.\" ------------------------------------------------------------------
+.
+.
+.Ss2 Binary distribution sets
+.\"
+.\" ------------------------------------------------------------------
+.\" XXX: most sets except kern and xserver should be in notes/common
+.\"
+The
+.Nx
+\*M
+binary distribution sets contain the binaries which
+comprise the
+.Nx
+\*V release for \*M.
+The binary distribution sets can be found in the
+.Pa \*M/binary/sets
+subdirectory
+of the
+.Nx
+\*V
+distribution tree, and are as follows:
+.(tag xserver \" sets
+.
+.It Sy base
+The
+.Nx
+\*V
+\*M
+.Sy base
+binary distribution.
+You
+.Em must
+install this distribution set.
+It contains the base
+.Nx
+utilities that are necessary for the
+system to run and be minimally functional.
+.
+.It Sy comp
+Things needed for compiling programs.
+This set includes the system include files
+.Pq Pa /usr/include
+and the various system libraries (except the shared
+libraries, which are included as part of the
+.Sy base
+set).
+This set also includes the manual pages for
+all of the utilities it contains, as well as the
+system call and library manual pages.
+.
+.It Sy etc
+This distribution set contains the system
+configuration files that reside in
+.Pa /etc
+and in several other places.
+This set
+.Em must
+be installed if you are installing the system from scratch, but should
+.Em not
+be used if you are upgrading.
+.
+.It Sy games
+This set includes the games and their manual pages.
+.
+.\" MD kernel set(s) -------------------------------------------------
+.
+.It Sy kern-GENERIC
+This set contains a
+.Nx*M
+\*V
+.Li GENERIC
+kernel, named
+.Pa /netbsd .
+You
+.Em must
+install this distribution set.
+.
+.\" ------------------------------------------------------------------
+.
+.It Sy man
+This set includes all of the manual pages for the
+binaries and other software contained in the
+.Sy base
+set.
+Note that it does not include any of the manual pages
+that are included in the other sets.
+.
+.It Sy misc
+This set includes the system dictionaries,
+the typesettable document set, and other files from
+.Pa /usr/share .
+.
+.It Sy text
+This set includes
+.Nx Ns 's
+text processing tools, including
+.Xr groff 1 ,
+all related programs, and their manual pages.
+.
+.tag) \" sets
+.
+.
+.\" X sets -----------------------------------------------------------
+.\" XXX: XOrg vs XFree
+.\" XXX: ports without xserver
+.Pp
+.Nx
+maintains its own set of sources for the X Window System in order to
+assure tight integration and compatibility.
+These sources are based on X.Org.
+Binary sets for the X Window System are distributed with
+.Nx .
+The sets are:
+.(tag xserver \" x sets
+.
+.It Sy xbase
+The basic files needed for a complete X
+client environment.
+This does not include the X servers.
+.
+.It Sy xcomp
+The extra libraries and include files needed to compile X source code.
+.
+.It Sy xfont
+Fonts needed by the X server and by X clients.
+.
+.It Sy xetc
+Configuration files for X which could be locally modified.
+.
+.It Sy xserver
+The X server. 
+.
+.tag) \" x sets
+.
+.\" ------------------------------------------------------------------
+.
+.
+.\" MI DISCUSSION OF BINARY SETS -------------------------------------
+.\" XXX: should be in notes/common
+.
+.Pp
+The \*M binary distribution sets are distributed as gzipped tar files
+named with the extension
+.Sy .tgz ,
+e.g.
+.Pa base.tgz .
+.
+.
+.Pp
+The instructions given for extracting the source sets work equally
+well for the binary sets, but it is worth noting that if you use that
+method, the filenames stored in the sets are relative and therefore
+the files are extracted
+.Em below the current directory .
+Therefore, if you want to extract the binaries into your system, i.e.
+replace the system binaries with them, you have to run the
+.Ic "tar -xzpf"
+command from the root directory (
+.Pa / 
+) of your system.
+.
+.
+.\" MD DISCUSSION ----------------------------------------------------
+.
+.Pp
+There is a copy of the
+.Nx Ns /acorn26
+bootloader,
+.Ic boot26 ,
+in the
+.Pa installation/misc
+subdirectory.
+This is a RISC OS relocatable module, and should have its file
+type set to ffa (Module) once it's been copied to a RISC OS system.
diff -r 33240b3427a6 -r d75a007f654c distrib/notes/acorn32/contents
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/acorn32/contents    Sat May 28 06:00:05 2011 +0000
@@ -0,0 +1,259 @@
+.\"    $NetBSD: contents,v 1.1 2011/05/28 06:00:05 tsutsui Exp $
+.\"
+.\" Copyright (c) 1999-2005 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.
+.Ss2 NetBSD/\*M subdirectory structure
+The \*M-specific portion of the