rebuilt .html docs for privoxy version 3.0.26
[privoxy.git] / doc / webserver / developer-manual / cvs.html
index 3262477..e6bd8d3 100644 (file)
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
-Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+"http://www.w3.org/TR/html4/loose.dtd">
+
 <html>
-  <head>
-    <title>
-      The CVS Repository
-    </title>
-    <meta name="GENERATOR" content=
-    "Modular DocBook HTML Stylesheet Version 1.79">
-    <link rel="HOME" title="Privoxy Developer Manual" href="index.html">
-    <link rel="PREVIOUS" title="Introduction" href="introduction.html">
-    <link rel="NEXT" title="Documentation Guidelines" href=
-    "documentation.html">
-    <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
-    <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
-  </head>
-  <body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
-  "#840084" alink="#0000FF">
-    <div class="NAVHEADER">
-      <table summary="Header navigation table" width="100%" border="0"
-      cellpadding="0" cellspacing="0">
-        <tr>
-          <th colspan="3" align="center">
-            Privoxy Developer Manual
-          </th>
-        </tr>
-        <tr>
-          <td width="10%" align="left" valign="bottom">
-            <a href="introduction.html" accesskey="P">Prev</a>
-          </td>
-          <td width="80%" align="center" valign="bottom">
-          </td>
-          <td width="10%" align="right" valign="bottom">
-            <a href="documentation.html" accesskey="N">Next</a>
-          </td>
-        </tr>
-      </table>
-      <hr align="LEFT" width="100%">
+<head>
+  <title>The CVS Repository</title>
+  <meta name="GENERATOR" content=
+  "Modular DocBook HTML Stylesheet Version 1.79">
+  <link rel="HOME" title="Privoxy Developer Manual" href="index.html">
+  <link rel="PREVIOUS" title="Introduction" href="introduction.html">
+  <link rel="NEXT" title="Documentation Guidelines" href=
+  "documentation.html">
+  <link rel="STYLESHEET" type="text/css" href="../p_doc.css">
+  <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
+</head>
+
+<body class="SECT1" bgcolor="#EEEEEE" text="#000000" link="#0000FF" vlink=
+"#840084" alink="#0000FF">
+  <div class="NAVHEADER">
+    <table summary="Header navigation table" width="100%" border="0"
+    cellpadding="0" cellspacing="0">
+      <tr>
+        <th colspan="3" align="center">Privoxy Developer Manual</th>
+      </tr>
+
+      <tr>
+        <td width="10%" align="left" valign="bottom"><a href=
+        "introduction.html" accesskey="P">Prev</a></td>
+
+        <td width="80%" align="center" valign="bottom"></td>
+
+        <td width="10%" align="right" valign="bottom"><a href=
+        "documentation.html" accesskey="N">Next</a></td>
+      </tr>
+    </table>
+    <hr align="left" width="100%">
+  </div>
+
+  <div class="SECT1">
+    <h1 class="SECT1"><a name="CVS" id="CVS">2. The CVS Repository</a></h1>
+
+    <p>If you become part of the active development team, you will eventually
+    need write access to our holy grail, the CVS repository. One of the team
+    members will need to set this up for you. Please read this chapter
+    completely before accessing via CVS.</p>
+
+    <div class="SECT2">
+      <h2 class="SECT2"><a name="CVSACCESS" id="CVSACCESS">2.1. Access to
+      CVS</a></h2>
+
+      <p>The project's CVS repository is hosted on <a href=
+      "https://sourceforge.net/" target="_top">SourceForge.</a> For
+      historical reasons, the CVS server is called <tt class=
+      "LITERAL">ijbswa.cvs.sourceforge.net</tt>, the repository is called
+      <tt class="LITERAL">ijbswa</tt>, and the source tree module is called
+      <tt class="LITERAL">current</tt>.</p>
     </div>
