remove leading spaces from <screen> and <programlisting> blocks
[privoxy.git] / doc / source / developer-manual.sgml
index 2936a55..966ec0b 100644 (file)
@@ -2057,7 +2057,7 @@ fk@t520 ~ $privoxy-regression-test.pl --test-number 785 --verbose --debug 4
 2020-12-14 12:17:56: Ooops. Expected removal but: 'Referer: https://p.p/' is still there.
 2020-12-14 12:17:56: Failure for test 785 (0/13/5). Header 'Referer: https://p.p/' and tag 'hide-referrer{conditional-block}'
 2020-12-14 12:17:56: Executed 1 regression tests. Skipped 1201. 0 successes, 1 failures.
-     </programlisting>
+</programlisting>
      <para>
       Use the if the <command>--privoxy-address</command> option if the
       http_proxy environment variable isn't configured and you don't want
@@ -2294,12 +2294,12 @@ for-privoxy-version=3.0.11
         Create the change log:
        </para>
        <programlisting>
-  $ git tag
-  #   to see the tags
-  $ git log [last release tag]..master &gt; /tmp/log
-  #   get the commit log since the last release
-  $ utils/makeChangeLog /tmp/log &gt; /tmp/change.log
-  #   reformat the commit log
+$ git tag
+#   to see the tags
+$ git log [last release tag]..master &gt; /tmp/log
+#   get the commit log since the last release
+$ utils/makeChangeLog /tmp/log &gt; /tmp/change.log
+#   reformat the commit log
 </programlisting>
        <para>
         Edit <filename>/tmp/change.log</filename> to remove trivial
@@ -2322,7 +2322,7 @@ for-privoxy-version=3.0.11
         <filename>doc/source/changelog.sgml</filename>:
        </para>
        <programlisting>
-  $ utils/changelog2doc.pl /tmp/change.log &gt;| doc/source/changelog.sgml
+$ utils/changelog2doc.pl /tmp/change.log &gt;| doc/source/changelog.sgml
 </programlisting>
       </listitem>
       <listitem>
@@ -2340,11 +2340,11 @@ for-privoxy-version=3.0.11
        <para>
         All documentation should be rebuilt:
        <programlisting>
-  $ make man
-  $ make dok
-  $ make dok-man
-  $ make dok-tidy
-  $ make config-file
+$ make man
+$ make dok
+$ make dok-man
+$ make dok-tidy
+$ make config-file
 </programlisting>
         Finished docs should be then be committed to Git (for those
         without the ability to build these). Some docs may require
@@ -2417,11 +2417,11 @@ for-privoxy-version=3.0.11
      </para>
 
       <programlisting>
-  mkdir dist # delete or choose different name if it already exists
-  cd dist
-  git clone https://www.privoxy.org/git/privoxy.git
-  cd privoxy
-  git checkout v_X_Y_Z
+mkdir dist # delete or choose different name if it already exists
+cd dist
+git clone https://www.privoxy.org/git/privoxy.git
+cd privoxy
+git checkout v_X_Y_Z
 </programlisting>
 
     <para>
@@ -2571,13 +2571,13 @@ for-privoxy-version=3.0.11
         packages" above). Then run from that directory:
       </para>
         <programlisting>
-  autoheader && autoconf && ./configure
+autoheader && autoconf && ./configure
 </programlisting>
       <para>
         Then do:
       </para>
         <programlisting>
-  make tarball-dist
+make tarball-dist
 </programlisting>
     </sect3>
 
@@ -2605,8 +2605,8 @@ for-privoxy-version=3.0.11
         All you need to do is:
       </para>
       <programlisting>
-  cd windows
-  make
+cd windows
+make
 </programlisting>
       <para>
         Now you can manually rename <filename>privoxy_setup.exe</filename> to
@@ -2616,8 +2616,8 @@ for-privoxy-version=3.0.11
         GPG sign the installer and zip file,
       </para>
       <programlisting>
-  $ gpg --armor --detach --sign <filename>privoxy_setup_X.Y.Z.exe</filename>
-  $ gpg --armor --detach --sign <filename>privoxy_X.Y.Z.zip</filename>
+gpg --armor --detach --sign <filename>privoxy_setup_X.Y.Z.exe</filename>
+gpg --armor --detach --sign <filename>privoxy_X.Y.Z.zip</filename>
 </programlisting>
       <para>
         and upload the files to SourceForge.
@@ -2634,62 +2634,62 @@ for-privoxy-version=3.0.11
        Using git-buildpackage we start with a clone of the last Debian version:
       </para>
       <programlisting>
-  gbp clone https://salsa.debian.org/debian/privoxy.git
-  cd privoxy
+gbp clone https://salsa.debian.org/debian/privoxy.git
+cd privoxy
 </programlisting>
       <para>
        or if the repository is already there
       </para>
       <programlisting>
-  cd privoxy
-  gbp pull
+cd privoxy
+gbp pull
 </programlisting>
       <para>
        Now import the newly released upstream tarball via debian/watch file:
       </para>
       <programlisting>
-  gbp import-orig --uscan
+gbp import-orig --uscan
 </programlisting>
       <para>
        Next update all Debian quilt patches to the new version:
       </para>
       <programlisting>
-  while quilt push; do quilt refresh; done
+while quilt push; do quilt refresh; done
 </programlisting>
       <para>
        If some patch is no longer required (because it is already merged
        upstream), it can be removed using
       </para>
       <programlisting>
-  quilt delete XX_patchname.patch
-  git rm debian/patches/XX_patchname.patch
+quilt delete XX_patchname.patch
+git rm debian/patches/XX_patchname.patch
 </programlisting>
       <para>
        If the patch needs modification, you can apply, edit and update it with
       </para>
       <programlisting>
-  quilt push -f
-  quilt edit some_file
-  quilt refresh
+quilt push -f
+quilt edit some_file
+quilt refresh
 </programlisting>
       <para>
        until
       </para>
       <programlisting>
-  while quilt push; do quilt refresh; done
+while quilt push; do quilt refresh; done
 </programlisting>
       <para>
        succeeds. Then you can
       </para>
       <programlisting>
-  quilt pop -a
+quilt pop -a
 </programlisting>
       <para>
        Now add a new entry to the debian/changelog representing the new
        version:
       </para>
       <programlisting>
-  dch -v &p-version;-1
+dch -v &p-version;-1
 </programlisting>
       <para>
        and describe what you did before and don't forget to git commit all
@@ -2699,26 +2699,26 @@ for-privoxy-version=3.0.11
        Now you can build the package on the local machine using
       </para>
       <programlisting>
-  gbp buildpackage -us -uc
+gbp buildpackage -us -uc
 </programlisting>
       <para>
        You should check for warnings using
       </para>
       <programlisting>
-  lintian -iI ../build-area/privoxy_&p-version;-1_amd64.changes
+lintian -iI ../build-area/privoxy_&p-version;-1_amd64.changes
 </programlisting>
       <para>
        Maybe rebuild the package in different defined cowbuilder environments
        like
       </para>
       <programlisting>
-  sudo cowbuilder --build --basepath /var/cache/pbuilder/base.cow ../build-area/privoxy_&p-version;-1.dsc
+sudo cowbuilder --build --basepath /var/cache/pbuilder/base.cow ../build-area/privoxy_&p-version;-1.dsc
 </programlisting>
       <para>
        And try to run autopackage testing suite on the result:
       </para>
       <programlisting>
-  autopkgtest /var/cache/pbuilder/result/privoxy_&p-version;-1_amd64.changes -s -- schroot sid
+autopkgtest /var/cache/pbuilder/result/privoxy_&p-version;-1_amd64.changes -s -- schroot sid
 </programlisting>
       <para>
        Or just push the changes to salsa.debian.org, where a CI pipeline is
@@ -2731,8 +2731,8 @@ for-privoxy-version=3.0.11
        Then sign both files:
       </para>
       <programlisting>
-  gpg --detach-sign --armor privoxy_&p-version;-1_i386.deb
-  gpg --detach-sign --armor privoxy_&p-version;-1_amd64.deb
+gpg --detach-sign --armor privoxy_&p-version;-1_i386.deb
+gpg --detach-sign --armor privoxy_&p-version;-1_amd64.deb
 </programlisting>
       <para>
        Create a README file containing the recent block from debian/changelog
@@ -2748,34 +2748,34 @@ for-privoxy-version=3.0.11
        run the following commands:
       </para>
       <programlisting>
-  sudo apt install build-essential devscripts
-  sudo apt-get build-dep privoxy
+sudo apt install build-essential devscripts
+sudo apt-get build-dep privoxy
 </programlisting>
       <para>
        After this enter the checked out privoxy git tree and check that all
        (new) build dependencies are met:
       </para>
       <programlisting>
-  dpkg-checkbuilddeps
+dpkg-checkbuilddeps
 </programlisting>
       <para>
        If something is missing, just add it using
       </para>
       <programlisting>
-  sudo apt install foobar
+sudo apt install foobar
 </programlisting>
       <para>
        Now you may update debian/changelog, especially the version number
        using
       </para>
       <programlisting>
-  dch
+dch
 </programlisting>
       <para>
        and finally build the package:
       </para>
       <programlisting>
-  debuild -us -uc -b
+debuild -us -uc -b
 </programlisting>
       <para>
        If everything went okay, you may find the resulting Debian package in
@@ -2785,15 +2785,15 @@ for-privoxy-version=3.0.11
        You may want to clean up the build tree using
       </para>
       <programlisting>
-  debian/rules clean
+debian/rules clean
 </programlisting>
       <para>
        And maybe repair some artefacts using one or both of the following
        commands:
       </para>
       <programlisting>
-  git reset --hard
-  git clean -fd
+git reset --hard
+git clean -fd
 </programlisting>
     </sect4>
     </sect3>
@@ -2817,7 +2817,7 @@ for-privoxy-version=3.0.11
           follows into a folder parallel to the exported privoxy source:
         </para>
           <programlisting>
-  cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co OSXPackageBuilder
+cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co OSXPackageBuilder
 </programlisting>
         <para>
           The module contains complete instructions on its usage in the file
@@ -2844,14 +2844,14 @@ for-privoxy-version=3.0.11
           exported privoxy source:
         </para>
           <programlisting>
-  cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co osxsetup
+cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co osxsetup
 </programlisting>
         <para>
           Then run:
         </para>
           <programlisting>
-  cd osxsetup
-  build
+cd osxsetup
+build
 </programlisting>
         <para>
           This will run <filename>autoheader</filename>, <filename>autoconf</filename>
@@ -2866,7 +2866,7 @@ for-privoxy-version=3.0.11
         name, you can then create the distributable zip file with the command:
         </para>
           <programlisting>
-  zip -r privoxyosx_setup_x.y.z.zip Privoxy.pkg
+zip -r privoxyosx_setup_x.y.z.zip Privoxy.pkg
 </programlisting>
         <para>
           You can then upload this file directly to the Files section of the
@@ -2888,7 +2888,7 @@ for-privoxy-version=3.0.11
           exported privoxy source:
         </para>
           <programlisting>
-  cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co macsetup
+cvs -z3 -d:pserver:anonymous@ijbswa.cvs.sourceforge.net:/cvsroot/ijbswa co macsetup
 </programlisting>
         <para>
           The module contains complete instructions on its usage in its
@@ -2993,7 +2993,7 @@ for-privoxy-version=3.0.11
     SGML files, do:
    </para>
     <programlisting>
-  make dok
+make dok && make dok-tidy
 </programlisting>
    <para>
     That will generate <filename>doc/webserver/user-manual</filename>,
@@ -3018,7 +3018,7 @@ for-privoxy-version=3.0.11
     If these are docs in the stable branch, then do:
    </para>
     <programlisting>
-  make webserver
+make webserver
 </programlisting>
    <para>
     This will do the upload to the SourceForge webserver (which is manually