From 34642db92f251d027c5fcdb861380fd10b012117 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ulrich=20M=C3=BCller?= Date: Thu, 23 Nov 2017 09:06:56 +0100 Subject: general-concepts/tree: Document current practice for distfile names. At the time of writing, all distfiles referenced from the Gentoo repository are using only ASCII alphanumeric plus +-.@[]_~ special characters. If all known overlays are included, characters %&();=? occur in addition. Closes: https://bugs.gentoo.org/638538 --- general-concepts/tree/text.xml | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/general-concepts/tree/text.xml b/general-concepts/tree/text.xml index de452e3..d524861 100644 --- a/general-concepts/tree/text.xml +++ b/general-concepts/tree/text.xml @@ -103,6 +103,17 @@ Things that do not belong in the tree:
  • Files whose name starts with a dot, a hyphen, or a plus sign
    • +

    +Naming rules for distfiles are more lenient, but for interoperability their +filenames are restricted to the printable ASCII range excluding SPACE, i.e., +U+0021 to U+007e (see also + +GLEP 31). Any characters that have a special meaning in Bash or in +SRC_URI should also be avoided. If necessary, upstream files can be +renamed using +-> syntax. +

    +

    Software-wise, in general all of the following should be met in order for a package to be included in the tree:

    -- cgit v1.2.3