1 |
commit: df83006f70ca0b0d5ac057e04598e07e08919429 |
2 |
Author: Arfrever Frehtes Taifersar Arahesis <Arfrever <AT> Apache <DOT> Org> |
3 |
AuthorDate: Mon Jun 25 02:08:25 2012 +0000 |
4 |
Commit: Arfrever Frehtes Taifersar Arahesis <arfrever.fta <AT> gmail <DOT> com> |
5 |
CommitDate: Mon Jun 25 02:08:25 2012 +0000 |
6 |
URL: http://git.overlays.gentoo.org/gitweb/?p=proj/portage.git;a=commit;h=df83006f |
7 |
|
8 |
Reformat documentation of EAPI="4-python". |
9 |
|
10 |
--- |
11 |
doc/package/ebuild/eapi/4-python.docbook | 224 +++++++++++++++--------------- |
12 |
1 files changed, 114 insertions(+), 110 deletions(-) |
13 |
|
14 |
diff --git a/doc/package/ebuild/eapi/4-python.docbook b/doc/package/ebuild/eapi/4-python.docbook |
15 |
index 04457f2..8420abb 100644 |
16 |
--- a/doc/package/ebuild/eapi/4-python.docbook |
17 |
+++ b/doc/package/ebuild/eapi/4-python.docbook |
18 |
@@ -1,112 +1,116 @@ |
19 |
<section id='package-ebuild-eapi-4-python'> |
20 |
-<title>EAPI 4-python</title> |
21 |
-<para>Also see the |
22 |
-<ulink url="http://people.apache.org/~Arfrever/EAPI_4-python_Specification"> |
23 |
-official EAPI 4-python Specification</ulink>. |
24 |
-</para> |
25 |
-<section id='package-ebuild-eapi-4-python-helpers'> |
26 |
-<title>Helpers</title> |
27 |
-<section id='package-ebuild-eapi-4-python-helpers-banned-global-scope'> |
28 |
-<title>Helpers Banned in Global Scope</title> |
29 |
-<para> |
30 |
-<itemizedlist> |
31 |
-<listitem><para>diropts</para></listitem> |
32 |
-<listitem><para>docompress</para></listitem> |
33 |
-<listitem><para>exeopts</para></listitem> |
34 |
-<listitem><para>insopts</para></listitem> |
35 |
-<listitem><para>keepdir</para></listitem> |
36 |
-<listitem><para>libopts</para></listitem> |
37 |
-<listitem><para>use</para></listitem> |
38 |
-<listitem><para>use_enable</para></listitem> |
39 |
-<listitem><para>use_with</para></listitem> |
40 |
-<listitem><para>useq</para></listitem> |
41 |
-<listitem><para>usev</para></listitem> |
42 |
-</itemizedlist> |
43 |
-</para> |
44 |
-</section> |
45 |
-</section> |
46 |
-<section id='package-ebuild-eapi-4-python-package-names-allow-period-characters'> |
47 |
-<title>Support for Period Characters in Package Names</title> |
48 |
-<para> |
49 |
-The "." character is allowed in package names. |
50 |
-</para> |
51 |
-</section> |
52 |
-<section id='package-ebuild-eapi-4-python-use-flag-allow-period-characters'> |
53 |
-<title>Support for Period Characters in USE Flags</title> |
54 |
-<para> |
55 |
-The "." character is allowed in USE flags. |
56 |
-</para> |
57 |
-</section> |
58 |
-<section id='package-ebuild-eapi-4-python-globstar'> |
59 |
-<title>globstar shell option enabled by default</title> |
60 |
-<para> |
61 |
-globstar shell option is enabled by default, which enables recursive expansion of ** pattern in pathname expansion context. |
62 |
-</para> |
63 |
-</section> |
64 |
-<section id='package-ebuild-eapi-4-python-repository-variable'> |
65 |
-<title>REPOSITORY Variable</title> |
66 |
-<para> |
67 |
-The new REPOSITORY variable is set in ebuild environment. This variable contains name of repository, which contains currently used ebuild. |
68 |
-</para> |
69 |
-</section> |
70 |
-<section id='package-ebuild-eapi-4-python-repository-dependencies'> |
71 |
-<title>Repository Dependencies</title> |
72 |
-<para> |
73 |
-Repository dependencies are supported in atoms in DEPEND, PDEPEND and RDEPEND and atoms passed to best_version and has_version functions. |
74 |
-Repository dependency is specified by two colons followed by repository name. |
75 |
-</para> |
76 |
-<table><title>Repository Dependency Examples</title> |
77 |
-<tgroup cols='1' align='left' > |
78 |
-<colspec colname='atom'/> |
79 |
-<thead> |
80 |
-<row> |
81 |
-<entry>Atom</entry> |
82 |
-</row> |
83 |
-</thead> |
84 |
-<tbody> |
85 |
-<row> |
86 |
-<entry>dev-lang/python::progress</entry> |
87 |
-</row> |
88 |
-<row> |
89 |
-<entry>>=dev-lang/python-3.2::progress</entry> |
90 |
-</row> |
91 |
-<row> |
92 |
-<entry>dev-lang/python:3.2::progress</entry> |
93 |
-</row> |
94 |
-<row> |
95 |
-<entry>dev-lang/python::progress[xml]</entry> |
96 |
-</row> |
97 |
-<row> |
98 |
-<entry>dev-lang/python:3.2::progress[xml]</entry> |
99 |
-</row> |
100 |
-</tbody> |
101 |
-</tgroup> |
102 |
-</table> |
103 |
-</section> |
104 |
-<section id='package-ebuild-eapi-4-python-repo-level-config'> |
105 |
-<title>Extended Repository-Level Configuration</title> |
106 |
-<para> |
107 |
-Repository-level configuration in ${repository}/profiles is supported for |
108 |
-the following files: |
109 |
-<itemizedlist> |
110 |
-<listitem><para>make.defaults</para></listitem> |
111 |
-<listitem><para>package.use</para></listitem> |
112 |
-<listitem><para>package.use.force</para></listitem> |
113 |
-<listitem><para>package.use.mask</para></listitem> |
114 |
-<listitem><para>use.force</para></listitem> |
115 |
-<listitem><para>use.mask</para></listitem> |
116 |
-</itemizedlist> |
117 |
-</para> |
118 |
-<para> |
119 |
-By default, the following files in ${repository}/profiles can be also directories: |
120 |
-<itemizedlist> |
121 |
-<listitem><para>package.mask</para></listitem> |
122 |
-<listitem><para>package.use</para></listitem> |
123 |
-<listitem><para>package.use.force</para></listitem> |
124 |
-<listitem><para>package.use.mask</para></listitem> |
125 |
-<listitem><para>use.force</para></listitem> |
126 |
-<listitem><para>use.mask</para></listitem> |
127 |
-</itemizedlist> |
128 |
-</para> |
129 |
-</section> |
130 |
+ <title>EAPI 4-python</title> |
131 |
+ <para> |
132 |
+ Also see the <ulink url="http://people.apache.org/~Arfrever/EAPI_4-python_Specification">official EAPI 4-python Specification</ulink>. |
133 |
+ </para> |
134 |
+ <section id='package-ebuild-eapi-4-python-helpers'> |
135 |
+ <title>Helpers</title> |
136 |
+ <section id='package-ebuild-eapi-4-python-helpers-banned-in-global-scope'> |
137 |
+ <title>Helpers Banned in Global Scope</title> |
138 |
+ <para> |
139 |
+ <itemizedlist> |
140 |
+ <listitem><para>diropts</para></listitem> |
141 |
+ <listitem><para>docompress</para></listitem> |
142 |
+ <listitem><para>exeopts</para></listitem> |
143 |
+ <listitem><para>insopts</para></listitem> |
144 |
+ <listitem><para>keepdir</para></listitem> |
145 |
+ <listitem><para>libopts</para></listitem> |
146 |
+ <listitem><para>use</para></listitem> |
147 |
+ <listitem><para>use_enable</para></listitem> |
148 |
+ <listitem><para>use_with</para></listitem> |
149 |
+ <listitem><para>useq</para></listitem> |
150 |
+ <listitem><para>usev</para></listitem> |
151 |
+ </itemizedlist> |
152 |
+ </para> |
153 |
+ </section> |
154 |
+ </section> |
155 |
+ <section id='package-ebuild-eapi-4-python-metadata'> |
156 |
+ <title>Metadata</title> |
157 |
+ <section id='package-ebuild-eapi-4-python-metadata-package-names-allow-period-characters'> |
158 |
+ <title>Support for Period Characters in Package Names</title> |
159 |
+ <para> |
160 |
+ The "." character is allowed in package names. |
161 |
+ </para> |
162 |
+ </section> |
163 |
+ <section id='package-ebuild-eapi-4-python-metadata-use-flags-allow-period-characters'> |
164 |
+ <title>Support for Period Characters in USE Flags</title> |
165 |
+ <para> |
166 |
+ The "." character is allowed in USE flags. |
167 |
+ </para> |
168 |
+ </section> |
169 |
+ <section id='package-ebuild-eapi-4-python-metadata-repository-dependencies'> |
170 |
+ <title>Repository Dependencies</title> |
171 |
+ <para> |
172 |
+ Repository dependencies are supported in atoms in DEPEND, PDEPEND and RDEPEND and atoms passed to best_version and has_version functions. |
173 |
+ Repository dependency is specified by two colons followed by repository name. |
174 |
+ </para> |
175 |
+ <table><title>Repository Dependency Examples</title> |
176 |
+ <tgroup cols='1' align='left'> |
177 |
+ <colspec colname='atom'/> |
178 |
+ <thead> |
179 |
+ <row> |
180 |
+ <entry>Atom</entry> |
181 |
+ </row> |
182 |
+ </thead> |
183 |
+ <tbody> |
184 |
+ <row> |
185 |
+ <entry>dev-lang/python::progress</entry> |
186 |
+ </row> |
187 |
+ <row> |
188 |
+ <entry>>=dev-lang/python-3.2::progress</entry> |
189 |
+ </row> |
190 |
+ <row> |
191 |
+ <entry>dev-lang/python:3.2::progress</entry> |
192 |
+ </row> |
193 |
+ <row> |
194 |
+ <entry>dev-lang/python::progress[xml]</entry> |
195 |
+ </row> |
196 |
+ <row> |
197 |
+ <entry>dev-lang/python:3.2::progress[xml]</entry> |
198 |
+ </row> |
199 |
+ </tbody> |
200 |
+ </tgroup> |
201 |
+ </table> |
202 |
+ </section> |
203 |
+ </section> |
204 |
+ <section id='package-ebuild-eapi-4-python-globstar'> |
205 |
+ <title>globstar shell option enabled by default</title> |
206 |
+ <para> |
207 |
+ globstar shell option is enabled by default, which enables recursive expansion of ** pattern in pathname expansion context. |
208 |
+ </para> |
209 |
+ </section> |
210 |
+ <section id='package-ebuild-eapi-4-python-variables'> |
211 |
+ <title>Variables</title> |
212 |
+ <section id='package-ebuild-eapi-4-python-variables-repository'> |
213 |
+ <title>REPOSITORY Variable</title> |
214 |
+ <para> |
215 |
+ The new REPOSITORY variable is set in ebuild environment. This variable contains name of repository, which contains currently used ebuild. |
216 |
+ </para> |
217 |
+ </section> |
218 |
+ </section> |
219 |
+ <section id='package-ebuild-eapi-4-python-repo-level-config'> |
220 |
+ <title>Extended Repository-Level Configuration</title> |
221 |
+ <para> |
222 |
+ Repository-level configuration in ${repository}/profiles is supported for the following files: |
223 |
+ <itemizedlist> |
224 |
+ <listitem><para>make.defaults</para></listitem> |
225 |
+ <listitem><para>package.use</para></listitem> |
226 |
+ <listitem><para>package.use.force</para></listitem> |
227 |
+ <listitem><para>package.use.mask</para></listitem> |
228 |
+ <listitem><para>use.force</para></listitem> |
229 |
+ <listitem><para>use.mask</para></listitem> |
230 |
+ </itemizedlist> |
231 |
+ </para> |
232 |
+ <para> |
233 |
+ By default, the following files in ${repository}/profiles can be also directories: |
234 |
+ <itemizedlist> |
235 |
+ <listitem><para>package.mask</para></listitem> |
236 |
+ <listitem><para>package.use</para></listitem> |
237 |
+ <listitem><para>package.use.force</para></listitem> |
238 |
+ <listitem><para>package.use.mask</para></listitem> |
239 |
+ <listitem><para>use.force</para></listitem> |
240 |
+ <listitem><para>use.mask</para></listitem> |
241 |
+ </itemizedlist> |
242 |
+ </para> |
243 |
+ </section> |
244 |
</section> |