Re: Documentation epub format

From: Greg Stark <stark(at)mit(dot)edu>
To: Fabien COELHO <coelho(at)cri(dot)ensmp(dot)fr>
Cc: PostgreSQL Developers <pgsql-hackers(at)postgresql(dot)org>
Subject: Re: Documentation epub format
Date: 2013-05-02 00:49:03
Message-ID: CAM-w4HN+Ao5J24uvQ+YzF13q6yXv=qPiitHZBu2h4sOLHD_bnw@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-hackers

On Wed, May 1, 2013 at 5:27 PM, Fabien COELHO <coelho(at)cri(dot)ensmp(dot)fr> wrote:
> I must admit that there is a bit of a disappointement as far as the user
> experience is concerned: the generated file is barely usable on an iPad2
> with the default iBooks reader, which was clearly not designed for handling
> a "4592" pages book (from its point of view).

Surely that just means you need a better reader?

Fwiw I routinely use PDFs of Oracle docs that are about that size.
They're *way* more useful than the html docs that are broken up into a
lot of smaller files. Being able to search and jump around in them is
extremely handy. This would have been unwieldy in older generations of
PDF readers but newer ones don't actually load the whole file into
memory and can read and uncompress just the sections they need.
Sometimes (though I can never predict when) even over the web.

I also find it hard to believe the Postgres docs are really that big.
Surely a big chunk of it is just some reference material like tables
of data or something? The other section of the docs that can
reasonably be broken out imho is the man pages. But the rest really
belong in a single document.

--
greg

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Peter Eisentraut 2013-05-02 03:23:45 Re: Documentation epub format
Previous Message Josh Berkus 2013-05-01 19:28:19 Re: Documentation epub format

Browse pgsql-hackers by date

  From Date Subject
Next Message Mark Kirkwood 2013-05-02 00:49:17 Re: In progress INSERT wrecks plans on table
Previous Message Josh Berkus 2013-05-02 00:44:00 Re: Proposal to add --single-row to psql