Gentoo Archives: gentoo-commits

From: "Ulrich Müller" <ulm@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] proj/devmanual:master commit in: tasks-reference/, general-concepts/linguas/, profiles/, ...
Date: Fri, 06 Sep 2019 09:41:29
Message-Id: 1567762850.f9567de4159240d7c3074f78301fe0d6a65ee25f.ulm@gentoo
1 commit: f9567de4159240d7c3074f78301fe0d6a65ee25f
2 Author: Michael Orlitzky <mjo <AT> gentoo <DOT> org>
3 AuthorDate: Thu Apr 25 17:25:50 2019 +0000
4 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
5 CommitDate: Fri Sep 6 09:40:50 2019 +0000
6 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=f9567de4
7
8 Remove empty TODO pages.
9
10 The following pages were devoid of any real information, containing
11 only a note to "write me in the future,"
12
13 * ebuild-writing/functions/src_unpack/deb-sources
14 * ebuild-writing/functions/src_unpack/tla-sources
15 * general-concepts/distributed-building
16 * general-concepts/linguas
17 * general-concepts/privileges
18 * profiles/profiles.desc
19 * tasks-reference/perl-modules
20
21 That isn't helpful to the reader, and just plain looks bad. This
22 commit removes them all.
23
24 Closes: https://bugs.gentoo.org/684350
25 Signed-off-by: Michael Orlitzky <mjo <AT> gentoo.org>
26 Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>
27
28 .../functions/src_unpack/deb-sources/text.xml | 12 ------------
29 ebuild-writing/functions/src_unpack/text.xml | 2 --
30 .../functions/src_unpack/tla-sources/text.xml | 12 ------------
31 general-concepts/distributed-building/text.xml | 13 -------------
32 general-concepts/linguas/text.xml | 13 -------------
33 general-concepts/privileges/text.xml | 15 ---------------
34 general-concepts/text.xml | 3 ---
35 profiles/profiles.desc/text.xml | 14 --------------
36 profiles/text.xml | 1 -
37 tasks-reference/perl-modules/text.xml | 19 -------------------
38 tasks-reference/text.xml | 1 -
39 11 files changed, 105 deletions(-)
40
41 diff --git a/ebuild-writing/functions/src_unpack/deb-sources/text.xml b/ebuild-writing/functions/src_unpack/deb-sources/text.xml
42 deleted file mode 100644
43 index bdbadb4..0000000
44 --- a/ebuild-writing/functions/src_unpack/deb-sources/text.xml
45 +++ /dev/null
46 @@ -1,12 +0,0 @@
47 -<?xml version="1.0"?>
48 -<guide self="ebuild-writing/functions/src_unpack/deb-sources/">
49 -<chapter>
50 -<title>Debian Sources</title>
51 -
52 -<body>
53 -<todo>
54 -from vapier: we dont have to 'handle' these because all debian packages have a source tarball ... the .deb format is pretty simple though, it's managed by the 'ar' utility from binutils. you can unpack a .deb by simply doing ar x blah.deb ... this will give you three files: debian-binary: plain text file which just contains version number of the .deb format control.tar.gz: a few files which control installing/verifying of package data.tar.gz: all the compiled files ... you could just extract it to /
55 -</todo>
56 -</body>
57 -</chapter>
58 -</guide>
59
60 diff --git a/ebuild-writing/functions/src_unpack/text.xml b/ebuild-writing/functions/src_unpack/text.xml
61 index a964a74..76b5f35 100644
62 --- a/ebuild-writing/functions/src_unpack/text.xml
63 +++ b/ebuild-writing/functions/src_unpack/text.xml
64 @@ -95,8 +95,6 @@ The following subsections cover different topics which often occur when writing
65
66 <include href="cvs-sources/"/>
67 <include href="svn-sources/"/>
68 -<include href="tla-sources/"/>
69 <include href="rpm-sources/"/>
70 -<include href="deb-sources/"/>
71 <include href="other-formats/"/>
72 </guide>
73
74 diff --git a/ebuild-writing/functions/src_unpack/tla-sources/text.xml b/ebuild-writing/functions/src_unpack/tla-sources/text.xml
75 deleted file mode 100644
76 index 97a8b40..0000000
77 --- a/ebuild-writing/functions/src_unpack/tla-sources/text.xml
78 +++ /dev/null
79 @@ -1,12 +0,0 @@
80 -<?xml version="1.0"?>
81 -<guide self="ebuild-writing/functions/src_unpack/tla-sources/">
82 -<chapter>
83 -<title>Arch Sources</title>
84 -
85 -<body>
86 -<todo>
87 -Anyone want to write this? You can probably mostly copy the CVS Sources and Subversion Sources chapters.
88 -</todo>
89 -</body>
90 -</chapter>
91 -</guide>
92
93 diff --git a/general-concepts/distributed-building/text.xml b/general-concepts/distributed-building/text.xml
94 deleted file mode 100644
95 index 003c27f..0000000
96 --- a/general-concepts/distributed-building/text.xml
97 +++ /dev/null
98 @@ -1,13 +0,0 @@
99 -<?xml version="1.0"?>
100 -<guide self="general-concepts/distributed-building/">
101 -<chapter>
102 -<title>Distributed and Parallel Building</title>
103 -
104 -<body>
105 -
106 -<todo>Write this.</todo>
107 -
108 -</body>
109 -</chapter>
110 -</guide>
111 -
112
113 diff --git a/general-concepts/linguas/text.xml b/general-concepts/linguas/text.xml
114 deleted file mode 100644
115 index d44a879..0000000
116 --- a/general-concepts/linguas/text.xml
117 +++ /dev/null
118 @@ -1,13 +0,0 @@
119 -<?xml version="1.0"?>
120 -<guide self="general-concepts/linguas/">
121 -<chapter>
122 -<title>Linguas</title>
123 -
124 -<body>
125 -<todo>
126 -Write this. From vapier: "used to specify languages users wish to have support for. USE=nls covers generally natural language support, but LINGUAS covers specific languages (see the games-rpg/nwn for example). the variable is expanded for USE access in ebuilds. LINGUAS=de would automatically add 'linguas_de' to USE." We also need strip-linguas examples.
127 -</todo>
128 -</body>
129 -
130 -</chapter>
131 -</guide>
132
133 diff --git a/general-concepts/privileges/text.xml b/general-concepts/privileges/text.xml
134 deleted file mode 100644
135 index 8dc516b..0000000
136 --- a/general-concepts/privileges/text.xml
137 +++ /dev/null
138 @@ -1,15 +0,0 @@
139 -<?xml version="1.0"?>
140 -<guide self="general-concepts/privileges/">
141 -<chapter>
142 -<title>Privileges</title>
143 -
144 -<body>
145 -<todo>
146 -general privs stuff, include stuff on setuid/setgid and sticky since
147 -a lot of people seem to be confused about those... Also notes on the portage
148 -user and group issues, and what we use for root:root to make *bsd work.
149 -</todo>
150 -</body>
151 -
152 -</chapter>
153 -</guide>
154
155 diff --git a/general-concepts/text.xml b/general-concepts/text.xml
156 index 0746e3d..1e40785 100644
157 --- a/general-concepts/text.xml
158 +++ b/general-concepts/text.xml
159 @@ -24,7 +24,6 @@ writing ebuilds or working with the Gentoo repository.
160 <include href="git-to-rsync/"/>
161 <include href="dependencies/"/>
162 <include href="manifest/"/>
163 -<include href="distributed-building/"/>
164 <include href="ebuild-revisions/"/>
165 <include href="emerge-and-ebuild/"/>
166 <include href="features/"/>
167 @@ -32,13 +31,11 @@ writing ebuilds or working with the Gentoo repository.
168 <include href="herds-and-projects/"/>
169 <include href="install-destinations/"/>
170 <include href="licenses/"/>
171 -<include href="linguas/"/>
172 <include href="mirrors/"/>
173 <include href="news/"/>
174 <include href="overlay/"/>
175 <include href="pic/"/>
176 <include href="portage-cache/"/>
177 -<include href="privileges/"/>
178 <include href="sandbox/"/>
179 <include href="slotting/"/>
180 <include href="tree/"/>
181
182 diff --git a/profiles/profiles.desc/text.xml b/profiles/profiles.desc/text.xml
183 deleted file mode 100644
184 index 16dc52a..0000000
185 --- a/profiles/profiles.desc/text.xml
186 +++ /dev/null
187 @@ -1,14 +0,0 @@
188 -<?xml version="1.0"?>
189 -<guide self="profiles/profiles.desc/">
190 -<chapter>
191 -<title>Profiles <c>profiles.desc</c> File</title>
192 -<body>
193 -
194 -<todo>
195 -Find someone who knows exactly what this file's really used for with
196 -current portage versions and what is and isn't allowed.
197 -</todo>
198 -
199 -</body>
200 -</chapter>
201 -</guide>
202
203 diff --git a/profiles/text.xml b/profiles/text.xml
204 index 4db23c6..419c5c7 100644
205 --- a/profiles/text.xml
206 +++ b/profiles/text.xml
207 @@ -22,7 +22,6 @@ are also documented in <c>man portage</c>.
208 <include href="info_files/"/>
209 <include href="package.mask/"/>
210 <include href="packages/"/>
211 -<include href="profiles.desc/"/>
212 <include href="updates/"/>
213 <include href="use.desc/"/>
214 <include href="use.mask/"/>
215
216 diff --git a/tasks-reference/perl-modules/text.xml b/tasks-reference/perl-modules/text.xml
217 deleted file mode 100644
218 index 4510bf7..0000000
219 --- a/tasks-reference/perl-modules/text.xml
220 +++ /dev/null
221 @@ -1,19 +0,0 @@
222 -<?xml version="1.0"?>
223 -<guide self="tasks-reference/perl-modules/">
224 -<chapter>
225 -<title>Perl Modules</title>
226 -<body>
227 -
228 -<p>
229 -This section covers where and how Perl modules should be installed. This is for
230 -Perl applications which use their own <c>.pm</c> files, <b>not</b> for CPAN things.
231 -</p>
232 -
233 -<todo>
234 -write me. see thread on -dev.
235 -</todo>
236 -
237 -</body>
238 -</chapter>
239 -</guide>
240 -
241
242 diff --git a/tasks-reference/text.xml b/tasks-reference/text.xml
243 index 8de23bb..5137b4d 100644
244 --- a/tasks-reference/text.xml
245 +++ b/tasks-reference/text.xml
246 @@ -22,5 +22,4 @@ ebuilds.
247 <include href="environment/"/>
248 <include href="init-scripts/"/>
249 <include href="pam/"/>
250 -<include href="perl-modules/"/>
251 </guide>