summaryrefslogtreecommitdiff
path: root/README.rst
diff options
context:
space:
mode:
Diffstat (limited to 'README.rst')
-rw-r--r--README.rst102
1 files changed, 102 insertions, 0 deletions
diff --git a/README.rst b/README.rst
new file mode 100644
index 000000000..47da3746d
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,102 @@
+=====================================
+ README for Adélie Linux Package Set
+=====================================
+:Authors:
+ * **Andrew Wilcox**, primary maintainer
+ * **Elizabeth Myers**, maintainer
+ * **Adélie Linux Developers and Users**, contributions
+:Status:
+ Production
+:Copyright:
+ © 2016 Wilcox Technologies LLC. NCSA open source licence.
+
+
+
+
+Introduction
+============
+
+This repository contains the Adélie Linux package set. It is used as an
+overlay in the Portage system for package building to create the repository
+used by Adélie's APK package manager.
+
+
+Licenses
+`````````
+As the Adélie Linux project is an open-source Linux distribution, packages
+contained in this repository must also be provided under a license recognised
+by the OSI_. A separate repository may be provided in the future for certain
+non-free components, such as device driver firmware.
+
+.. _OSI: http://opensource.org/licenses/category
+
+
+Changes
+```````
+Any changes to this repository - additions, removal, or version bumps - 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.
+
+
+
+
+Contents
+========
+
+This section contains a high-level view of the contents of this repository.
+It does not list every package available; it is merely a guide to help you
+find what you need.
+
+
+``profiles``: Configuration
+```````````````````````````
+The ``profiles`` directory contains special instructions to the Portage++
+system to ensure proper build and runtime configuration for packages.
+
+
+``sys-apps``: System Applications
+`````````````````````````````````
+Packages in the ``sys-apps`` category provide core system functionality, such
+as ``apk-tools`` or ``portage++``.
+
+
+
+
+Usage
+=====
+
+This section contains usage information for this repository.
+
+
+As an overlay
+`````````````
+
+This repository can be added as an overlay to any system running Portage or
+Portage++. However, please do not add it to a Gentoo computer unless you
+intend to use it for developing Adélie. None of the packages here are useful
+for a Gentoo computer, and some packages (such as ``baselayout``) may in fact
+damage your Gentoo installation if installed from this repository. Please be
+careful.
+
+Create a file named ``adelie.conf`` to ``/etc/portage/repos.conf``, and enter
+the following text:
+
+::
+
+ [adelie]
+ location = /usr/local/portage-adelie
+ sync-type = git
+ sync-uri = https://code.foxkit.us/adelie/packages.git
+ auto-sync = yes
+
+Run ``emerge --sync`` or ``eix-sync`` to update the package index on your
+local system. The packages will then be available to you.
+
+
+As a repository
+```````````````
+
+The Adélie Linux system is preconfigured to use packages in this repository
+for APK. No configuration is required.
+