1 |
swift 05/08/01 15:52:23 |
2 |
|
3 |
Modified: xml/htdocs/doc/en apache-upgrading.xml metadoc.xml |
4 |
Added: xml/htdocs/doc/en apache-developer.xml |
5 |
Log: |
6 |
#99539 - Apache developer documentation |
7 |
|
8 |
Revision Changes Path |
9 |
1.2 +2 -2 xml/htdocs/doc/en/apache-upgrading.xml |
10 |
|
11 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/apache-upgrading.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
12 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/apache-upgrading.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo |
13 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/apache-upgrading.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo |
14 |
|
15 |
Index: apache-upgrading.xml |
16 |
=================================================================== |
17 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/apache-upgrading.xml,v |
18 |
retrieving revision 1.1 |
19 |
retrieving revision 1.2 |
20 |
diff -u -r1.1 -r1.2 |
21 |
--- apache-upgrading.xml 1 Aug 2005 15:17:11 -0000 1.1 |
22 |
+++ apache-upgrading.xml 1 Aug 2005 15:52:23 -0000 1.2 |
23 |
@@ -16,7 +16,7 @@ |
24 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
25 |
<license/> |
26 |
|
27 |
-<version>2.1</version> |
28 |
+<version>2.2</version> |
29 |
<date>2005-08-01</date> |
30 |
|
31 |
<chapter> |
32 |
@@ -66,7 +66,7 @@ |
33 |
This document details how to upgrade without breaking your system. If you are |
34 |
a developer or would like to know what we changed, or how ebuilds need to be |
35 |
modified to take advantage of our eclass, then check the <uri |
36 |
-link="/proj/en/developer.xml">Apache Developer Reference</uri>. |
37 |
+link="apache-developer.xml">Apache Developer Reference</uri>. |
38 |
</p> |
39 |
|
40 |
</body> |
41 |
|
42 |
|
43 |
|
44 |
1.92 +6 -1 xml/htdocs/doc/en/metadoc.xml |
45 |
|
46 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/metadoc.xml?rev=1.92&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
47 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/metadoc.xml?rev=1.92&content-type=text/plain&cvsroot=gentoo |
48 |
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/metadoc.xml.diff?r1=1.91&r2=1.92&cvsroot=gentoo |
49 |
|
50 |
Index: metadoc.xml |
51 |
=================================================================== |
52 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v |
53 |
retrieving revision 1.91 |
54 |
retrieving revision 1.92 |
55 |
diff -u -r1.91 -r1.92 |
56 |
--- metadoc.xml 1 Aug 2005 15:17:11 -0000 1.91 |
57 |
+++ metadoc.xml 1 Aug 2005 15:52:23 -0000 1.92 |
58 |
@@ -1,5 +1,5 @@ |
59 |
<?xml version='1.0' encoding="UTF-8"?> |
60 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v 1.91 2005/08/01 15:17:11 swift Exp $ --> |
61 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/metadoc.xml,v 1.92 2005/08/01 15:52:23 swift Exp $ --> |
62 |
<!DOCTYPE metadoc SYSTEM "/dtd/metadoc.dtd"> |
63 |
|
64 |
<metadoc lang="en"> |
65 |
@@ -361,6 +361,7 @@ |
66 |
<file id="shb-uptodate">/doc/en/security/shb-uptodate.xml</file> |
67 |
<file id="apache-troubleshooting">/doc/en/apache-troubleshooting.xml</file> |
68 |
<file id="apache-upgrading">/doc/en/apache-upgrading.xml</file> |
69 |
+ <file id="apache-developer">/doc/en/apache-developer.xml</file> |
70 |
</files> |
71 |
<docs> |
72 |
<doc id="name-logo"> |
73 |
@@ -989,5 +990,9 @@ |
74 |
<memberof>sysadmin_specific</memberof> |
75 |
<fileid>apache-upgrading</fileid> |
76 |
</doc> |
77 |
+ <doc id="apache-developer"> |
78 |
+ <memberof>gentoodev_docs</memberof> |
79 |
+ <fileid>apache-developer</fileid> |
80 |
+ </doc> |
81 |
</docs> |
82 |
</metadoc> |
83 |
|
84 |
|
85 |
|
86 |
1.1 xml/htdocs/doc/en/apache-developer.xml |
87 |
|
88 |
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/apache-developer.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo |
89 |
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/apache-developer.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo |
90 |
|
91 |
Index: apache-developer.xml |
92 |
=================================================================== |
93 |
<?xml version='1.0' encoding="UTF-8"?> |
94 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
95 |
<guide link="apache-developer.xml" lang="en"> |
96 |
<title>Apache Developer Documentation</title> |
97 |
|
98 |
<author title="Author"> |
99 |
<mail link="vericgar@g.o">Michael Stewart</mail> |
100 |
</author> |
101 |
|
102 |
<abstract> |
103 |
This document provides details about the new eclasses available for developers |
104 |
of packages that relate to Apache. |
105 |
</abstract> |
106 |
|
107 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
108 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
109 |
<license/> |
110 |
|
111 |
<version>2.1</version> |
112 |
<date>2005-08-01</date> |
113 |
|
114 |
<chapter> |
115 |
<title>About this document</title> |
116 |
<section> |
117 |
<body> |
118 |
|
119 |
<p> |
120 |
This document details the <uri link="#apache-module">new eclasses</uri>, <uri |
121 |
link="#changes">what we changed</uri> from the previous style of apache and |
122 |
how ebuilds need to be <uri link="#ebuild-update">modified</uri> to take |
123 |
advantage of our new eclasses. If you are a user looking for information on |
124 |
how to upgrade, please use the <uri link="apache-upgrading.xml">Upgrading |
125 |
Apache</uri> document. |
126 |
</p> |
127 |
|
128 |
</body> |
129 |
</section> |
130 |
</chapter> |
131 |
|
132 |
<chapter id="changes"> |
133 |
<title>What Has Changed</title> |
134 |
<section> |
135 |
<title>Overview</title> |
136 |
<body> |
137 |
|
138 |
<p> |
139 |
We have made many changes to the way Apache and its modules install and work |
140 |
on Gentoo. This eases the maintenance burden and more closely follows upstream |
141 |
practices. Our changes are: |
142 |
</p> |
143 |
|
144 |
<ul> |
145 |
<li>Fixed many <uri link="#buglist">bugs</uri></li> |
146 |
<li>Changed installation and configuration paths</li> |
147 |
<li> |
148 |
Created <uri link="#depend-apache">depend.apache</uri> and <uri |
149 |
link="#apache-module">apache-module</uri> eclasses |
150 |
</li> |
151 |
<li> |
152 |
Combined apache.conf and commonapache.conf into one file that is very |
153 |
similar to how upstream distributes it |
154 |
</li> |
155 |
<li> |
156 |
Split <c>apr</c> and <c>apr-utils</c> out of apache so some packages no |
157 |
longer require apache |
158 |
</li> |
159 |
<li>Updated and version bumped nearly every module</li> |
160 |
<li>Made more MPMs available</li> |
161 |
<li>Added lingerd support</li> |
162 |
<li>Fixed large file support</li> |
163 |
<li><e>Much more I'm sure I'm forgetting...</e></li> |
164 |
</ul> |
165 |
|
166 |
</body> |
167 |
</section> |
168 |
<section> |
169 |
<title>Apache Path Locations</title> |
170 |
<body> |
171 |
|
172 |
<p> |
173 |
In order to more closely follow how upstream and other distributions install |
174 |
apache, the following paths have changed: |
175 |
</p> |
176 |
|
177 |
</body> |
178 |
</section> |
179 |
<section> |
180 |
<title>Apache 1.x</title> |
181 |
<body> |
182 |
|
183 |
<table> |
184 |
<tr> |
185 |
<th>Use</th> |
186 |
<th>Old Path</th> |
187 |
<th>New Path</th> |
188 |
</tr> |
189 |
<tr> |
190 |
<ti>Server Root</ti> |
191 |
<ti><path>/etc/apache/</path></ti> |
192 |
<ti><path>/usr/lib/apache/</path></ti> |
193 |
</tr> |
194 |
<tr> |
195 |
<ti>Configuration Directory</ti> |
196 |
<ti><path>/etc/apache/conf/</path></ti> |
197 |
<ti><path>/etc/apache/</path></ti> |
198 |
</tr> |
199 |
<tr> |
200 |
<ti>Configuration</ti> |
201 |
<ti><path>/etc/apache/conf/apache.conf</path></ti> |
202 |
<ti><path>/etc/apache/httpd.conf</path></ti> |
203 |
</tr> |
204 |
<tr> |
205 |
<ti>Configuration</ti> |
206 |
<ti><path>/etc/apache/conf/commonapache.conf</path></ti> |
207 |
<ti><path>/etc/apache/httpd.conf</path></ti> |
208 |
</tr> |
209 |
<tr> |
210 |
<ti>Vhosts Configuration</ti> |
211 |
<ti><path>/etc/apache/conf/vhosts/</path></ti> |
212 |
<ti><path>/etc/apache/vhosts.d/</path></ti> |
213 |
</tr> |
214 |
<tr> |
215 |
<ti>Modules Configuration</ti> |
216 |
<ti><path>/etc/apache/conf/addon-modules/</path></ti> |
217 |
<ti><path>/etc/apache/modules.d/</path></ti> |
218 |
</tr> |
219 |
<tr> |
220 |
<ti>Module Binaries</ti> |
221 |
<ti><path>/usr/lib/apache-extramodules/</path></ti> |
222 |
<ti><path>/usr/lib/apache/modules/</path></ti> |
223 |
</tr> |
224 |
</table> |
225 |
|
226 |
</body> |
227 |
</section> |
228 |
<section> |
229 |
<title>Apache 2.x</title> |
230 |
<body> |
231 |
|
232 |
<table> |
233 |
<tr> |
234 |
<th>Use</th> |
235 |
<th>Old Path</th> |
236 |
<th>New Path</th> |
237 |
</tr> |
238 |
<tr> |
239 |
<ti>Server Root</ti> |
240 |
<ti><path>/etc/apache2/</path></ti> |
241 |
<ti><path>/usr/lib/apache2/</path></ti> |
242 |
</tr> |
243 |
<tr> |
244 |
<ti>Configuration Directory</ti> |
245 |
<ti><path>/etc/apache2/conf/</path></ti> |
246 |
<ti><path>/etc/apache2/</path></ti> |
247 |
</tr> |
248 |
<tr> |
249 |
<ti>Configuration</ti> |
250 |
<ti><path>/etc/apache2/conf/apache2.conf</path></ti> |
251 |
<ti><path>/etc/apache2/httpd.conf</path></ti> |
252 |
</tr> |
253 |
<tr> |
254 |
<ti>Configuration</ti> |
255 |
<ti><path>/etc/apache2/conf/commonapache2.conf</path></ti> |
256 |
<ti><path>/etc/apache2/httpd.conf</path></ti> |
257 |
</tr> |
258 |
<tr> |
259 |
<ti>Vhosts Configuration</ti> |
260 |
<ti><path>/etc/apache2/conf/vhosts/</path></ti> |
261 |
<ti><path>/etc/apache2/vhosts.d/</path></ti> |
262 |
</tr> |
263 |
<tr> |
264 |
<ti>Modules Configuration</ti> |
265 |
<ti><path>/etc/apache2/conf/modules.d/</path></ti> |
266 |
<ti><path>/etc/apache2/modules.d/</path></ti> |
267 |
</tr> |
268 |
<tr> |
269 |
<ti>Module Binaries</ti> |
270 |
<ti><path>/usr/lib/apache2-extramodules/</path></ti> |
271 |
<ti><path>/usr/lib/apache2/modules/</path></ti> |
272 |
</tr> |
273 |
</table> |
274 |
|
275 |
<note> |
276 |
The default configuration now automatically includes |
277 |
<path>modules.d/*.conf</path> and <path>vhosts.d/*.conf</path> by default. |
278 |
However, the directive in <path>httpd.conf</path> lists the above as |
279 |
<path>conf/modules.d/*.conf</path> and <path>conf/vhosts.d/*.conf</path>. This |
280 |
is because Apache reads the configuration using the directory |
281 |
<path>/usr/lib/apache{|2}</path> which contains a symbolic link <path>conf -> |
282 |
/etc/apache{|2}</path>. |
283 |
</note> |
284 |
|
285 |
|
286 |
<impo> |
287 |
If you are a developer updating an ebuild to work with the changes we've made, |
288 |
please do not hard-code the above paths into your ebuild - see the eclass |
289 |
documentation on appropriate variables you can use instead. |
290 |
</impo> |
291 |
|
292 |
|
293 |
|
294 |
|
295 |
-- |
296 |
gentoo-doc-cvs@g.o mailing list |