[Privoxy-devel] Documentation problems

[Lee]

On 10/30/18, Fabian Keil <fk at fabiankeil.de> wrote:
> Lee <ler762 at gmail.com> wrote:
>
>> On 10/30/18, Fabian Keil <fk at fabiankeil.de> wrote:
>> > Lee <ler762 at gmail.com> wrote:
>> >
>> >> 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:
>
>> >> >> > 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
>> >
>> > I have:
>> >    133	W3M_DUMP   = w3m -I ISO-8859 -O ASCII -dump
>> >    134	W3M_DUMP_UTF8 = w3m -I ISO-8859 -O UTF-8 -dump
>> >    135	# docbook output is ISO-8859 (which is a superset of ascii)
>> >    136	JADECAT    =  -c /usr/local/share/sgml/docbook/2.4.1/docbook.cat
>> > -c
>> > /usr/local/share/sgml/docbook/3.0/docbook.cat -c
>> > /usr/local/share/sgml/docbook/3.1/docbook.cat
>>
>> That's .. interesting.  Can you still build the docs if you cut
>> JADECAT down to just
>>   -c /usr/local/share/sgml/docbook/3.1/docbook.cat
>
> No.

*sigh*  I never figured out how docbook pulls all the bits & pieces
together, so it'll probably take me a while :(

In the mean time, do you have an /etc/sgml on your system?
$ ls /etc/sgml
catalog           sgml-docbook-3.0.cat  sgml-docbook-4.1.cat
sgml-docbook-4.4.cat   xml-docbook-4.2.cat  xml-docbook-4.5.cat
sgml.conf         sgml-docbook-3.1.cat  sgml-docbook-4.2.cat
sgml-docbook-4.5.cat   xml-docbook-4.3.cat
sgml-docbook.cat  sgml-docbook-4.0.cat  sgml-docbook-4.3.cat
xml-docbook-4.1.2.cat  xml-docbook-4.4.cat

and the results of
  find / -name iso-amsa\.\*
(or find /etc ...  and find /usr ...  if find /  takes too long)
might help.

Lee

>
> fk at t520 ~/git/privoxy.git $gmake dok
> Setting doc version and status to 3.0.27, UNRELEASED
> rm -f -r doc/source/*bak doc/source/*/*bak
> Setting docs to not stable 3.0.27
> rm -f -r doc/source/*bak doc/source/*/*bak;
> rm -f doc/webserver/developer-manual/*.html
> rm -f -r doc/source/developer-manual
> mkdir -p doc/source/developer-manual
> cd doc/source/developer-manual && jade -c
> /usr/local/share/sgml/docbook/3.1/docbook.cat -ihtml -t sgml  -D.. -d
> ldp.dsl#html ../developer-manual.sgml && cd .. && cp developer-manual/*.html
> ../webserver/developer-manual/
> jade:/usr/local/share/sgml/docbook/3.1/dbcent.mod:54:0:E: cannot find
> "iso-amsa.gml"; tried "/usr/local/share/sgml/docbook/3.1/iso-amsa.gml",
> "../iso-amsa.gml"
> jade:/usr/local/share/sgml/docbook/3.1/dbcent.mod:61:0:E: cannot find
> "iso-amsb.gml"; tried "/usr/local/share/sgml/docbook/3.1/iso-amsb.gml",
> "../iso-amsb.gml"
   .. snip ..