On Thu, Jun 24, 2010 at 2:32 PM, Roger Binns <rog...@rogerbinns.com> wrote: > -----BEGIN PGP SIGNED MESSAGE----- > Hash: SHA1 > > On 06/24/2010 06:08 AM, Peng Yu wrote: >> It is very common that software provide >> document in many different format. For example, python, GNU make. > > Not really the case. The software that provides documentation in PDF has > usually done so because the help is authored in Latex or a very similar > format. The GNU standard for documentation (info) was Latex compatible > which is why you'll find most GNU tools do have PDF documentation. > > For Python, documentation is authored using Sphinx (and was historically > something similar to Latex). Sphinx has a way of generating Latex output > which can then be processed into PDF although it is enough of a pain that > most Sphinx projects do not both with PDF. > > The documentation for SQLite is not authored in a Latex compatible format > and so isn't trivial to turn into PDF. You are of course welcome to provide > a tool that does the conversion. > > Instead it targets HTML output like pretty much everyone else out there. > You are going to have to get used to this new reality. If you like PDF > because it gives you a single self contained file that is searchable and > usable offline then I suggest looking into the CHM format. > > Note you can download the HTML docs for local offline access. You can > create a CHM file by creating a small project file and compiling it. There > is a CHM compiler for Windows, and you can also do so under Linux (google > HHW4Wine). > > If you want the PDF for printing then that is a really bad idea as the > documentation is not authored or intended for dead tree - eg it doesn't have > physical pages, and isn't intended to be read with a beginning, middle and > end. In HTML format it works with any screen size, big or small. Use your > HTML viewer tools to print it as you see fit.
I'm using pdf because I can comment and bookmark it to facilitate my reading process. I'm open to any other options. But it seems that there is no way to comment on chm (Let me know if I'm wrong). Then probably the solution is to convert html into pdf. -- Regards, Peng _______________________________________________ sqlite-users mailing list sqlite-users@sqlite.org http://sqlite.org:8080/cgi-bin/mailman/listinfo/sqlite-users