-    <div class="SECT1">
-      <h1 class="SECT1">
-        <a name="CVS">2. The CVS Repository</a>
-      </h1>
-      <p>
-        If you become part of the active development team, you will
-        eventually need write access to our holy grail, the CVS repository.
-        One of the team members will need to set this up for you. Please read
-        this chapter completely before accessing via CVS.
-      </p>
-      <div class="SECT2">
-        <h2 class="SECT2">
-          <a name="CVSACCESS">2.1. Access to CVS</a>
-        </h2>
-        <p>
-          The project's CVS repository is hosted on <a href=
-          "https://sourceforge.net/" target="_top">SourceForge.</a> For
-          historical reasons, the CVS server is called <tt class=
-          "LITERAL">ijbswa.cvs.sourceforge.net</tt>, the repository is called
-          <tt class="LITERAL">ijbswa</tt>, and the source tree module is
-          called <tt class="LITERAL">current</tt>.
-        </p>
-      </div>
-      <div class="SECT2">
-        <h2 class="SECT2">
-          <a name="CVSBRANCHES">2.2. Branches</a>
-        </h2>
-        <p>
-          Within the CVS repository, there are modules and branches. As
-          mentioned, the sources are in the <tt class="LITERAL">current</tt>
-          <span class="QUOTE">"module"</span>. Other modules are present for
-          platform specific issues. There is a webview of the CVS hierarchy
-          at <a href="http://ijbswa.cvs.sourceforge.net/viewvc/ijbswa/"
-          target="_top">http://ijbswa.cvs.sourceforge.net/viewvc/ijbswa/</a>,
-          which might help with visualizing how these pieces fit together.
-        </p>
-        <p>
-          At one time there were two distinct branches: stable and unstable.
-          The more drastic changes were to be in the unstable branch. These
-          branches have now been merged to minimize time and effort of
-          maintaining two branches.
-        </p>
-      </div>
-      <div class="SECT2">
-        <h2 class="SECT2">
-          <a name="CVSCOMMIT">2.3. CVS Commit Guidelines</a>
-        </h2>
-        <p>
-          The source tree is the heart of every software project. Every
-          effort must be made to ensure that it is readable, compilable and
-          consistent at all times. We expect anyone with CVS access to
-          strictly adhere to the following guidelines:
-        </p>
-        <p>
-          Basic Guidelines, for all branches:
-        </p>
-        <p>
-        </p>
-        <ul>
-          <li>
-            <p>
-              Please don't commit even a small change without testing it
-              thoroughly first. When we're close to a public release, ask a
-              fellow developer to review your changes.
-            </p>
-          </li>
-          <li>
-            <p>
-              Your commit message should give a concise overview of <span
-              class="emphasis"><i class="EMPHASIS">what you
-              changed</i></span> (no big details) and <span class=
-              "emphasis"><i class="EMPHASIS">why you changed it</i></span>
-              Just check previous messages for good examples.
-            </p>
-          </li>
-          <li>
-            <p>
-              Don't use the same message on multiple files, unless it equally
-              applies to all those files.
-            </p>
-          </li>
-          <li>
-            <p>
-              If your changes span multiple files, and the code won't
-              recompile unless all changes are committed (e.g. when changing
-              the signature of a function), then commit all files one after
-              another, without long delays in between. If necessary, prepare
-              the commit messages in advance.
-            </p>
-          </li>
-          <li>
-            <p>
-              Before changing things on CVS, make sure that your changes are
-              in line with the team's general consensus on what should be
-              done.
-            </p>
-          </li>
-          <li>
-            <p>
-              Note that near a major public release, we get more cautious.
-              There is always the possibility to submit a patch to the <a
-              href=
-              "https://sourceforge.net/tracker/?atid=311118&amp;group_id=11118&amp;func=browse"
-               target="_top">patch tracker</a> instead.
-            </p>
-          </li>
-        </ul>
-      </div>
+
+    <div class="SECT2">
+      <h2 class="SECT2"><a name="CVSBRANCHES" id="CVSBRANCHES">2.2.
+      Branches</a></h2>
+
+      <p>Within the CVS repository, there are modules and branches. As
+      mentioned, the sources are in the <tt class="LITERAL">current</tt>
+      <span class="QUOTE">"module"</span>. Other modules are present for
+      platform specific issues. There is a webview of the CVS hierarchy at
+      <a href="http://ijbswa.cvs.sourceforge.net/viewvc/ijbswa/" target=
+      "_top">http://ijbswa.cvs.sourceforge.net/viewvc/ijbswa/</a>, which
+      might help with visualizing how these pieces fit together.</p>
+
+      <p>At one time there were two distinct branches: stable and unstable.
+      The more drastic changes were to be in the unstable branch. These
+      branches have now been merged to minimize time and effort of
+      maintaining two branches.</p>
     </div>
