1 files changed, 207 insertions, 0 deletions
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..5d512a1
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,207 @@
+=======================================
+ README for Adélie Linux Base File Set
+=======================================
+:Authors:
+ * **A. Wilcox**, maintainer / developer
+ * **Elizabeth Myers**, developer
+ * **The FreeBSD project and its contributors**, files in /etc
+:Status:
+ Production
+:Copyright:
+ © 2016 Adélie Linux.  BSD open source license.
+
+
+
+Introduction
+============
+
+This distribution contains the base file set needed for running Adélie Linux.
+Its contents are installed to the root file system.
+
+
+License
+```````
+The Adélie Linux project typically licenses its original source code under the
+permissive, open NCSA license.  However, since the project has found no usable
+copies of some files needed for /etc licensed under such a license, it has been
+deemed necessary to seek outside projects for these files.
+
+The closest project that met the criteria of freely licensed and usable files
+was FreeBSD; therefore, the entire base file set is licensed under the terms of
+the 3-clause BSD license.
+
+
+Changes
+```````
+Any changes to this repository must be reviewed before being pushed to the
+master branch.  There are no exceptions to this rule.  For security-sensitive
+updates, contact the Security Team at sec-bugs@adelielinux.org.
+
+
+
+Background
+==========
+
+The ``baselayout`` package from the upstream Gentoo project is deficient in a
+number of ways.  It was determined to be fairly inflexible, especially relating
+to forcing the installation of a modprobe.d directory with deprecated aliases.
+It also installs Gentoo-specific release files (including the
+``/etc/gentoo-release`` file and the contents of ``/etc/os-release``), and
+makes assumptions about shell environments that may not exist on Adélie.  This
+led directly to the creation of this project.
+
+
+
+Assumptions and Dependencies
+============================
+
+#. It is assumed that the target computer is running a Unix-compatible
+   operating environment.
+
+#. It is assumed that there is no other software distribution installed on the
+   target computer.  However, an older version of Adélie may be installed.
+
+#. This project must supply an ``/etc/lsb-release`` file compliant with the
+   `Linux Standard Base`__, which at the time of this writing is at version
+   5.0.
+__ http://refspecs.linux-foundation.org/LSB_5.0.0/LSB-Core-generic/LSB-Core-generic/execenvfhs.html
+
+#. This project must comply with the `Filesystem Hierarchy Standard`__,
+   which at the time of this writing is at version 3.0.
+__ http://refspecs.linuxfoundation.org/FHS_3.0/fhs-3.0.html
+
+
+
+
+Scope and Limitations
+=====================
+
+This section is informational and contains an overall roadmap for the
+development of this project.
+
+
+Initial release
+```````````````
+
+Version 1.0 must be fully usable on all Tier I architectures specified for the
+Adélie Linux project.  It must render the system operable and compliant with
+the Filesystem Hierarchy Standard, version 3.0.
+
+Future versions of 1.x may add support for non-Tier I architectures, if such
+support is necessary in this project.  It is not anticipated to include any
+architecture- or machine-specific objects in this project.
+
+
+Secondary release
+`````````````````
+
+If user demand is present for a port of the Adélie system to a different kernel
+such as FreeBSD is present, changes to this project to ensure compatibility
+with such a system may begin during the 2.x version cycle.
+
+
+Subsequent releases
+```````````````````
+
+Newer versions of the LSB or FHS standards may require tweaks or changes to
+this project.  They will be reviewed and the changes required will be
+determined if and when such standard updates are published.
+
+
+Limitations and exclusions
+``````````````````````````
+
+The following portions of the FHS and LSB are purposefully ignored by this
+project, for the reason specified.
+
+Executables in ``/bin``
+:::::::::::::::::::::::
+The executables specified in FHS §3.4.2 and §3.4.3 are excluded from this
+project as it is assumed these executables are installed by other packages
+included in the base software distribution.
+
+The single executable specified in FHS §6.1.2 is specified in a way that makes
+it ambiguous if it is always required or only required on computers containing
+a serial port.  Either way, this executable is provided by a separate package
+from a separate project and is also excluded from this project.
+
+Files in ``/etc``
+:::::::::::::::::
+Some files specified as optional in FHS §3.7.3 are not included in this project
+as they are better handled by their respective packages, including:
+
+* ``X11`` - handled by the ``xorg-server`` package.
+
+* ``csh.login`` - handled by the ``tcsh`` package.
+
+* ``exports`` - handled by the ``nfs-utils`` package.
+
+* ``fstab`` and ``resolv.conf`` - handled by Project Horizon.
+
+* ``ftpusers`` - handled by FTP daemon packages.
+
+* ``gateways`` - handled by the ``netkit-routed`` package.
+
+* ``gettydefs`` - handled by the ``mgetty`` or ``mingetty`` package.
+
+* ``group`` and ``passwd`` - handled by the ``shadow`` package.
+
+* ``host.conf`` - this file is glibc-specific.
+
+* ``hosts.allow`` and ``hosts.deny`` - handled by the ``tcp-wrappers`` package.
+
+* ``hosts.equiv`` - handled by the ``netkit-rsh`` package.
+
+* ``hosts.lpd`` and ``printcap`` - handled by printer packages.
+
+* ``inetd.conf`` - handled by inetd packages.
+
+* ``inittab`` - handled by the ``sysvinit`` package.
+
+* ``ld.so.conf`` - handled by the ``gcc-runtime`` package.
+
+* ``mtools.conf`` - handled by the ``mtools`` package.
+
+* ``rpc`` - handled by the ``librpc`` package.
+
+* ``shells`` - automatically generated by ``apk`` on shell installation.
+
+* ``syslog.conf`` - handled by syslog packages that require it.
+
+``/etc/cron.*`` tree
+::::::::::::::::::::
+This set of directories as specified in LSB-Core §18.2 is not included in this
+project, as any package that satisfies the ``cron`` virtual shall create it.
+
+``/etc/init.d`` directory
+:::::::::::::::::::::::::
+This directory specifed in LSB-Core §18.2 is created by the ``openrc`` package
+and is not included in this project.
+
+.. warning::
+   Do we know what s6 does?
+
+The ``/etc/mtab`` file
+::::::::::::::::::::::
+The ``/etc/mtab`` file is provided as a symlink to /proc/self/mounts only.
+Support for the ``/etc/mtab`` file being a regular file is not provided.
+This appears to be in line with FHS §3.7.3.
+
+Files in ``/lib``
+:::::::::::::::::
+While FHS §3.9.2 is ambiguous on whether ``/lib/libc.so.*`` is required when
+``/lib/ld*`` is present or not, this project *does* supply a symlink called
+``/lib/libc.so.1``.
+
+It is assumed that the symlink ``/lib/cpp`` as specified in FHS §3.9.2 is
+provided by ``gcc``.
+
+The directory ``/lib/modules`` specified by FHS §3.9.3 is provided by the
+``easy-kernel-modules`` package on systems where it is installed.
+
+Executables in ``/sbin``
+::::::::::::::::::::::::
+The executables specified in FHS §3.16.2 and §3.16.3 are excluded from this
+project as it is assumed these executables are installed by other packages
+included in the base software distribution.
+