aboutsummaryrefslogtreecommitdiff
path: root/release/ABOUT.TXT
diff options
context:
space:
mode:
authorJordan K. Hubbard <jkh@FreeBSD.org>1996-12-14 22:45:42 +0000
committerJordan K. Hubbard <jkh@FreeBSD.org>1996-12-14 22:45:42 +0000
commit5d755bde76197bd6f4ab9b8f9c2f8835c0bceb27 (patch)
tree47005192f61e9d91932f3d25f985969a6792fae6 /release/ABOUT.TXT
parent3c1d2e5b15a5b2425ed7f68dbb0d9b0cb72ea1da (diff)
downloadsrc-5d755bde76197bd6f4ab9b8f9c2f8835c0bceb27.tar.gz
src-5d755bde76197bd6f4ab9b8f9c2f8835c0bceb27.zip
Give this file a home also. No, I don't like it here either but
I don't want it in sysinstall/help, since that'll get it stuck on the actual floppy, and I didn't fell like creating a doc/ subdirectory for one file either. Bah.
Notes
Notes: svn path=/head/; revision=20480
Diffstat (limited to 'release/ABOUT.TXT')
-rw-r--r--release/ABOUT.TXT83
1 files changed, 83 insertions, 0 deletions
diff --git a/release/ABOUT.TXT b/release/ABOUT.TXT
new file mode 100644
index 000000000000..d83f52d43965
--- /dev/null
+++ b/release/ABOUT.TXT
@@ -0,0 +1,83 @@
+This file attempts to describe what you're seeing here. Here is a typical
+distribution tree:
+
+HARDWARE.TXT bin dict manpages tools
+INSTALL.TXT compat1x des doc packages
+README.TXT compat20 floppies ports
+RELNOTES.TXT compat21 games proflibs
+XF8632 info src
+
+The *.TXT files are, obviously, documentation. The XF8632 directory contains
+the XFree86 project's 3.2 release and consists of a series of gzip'd tar
+files which contain each component of the XFree86 distribution.
+
+The compat1x, compat20 and compat21 directories contain compatibility
+distributions for older releases and are also distributed as single gzip'd
+tar files - they can be installed during release time or later by running
+their `install.sh' scripts.
+
+The bin, dict, des, doc, games, info, manpages, proflibs and src directories
+contain the primary distribution components of FreeBSD itself and are split
+into smaller files for ease of distribution on floppy (should such be
+necessary). A typical distribution (we'll use the info distribution
+as an example) looks like this:
+
+CHECKSUM.MD5 info.ab info.ad info.inf install.sh
+info.aa info.ac info.ae info.mtree
+
+The CHECKSUM.MD5 file contains MD5 signatures for each file, should
+data corruption be suspected, and is purely for reference - it is not
+used by the actual installation. The info.a* files are split, gzip'd
+tar files, the contents of which could be viewed by doing:
+
+ cat info.a* | tar tvzf -
+
+They are automatically concatenated and extracted during the installation
+procedure, assuming that the info distribution was selected in the
+distributions menu.
+
+The info.inf file is also a necessary component and is read by the
+installation program in order to figure out how many pieces to look for
+when fetching and concatenating the distribution. When putting a distribution
+onto floppies, this file must occupy the first floppy of the set.
+
+The info.mtree file is another non-essential file which is provided purely
+for user reference. It contains the MD5 signatures of the *unpacked*
+distribution and can be used later as fodder for the mtree(1) program
+in verifying the permissions and checksums of the distribution against
+whatever is installed on your system. When used with the bin distribution,
+this can be an excellent way of detecting trojan horse attacks on your
+system.
+
+Finally, the install.sh file is for use by those who'd like to install the
+distribution *after* installation time, e.g. some time after the system
+is already installed and working. To install the info distribution from
+CDROM after your system was installed, for example, you'd do:
+
+ cd /cdrom/info
+ sh install.sh
+
+And that's all there is to it! This also works for the other distributions,
+including the compat* ones.
+
+
+The floppies subdirectory contains the floppy installation images.
+The floppies/README.TXT file should be referred to for more information
+about them.
+
+The packages and ports directories contain the FreeBSD packages and
+ports collections, respectively. The packages may be installed using
+the package menu in /stand/sysinstall (the utility which runs when you
+first install FreeBSD) or individually with the pkg_add(1) command.
+
+The ports tree should be copied to your hard disk or linked to with
+the lndir command, which comes with the XFree86 distribution. More
+information on it can be obtained from http://www.freebsd.org/ports
+or locally from file:/usr/share/doc/handbook if you've installed
+the doc distribution.
+
+Last of all, the tools directory contains various DOS tools for
+discovering disk geometries, installing boot managers and the like.
+It is purely optional and provided merely for user convenience.
+
+ Jordan