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

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
   2 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
   3 <html>
   4   <head>
   5     <title>
   6       Update the Webserver
   7     </title>
   8     <meta name="GENERATOR" content=
   9     "Modular DocBook HTML Stylesheet Version 1.79">
  10     <link rel="HOME" title="Privoxy Developer Manual" href="index.html">
  11     <link rel="PREVIOUS" title="Releasing a New Version" href=
  12     "newrelease.html">
  13     <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
  14     <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  15   </head>
  16   <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
  17   "#840084" alink="#0000FF">
  18     <div class="NAVHEADER">
  19       <table summary="Header navigation table" width="100%" border="0"
  20       cellpadding="0" cellspacing="0">
  21         <tr>
  22           <th colspan="3" align="center">
  23             Privoxy Developer Manual
  24           </th>
  25         </tr>
  26         <tr>
  27           <td width="10%" align="left" valign="bottom">
  28             <a href="newrelease.html" accesskey="P">Prev</a>
  29           </td>
  30           <td width="80%" align="center" valign="bottom">
  31           </td>
  32           <td width="10%" align="right" valign="bottom">
  33             &nbsp;
  34           </td>
  35         </tr>
  36       </table>
  37       <hr align="LEFT" width="100%">
  38     </div>
  39     <div class="SECT1">
  40       <h1 class="SECT1">
  41         <a name="WEBSERVER-UPDATE">7. Update the Webserver</a>
  42       </h1>
  43       <p>
  44         The webserver should be updated at least with each stable release.
  45         When updating, please follow these steps to make sure that no broken
  46         links, inconsistent contents or permission problems will occur (as it
  47         has many times in the past!):
  48       </p>
  49       <p>
  50         If you have changed anything in the stable-branch documentation
  51         source SGML files, do:
  52       </p>
  53       <p>
  54       </p>
  55       <table border="0" bgcolor="#E0E0E0" width="100%">
  56         <tr>
  57           <td>
  58 <pre class="PROGRAMLISTING">
  59   make dok
  60 </pre>
  61           </td>
  62         </tr>
  63       </table>
  64
  65       <p>
  66         That will generate <tt class=
  67         "FILENAME">doc/webserver/user-manual</tt>, <tt class=
  68         "FILENAME">doc/webserver/developer-manual</tt>, <tt class=
  69         "FILENAME">doc/webserver/faq</tt>, <tt class=
  70         "FILENAME">doc/webserver/index.html</tt> automatically.
  71       </p>
  72       <p>
  73         If you changed the manual page sources, generate <tt class=
  74         "FILENAME">doc/webserver/man-page/privoxy-man-page.html</tt> by
  75         running <span class="QUOTE">"<b class="COMMAND">make man</b>"</span>.
  76         (This is a separate target due to dependencies on some obscure perl
  77         scripts [now in CVS, but not well tested]. See comments in <tt class=
  78         "FILENAME">GNUmakefile</tt>.)
  79       </p>
  80       <p>
  81         If you want to add new files to the webserver, create them locally in
  82         the <tt class="FILENAME">doc/webserver/*</tt> directory (or create
  83         new directories under <tt class="FILENAME">doc/webserver</tt>).
  84       </p>
  85       <p>
  86         Next, commit any changes from the above steps to CVS. All set? If
  87         these are docs in the stable branch, then do:
  88       </p>
  89       <p>
  90       </p>
  91       <table border="0" bgcolor="#E0E0E0" width="100%">
  92         <tr>
  93           <td>
  94 <pre class="PROGRAMLISTING">
  95   make webserver
  96 </pre>
  97           </td>
  98         </tr>
  99       </table>
 100
 101       <p>
 102         This will do the upload to <a href="https://www.privoxy.org/" target=
 103         "_top">the webserver</a> (www.privoxy.org) and ensure all files and
 104         directories there are group writable.
 105       </p>
 106       <p>
 107         Please do <span class="emphasis"><i class="EMPHASIS">NOT</i></span>
 108         use any other means of transferring files to the webserver to avoid
 109         permission problems. Also, please do not upload docs from development
 110         branches or versions. The publicly posted docs should be in sync with
 111         the last official release.
 112       </p>
 113     </div>
 114     <div class="NAVFOOTER">
 115       <hr align="LEFT" width="100%">
 116       <table summary="Footer navigation table" width="100%" border="0"
 117       cellpadding="0" cellspacing="0">
 118         <tr>
 119           <td width="33%" align="left" valign="top">
 120             <a href="newrelease.html" accesskey="P">Prev</a>
 121           </td>
 122           <td width="34%" align="center" valign="top">
 123             <a href="index.html" accesskey="H">Home</a>
 124           </td>
 125           <td width="33%" align="right" valign="top">
 126             &nbsp;
 127           </td>
 128         </tr>
 129         <tr>
 130           <td width="33%" align="left" valign="top">
 131             Releasing a New Version
 132           </td>
 133           <td width="34%" align="center" valign="top">
 134             &nbsp;
 135           </td>
 136           <td width="33%" align="right" valign="top">
 137             &nbsp;
 138           </td>
 139         </tr>
 140       </table>
 141     </div>
 142   </body>
 143 </html>
 144