Error building DOCS

[london-coder]

Hi,

Thanks for all your effort in creating and updating Cowboy. I'm new to it, and the first thing I tried, (following the instructions in the README), was to try and build the docs, using make docs from the cowboy directory. What seems to be happening, is that the 'doc/src/guide/book.xml' seems to be auto generated. And, it is generated with the WRONG protocol for the docbookx.dtd [this is the output from make docs]
<<<
I/O error : Attempt to load network entity http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd
/Users/Alan/sandbox/cowboy/doc/src/guide/book.xml:2: warning: failed to load external entity "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
D DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"

There is no dtd using http:// However, there is a dtd using https://

I can change the URL manually in the book.xml, but, immediately running make docs, after making the change, ( and cofirming the change was saved, using head ..../book.xml ), I see the same error loading the dtd.

If you would be willing to change this, I would be very grateful. If you don't have time for this, please let me know where the book.xml is generated, and I will be happy to make that change and then submit the change (pull request) to the github repo?

Regards,
Alan

[essen]

It uses the old Asciidoc and its a2x to generate a PDF which likely is what's not working for you. You can have it installed locally, mine is installed by docbook-xml and is located at /usr/share/xml/docbook/xml-dtd-4.4/docbookx.dtd.

I have plans to avoid the dependency altogether but got distracted by QUIC.

Alternatively the documentation is available on https://ninenines.eu and I'm attaching the generated PDF of roughly current master.

guide.pdf

[london-coder]

Many thanks for the reply. I'll give that a try.

I think your ninenines web site documentation is very good. But, I like having a PDF for reading off-line.

Regards,