summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--CHANGELOG.rst5
-rw-r--r--CONTRIBUTING.rst142
-rw-r--r--LICENSE33
-rw-r--r--README.rst102
4 files changed, 282 insertions, 0 deletions
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
new file mode 100644
index 000000000..533578b51
--- /dev/null
+++ b/CHANGELOG.rst
@@ -0,0 +1,5 @@
+Initial version
+===============
+
+* Created the repository.
+
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
new file mode 100644
index 000000000..00e42c63d
--- /dev/null
+++ b/CONTRIBUTING.rst
@@ -0,0 +1,142 @@
+=================================================
+ Contribution Guide for Adélie Linux Package Set
+=================================================
+:Author:
+ * **Andrew Wilcox**, documentation writer
+:Status:
+ Draft
+: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.
+
+
+
+
+Ebuild Format
+=============
+
+This section describes the Ebuild format required for packages in this
+repository.
+
+
+EAPI
+````
+
+Any Ebuild present in this repository **must** use EAPI 5. As EAPI 6 is not
+yet supported by any publicly released version of the Portage toolkit, it is
+not yet acceptable for use in this repository.
+
+
+Source URIs
+```````````
+
+It is recommended that any Ebuild present in this repository use an official
+Adélie Linux mirror for any files downloaded (``mirror://adelie/``).
+Exceptions will be granted on a case-by-case basis for issues such as file
+size or rapid version change.
+
+
+Comments
+````````
+
+It is highly encouraged that you use comments in your Ebuild. This grants
+other developers and the Adélie Linux team the same level of understanding
+that you have over the package. Any issues found that cause behaviour
+deviant from the eclass defaults should have an explanation and/or link to
+a problem report (either upstream or on http://bts.adelielinux.org/).
+
+
+Custom Eclasses
+```````````````
+
+If you require a custom Eclass not already present in the base Portage tree
+or this repository, please file a problem report on http://bts.adelielinux.org/
+with an explanation of what your Eclass will provide. A test suite in the
+form of various Ebuilds demonstrating proper behaviour and failure modes will
+be greatly appreciated and raise the likelihood of a speedy addition to the
+tree. Please do **not** file a pull request containing a new Eclass without
+filing a problem report first.
+
+
+
+
+Contributing Changes
+====================
+
+This section describes the usual flows of contribution to this repository.
+
+
+GitLab Pull Requests
+````````````````````
+
+#. If you do not already have a GitLab account, you must create one.
+
+#. Create a *fork* of the packages repository. For more information, consult
+ the GitLab online documentation.
+
+#. Clone your forked repository to your computer.
+
+#. Make your changes.
+
+#. Test your changes to ensure they are correct.
+
+#. Add (or remove) changed files using ``git add`` and ``git rm``.
+
+#. Commit your changes to the tree using the command ``repoman commit``.
+
+#. Visit your forked repository in a Web browser.
+
+#. Choose the *Create Pull Request* button.
+
+#. Review your changes to ensure they are correct, and then submit the form.
+
+
+Mailing List
+````````````
+
+#. Clone the packages repository to your computer.
+
+#. Make your changes.
+
+#. Test your changes to ensure they are correct.
+
+#. Add (or remove) changed files using ``git add`` and ``git rm``.
+
+#. Commit your changes to the tree using the command ``repoman commit``.
+
+#. Use the command ``git format-patch HEAD^`` to create a patch file for your
+ commit.
+
+ .. note:: If you have made multiple commits to the tree, you will need to
+ add an additional ^ for each commit you have made. For example,
+ if you have made three commits, you will use the command
+ ``git format-patch HEAD^^^``.
+
+#. Email the resulting patch to the packagers mailing list.
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 000000000..44f234cb1
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,33 @@
+Copyright (c) 2016 Wilcox Technologies LLC.
+All rights reserved.
+
+Developed by: Adélie Linux Team
+ Wilcox Technologies LLC
+ http://adelielinux.org/
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal with the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject
+to the following conditions:
+
+Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimers.
+
+Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimers in
+the documentation and/or other materials provided with the distribution.
+
+Neither the names of Adélie Linux, Wilcox Technologies, LLC, nor the
+names of its contributors may be used to endorse or promote products
+derived from this Software without specific prior written permission.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE CONTRIBUTORS OR COPYRIGHT HOLDERS BE LIABLE
+FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
+CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE.
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.
+