[gentoo-commits] proj/devmanual:master commit in: appendices/common-problems/

[gentoo-commits] proj/devmanual:master commit in: appendices/common-problems/

[Göktürk Yüksek]

commit:     658d52f0eafaa6c139aa1c6ba5c249afa2e2f4e1
Author:     Göktürk Yüksek <gokturk <AT> binghamton <DOT> edu>
AuthorDate: Wed May  4 08:53:44 2016 +0000
Commit:     Göktürk Yüksek <gokturk <AT> binghamton <DOT> edu>
CommitDate: Wed May  4 09:08:20 2016 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=658d52f0

appendices/common-problems: remove the misleading sandbox violation example

In the "Handling Access Violations" section, there is an example of a
build system causing a sandbox violation by attempting to access
HOME. Per PMS, HOME is a predefined read-only environment variable
that points to a temporary location, which doesn't cause any sandbox
violations. Remove the example while keeping the idea of tricking the
build system into using a safer location.

Signed-off-by: Göktürk Yüksek <gokturk <AT> binghamton.edu>

 appendices/common-problems/text.xml | 30 +++++-------------------------
 1 file changed, 5 insertions(+), 25 deletions(-)

diff --git a/appendices/common-problems/text.xml b/appendices/common-problems/text.xml
index b0a7e58..2a9a2e7 100644
--- a/appendices/common-problems/text.xml
+++ b/appendices/common-problems/text.xml
@@ -214,31 +214,11 @@ ebuilds.
 </p>
 
 <p>
-Access violations most commonly occur during the install phase. See
-<c>src_install</c> and <uri link="::general-concepts/install-destinations/"/>
-for discussion.
-</p>
-
-<p>
-Sometimes problems can also occur with packages attempting to write to
-<c>${HOME}</c>. To get around this, it is usually sufficient to trick the build
-system into using a safer location. For example, the <c>fluxbox</c> menu generator
-tries to work in <c>${HOME}/.fluxbox</c> <d/> to get around this, the following is
-used:
-</p>
-
-<codesample lang="ebuild">
-ebegin "Creating a menu file (may take a while)"
-mkdir -p "${T}/home/.fluxbox" || die "mkdir home failed"
-MENUFILENAME="${S}/data/menu" MENUTITLE="Fluxbox ${PV}" \
-    CHECKINIT="no. go away." HOME="${T}/home" \
-    "${S}"/util/fluxbox-generate_menu -is -ds \
-    || die "menu generation failed"
-eend $?
-</codesample>
-
-<p>
-In this situation, providing a fake home directory is all that is needed.
+Access violations most commonly occur during the install
+phase. Sometimes it is possible to get around the sandbox violations
+by tricking the build system into using a safer location. See
+<c>src_install</c> and
+<uri link="::general-concepts/install-destinations/"/> for discussion.
 </p>
 
 </body>

[gentoo-commits] proj/devmanual:master commit in: appendices/common-problems/

[Göktürk Yüksek]

commit:     e1d909e88aeef35154132d95415d439f09e79adb
Author:     Thomas D <whissi <AT> whissi <DOT> de>
AuthorDate: Wed May 11 01:08:40 2016 +0000
Commit:     Göktürk Yüksek <gokturk <AT> binghamton <DOT> edu>
CommitDate: Sun May 15 01:20:40 2016 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=e1d909e8

appendices/common-problems: Fix anchor link to "Version and Name Formatting Issues"

 appendices/common-problems/text.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/appendices/common-problems/text.xml b/appendices/common-problems/text.xml
index 2a9a2e7..bced1db 100644
--- a/appendices/common-problems/text.xml
+++ b/appendices/common-problems/text.xml
@@ -58,7 +58,7 @@ in use, there are various alternatives:
     Usually when any of the above are used in global scope, it is to manipulate
     a version or program name string. These should be avoided in favour of
     pure <c>bash</c> constructs. The <c>versionator</c> eclass is often of use here.
-    See <uri link="::ebuild-writing/variables/#Version Formatting Issues"/>,
+    See <uri link="::ebuild-writing/variables/#Version and Name Formatting Issues"/>,
     <c>man versionator.eclass</c> and <uri
     link="::tools-reference/bash/#Bash Variable Manipulation"/>.
     </p>

