[gentoo-commits] proj/devmanual:master commit in: general-concepts/tree/

[gentoo-commits] proj/devmanual:master commit in: general-concepts/tree/

[Ulrich Müller]

commit:     57f7cae438731c26130d8f45e12572e727185189
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Thu May  7 16:33:57 2015 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Thu May  7 16:33:57 2015 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=57f7cae4

Add item about allowed characters in filenames.

This documents the status quo of actual usage; all filenames in the
Portage tree are composed of characters in the [A-Za-z0-9._+-] set.
("File" is to be understood in its Unix meaning here, i.e. includes
regular files and directories.)

 general-concepts/tree/text.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/general-concepts/tree/text.xml b/general-concepts/tree/text.xml
index 2bceca5..698d65d 100644
--- a/general-concepts/tree/text.xml
+++ b/general-concepts/tree/text.xml
@@ -80,6 +80,7 @@ Things that do <b>not</b> belong in the tree:
   <li>Large patches</li>
   <li>Non-text files</li>
   <li>Photos of teletubbies</li>
+  <li>Files whose name contains characters outside <c>[A-Za-z0-9._+-]</c></li>
   <li>Files whose name starts with a dot</li>
 </ul>
 

[gentoo-commits] proj/devmanual:master commit in: general-concepts/tree/

[Ulrich Müller]

commit:     75c827526d2773ac094cfd13817e481fd924789b
Author:     Gokturk Yuksek <gokturk <AT> binghamton <DOT> edu>
AuthorDate: Thu Feb  4 00:57:31 2016 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Fri Feb  5 12:58:18 2016 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=75c82752

general-concepts/tree: substitute "CVS" with "git" #558642

Gentoo-Bug: https://bugs.gentoo.org/show_bug.cgi?id=558642
Signed-off-by: Gokturk Yuksek <gokturk <AT> binghamton.edu>

 general-concepts/tree/text.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/general-concepts/tree/text.xml b/general-concepts/tree/text.xml
index 022a1ea..6f59f09 100644
--- a/general-concepts/tree/text.xml
+++ b/general-concepts/tree/text.xml
@@ -59,11 +59,11 @@ The basic layout of the portage tree is as follows:
   <li>Scripts directory, <c>scripts/</c></li>
   <li>
   Distfiles directory, <c>distfiles/</c>. This is not included in the main
-  CVS tree, but it will be found on most user systems.
+  git tree, but it will be found on most user systems.
   </li>
   <li>
   Packages directory, <c>packages</c>. Again, this is found on user systems but not
-  in the main CVS tree.
+  in the main git tree.
   </li>
 </ul>
 </body>

[gentoo-commits] proj/devmanual:master commit in: general-concepts/tree/

[Ulrich Müller]

commit:     c1420a4b7814b5cb9841d8bd322c341ecfbb4213
Author:     Gokturk Yuksek <gokturk <AT> binghamton <DOT> edu>
AuthorDate: Thu Feb  4 00:57:47 2016 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Fri Feb  5 12:58:21 2016 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=c1420a4b

general-concepts/tree: remove the reference to the ChangeLog #485314

Gentoo-Bug: https://bugs.gentoo.org/show_bug.cgi?id=485314
Signed-off-by: Gokturk Yuksek <gokturk <AT> binghamton.edu>

 general-concepts/tree/text.xml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/general-concepts/tree/text.xml b/general-concepts/tree/text.xml
index 6f59f09..877b8f4 100644
--- a/general-concepts/tree/text.xml
+++ b/general-concepts/tree/text.xml
@@ -17,7 +17,6 @@ The basic layout of the portage tree is as follows:
     Package directories for example <c>app-editors/vim</c>
     <ul>
       <li>Package metadata, for example <c>app-editors/vim/metadata.xml</c></li>
-      <li>Package changelog, for example <c>app-editors/vim/ChangeLog</c></li>
       <li>Package Manifest, for example <c>app-editors/vim/Manifest</c></li>
       <li>
       Ebuilds, for example <c>app-editors/vim/vim-6.3.068.ebuild</c>,

