Re: [DOCS] 9.0.3 pdf manual is missing bookmarks

From: Josh Kupershmidt <schmiddy(at)gmail(dot)com>
To: gabriele(dot)garuglieri(at)infoblu(dot)it
Cc: pgsql-docs(at)postgresql(dot)org, pgsql-www(at)postgresql(dot)org
Subject: Re: [DOCS] 9.0.3 pdf manual is missing bookmarks
Date: 2011-04-16 23:31:50
Message-ID: BANLkTi=3bmt0VgEg09v5Tz88kN-2NpnfDw@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs pgsql-www

[CC'ing the -www list, since this affects the PDFs provided by the
website. Ugh, and resending without attachments since it looks like
the last attempt didn't make it to the list.]

On Thu, Apr 7, 2011 at 2:15 AM,  <gabriele(dot)garuglieri(at)infoblu(dot)it> wrote:
> the 9.0.2 has them, but 9.0.3 pdf documentation is missing the bookmarks.
> When looking for something is a real pain having to always use find or
> switch back to TOC pages.
>
> Any chance that you can generate and republish a corrected doc?

Hi Gabriele,

Thanks for taking the time to report this, and sorry for the delay in
following up. Just to clarify what (I think) Gabriele is complaining
about, here [1] is a screenshot from the Okular viewer of the
9.0.3 -A4 or -US PDFs from the website [2]. You can see that the
"Contents" pane in the top left is greyed out [3].

When I built these PDFs from the 9.0.3 tarball myself, the results
looked better [4]. Assuming this fixes Gabriele's problem, could we
update the website with the fixed versions [5] of the 9.0.3 PDFs?

Also, I noticed that the page of PDFs is not consistent with the PDF
naming scheme wrt. minor version numbers. We provide e.g.
"postgresql-8.4.6-A4.pdf" and "postgresql-9.0-A4.pdf". Personally, I
like having the minor version number included, but could we just be
consistent either way?

Josh

--
Footnotes / links:
[1] see http://kupershmidt.org/pg/screenshot_9.0.3_missing.png
[2] http://www.postgresql.org/docs/manuals/
[3] The 8.2 A4 PDF appears to also be missing the Contents pane, or
"bookmarks", plus its index on page 1759 is missing entirely.
[4] see http://kupershmidt.org/pg/screenshot_9.0.3_fixed.png
[5] Fixed 9.0.3 PDFs:
 a.) http://kupershmidt.org/pg/postgres-9.0.3-A4_fixed.pdf
 b.) http://kupershmidt.org/pg/postgres-9.0.3-US_fixed.pdf

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Magnus Hagander 2011-04-17 06:57:17 Re: [DOCS] 9.0.3 pdf manual is missing bookmarks
Previous Message Josh Kupershmidt 2011-04-15 00:52:15 Re: CREATE EXTENSION: documenting prereqs

Browse pgsql-www by date

  From Date Subject
Next Message Magnus Hagander 2011-04-17 06:57:17 Re: [DOCS] 9.0.3 pdf manual is missing bookmarks
Previous Message Magnus Hagander 2011-04-13 20:56:07 Re: multiple repos per project on git.postgresql.org?