doc/webserver/developer-manual/webserver-update.html

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