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