The FreeBSD Documentation Project: Is it just me or anyone is interested in reading the FAQ and Hand

Warren Block wblock at
Sat Oct 24 04:30:06 UTC 2015

On Fri, 23 Oct 2015, John via freebsd-questions wrote:

> I've been reading long articles, web pages on the Kindle for years and 
> have no problems converting most HTML pages to Kindle format. However, 
> I just learned the FAQ and Handbook are not plain simple [Single HTML] 
> files converting fine with default settings with Calibre to ebook, but 
> in 'XML DocBook' format (never heard of it before) which convert to an 
> ebook containing its main content in a table with Calibre conversion 
> (with default settings), which less so readable.

Sorry, having trouble following the question.  The documentation sources 
are in DocBook XML.  Several output file formats are generated from 
those sources, including split ("chunked") HTML, single HTML, PDF, and 
other formats.  The HTML documents have a link at the start to choose 
the single or split form.

> The reason I'm asking if it is only my interest, or, perhaps can be in 
> the interest of many is, if the latter, then it would be useful to 
> make information on how to get the documentation in Kindle or EPUB 
> format more clearly visible on the page - or, perhaps even offer 
> direct downloads - , as I guess more people are familiar with these - 
> and maybe even find them more useful - than 'XML DocBook.'

We should offer EPUB formats.  I do not have a device that uses them, 
but understood they could be created from PDFs.

More information about the freebsd-questions mailing list