Hi Adam, Adam wrote on Sun, Sep 27, 2015 at 12:04:56PM +0200:
> What I like about the https://www.freebsd.org/doc/handbook/ It is intentional that OpenBSD does not have a handbook like FreeBSD. OpenBSD is not supposed to be so complicated that you need to read a book to use it, or even to become a developer. One of our goals is that to use OpenBSD and fully profit from all features, you need no information but 1. the manual pages 2. the FAQ 3. and operating-system independent technical knowledge if that's required for your application (like, how does one run a public mailserver, or how does BGP work, or ...) > is that you can toggle between [ Split HTML / Single HTML ]. > The Single HTML you can download and read on your Kindle or > other e-reader device, offline, [...] > Would it be possible to offer http://www.openbsd.org/faq/ > as a single HTML as well? No. We are not investing additional work into the formatting of the FAQ at this time. Instead, i hope to convert the FAQ to mdoc(7) format in the future and include it into the base system. That has various advantages. You can already do the following now to get one single document containing all the manuals on your system: man -ak Nd~. > all.0 man -ak -Thtml Nd~. > all.html man -M/usr/share/man -ak -Tpdf Nd~. > base.pdf On my laptop, having a couple of ports installed, that's text format: 2M lines, 90MB HTML format: 2.5M lines, 105MB PDF format: 16k pages, 3.7GB (base only; it's a known problem that mandoc -Tpdf generates big files; but you can read it even with xpdf(1)) right now. Nobody else asked for this so far, so it isn't tested and there may well be room for improvement in detail. That doesn't include the FAQ yet, but it shouldn't be too difficult for you to cut out the <body> parts from those 15 files and append them to the HTML file you get from mandoc. Yours, Ingo
