[gentoo-commits] proj/devmanual:master commit in: general-concepts/projects/, ebuild-writing/variables/, ...
commit: 2556659c7a76dd00176efd7892e02ca0130998e2 Author: Ulrich Müller gentoo org> AuthorDate: Fri Oct 27 10:22:01 2023 + Commit: Ulrich Müller gentoo org> CommitDate: Mon Oct 30 16:21:14 2023 + URL:https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=2556659c Fix internal links Signed-off-by: Ulrich Müller gentoo.org> appendices/common-problems/text.xml| 4 +-- appendices/contributors/text.xml | 26 - archs/alpha/text.xml | 2 +- archs/sparc/text.xml | 6 ++-- ebuild-maintenance/git/text.xml| 2 +- ebuild-maintenance/package-moves/text.xml | 2 +- ebuild-maintenance/removal/text.xml| 2 +- ebuild-writing/common-mistakes/text.xml| 2 +- ebuild-writing/error-handling/text.xml | 2 +- ebuild-writing/file-format/text.xml| 13 + ebuild-writing/functions/pkg_nofetch/text.xml | 4 +-- ebuild-writing/functions/pkg_preinst/text.xml | 6 ++-- .../src_compile/build-environment/text.xml | 2 +- ebuild-writing/functions/src_install/text.xml | 2 +- .../functions/src_prepare/epatch/text.xml | 2 +- ebuild-writing/functions/text.xml | 13 + ebuild-writing/misc-files/metadata/text.xml| 5 ++-- ebuild-writing/user-submitted/text.xml | 2 +- ebuild-writing/using-eclasses/text.xml | 8 ++--- ebuild-writing/variables/text.xml | 34 +++--- eclass-writing/text.xml| 5 ++-- function-reference/message-functions/text.xml | 2 +- function-reference/query-functions/text.xml| 5 ++-- function-reference/sandbox-functions/text.xml | 7 +++-- general-concepts/autotools/text.xml| 13 + general-concepts/dependencies/text.xml | 6 ++-- general-concepts/ebuild-revisions/text.xml | 8 ++--- general-concepts/mirrors/text.xml | 7 +++-- general-concepts/projects/text.xml | 2 +- general-concepts/slotting/text.xml | 4 +-- general-concepts/tree/text.xml | 2 +- profiles/use.desc/text.xml | 4 +-- quickstart/text.xml| 34 -- tools-reference/diff-and-patch/text.xml| 4 +-- 34 files changed, 124 insertions(+), 118 deletions(-) diff --git a/appendices/common-problems/text.xml b/appendices/common-problems/text.xml index 1c45179..87c21bb 100644 --- a/appendices/common-problems/text.xml +++ b/appendices/common-problems/text.xml @@ -100,8 +100,8 @@ for security reasons. If this message is shown, you have a couple of options: linking. This solution is preferred. -Use append-ldflags (see ) +Use append-ldflags (see +) to add -Wl,-z,now. This will affect all binaries installed, not just the setXid ones. diff --git a/appendices/contributors/text.xml b/appendices/contributors/text.xml index aa101f5..06a6e0c 100644 --- a/appendices/contributors/text.xml +++ b/appendices/contributors/text.xml @@ -16,38 +16,38 @@ This page lists the contributions to the Gentoo Development Guide: - + - + - , + , - + - , + , - + - + - + - + Previous maintainer (XSL Stylesheets, legacy Developer Handbook content) @@ -56,9 +56,9 @@ This page lists the contributions to the Gentoo Development Guide: XSL Stylesheets, previous maintainer -, -, -, +, +, +, Misc @@ -71,7 +71,7 @@ Misc DTD, XSL stylesheet, eclass conversion - + Misc diff --git a/archs/alpha/text.xml b/archs/alpha/text.xml index 9a89adc..32b539b 100644 --- a/archs/alpha/text.xml +++ b/archs/alpha/text.xml @@ -87,7 +87,7 @@ which the compiler was built. The -mieee flag should always be used unless you have a deep knowledge of the Alpha architecture, so the comments on - are + are really important on Alpha. diff --git a/archs/sparc/text.xml b/archs/sparc/text.xml index b2a83fb..5cfbdf2 100644 --- a/archs/sparc/text.xml +++ b/archs/sparc/text.xml @@ -55,8 +55,8 @@ buses. This section is in addition to the guidelines in -. It discusses additional -requirements for the SPARC architecture. +. It discusses +additional requirements for the SPARC architecture. @@ -116,7 +116,7 @@ code. Depending upon the application, this can be anywhere up to five times slower than v9 code when running on an UltraSparc cryptographic and graphics applications which make heavy use of integer multiplication and division are especially badly hit. For this reason, the comments in - + are especially important on SPARC. diff --git a/ebuild-maintenance/git/text.xml b/ebuild-maintenance/git/text.xml index 8cdabde..8bef553
[gentoo-commits] proj/devmanual:master commit in: general-concepts/projects/
commit: e203df7c6f481745aebf350d95dd9dff83e19237 Author: Sam James gentoo org> AuthorDate: Tue Feb 22 07:15:54 2022 + Commit: Sam James gentoo org> CommitDate: Thu Mar 10 23:32:57 2022 + URL:https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=e203df7c general-concepts/projects: mention IRC channels Signed-off-by: Sam James gentoo.org> Closes: https://github.com/gentoo/devmanual/pull/272 Signed-off-by: Sam James gentoo.org> general-concepts/projects/text.xml | 6 ++ 1 file changed, 6 insertions(+) diff --git a/general-concepts/projects/text.xml b/general-concepts/projects/text.xml index 32d5646..1282025 100644 --- a/general-concepts/projects/text.xml +++ b/general-concepts/projects/text.xml @@ -76,6 +76,12 @@ modifying the member list. It is standard however to consult the project lead. + +If the project has an official IRC channel listed on its project page, +developers should join the channel if possible to facilitate +coordination and collaboration. + + Developers should remember to add themselves to the alias by editing /var/mail/alias/misc/alias name on
[gentoo-commits] proj/devmanual:master commit in: general-concepts/projects/
commit: 70113f28b1525d9b55feed7b127afe445106b6c6 Author: Sam James gentoo org> AuthorDate: Tue Feb 22 07:14:56 2022 + Commit: Sam James gentoo org> CommitDate: Thu Mar 10 23:32:52 2022 + URL:https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=70113f28 general-concepts/projects: consult project lead on joining Signed-off-by: Sam James gentoo.org> general-concepts/projects/text.xml | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/general-concepts/projects/text.xml b/general-concepts/projects/text.xml index c0a28ca..32d5646 100644 --- a/general-concepts/projects/text.xml +++ b/general-concepts/projects/text.xml @@ -72,7 +72,8 @@ lists the members of the project. Simply modifying the list is sufficient for adding or removing a developer. Note that different projects have different requirements and procedures for recruiting developers, which may require prior arrangements to be made before -modifying the member list. +modifying the member list. It is standard however to consult +the project lead.
[gentoo-commits] proj/devmanual:master commit in: general-concepts/projects/, ebuild-maintenance/git/, ...
commit: 31553dc80f9ccd39052889dc1327ddb7c22c1f8f Author: Ulrich Müller gentoo org> AuthorDate: Thu Dec 26 09:00:02 2019 + Commit: Ulrich Müller gentoo org> CommitDate: Thu Dec 26 17:58:45 2019 + URL:https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=31553dc8 Replace by throughout. Signed-off-by: Ulrich Müller gentoo.org> appendices/contributing/devbook-guide/text.xml | 2 +- ebuild-maintenance/git/text.xml| 2 +- ebuild-maintenance/maintenance-tasks/text.xml | 50 +- ebuild-writing/common-mistakes/text.xml| 6 ++-- ebuild-writing/misc-files/metadata/text.xml| 18 +- general-concepts/manifest/text.xml | 4 +-- general-concepts/projects/text.xml | 2 +- 7 files changed, 42 insertions(+), 42 deletions(-) diff --git a/appendices/contributing/devbook-guide/text.xml b/appendices/contributing/devbook-guide/text.xml index 29be787..d39e794 100644 --- a/appendices/contributing/devbook-guide/text.xml +++ b/appendices/contributing/devbook-guide/text.xml @@ -215,7 +215,7 @@ Now, here's how the body element above is rendered: -This is a paragraph. /etc/passwd is a file. +This is a paragraph. /etc/passwd is a file. https://forums.gentoo.org is my favorite web site. Type ls if you feel like it. I really want to go to sleep now. diff --git a/ebuild-maintenance/git/text.xml b/ebuild-maintenance/git/text.xml index ba811ac..864036e 100644 --- a/ebuild-maintenance/git/text.xml +++ b/ebuild-maintenance/git/text.xml @@ -175,7 +175,7 @@ do not split relevant or interdependent changes within a single package. Avoid creating commits introducing a temporary breakage. Unless impossible, add packages in dependency install order. Add licenses before the packages -needing them. Commit package.mask and other profile changes before +needing them. Commit package.mask and other profile changes before ebuilds relying on them. Usually it is also acceptable to include those changes along with the commit adding the package. diff --git a/ebuild-maintenance/maintenance-tasks/text.xml b/ebuild-maintenance/maintenance-tasks/text.xml index 1fa67dc..f66d636 100644 --- a/ebuild-maintenance/maintenance-tasks/text.xml +++ b/ebuild-maintenance/maintenance-tasks/text.xml @@ -32,10 +32,10 @@ select all possible fields, then submit the query. For you lazy people, click In general, the Gentoo repository should only be used for storing -.ebuild files, as well as any relatively small companion +.ebuild files, as well as any relatively small companion files, such as patches or sample configuration files. These types of -files should be placed in the mycat/mypkg/files directory -to keep the main mycat/mypkg directory uncluttered. +files should be placed in the mycat/mypkg/files directory +to keep the main mycat/mypkg directory uncluttered. Exceptions to this rule are for larger patch files (we recommend this for patches above 20KB) which should be distributed as tarballs via the Gentoo @@ -99,23 +99,23 @@ work on those architectures. As noted earlier, under each package subdirectory is -a files/ directory. Any patches, configuration files, or +a files/ directory. Any patches, configuration files, or other ancillary files your package might require should be added to this directory; any files bigger than 20KB-or-so should go to the mirrors to lower the amount of (unneeded) files our users have to download. You may want to consider naming patches you create yourself just to get your package to build with a version-specific name, such -as mypkg-1.0-gentoo.diff, or more -simply, 1.0-gentoo.diff. Also note that the -gentoo extension informs people that this patch was created +as mypkg-1.0-gentoo.diff, or more +simply, 1.0-gentoo.diff. Also note that the +gentoo extension informs people that this patch was created by us, the Gentoo Linux developers, rather than having been grabbed from a mailing list or somewhere else. Again, you should not compress these patches. -Consider prefixing or suffixing (such as mypkg-1.0) every file -you put into the files/ directory, so that the files used for +Consider prefixing or suffixing (such as mypkg-1.0) every file +you put into the files/ directory, so that the files used for each individual version on an ebuild are distinguishable from one another, and so that the changes between different revisions are visible. This is generally a really good idea :). You may want to use a different suffix if you wish to @@ -123,8 +123,8 @@ convey more meaning with the patch name. -If you have many files that should go into the files/ directory, -consider creating subdirectories such as files/1.0/ and putting the +If you have many files that should go into the files/ directory, +consider creating subdirectories such as files/1.0/ and putting the relevant files in the appropriate subdirectory. If you use this method, you do not need to add