-    <div class="NAVFOOTER">
-      <hr align="LEFT" width="100%">
-      <table summary="Footer navigation table" width="100%" border="0"
-      cellpadding="0" cellspacing="0">
-        <tr>
-          <td width="33%" align="left" valign="top">
-            <a href="introduction.html" accesskey="P">Prev</a>
-          </td>
-          <td width="34%" align="center" valign="top">
-            <a href="index.html" accesskey="H">Home</a>
-          </td>
-          <td width="33%" align="right" valign="top">
-            <a href="documentation.html" accesskey="N">Next</a>
-          </td>
-        </tr>
-        <tr>
-          <td width="33%" align="left" valign="top">
-            Introduction
-          </td>
-          <td width="34%" align="center" valign="top">
-            &nbsp;
-          </td>
-          <td width="33%" align="right" valign="top">
-            Documentation Guidelines
-          </td>
-        </tr>
-      </table>
+
+    <div class="SECT2">
+      <h2 class="SECT2"><a name="CVSCOMMIT" id="CVSCOMMIT">2.3. CVS Commit
+      Guidelines</a></h2>
+
+      <p>The source tree is the heart of every software project. Every effort
+      must be made to ensure that it is readable, compilable and consistent
+      at all times. We expect anyone with CVS access to strictly adhere to
+      the following guidelines:</p>
+
+      <p>Basic Guidelines, for all branches:</p>
+
+      <ul>
+        <li>
+          <p>Please don't commit even a small change without testing it
+          thoroughly first. When we're close to a public release, ask a
+          fellow developer to review your changes.</p>
+        </li>
+
+        <li>
+          <p>Your commit message should give a concise overview of
+          <span class="emphasis"><i class="EMPHASIS">what you
+          changed</i></span> (no big details) and <span class=
+          "emphasis"><i class="EMPHASIS">why you changed it</i></span> Just
+          check previous messages for good examples.</p>
+        </li>
+
+        <li>
+          <p>Don't use the same message on multiple files, unless it equally
+          applies to all those files.</p>
+        </li>
+
+        <li>
+          <p>If your changes span multiple files, and the code won't
+          recompile unless all changes are committed (e.g. when changing the
+          signature of a function), then commit all files one after another,
+          without long delays in between. If necessary, prepare the commit
+          messages in advance.</p>
+        </li>
+
+        <li>
+          <p>Before changing things on CVS, make sure that your changes are
+          in line with the team's general consensus on what should be
+          done.</p>
+        </li>
+
+        <li>
+          <p>Note that near a major public release, we get more cautious.
+          There is always the possibility to submit a patch to the <a href=
+          "https://sourceforge.net/tracker/?atid=311118&amp;group_id=11118&amp;func=browse"
+          target="_top">patch tracker</a> instead.</p>
+        </li>
+      </ul>
     </div>
-  </body>
-</html>
+  </div>
 
+  <div class="NAVFOOTER">
+    <hr align="left" width="100%">
+
+    <table summary="Footer navigation table" width="100%" border="0"
+    cellpadding="0" cellspacing="0">
+      <tr>
+        <td width="33%" align="left" valign="top"><a href="introduction.html"
+        accesskey="P">Prev</a></td>
+
+        <td width="34%" align="center" valign="top"><a href="index.html"
+        accesskey="H">Home</a></td>
+
+        <td width="33%" align="right" valign="top"><a href=
+        "documentation.html" accesskey="N">Next</a></td>
+      </tr>
+
+      <tr>
+        <td width="33%" align="left" valign="top">Introduction</td>
+
+        <td width="34%" align="center" valign="top">&nbsp;</td>
+
+        <td width="33%" align="right" valign="top">Documentation
+        Guidelines</td>
+      </tr>
+    </table>
+  </div>
+</body>
+</html>