[gentoo-commits] proj/devmanual:master commit in: general-concepts/tree/

[Göktürk Yüksek]

commit:     fe224c4eab5ab7ccfa637903bc2ee7c2be339d6d
Author:     Wim Muskee <wimmuskee <AT> gmail <DOT> com>
AuthorDate: Sun Nov 13 15:44:51 2016 +0000
Commit:     Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
CommitDate: Wed Nov 30 06:34:07 2016 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=fe224c4e

general-concepts/tree: Add mention for metadata directory in gentoo tree

Gentoo-Bug: 572150

 general-concepts/tree/text.xml | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/general-concepts/tree/text.xml b/general-concepts/tree/text.xml
index 4d8bf0e..de452e3 100644
--- a/general-concepts/tree/text.xml
+++ b/general-concepts/tree/text.xml
@@ -38,6 +38,26 @@ The basic layout of the Gentoo repository is as follows:
   <li>Eclasses directory, <c>eclass/</c></li>
   <li>Licenses directory, <c>licenses/</c></li>
   <li>
+  Metadata directory, <c>metadata/</c>. Most of the listed contents
+  are not kept directly in the main git tree but instead
+  auto-generated or included from other repositories as part of the
+  <uri link="::general-concepts/git-to-rsync">Git to Rsync</uri>
+  process.
+  <ul>
+    <li>
+    Various control files, for example <c>layout.conf</c>, <c>timestamp</c>
+    and <c>projects.xml</c>. Only <c>layout.conf</c> exists in the main git tree.
+    </li>
+    <li>
+    XML validation files in <c>metadata/dtd/</c> and <c>metadata/xml-schema/</c>.
+    </li>
+    <li>
+    Security advisories in <c>metadata/glsa/</c> and news items in
+    <c>metadata/news/</c>
+    </li>
+  </ul>
+  </li>
+  <li>
   Profiles directory, <c>profiles/</c>
   <ul>
     <li>

[gentoo-commits] proj/devmanual:master commit in: general-concepts/tree/

[Ulrich Müller]

commit:     34642db92f251d027c5fcdb861380fd10b012117
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Thu Nov 23 08:06:56 2017 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Thu Nov 23 23:11:47 2017 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=34642db9

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
@@ -104,6 +104,17 @@ Things that do <b>not</b> belong in the tree:
 </ul>
 
 <p>
+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
+<uri link="https://www.gentoo.org/glep/glep-0031.html#suitable-characters-for-file-and-directory-names">
+GLEP 31</uri>). Any characters that have a special meaning in Bash or in
+<c>SRC_URI</c> should also be avoided. If necessary, upstream files can be
+renamed using <uri link="::ebuild-writing/variables/#Renaming Sources">
+<c>-&gt;</c> syntax</uri>.
+</p>
+
+<p>
 Software-wise, in general all of the following should be met in order for a package to be included in the tree:
 </p>
 

[gentoo-commits] proj/devmanual:master commit in: general-concepts/tree/

[Ulrich Müller]

commit:     931b093033d4ad0579fa6b0256dccc5e7cdfd4da
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Wed Nov 29 08:59:25 2017 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Wed Nov 29 08:59:25 2017 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=931b0930

general-concepts/tree: Move link because around -> it was looking strange.

 general-concepts/tree/text.xml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/general-concepts/tree/text.xml b/general-concepts/tree/text.xml
index d524861..07ac8c0 100644
--- a/general-concepts/tree/text.xml
+++ b/general-concepts/tree/text.xml
@@ -106,12 +106,12 @@ Things that do <b>not</b> belong in the tree:
 <p>
 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
+U+0021 to U+007E (see also
 <uri link="https://www.gentoo.org/glep/glep-0031.html#suitable-characters-for-file-and-directory-names">
 GLEP 31</uri>). Any characters that have a special meaning in Bash or in
 <c>SRC_URI</c> should also be avoided. If necessary, upstream files can be
