[src/trunk]: src/distrib/notes/news68k The first cut of news68k install notes...

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

details:   https://anonhg.NetBSD.org/src/rev/84c118afce4b
branches:  trunk
changeset: 487874:84c118afce4b
user:      tsutsui <tsutsui%NetBSD.org@localhost>
date:      Wed Jun 14 10:34:29 2000 +0000

description:
The first cut of news68k install notes. Needs more enhancement.

XXX How can we sync "contents" files on all ports?

diffstat:

 distrib/notes/news68k/Makefile |    3 +
 distrib/notes/news68k/contents |  288 +++++++++++++++++++++++++++++++++++++++++
 distrib/notes/news68k/hardware |   48 ++++++
 distrib/notes/news68k/install  |    2 +
 distrib/notes/news68k/legal    |    2 +
 distrib/notes/news68k/prep     |    6 +
 distrib/notes/news68k/upgrade  |    3 +
 distrib/notes/news68k/whatis   |    3 +
 distrib/notes/news68k/xfer     |  114 ++++++++++++++++
 9 files changed, 469 insertions(+), 0 deletions(-)

diffs (truncated from 505 to 300 lines):

diff -r 7118272f044d -r 84c118afce4b distrib/notes/news68k/Makefile
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/news68k/Makefile    Wed Jun 14 10:34:29 2000 +0000
@@ -0,0 +1,3 @@
+#      $NetBSD: Makefile,v 1.1 2000/06/14 10:34:29 tsutsui Exp $
+
+.include <bsd.prog.mk>
diff -r 7118272f044d -r 84c118afce4b distrib/notes/news68k/contents
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/distrib/notes/news68k/contents    Wed Jun 14 10:34:29 2000 +0000
@@ -0,0 +1,288 @@
+.\"    $NetBSD: contents,v 1.1 2000/06/14 10:34:30 tsutsui Exp $
+.\"
+.\" Copyright (c) 1999, 2000 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.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"        This product includes software developed by the NetBSD
+.\"        Foundation, Inc. and its contributors.
+.\" 4. Neither the name of The NetBSD Foundation nor the names of its
+.\"    contributors may be used to endorse or promote products derived
+.\"    from this software without specific prior written permission.
+.\"
+.\" 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.
+.\"
+.ds m \*[MACHINE]
+.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/
+.Bl -tag -compact -width INSTALL.html
+.      It Pa INSTALL.html
+.      It Pa INSTALL.ps
+.      It Pa INSTALL.txt
+.      It Pa INSTALL.more
+Installation notes; this file. The
+.Pa \&.more No file contains underlined text using the
+.Xr more 1
+conventions for indicating italic and bold display.
+.      It Pa binary/
+.      Bl -tag -compact -width diskimage/
+.              It Pa sets/
+\*m binary distribution sets;
+see below.
+.              It Pa kernel/
+\*m installation kernels.
+.              It Pa security/
+\*m security distribution; see below.
+.      El
+.      It Pa installation/
+.\" BTW, .Bl ... .El is not allowed unless there is at least one .It.
+.
+.\"============================================ MD INSTALLATION SUBTREE
+.
+.      Bl -tag -compact -width diskimage/
+.              It Pa floppy/
+\*m boot and installation floppy; see below.
+.              It Pa kernel/
+.No contains a Pa netbsd-INSTALL.gz
+installation kernel; this is the same installer kernel as in the
+install image, but without the various boot program and filesystem
+wrappers. It can be netbooted or diskbooted from a previous installation.
+.      El
+.
+.El
+.
+.
+.
+.if r_news68k \{\
+.Ss2 Bootable installation floppy
+.Pp
+There is a bootable image in the
+.Nx
+\*m distribution.
+This is a single-file image containing the install kernel,
+which includes ramdisk root filesystem image.
+.\}
+.
+.Ss2 Binary Distribution Sets
+The
+.Nx
+\*m
+binary distribution sets contain the binaries which
+comprise the
+.Nx \*V
+release for the \*m. There are eight binary distribution
+.ie r_pc532 sets.
+.el .No sets and the Em security No distribution set.
+The binary distribution sets can be found in the
+.Pa \*m/binary/sets
+subdirectory
+of the
+.Nx \*V
+distribution tree, and are as follows:
+.Bl -tag -width mmmmmmmmmmm -compact
+.Pp
+.It Sy base
+The
+.Nx \*V
+.No \*m Sy base No 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
+includes shared library support, and excludes
+everything described below.
+.br
+.if r_news68k .Em 12.9M gzipped, 40.1M uncompressed
+.Pp
+.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.
+.br
+.if r_news68k .Em 13M gzipped, 50M uncompressed
+.Pp
+.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. (If you are upgrading,
+it's recommended that you get a copy of this set and
+.Em carefully
+upgrade your configuration files by hand.)
+.br
+.if r_news68k .Em 56K gzipped, 330K uncompressed
+.Pp
+.It Sy games
+This set includes the games and their manual pages.
+.br
+.if r_news68k .Em 2.8M gzipped, 7M uncompressed
+.
+.\" garden variety kern set description
+.
+.if !\n[arm32]:\n[atari]:\n[mac68k]:\n[sun3] \{\
+.Pp
+.It Sy kern
+This set contains a NetBSD/\*m \*V
+.Tn GENERIC No kernel, named Pa /netbsd .
+.No You Em must
+install this distribution set.
+.br
+.if r_news68k .Em 532k gzipped, 1.1M uncompressed
+.\}
+.Pp
+.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.
+.br
+.\" Contrary to popular belief, these aren't MI yet....
+.\" .Em 4.0M gzipped, 15.9M uncompressed
+.if r_news68k .Em 3.9M gzipped, 15.6M uncompressed
+.Pp
+.It Sy misc
+This set includes the (rather large) system dictionaries,
+the typesettable document set, and other files from
+.Pa /usr/share .
+.br
+.\" Contrary to popular belief, these aren't (quite!) MI yet....
+.\" .Em 2.1M gzipped, 8.5M uncompressed
+.if r_news68k .Em 2.2M gzipped, 8.5M uncompressed
+.Pp
+.It Sy text
+This set includes NetBSD's text processing tools,
+including
+.Xr groff 1 ,
+all related programs, and their manual pages.
+.br
+.if r_news68k .Em 1.3M gzipped, 4.5M uncompressed
+.El
+.
+.
+.el \{\
+.Pp
+The \*m security distribution set is named
+.Sy secr No and can be found in the
+.D1 Pa \*m/binary/security
+subdirectory of the
+.Nx \*V
+distribution tree. It contains security-related binaries
+which depend on cryptographic source code. You do not need this
+distribution set to use encrypted passwords in your password file; the
+.Sy base
+distribution includes a crypt library which can perform
+only the one-way encryption function. The security distribution
+includes a version of the Kerberos IV network security system, and
+a Kerberized version of
+.Xr telnet 1
+.No program. The Sy secr
+distribution set can be found only on those sites which carry the complete
+.Nx
+distribution and which can legally obtain it. Because
+of United States law, it may not be legal to distribute this set
+to locations outside of the United States and Canada.
+.br
+.if r_alpha .Em 1M gzipped, 3M uncompressed
+.if r_i386 . Em 798K gzipped, 2.4M uncompressed
+.\}
+.
+.
+.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 XFree86, and tightly track XFree86 releases.
+They are currently equivalent to XFree86 3.3.6.
+Binary sets for the X Window system are distributed with
+.Nx .
+.if r_news68k \{\
+Unfortunately, there is no framebuffer support on NetBSD/news68k yet,
+so we can only distribute the X clients this time.
+.\}
+The sets are:
+.Bl -tag -width xcontribmmm
+.It Sy xbase
+The basic files needed for a complete X
+client environment. This does not include
+the X servers.
+.br
+.if r_news68k .Em 2.4M gzippeed, 7.7M uncompressed
+.It Sy xcomp
+The extra libraries and include files needed to compile X source code.
+.br
+.if r_news68k .Em 1.6M gzipped, 6.8M uncompressed
+.It Sy xcontrib
+Programs that were contributed to X.
+.br
+.if r_news68k .Em 179k gzipped, 670k uncompressed
+.br
+.\" Contrary to popular belief, these aren't MI yet....
+.\" .Em 5.5M gzipped, 6.8M uncompressed
+.
+.
+.El
+.
+.\"============================ MI DISCUSSION OF BINARY SETS
+.
+.Pp
+The \*m binary distribution sets are distributed as gzipped tar files
+named with the extension
+.Sy .tgz , No 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 files are /-relative and
+therefore are extracted
+.Em below
+the current directory. That
+is, 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 xfp
+command from /.
+.
+.
+.
+.
diff -r 7118272f044d -r 84c118afce4b distrib/notes/news68k/hardware