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