summaryrefslogtreecommitdiff
path: root/README
blob: e9f2a76774a295fb9a46aa2922140aada7deb66b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
README for eselect
==================

Authors
-------

See the AUTHORS file.

Documentation
-------------

See ``doc/``. Use ``make html`` for HTML versions.

Copyright
---------

eselect is Copyright (c) 2005-2020 Gentoo Authors. This code is
distributed under the terms of the `GNU General Public License,
version 2 or later`__.

The documentation in the ``doc/`` directory is dual-licensed. It can
be distributed either under the above terms, or (at your option) under
the `Creative Commons Attribution-ShareAlike 4.0 International License`__.

__ https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
__ https://creativecommons.org/licenses/by-sa/4.0/

Style Notes
-----------

* Always use ``[[ brackets ]]``, never `[ brackets ]`.
* Use quotes on variables where necessary.
* For all source files, the same indenting rules apply as for ebuilds:
  one tab per indent level, with each tab representing 4 places.
* Avoid lines wider than 79 positions.
* Public functions don't get the ``es_`` prefix, private functions do.
* eval is evil, so we disabled it.
* Absolute paths to executables are not portable, so don't use them.


.. Local Variables:
.. mode: rst
.. fill-column: 72
.. indent-tabs-mode: nil
.. End:

.. vim: set ft=glep tw=72 sw=4 et spell spelllang=en :