[gentoo-commits] proj/devmanual:master commit in: appendices/common-problems/

[Ulrich Müller]

commit:     59c460dd367e04cd76eb4dacbca9686e22370d18
Author:     Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Fri Mar 12 18:18:30 2021 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Fri Mar 12 20:42:12 2021 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=59c460dd

appendices/common-problems: update eapi7-ver reference

We should refer to them as just built-in helpers now. Note that the linked
page references these anyway, so no need to describe them again.

Closes: https://github.com/gentoo/devmanual/pull/201
Signed-off-by: Sam James <sam <AT> gentoo.org>
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 appendices/common-problems/text.xml | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/appendices/common-problems/text.xml b/appendices/common-problems/text.xml
index b4fd3ea..a2af22a 100644
--- a/appendices/common-problems/text.xml
+++ b/appendices/common-problems/text.xml
@@ -57,11 +57,10 @@ in use, there are various alternatives:
   </dt>
   <dd>
     Usually when any of the above are used in global scope, it is to manipulate
-    a version or program name string. These should be avoided in favour of
-    pure <c>bash</c> constructs. The <c>eapi7-ver</c> eclass is often of use here.
-    See <uri link="::ebuild-writing/variables/#Version and Name Formatting Issues"/>,
-    <c>man eapi7-ver.eclass</c> and <uri
-    link="::tools-reference/bash/#Bash Variable Manipulation"/>.
+    a version or program name string. These should be avoided in favour of pure
+    <c>bash</c> constructs. The built-in helpers of EAPI 7 are useful here. See
+    <uri link="::ebuild-writing/variables/#Version and Name Formatting Issues"/>
+    and <uri link="::tools-reference/bash/#Bash Variable Manipulation"/>.
   </dd>
   <dt>
     <c>has_version</c>, <c>best_version</c>

[gentoo-commits] proj/devmanual:master commit in: appendices/common-problems/

[Ulrich Müller]

commit:     7c8e62980c7e35e115a868a810327c9eb6a471f2
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Wed Jun 22 16:22:59 2022 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Fri Jun 24 09:47:42 2022 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=7c8e6298

appendices/common-problems: Remove empty section

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

 appendices/common-problems/text.xml | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/appendices/common-problems/text.xml b/appendices/common-problems/text.xml
index 1dc01b8..48fc614 100644
--- a/appendices/common-problems/text.xml
+++ b/appendices/common-problems/text.xml
@@ -149,17 +149,6 @@ you see this notice locally. If you see this notice when working with a pure
 </subsection>
 </section>
 
-<section>
-<title>Handling <c>pkgcheck</c> Messages</title>
-<body>
-
-<todo>
-write me
-</todo>
-
-</body>
-</section>
-
 <section>
 <title>Handling Access Violations</title>
 <body>

[gentoo-commits] proj/devmanual:master commit in: appendices/common-problems/

[Ulrich Müller]

commit:     8b6447f81ecd067d8613d3771e70d17769953b77
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Wed Jun 22 16:20:05 2022 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Fri Jun 24 09:47:41 2022 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=8b6447f8

appendices/common-problems: Drop incomprehensible TODO directive

This exists since at least 2005 but nobody has written it.

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

 appendices/common-problems/text.xml | 11 -----------
 1 file changed, 11 deletions(-)

diff --git a/appendices/common-problems/text.xml b/appendices/common-problems/text.xml
index d124070..1dc01b8 100644
--- a/appendices/common-problems/text.xml
+++ b/appendices/common-problems/text.xml
@@ -145,17 +145,6 @@ you see this notice locally. If you see this notice when working with a pure
 <c>emerge sync</c> over <c>rsync</c> setup, it is probably a genuine issue.
 </p>
 
-<todo>
-from vapier:
-TEXTREL's ... binary files which contain text relocations ... see
-'prepstrip' for a full description unsafe files ... basically files that
-are setid and writable by Other users i've added the following QA checks to
-Portage HEAD (no idea when they'll hit a release): Insecure RUNPATHs ...
-binary files which have RUNPATH's encoded in them which are in +t
-directories Executable stacks ... binary files whose stack is marked with
-+x ... will bomb on amd64 for example
-</todo>
-
 </body>
 </subsection>
 </section>