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

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