* [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/functions/
@ 2016-02-23 7:17 Ulrich Müller
0 siblings, 0 replies; 8+ messages in thread
From: Ulrich Müller @ 2016-02-23 7:17 UTC (permalink / raw
To: gentoo-commits
commit: 1e6accd8734a16b896d3d529c6727ef3d3c5fd9f
Author: Vicente Jimenez Aguilar <googuy <AT> gmail <DOT> com>
AuthorDate: Mon Feb 22 13:05:41 2016 +0000
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Tue Feb 23 06:29:18 2016 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=1e6accd8
ebuild-writing/functions: Add src_configure to the list of called functions
src_configure is missing from the list of called functions when
installing from source
ebuild-writing/functions/text.xml | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/ebuild-writing/functions/text.xml b/ebuild-writing/functions/text.xml
index d10a51f..23d68f0 100644
--- a/ebuild-writing/functions/text.xml
+++ b/ebuild-writing/functions/text.xml
@@ -6,7 +6,8 @@
<body>
<p>
When installing packages from source, the function call order is <c>pkg_setup</c>,
-<c>src_unpack</c>, <c>src_prepare</c>, <c>src_compile</c>, <c>src_test</c> (optional, <c>FEATURES="test"</c>),
+<c>src_unpack</c>, <c>src_prepare</c>, <c>src_configure</c>, <c>src_compile</c>,
+<c>src_test</c> (optional, <c>FEATURES="test"</c>),
<c>src_install</c>, <c>pkg_preinst</c>, <c>pkg_postinst</c>. When installing packages
from a binary, the function call order is <c>pkg_setup</c>, <c>pkg_preinst</c>,
<c>pkg_postinst</c>.
^ permalink raw reply related [flat|nested] 8+ messages in thread
* [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/functions/
@ 2021-06-18 5:10 Sam James
0 siblings, 0 replies; 8+ messages in thread
From: Sam James @ 2021-06-18 5:10 UTC (permalink / raw
To: gentoo-commits
commit: 4346ec7a970d45423d7bf72d01710c805e2413e0
Author: Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Sat Apr 10 02:26:29 2021 +0000
Commit: Sam James <sam <AT> gentoo <DOT> org>
CommitDate: Fri Jun 18 05:08:41 2021 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=4346ec7a
ebuild-writing/functions: mention defining phases in the canonical order
This aids readability.
Signed-off-by: Sam James <sam <AT> gentoo.org>
Closes: https://github.com/gentoo/devmanual/pull/224
Signed-off-by: Sam James <sam <AT> gentoo.org>
ebuild-writing/functions/text.xml | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/ebuild-writing/functions/text.xml b/ebuild-writing/functions/text.xml
index b15c0b1..b4c3378 100644
--- a/ebuild-writing/functions/text.xml
+++ b/ebuild-writing/functions/text.xml
@@ -16,6 +16,11 @@ As some phases haven't been introduced from the beginning, you can have a look a
<uri link="::ebuild-writing/eapi"/> for an overview, what have been introduced in which EAPI.
</p>
+<p>
+Ebuilds should usually define phases in the order they are called,
+as set out above, for readability.
+</p>
+
<figure short="How the ebuild phase functions are processed" link="diagram.png"/>
<p>
^ permalink raw reply related [flat|nested] 8+ messages in thread
* [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/functions/
@ 2020-12-29 22:08 Göktürk Yüksek
0 siblings, 0 replies; 8+ messages in thread
From: Göktürk Yüksek @ 2020-12-29 22:08 UTC (permalink / raw
To: gentoo-commits
commit: 3c11fdb5423e2258388d0624bf7d6c45b8addf69
Author: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
AuthorDate: Tue Dec 29 02:40:34 2020 +0000
Commit: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
CommitDate: Tue Dec 29 22:06:37 2020 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=3c11fdb5
ebuild-writing/functions: prefer "phase functions" over "ebuild functions"
When the text specifically refers to phase functions, be more verbose
about it. Ebuilds can define other functions that are
internal. Eclasses also define functions. Using the term "phase
functions" should help clarify the ambiguity.
Signed-off-by: Göktürk Yüksek <gokturk <AT> gentoo.org>
ebuild-writing/functions/text.xml | 13 +++++++------
1 file changed, 7 insertions(+), 6 deletions(-)
diff --git a/ebuild-writing/functions/text.xml b/ebuild-writing/functions/text.xml
index a3e11d1..b15c0b1 100644
--- a/ebuild-writing/functions/text.xml
+++ b/ebuild-writing/functions/text.xml
@@ -1,22 +1,22 @@
<?xml version="1.0"?>
<guide self="ebuild-writing/functions/">
<chapter>
-<title>Ebuild Functions</title>
+<title>Ebuild Phase Functions</title>
<body>
<p>
-When installing packages from source, the function call order is
+When installing packages from source, the phase function call order is
<c>pkg_pretend</c>, <c>pkg_setup</c>,
<c>src_unpack</c>, <c>src_prepare</c>, <c>src_configure</c>, <c>src_compile</c>,
<c>src_test</c> (optional, <c>FEATURES="test"</c>),
<c>src_install</c>, <c>pkg_preinst</c>, <c>pkg_postinst</c>. When installing packages
-from a binary, the function call order is <c>pkg_pretend</c>,
+from a binary, the phase function call order is <c>pkg_pretend</c>,
<c>pkg_setup</c>, <c>pkg_preinst</c>, <c>pkg_postinst</c>.
As some phases haven't been introduced from the beginning, you can have a look at
<uri link="::ebuild-writing/eapi"/> for an overview, what have been introduced in which EAPI.
</p>
-<figure short="How the ebuild functions are processed" link="diagram.png"/>
+<figure short="How the ebuild phase functions are processed" link="diagram.png"/>
<p>
The <c>pkg_pretend</c> function is to be used for performing various
@@ -43,8 +43,9 @@ location, and Portage records digests of the files installed.
</p>
<p>
-When testing or debugging, you can instruct Portage to execute a specific function
-from an ebuild by using the <c>ebuild</c> command, see the <c>ebuild(1)</c> manual
+When testing or debugging, you can instruct Portage to execute a
+specific phase function of an ebuild by using the <c>ebuild</c>
+command, see the <c>ebuild(1)</c> manual
page for further information.
</p>
^ permalink raw reply related [flat|nested] 8+ messages in thread
* [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/functions/
@ 2019-11-12 17:18 Göktürk Yüksek
0 siblings, 0 replies; 8+ messages in thread
From: Göktürk Yüksek @ 2019-11-12 17:18 UTC (permalink / raw
To: gentoo-commits
commit: 93450a9dc3fb1fcc1ec90e3364b60673084c0199
Author: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
AuthorDate: Fri Nov 8 16:08:40 2019 +0000
Commit: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
CommitDate: Tue Nov 12 17:14:58 2019 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=93450a9d
ebuild-writing/functions: mention pkg_pretend as part of the phase sequence
Acked-by: Michael Orlitzky <mjo <AT> gentoo.org>
Signed-off-by: Göktürk Yüksek <gokturk <AT> gentoo.org>
Closes: https://github.com/gentoo/devmanual.gentoo.org/pull/117
ebuild-writing/functions/text.xml | 17 ++++++++++++++---
1 file changed, 14 insertions(+), 3 deletions(-)
diff --git a/ebuild-writing/functions/text.xml b/ebuild-writing/functions/text.xml
index 325a9b4..a6deb0a 100644
--- a/ebuild-writing/functions/text.xml
+++ b/ebuild-writing/functions/text.xml
@@ -5,18 +5,29 @@
<body>
<p>
-When installing packages from source, the function call order is <c>pkg_setup</c>,
+When installing packages from source, the function call order is
+<c>pkg_pretend</c> (for EAPI=4 and later), <c>pkg_setup</c>,
<c>src_unpack</c>, <c>src_prepare</c>, <c>src_configure</c>, <c>src_compile</c>,
<c>src_test</c> (optional, <c>FEATURES="test"</c>),
<c>src_install</c>, <c>pkg_preinst</c>, <c>pkg_postinst</c>. When installing packages
-from a binary, the function call order is <c>pkg_setup</c>, <c>pkg_preinst</c>,
-<c>pkg_postinst</c>.
+from a binary, the function call order is <c>pkg_pretend</c>,
+<c>pkg_setup</c>, <c>pkg_preinst</c>, <c>pkg_postinst</c>.
As some phases haven't been introduced from the beginning, you can have a look at
<uri link="::ebuild-writing/eapi"/> for an overview, what have been introduced in which EAPI.
</p>
<figure short="How the ebuild functions are processed" link="diagram.png"/>
+<p>
+The <c>pkg_pretend</c> function is to be used for performing various
+early sanity checks, such as ensuring that certain kernel options are
+enabled. It is important to keep in mind that <c>pkg_pretend</c> runs
+separately from the rest of the phase function sequence. Consequently,
+there is no environment saving or propagation to the next
+phase. Moreover, ebuild dependencies are not guaranteed to be
+satisfied at this phase.
+</p>
+
<p>
The <c>pkg_prerm</c> and <c>pkg_postrm</c> functions are called when uninstalling a
package. The <c>pkg_config</c> function is used for any special package
^ permalink raw reply related [flat|nested] 8+ messages in thread
* [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/functions/
@ 2019-11-12 17:18 Göktürk Yüksek
0 siblings, 0 replies; 8+ messages in thread
From: Göktürk Yüksek @ 2019-11-12 17:18 UTC (permalink / raw
To: gentoo-commits
commit: a391ee177b2b2e046a7d90eed7e8c9f8a7127996
Author: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
AuthorDate: Fri Nov 8 15:48:23 2019 +0000
Commit: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
CommitDate: Tue Nov 12 17:14:42 2019 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=a391ee17
ebuild-writing/functions/diagram.svg: add pkg_pretend to the figure
Acked-by: Michael Orlitzky <mjo <AT> gentoo.org>
Signed-off-by: Göktürk Yüksek <gokturk <AT> gentoo.org>
ebuild-writing/functions/diagram.svg | 606 ++++++++++++++++++++---------------
1 file changed, 352 insertions(+), 254 deletions(-)
diff --git a/ebuild-writing/functions/diagram.svg b/ebuild-writing/functions/diagram.svg
index 22e8108..43bf26e 100644
--- a/ebuild-writing/functions/diagram.svg
+++ b/ebuild-writing/functions/diagram.svg
@@ -1,318 +1,416 @@
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!-- Created with Inkscape (http://www.inkscape.org/) -->
<svg
+ xmlns:dc="http://purl.org/dc/elements/1.1/"
+ xmlns:cc="http://creativecommons.org/ns#"
+ xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
xmlns:svg="http://www.w3.org/2000/svg"
xmlns="http://www.w3.org/2000/svg"
- version="1.0"
- width="1100"
- height="80"
+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+ xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+ inkscape:export-ydpi="96"
+ inkscape:export-xdpi="96"
+ inkscape:version="1.0beta1 (fe3e306978, 2019-09-17)"
+ sodipodi:docname="diagram.svg"
+ id="svg2503"
viewBox="-130 100 1100 80"
- id="svg2503">
+ height="80"
+ width="1100"
+ version="1.0">
+ <metadata
+ id="metadata55">
+ <rdf:RDF>
+ <cc:Work
+ rdf:about="">
+ <dc:format>image/svg+xml</dc:format>
+ <dc:type
+ rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+ <dc:title></dc:title>
+ </cc:Work>
+ </rdf:RDF>
+ </metadata>
+ <sodipodi:namedview
+ inkscape:current-layer="svg2503"
+ inkscape:window-maximized="0"
+ inkscape:window-y="29"
+ inkscape:window-x="0"
+ inkscape:cy="-42.598355"
+ inkscape:cx="920.06029"
+ inkscape:zoom="3.7798071"
+ showgrid="false"
+ id="namedview53"
+ inkscape:window-height="1423"
+ inkscape:window-width="1929"
+ inkscape:pageshadow="2"
+ inkscape:pageopacity="0"
+ guidetolerance="10"
+ gridtolerance="10"
+ objecttolerance="10"
+ borderopacity="1"
+ inkscape:document-rotation="0"
+ bordercolor="#666666"
+ pagecolor="#ffffff" />
<defs
id="defs2577" />
<desc
id="desc2505">Ebuild Function Order</desc>
<rect
- width="1100"
- height="1000"
- x="-135"
- y="-10"
+ style="fill:#eeeeee;stroke-width:0.293003"
id="background"
- style="fill:#eeeeee" />
- <line
- style="stroke:#000000;stroke-width:2.19613099"
- id="line2593"
- y2="125"
- x2="372.11496"
- y1="125"
- x1="323.88504" />
+ y="96.698219"
+ x="-129.33987"
+ height="85.745827"
+ width="1101.323" />
<rect
- width="80"
- height="30"
- x="-115"
- y="110"
+ style="opacity:1;fill:#ccccff;stroke:#000000;stroke-width:2;stop-opacity:1"
id="rect2508"
- style="fill:#ccccff;stroke:#000000;stroke-width:2" />
+ y="115.12637"
+ x="-7.6246438"
+ height="30"
+ width="80" />
<text
- x="-75.000008"
- y="130"
+ style="text-anchor:middle;opacity:1;stop-opacity:1"
id="text2510"
- style="text-anchor:middle">pkg_setup</text>
- <g
- transform="translate(-125,0)"
- id="g2599">
- <line
- id="line2512"
- y2="125"
- x2="130"
- y1="125"
- x1="90"
- style="stroke:#000000;stroke-width:2" />
- <line
- id="line2514"
- y2="120"
- x2="122"
- y1="125"
- x1="130"
- style="stroke:#000000;stroke-width:2" />
- <line
- id="line2516"
- y2="130"
- x2="122"
- y1="125"
- x1="130"
- style="stroke:#000000;stroke-width:2" />
- </g>
+ y="135.12637"
+ x="32.375347">pkg_setup</text>
<rect
- width="80"
- height="30"
- x="4.9999924"
- y="110"
+ style="opacity:1;fill:#ffffff;stroke:#000000;stroke-width:2;stop-opacity:1"
id="rect2518"
- style="fill:#ffffff;stroke:#000000;stroke-width:2" />
+ y="115.12637"
+ x="109.90766"
+ height="30"
+ width="80" />
<text
- x="44.999992"
- y="130"
+ style="text-anchor:middle;opacity:1;stop-opacity:1"
id="text2520"
- style="text-anchor:middle">src_unpack</text>
- <line
- x1="373"
- y1="125"
- x2="365"
- y2="120"
- id="line2524"
- style="stroke:#000000;stroke-width:2" />
- <line
- x1="373"
- y1="125"
- x2="365"
- y2="130"
- id="line2526"
- style="stroke:#000000;stroke-width:2" />
+ y="135.12637"
+ x="149.90767">src_unpack</text>
<rect
- width="80"
- height="30"
- x="373"
- y="110"
+ style="opacity:1;fill:#ffffff;stroke:#000000;stroke-width:2;stop-opacity:1"
id="rect2528"
- style="fill:#ffffff;stroke:#000000;stroke-width:2" />
+ y="115.12637"
+ x="428.4689"
+ height="30"
+ width="80" />
<text
- x="413"
- y="130"
+ style="text-anchor:middle;opacity:1;stop-opacity:1"
id="text2530"
- style="text-anchor:middle">src_compile</text>
- <line
- x1="453"
- y1="125"
- x2="493"
- y2="125"
- id="line2532"
- style="stroke:#000000;stroke-width:2" />
- <line
- x1="493"
- y1="125"
- x2="485"
- y2="120"
- id="line2534"
- style="stroke:#000000;stroke-width:2" />
- <line
- x1="493"
- y1="125"
- x2="485"
- y2="130"
- id="line2536"
- style="stroke:#000000;stroke-width:2" />
+ y="135.12637"
+ x="468.4689">src_compile</text>
<path
- d="M 453,125 C 466.33333,125 473,129 473,137 C 473,145.66667 479.66667,150 493,150 L 573,150 C 586.33333,150 593,145.66667 593,137 C 593,129 599.66667,125 613,125"
+ inkscape:connector-curvature="0"
+ style="opacity:1;fill:none;stroke:#000000;stroke-width:2;stroke-miterlimit:4;stroke-dasharray:none;stop-opacity:1"
id="path2538"
- style="fill:none;stroke:#000000;stroke-width:2" />
+ d="m 509.22566,130.12637 c 11.55683,0 17.33525,4 17.33525,12 0,8.66667 5.77842,13 17.33525,13 h 69.34101 c 11.55683,0 17.33525,-4.33333 17.33525,-13 0,-8 5.77842,-12 17.33525,-12" />
<rect
- width="80"
- height="30"
- x="493"
- y="110"
+ style="opacity:1;fill:#ccffcc;stroke:#000000;stroke-width:2;stop-opacity:1"
id="rect2540"
- style="fill:#ccffcc;stroke:#000000;stroke-width:2" />
+ y="115.12637"
+ x="538.37067"
+ height="30"
+ width="80" />
<text
- x="532.99994"
- y="130"
+ style="text-anchor:middle;opacity:1;stop-opacity:1"
id="text2542"
- style="text-anchor:middle">src_test</text>
- <line
- x1="572.99994"
- y1="125"
- x2="612.99994"
- y2="125"
- id="line2544"
- style="stroke:#000000;stroke-width:2" />
- <line
- x1="612.99994"
- y1="125"
- x2="604.99994"
- y2="120"
- id="line2546"
- style="stroke:#000000;stroke-width:2" />
- <line
- x1="612.99994"
- y1="125"
- x2="604.99994"
- y2="130"
- id="line2548"
- style="stroke:#000000;stroke-width:2" />
+ y="135.12637"
+ x="578.37061">src_test</text>
+ <g
+ id="g915">
+ <line
+ x1="619.22565"
+ y1="130.12637"
+ x2="647.90759"
+ y2="130.12637"
+ id="line2544"
+ style="opacity:1;stroke:#000000;stroke-width:2;stroke-miterlimit:4;stroke-dasharray:none;stop-opacity:1" />
+ <line
+ x1="647.90759"
+ y1="130.12637"
+ x2="639.90759"
+ y2="125.12637"
+ id="line2546"
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1" />
+ <line
+ x1="647.90759"
+ y1="130.12637"
+ x2="639.90759"
+ y2="135.12637"
+ id="line2548"
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1" />
+ </g>
<rect
- width="80"
- height="30"
- x="612.99994"
- y="110"
+ style="opacity:1;fill:#ffffff;stroke:#000000;stroke-width:2;stop-opacity:1"
id="rect2550"
- style="fill:#ffffff;stroke:#000000;stroke-width:2" />
+ y="115.12637"
+ x="649.09814"
+ height="30"
+ width="80" />
<text
- x="652.99994"
- y="130"
+ style="text-anchor:middle;opacity:1;stop-opacity:1"
id="text2552"
- style="text-anchor:middle">src_install</text>
- <line
- x1="692.99994"
- y1="125"
- x2="732.99994"
- y2="125"
- id="line2554"
- style="stroke:#000000;stroke-width:2" />
- <line
- x1="732.99994"
- y1="125"
- x2="724.99994"
- y2="120"
- id="line2556"
- style="stroke:#000000;stroke-width:2" />
- <line
- x1="732.99994"
- y1="125"
- x2="724.99994"
- y2="130"
- id="line2558"
- style="stroke:#000000;stroke-width:2" />
+ y="135.12637"
+ x="687.09814">src_install</text>
+ <g
+ id="g920">
+ <line
+ x1="729.9978"
+ y1="130.12637"
+ x2="767.09814"
+ y2="130.12637"
+ id="line2554"
+ style="opacity:1;stroke:#000000;stroke-width:2;stroke-miterlimit:4;stroke-dasharray:none;stop-opacity:1" />
+ <line
+ x1="767.09814"
+ y1="130.12637"
+ x2="759.09814"
+ y2="125.12637"
+ id="line2556"
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1" />
+ <line
+ x1="767.09814"
+ y1="130.12637"
+ x2="759.09814"
+ y2="135.12637"
+ id="line2558"
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1" />
+ </g>
<rect
- width="80"
- height="30"
- x="732.99994"
- y="110"
+ style="opacity:1;fill:#ccccff;stroke:#000000;stroke-width:2;stop-opacity:1"
id="rect2560"
- style="fill:#ccccff;stroke:#000000;stroke-width:2" />
+ y="115.12637"
+ x="767.90759"
+ height="30"
+ width="80" />
<text
- x="772.99994"
- y="130"
+ style="text-anchor:middle;opacity:1;stop-opacity:1"
id="text2562"
- style="text-anchor:middle">pkg_preinst</text>
- <line
- x1="812.99994"
- y1="125"
- x2="852.99994"
- y2="125"
- id="line2564"
- style="stroke:#000000;stroke-width:2" />
- <line
- x1="852.99994"
- y1="125"
- x2="844.99994"
- y2="120"
- id="line2566"
- style="stroke:#000000;stroke-width:2" />
- <line
- x1="852.99994"
- y1="125"
- x2="844.99994"
- y2="130"
- id="line2568"
- style="stroke:#000000;stroke-width:2" />
+ y="135.12637"
+ x="807.90759">pkg_preinst</text>
+ <g
+ id="g925">
+ <line
+ x1="848.47461"
+ y1="130.12637"
+ x2="873.90759"
+ y2="130.12637"
+ id="line2564"
+ style="opacity:1;stroke:#000000;stroke-width:2;stroke-miterlimit:4;stroke-dasharray:none;stop-opacity:1" />
+ <line
+ x1="873.90759"
+ y1="130.12637"
+ x2="865.90759"
+ y2="125.12637"
+ id="line2566"
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1" />
+ <line
+ x1="873.90759"
+ y1="130.12637"
+ x2="865.90759"
+ y2="135.12637"
+ id="line2568"
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1" />
+ </g>
<rect
- width="80"
- height="30"
- x="852.99994"
- y="110"
+ style="opacity:1;fill:#ccccff;stroke:#000000;stroke-width:2;stop-opacity:1"
id="rect2570"
- style="fill:#ccccff;stroke:#000000;stroke-width:2" />
+ y="115.12637"
+ x="873.90759"
+ height="30"
+ width="80" />
<text
- x="892.99994"
- y="130"
+ style="text-anchor:middle;opacity:1;stop-opacity:1"
id="text2572"
- style="text-anchor:middle">pkg_postinst</text>
+ y="135.12637"
+ x="913.90759">pkg_postinst</text>
<path
- d="M -34.79404,125.20597 C -15.171638,125.20597 -5.3604277,130.80594 -5.3604277,142.00588 C -5.3604277,153.86465 4.4507723,159.79403 24.073182,159.79403 L 671.61258,159.79403 C 691.23498,159.79403 701.04619,153.86465 701.04619,142.00588 C 701.04619,130.80594 710.85739,125.20597 730.4798,125.20597"
+ inkscape:connector-curvature="0"
+ style="opacity:1;fill:none;stroke:#000000;stroke-width:2;stroke-miterlimit:4;stroke-dasharray:none;stop-opacity:1"
id="path2574"
- style="fill:none;stroke:#000000;stroke-width:2.41193652" />
+ d="m 71.583477,130.33234 c 17.871085,0 26.806636,5.59997 26.806636,16.79991 0,11.85877 8.935547,17.78815 26.806617,17.78815 h 589.74589 c 17.87109,0 26.80666,-5.92938 26.80666,-17.78815 0,-11.19994 8.93553,-16.79991 26.80662,-16.79991" />
<rect
- width="80"
- height="30"
- x="245"
- y="110"
+ style="opacity:1;fill:#ffffff;stroke:#000000;stroke-width:2;stop-opacity:1"
id="rect2583"
- style="fill:#ffffff;stroke:#000000;stroke-width:2" />
+ y="115.12637"
+ x="322.2374"
+ height="30"
+ width="80" />
<text
- x="286.13922"
- y="129.99992"
+ style="text-anchor:middle;opacity:1;stop-opacity:1"
id="text2585"
- style="text-anchor:middle">src_configure</text>
+ y="135.1263"
+ x="363.37662">src_configure</text>
<rect
- width="80"
- height="30"
- x="125"
- y="110"
+ style="opacity:1;fill:#ffffff;stroke:#000000;stroke-width:2;stop-opacity:1"
id="rect2587"
- style="fill:#ffffff;stroke:#000000;stroke-width:2" />
+ y="115.12637"
+ x="215.93536"
+ height="30"
+ width="80" />
<text
- x="167.51736"
- y="129.99992"
+ style="text-anchor:middle;opacity:1;stop-opacity:1"
id="text2589"
- style="text-anchor:middle">src_prepare</text>
+ y="135.1263"
+ x="258.45276">src_prepare</text>
+ <rect
+ width="80"
+ height="30"
+ x="-113.90761"
+ y="115.0796"
+ id="rect880"
+ style="opacity:1;fill:#ccccff;stroke:#000000;stroke-width:2;stop-opacity:1" />
+ <text
+ x="-73.904678"
+ y="133.18214"
+ id="text890"
+ style="text-anchor:middle;opacity:1;stop-opacity:1">pkg_pretend</text>
<g
- transform="translate(-5.0000077,0)"
- id="g2604">
+ id="g910">
<line
- x1="90"
- y1="125"
- x2="130"
- y2="125"
- id="line2606"
- style="stroke:#000000;stroke-width:2" />
+ x1="537.90765"
+ y1="130.12637"
+ x2="529.90765"
+ y2="125.12637"
+ id="line2534"
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1" />
<line
- x1="130"
- y1="125"
- x2="122"
- y2="120"
- id="line2608"
- style="stroke:#000000;stroke-width:2" />
+ x1="537.90765"
+ y1="130.12637"
+ x2="529.90765"
+ y2="135.12637"
+ id="line2536"
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1" />
<line
- x1="130"
- y1="125"
- x2="122"
- y2="130"
- id="line2610"
- style="stroke:#000000;stroke-width:2" />
+ style="opacity:1;stroke:#000000;stroke-width:2;stroke-miterlimit:4;stroke-dasharray:none;stop-opacity:1"
+ id="line890"
+ y2="130.12637"
+ x2="537.90759"
+ y1="130.12637"
+ x1="512.47461" />
+ <line
+ style="opacity:1;stroke:#000000;stroke-width:2;stroke-miterlimit:4;stroke-dasharray:none;stop-opacity:1"
+ id="line894"
+ y2="130.12637"
+ x2="537.90759"
+ y1="130.12637"
+ x1="509.22568" />
</g>
<g
- transform="translate(115,0)"
- id="g2612">
+ id="g904">
+ <line
+ x1="428.4689"
+ y1="130.12637"
+ x2="420.4689"
+ y2="125.12637"
+ id="line2524"
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1" />
+ <line
+ x1="428.4689"
+ y1="130.12637"
+ x2="420.4689"
+ y2="135.12637"
+ id="line2526"
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1" />
<line
- style="stroke:#000000;stroke-width:2"
- id="line2614"
- y2="125"
- x2="130"
- y1="125"
- x1="90" />
+ style="opacity:1;stroke:#000000;stroke-width:2;stroke-miterlimit:4;stroke-dasharray:none;stop-opacity:1"
+ id="line902"
+ y2="130.12637"
+ x2="428.4689"
+ y1="130.12637"
+ x1="403.03592" />
+ </g>
+ <g
+ id="g899">
<line
- style="stroke:#000000;stroke-width:2"
+ x1="322.2374"
+ y1="130.12637"
+ x2="314.2374"
+ y2="125.12637"
id="line2616"
- y2="120"
- x2="122"
- y1="125"
- x1="130" />
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1" />
<line
- style="stroke:#000000;stroke-width:2"
+ x1="322.2374"
+ y1="130.12637"
+ x2="314.2374"
+ y2="135.12637"
id="line2618"
- y2="130"
- x2="122"
- y1="125"
- x1="130" />
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1" />
+ <line
+ x1="296.80441"
+ y1="130.12637"
+ x2="322.2374"
+ y2="130.12637"
+ id="line904"
+ style="opacity:1;stroke:#000000;stroke-width:2;stroke-miterlimit:4;stroke-dasharray:none;stop-opacity:1" />
+ </g>
+ <g
+ id="g894">
+ <line
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1"
+ id="line2608"
+ y2="125.12637"
+ x2="207.93535"
+ y1="130.12637"
+ x1="215.93535" />
+ <line
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1"
+ id="line2610"
+ y2="135.12637"
+ x2="207.93535"
+ y1="130.12637"
+ x1="215.93535" />
+ <line
+ style="opacity:1;stroke:#000000;stroke-width:2;stroke-miterlimit:4;stroke-dasharray:none;stop-opacity:1"
+ id="line906"
+ y2="130.12637"
+ x2="215.93535"
+ y1="130.12637"
+ x1="190.50237" />
+ </g>
+ <g
+ id="g884">
+ <line
+ x1="-7.6246533"
+ y1="130.12637"
+ x2="-15.624653"
+ y2="125.12637"
+ id="line884"
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1" />
+ <line
+ x1="-7.6246533"
+ y1="130.12637"
+ x2="-15.624653"
+ y2="135.12637"
+ id="line886"
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1" />
+ <line
+ x1="-33.057636"
+ y1="130.12637"
+ x2="-7.6246533"
+ y2="130.12637"
+ id="line916"
+ style="opacity:1;stroke:#000000;stroke-width:2;stroke-miterlimit:4;stroke-dasharray:none;stop-opacity:1" />
+ </g>
+ <g
+ id="g889">
+ <line
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1"
+ x1="109.90767"
+ y1="130.12637"
+ x2="101.90767"
+ y2="125.12637"
+ id="line2514" />
+ <line
+ style="opacity:1;stroke:#000000;stroke-width:2;stop-opacity:1"
+ x1="109.90767"
+ y1="130.12637"
+ x2="101.90767"
+ y2="135.12637"
+ id="line2516" />
+ <line
+ style="opacity:1;stroke:#000000;stroke-width:2;stroke-miterlimit:4;stroke-dasharray:none;stop-opacity:1"
+ id="line920"
+ y2="130.12637"
+ x2="109.90767"
+ y1="130.12637"
+ x1="72.807327" />
</g>
</svg>
^ permalink raw reply related [flat|nested] 8+ messages in thread* [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/functions/
@ 2016-06-05 12:43 Göktürk Yüksek
0 siblings, 0 replies; 8+ messages in thread
From: Göktürk Yüksek @ 2016-06-05 12:43 UTC (permalink / raw
To: gentoo-commits
commit: 2e6e1cfa6f8e9eaf422197a7cee7a2f76ad84bb1
Author: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
AuthorDate: Sun Jun 5 12:41:26 2016 +0000
Commit: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
CommitDate: Sun Jun 5 12:41:26 2016 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=2e6e1cfa
ebuild-writing/functions: fix a typo in a <uri> tag s/.//
ebuild-writing/functions/text.xml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/ebuild-writing/functions/text.xml b/ebuild-writing/functions/text.xml
index 23d68f0..325a9b4 100644
--- a/ebuild-writing/functions/text.xml
+++ b/ebuild-writing/functions/text.xml
@@ -42,7 +42,7 @@ Downloading a package's source happens before any of these phases, so
<c>emerge --fetchonly</c> should perform all the network access you
need (unless you're using live ebuilds). Network access outside of
this would not be cached locally (e.g. in <c>${DISTDIR}</c>, see
-<uri link="::ebuild-writing/variables#Predefined Read-Only Variables."/>),
+<uri link="::ebuild-writing/variables#Predefined Read-Only Variables"/>),
which makes it hard to have reproducible builds (see
<uri link="::ebuild-writing/functions/src_unpack/cvs-sources#Disadvantages of CVS Sources"/>).
Avoid network access in any phase by using local files, extending
^ permalink raw reply related [flat|nested] 8+ messages in thread* [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/functions/
@ 2015-09-12 10:58 Markos Chandras
0 siblings, 0 replies; 8+ messages in thread
From: Markos Chandras @ 2015-09-12 10:58 UTC (permalink / raw
To: gentoo-commits
commit: e5518151d7096bb4f3cc876b97f6831f1716ed23
Author: Markos Chandras <hwoarang <AT> gentoo <DOT> org>
AuthorDate: Sat Sep 12 10:56:15 2015 +0000
Commit: Markos Chandras <hwoarang <AT> gentoo <DOT> org>
CommitDate: Sat Sep 12 10:58:10 2015 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=e5518151
ebuild-writing: functions: diagram.svg: Fix the SVG ViewBox value
Fix the SVG ViewBox value so all ebuild functions are displayed.
Thanks to Alex Legler <a3li <AT> gentoo.org>
X-Gentoo-Bug: 548418
X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=548418
ebuild-writing/functions/diagram.svg | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/ebuild-writing/functions/diagram.svg b/ebuild-writing/functions/diagram.svg
index 34ae53b..22e8108 100644
--- a/ebuild-writing/functions/diagram.svg
+++ b/ebuild-writing/functions/diagram.svg
@@ -6,7 +6,7 @@
version="1.0"
width="1100"
height="80"
- viewBox="0 100 830 80"
+ viewBox="-130 100 1100 80"
id="svg2503">
<defs
id="defs2577" />
^ permalink raw reply related [flat|nested] 8+ messages in thread* [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/functions/
@ 2014-10-18 17:35 Markos Chandras
0 siblings, 0 replies; 8+ messages in thread
From: Markos Chandras @ 2014-10-18 17:35 UTC (permalink / raw
To: gentoo-commits
commit: 2a7d19973f0713e66b38b7af04a263ae248fe7ca
Author: W. Trevor King <wking <AT> tremily <DOT> us>
AuthorDate: Wed Sep 3 01:15:44 2014 +0000
Commit: Markos Chandras <hwoarang <AT> gentoo <DOT> org>
CommitDate: Wed Sep 3 15:51:03 2014 +0000
URL: http://sources.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=2a7d1997
ebuild-writing/functions: Don't allow network access
There have been a number of bugs filed to remove network access from
ebuild phases [1,2,...], but until now this policy was undocumented
here. We'll have to relax this restriction if the src_fetch [3,4,5] or
pkg_fetch [6] proposals being discussed for EAPI-6 are accepted, but
neither is currently mentioned in either the PMS [7] or Portage [8].
Portage *does* have a network-sandbox feature [9,10], which applies to
all src_* phases except src_unpack (for live ebuilds). I think it
should be applied to pkg_* phases too, but Michał thinks they may need
networking "for some kind of IPC" [11]. Alexis pointed out that a
strict network-sandbox will break distcc [12], but since that network
access is the result of enabling a Portage feature (and not initiated
by the ebuild or package itself), it falls outside the scope of this
policy.
[1]: https://bugs.gentoo.org/show_bug.cgi?id=315403
Summary: media-video/jubler fails to build without network
[2]: https://bugs.gentoo.org/show_bug.cgi?id=336771
Summary: dev-libs/libevent tests require network access
[3]: https://bugs.gentoo.org/show_bug.cgi?id=182028
Summary: [Future EAPI] About managing CVS/SUBVERSION version of
software
[4]: http://thread.gmane.org/gmane.linux.gentoo.devel/47645/focus=52918
From: Marijn Schouten <hkBst <AT> gentoo.org>
Subject: src_fetch (was Re: EAPI 1 (Was: Re: Monthly Gentoo
Council Reminder for April))
Date: 2007-11-09 17:41:38 GMT
[5]: http://thread.gmane.org/gmane.linux.gentoo.devel/87869
From: Michał Górny <mgorny <AT> gentoo.org>
Subject: [EAPI 6] src_fetch() for fetching live sources
Date: 2013-08-27 10:01:27 GMT
[6]: http://thread.gmane.org/gmane.linux.gentoo.devel/87869/focus=878773
From: Ian Stakenvicius <axs <AT> gentoo.org>
Subject: Re: [EAPI 6] src_fetch() for fetching live sources
Date: 2013-08-27 14:33:27 GMT
[7]: git://git.overlays.gentoo.org/proj/pms.git
[8]: git://git.overlays.gentoo.org/proj/portage.git
[9]: http://thread.gmane.org/gmane.linux.gentoo.devel/87641
From: Michał Górny <mgorny <AT> gentoo.org>
Subject: New developer features in portage: cgroup,
network-sandbox, ipc-sandbox
Date: 2013-08-20 10:26:03 GMT
[10]: http://thread.gmane.org/gmane.linux.gentoo.devel/91131
From: Michał Górny <mgorny <AT> gentoo.org>
Subject: RFC: enabling ipc-sandbox & network-sandbox by default
Date: 2014-05-11 21:42:38 GMT
[11]: http://article.gmane.org/gmane.linux.gentoo.devel/87641
From: Michał Górny <mgorny <AT> gentoo.org>
Subject: New developer features in portage: cgroup,
network-sandbox, ipc-sandbox
Date: 2013-08-20 10:26:03 GMT
[12]: http://thread.gmane.org/gmane.linux.gentoo.devel/87641/focus=87658
From: Alexis Ballier <aballier <AT> gentoo.org>
Subject: Re: New developer features in portage: cgroup,
network-sandbox, ipc-sandbox
Date: 2013-08-20 15:04:35 GMT
---
ebuild-writing/functions/text.xml | 13 +++++++++++++
1 file changed, 13 insertions(+)
diff --git a/ebuild-writing/functions/text.xml b/ebuild-writing/functions/text.xml
index 09a910e..d10a51f 100644
--- a/ebuild-writing/functions/text.xml
+++ b/ebuild-writing/functions/text.xml
@@ -35,6 +35,19 @@ When testing or debugging, you can instruct Portage to execute a specific functi
from an ebuild by using the <c>ebuild</c> command, see the <c>ebuild(1)</c> manual
page for further information.
</p>
+
+<p>
+Downloading a package's source happens before any of these phases, so
+<c>emerge --fetchonly</c> should perform all the network access you
+need (unless you're using live ebuilds). Network access outside of
+this would not be cached locally (e.g. in <c>${DISTDIR}</c>, see
+<uri link="::ebuild-writing/variables#Predefined Read-Only Variables."/>),
+which makes it hard to have reproducible builds (see
+<uri link="::ebuild-writing/functions/src_unpack/cvs-sources#Disadvantages of CVS Sources"/>).
+Avoid network access in any phase by using local files, extending
+<c>SRC_URI</c> (see
+<uri link="::ebuild-writing/variables#Ebuild-defined Variables"/>), etc.
+</p>
</body>
<section>
^ permalink raw reply related [flat|nested] 8+ messages in thread
end of thread, other threads:[~2021-06-18 5:10 UTC | newest]
Thread overview: 8+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2016-02-23 7:17 [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/functions/ Ulrich Müller
-- strict thread matches above, loose matches on Subject: below --
2021-06-18 5:10 Sam James
2020-12-29 22:08 Göktürk Yüksek
2019-11-12 17:18 Göktürk Yüksek
2019-11-12 17:18 Göktürk Yüksek
2016-06-05 12:43 Göktürk Yüksek
2015-09-12 10:58 Markos Chandras
2014-10-18 17:35 Markos Chandras
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox