[Privoxy-devel] Documentation problems (was: privoxy debian patches)

[Fabian Keil]

Lee <ler762 at gmail.com> wrote:

> On 10/16/18, Roland Rosenfeld <roland at spinnaker.de> wrote:

> > - Replace 06_8bit_manual.patch by a new patch, that only changes
> >   preserve-sdata to #t in the HTML section.
> > - Append --preserve-entities yes to TIDY options in GNUmakefile.in.
> > - Change all ISO-8859-1 chars in doc/source/p-authors.sgml to SGML
> >   entities  
> 
> I can make all those changes in git

Documentation building is now somewhat differently broken on my system.

Links contain plain &'s instead of entities:

diff --git a/doc/webserver/developer-manual/git.html b/doc/webserver/developer-manual/git.html
index 9efdbdcf..8ce1276c 100644
--- a/doc/webserver/developer-manual/git.html
+++ b/doc/webserver/developer-manual/git.html
@@ -78,8 +78,8 @@
         </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&group_id=11118&func=browse"
-          target="_top">patch tracker</a> instead.</p>
+          patch to the <a href="https://sourceforge.net/tracker/?atid=311118&group_id=11118&func=browse" target=
+          "_top">patch tracker</a> instead.</p>
         </li>
       </ul>
     </div>

I can fix that by changing TIDY to use "--preserve-entities no"
again but this brings back the offending copyright symbol.

Additionally pre tags use incorrect spacing:

diff --git a/doc/webserver/developer-manual/newrelease.html b/doc/webserver/developer-manual/newrelease.html
index c75226e1..265edc7e 100644
--- a/doc/webserver/developer-manual/newrelease.html
+++ b/doc/webserver/developer-manual/newrelease.html
@@ -160,8 +160,8 @@ for-privoxy-version=3.0.11</pre>
           <table border="0" bgcolor="#E0E0E0" width="90%">
             <tr>
               <td>
-                <pre class=
-                "PROGRAMLISTING">  $ utils/changelog2doc.pl /tmp/change.log >| doc/source/changelog.sgml</pre>
+                <pre class="PROGRAMLISTING">
+                $ utils/changelog2doc.pl /tmp/change.log >| doc/source/changelog.sgml</pre>
               </td>
             </tr>
           </table>

The latter is actual an old problem but I'm surprised
that it doesn't seem to happen when you build the docs.

Fabian
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 833 bytes
Desc: OpenPGP digital signature
URL: <https://lists.privoxy.org/pipermail/privoxy-devel/attachments/20181029/c3090569/attachment.bin>