[Privoxy-devel] Documentation problems

[Lee]

On 10/30/18, Fabian Keil <fk at fabiankeil.de> wrote:
> Lee <ler762 at gmail.com> wrote:
>
>> On 10/29/18, Fabian Keil <fk at fabiankeil.de> wrote:
>> > 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>
>> >
>>
>> Can you try doing a 'make clean && make distclean' before rebuilding
>> the docs -- without 'make dok-tidy' ?
>
> Doesn't help:

It was worth a shot.
Staying with simple.. snippet from GNUmakefile showing how docbook
stuff is built:
W3M_DUMP   = w3m -I ISO-8859 -O ASCII -dump
W3M_DUMP_UTF8 = w3m -I ISO-8859 -O UTF-8 -dump
# docbook output is ISO-8859 (which is a superset of ascii)
JADECAT    =
JADEBIN    = jade
  -- my debian system has openjade
DB         = $(JADEBIN) $(JADECAT) -ihtml -t sgml  -D.. -d ldp.dsl\#html
DB_TXT     = $(JADEBIN) $(JADECAT) -ihtml -t sgml  -D.. -d ldp.dsl\#print

$ which jade
/usr/bin/jade
$ ls -l /usr/bin/jade
lrwxrwxrwx 1 root None 12 May 31  2017 /usr/bin/jade -> openjade.exe
$ which openjade
/usr/bin/openjade

$ openjade --version
openjade:I: "OpenJade" version "1.4devel"
openjade:I: "OpenSP" version "1.5.2"

yours?  And are you still on FreeBSD or have you switched to something else?

Lee