-renamed using <uri link="::ebuild-writing/variables/#Renaming Sources">
-<c>-&gt;</c> syntax</uri>.
+<uri link="::ebuild-writing/variables/#Renaming Sources">renamed</uri> using
+<c>-&gt;</c> syntax.
 </p>
 
 <p>

[gentoo-commits] proj/devmanual:master commit in: general-concepts/tree/

[Ulrich Müller]

commit:     3b6603d6c6e7918e6ad7e74ea7fe38fb422f49cb
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Mon Sep  2 14:08:59 2019 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Mon Sep  2 14:08:59 2019 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=3b6603d6

general-concepts/tree: distfiles and packages don't belong to the repo.

Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 general-concepts/tree/text.xml | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/general-concepts/tree/text.xml b/general-concepts/tree/text.xml
index 07ac8c0..4afd8d5 100644
--- a/general-concepts/tree/text.xml
+++ b/general-concepts/tree/text.xml
@@ -76,14 +76,6 @@ The basic layout of the Gentoo repository is as follows:
   </ul>
   </li>
   <li>Scripts directory, <c>scripts/</c></li>
-  <li>
-  Distfiles directory, <c>distfiles/</c>. This is not included in the main
-  git tree, but it will be found on most user systems.
-  </li>
-  <li>
-  Packages directory, <c>packages</c>. Again, this is found on user systems but not
-  in the main git tree.
-  </li>
 </ul>
 </body>
 

[gentoo-commits] proj/devmanual:master commit in: general-concepts/tree/

[Ulrich Müller]

commit:     38de9c654dd036b304b158a32b14dbe785327938
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Sun Jun  2 06:16:25 2024 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Sun Jun  2 06:16:25 2024 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=38de9c65

general-concepts/tree: Allow @ in filenames

As discussed in #gentoo-dev.

Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 general-concepts/tree/text.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/general-concepts/tree/text.xml b/general-concepts/tree/text.xml
index f1877fd..3a3dc99 100644
--- a/general-concepts/tree/text.xml
+++ b/general-concepts/tree/text.xml
@@ -91,7 +91,7 @@ Things that do <b>not</b> belong in the tree:
   <li>Large patches</li>
   <li>Non-text files</li>
   <li>Photos of teletubbies</li>
-  <li>Files whose name contains characters outside <c>[A-Za-z0-9._+-]</c></li>
+  <li>Files whose name contains characters outside <c>[A-Za-z0-9._+@-]</c></li>
   <li>Files whose name starts with a dot, a hyphen, or a plus sign</li>
 </ul>
 

[gentoo-commits] proj/devmanual:master commit in: general-concepts/tree/

[Ulrich Müller]

commit:     4d099f483b70fcca7407d61462b5e8d70f26c834
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Sun Jun  2 17:34:42 2024 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Sun Jun  2 17:34:42 2024 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=4d099f48

Revert "general-concepts/tree: Allow @ in filenames"

As it turns out, Portage will silently drop files containing an @ char
during Manifest generation.

See bug 411127 and bug 106544 for further reference.

This reverts commit 38de9c654dd036b304b158a32b14dbe785327938.

Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 general-concepts/tree/text.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/general-concepts/tree/text.xml b/general-concepts/tree/text.xml
index 3a3dc99..f1877fd 100644
--- a/general-concepts/tree/text.xml
+++ b/general-concepts/tree/text.xml
@@ -91,7 +91,7 @@ Things that do <b>not</b> belong in the tree:
   <li>Large patches</li>
   <li>Non-text files</li>
   <li>Photos of teletubbies</li>
-  <li>Files whose name contains characters outside <c>[A-Za-z0-9._+@-]</c></li>
+  <li>Files whose name contains characters outside <c>[A-Za-z0-9._+-]</c></li>
   <li>Files whose name starts with a dot, a hyphen, or a plus sign</li>
 </ul>