Re-commit to solve various last minute issues for charsets, etc.
[privoxy.git] / doc / webserver / developer-manual / webserver-update.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >Update the Webserver</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9 REL="HOME"
10 TITLE="Privoxy Developer Manual"
11 HREF="index.html"><LINK
12 REL="PREVIOUS"
13 TITLE="Releasing a New Version"
14 HREF="newrelease.html"><LINK
15 REL="NEXT"
16 TITLE="Contacting the developers, Bug Reporting and Feature Requests"
17 HREF="contact.html"><LINK
18 REL="STYLESHEET"
19 TYPE="text/css"
20 HREF="../p_doc.css"><META
21 HTTP-EQUIV="Content-Type"
22 CONTENT="text/html;
23 charset=ISO-8859-1"></HEAD
24 ><BODY
25 CLASS="SECT1"
26 BGCOLOR="#EEEEEE"
27 TEXT="#000000"
28 LINK="#0000FF"
29 VLINK="#840084"
30 ALINK="#0000FF"
31 ><DIV
32 CLASS="NAVHEADER"
33 ><TABLE
34 SUMMARY="Header navigation table"
35 WIDTH="100%"
36 BORDER="0"
37 CELLPADDING="0"
38 CELLSPACING="0"
39 ><TR
40 ><TH
41 COLSPAN="3"
42 ALIGN="center"
43 >Privoxy Developer Manual</TH
44 ></TR
45 ><TR
46 ><TD
47 WIDTH="10%"
48 ALIGN="left"
49 VALIGN="bottom"
50 ><A
51 HREF="newrelease.html"
52 ACCESSKEY="P"
53 >Prev</A
54 ></TD
55 ><TD
56 WIDTH="80%"
57 ALIGN="center"
58 VALIGN="bottom"
59 ></TD
60 ><TD
61 WIDTH="10%"
62 ALIGN="right"
63 VALIGN="bottom"
64 ><A
65 HREF="contact.html"
66 ACCESSKEY="N"
67 >Next</A
68 ></TD
69 ></TR
70 ></TABLE
71 ><HR
72 ALIGN="LEFT"
73 WIDTH="100%"></DIV
74 ><DIV
75 CLASS="SECT1"
76 ><H1
77 CLASS="SECT1"
78 ><A
79 NAME="WEBSERVER-UPDATE"
80 >7. Update the Webserver</A
81 ></H1
82 ><P
83 >    The webserver should be updated at least with each stable release. When
84     updating, please follow these steps to make sure that no broken links,
85     inconsistent contents or permission problems will occur (as it has many 
86     times in the past!):
87    </P
88 ><P
89 >    If you have changed anything in the stable-branch documentation source
90     SGML files, do:
91    </P
92 ><P
93 >    <TABLE
94 BORDER="0"
95 BGCOLOR="#E0E0E0"
96 WIDTH="100%"
97 ><TR
98 ><TD
99 ><PRE
100 CLASS="PROGRAMLISTING"
101 >  make dok dok-pdf # (or 'make redhat-dok dok-pdf' if 'make dok' doesn't work for you)</PRE
102 ></TD
103 ></TR
104 ></TABLE
105 >
106    </P
107 ><P
108 >    That will generate <TT
109 CLASS="FILENAME"
110 >doc/webserver/user-manual</TT
111 >,
112     <TT
113 CLASS="FILENAME"
114 >doc/webserver/developer-manual</TT
115 >,
116     <TT
117 CLASS="FILENAME"
118 >doc/webserver/faq</TT
119 >, 
120     <TT
121 CLASS="FILENAME"
122 >doc/pdf/*.pdf</TT
123 > and
124     <TT
125 CLASS="FILENAME"
126 >doc/webserver/index.html</TT
127 > automatically.
128    </P
129 ><P
130 >    If you changed the manual page sources, generate
131     <TT
132 CLASS="FILENAME"
133 >doc/webserver/man-page/privoxy-man-page.html</TT
134 >
135     by running <SPAN
136 CLASS="QUOTE"
137 >"<B
138 CLASS="COMMAND"
139 >make man</B
140 >"</SPAN
141 >. (This is
142     a separate target due to dependencies on some obscure perl scripts
143     [now in CVS, but not well tested]. See comments in <TT
144 CLASS="FILENAME"
145 >GNUmakefile</TT
146 >.)
147    </P
148 ><P
149 >    If you want to add new files to the webserver, create them locally in
150     the <TT
151 CLASS="FILENAME"
152 >doc/webserver/*</TT
153 > directory (or
154     create new directories under <TT
155 CLASS="FILENAME"
156 >doc/webserver</TT
157 >).
158    </P
159 ><P
160 >    Next, commit any changes from the above steps to CVS. All set? 
161     If these are docs in the stable branch, then do:
162    </P
163 ><P
164 >    <TABLE
165 BORDER="0"
166 BGCOLOR="#E0E0E0"
167 WIDTH="100%"
168 ><TR
169 ><TD
170 ><PRE
171 CLASS="PROGRAMLISTING"
172 >  make webserver</PRE
173 ></TD
174 ></TR
175 ></TABLE
176 >
177    </P
178 ><P
179 >    This will do the upload to <A
180 HREF="http://www.privoxy.org/"
181 TARGET="_top"
182 >the
183     webserver</A
184 > (www.privoxy.org) and ensure all files and directories
185     there are group writable.
186    </P
187 ><P
188 >    Please do <SPAN
189 CLASS="emphasis"
190 ><I
191 CLASS="EMPHASIS"
192 >NOT</I
193 ></SPAN
194 > use any other means of transferring
195     files to the webserver to avoid permission problems. Also, please do not
196     upload docs from development branches or versions. The publicly posted
197     docs should be in sync with the last official release.
198    </P
199 ></DIV
200 ><DIV
201 CLASS="NAVFOOTER"
202 ><HR
203 ALIGN="LEFT"
204 WIDTH="100%"><TABLE
205 SUMMARY="Footer navigation table"
206 WIDTH="100%"
207 BORDER="0"
208 CELLPADDING="0"
209 CELLSPACING="0"
210 ><TR
211 ><TD
212 WIDTH="33%"
213 ALIGN="left"
214 VALIGN="top"
215 ><A
216 HREF="newrelease.html"
217 ACCESSKEY="P"
218 >Prev</A
219 ></TD
220 ><TD
221 WIDTH="34%"
222 ALIGN="center"
223 VALIGN="top"
224 ><A
225 HREF="index.html"
226 ACCESSKEY="H"
227 >Home</A
228 ></TD
229 ><TD
230 WIDTH="33%"
231 ALIGN="right"
232 VALIGN="top"
233 ><A
234 HREF="contact.html"
235 ACCESSKEY="N"
236 >Next</A
237 ></TD
238 ></TR
239 ><TR
240 ><TD
241 WIDTH="33%"
242 ALIGN="left"
243 VALIGN="top"
244 >Releasing a New Version</TD
245 ><TD
246 WIDTH="34%"
247 ALIGN="center"
248 VALIGN="top"
249 >&nbsp;</TD
250 ><TD
251 WIDTH="33%"
252 ALIGN="right"
253 VALIGN="top"
254 >Contacting the developers, Bug Reporting and Feature Requests</TD
255 ></TR
256 ></TABLE
257 ></DIV
258 ></BODY
259 ></HTML
260 >