Re: Change pg_attribute textual link to an actual link

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Daniel Gustafsson <daniel(at)yesql(dot)se>
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Change pg_attribute textual link to an actual link
Date: 2018-10-21 23:27:21
Message-ID: 80062.1540164441@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Daniel Gustafsson <daniel(at)yesql(dot)se> writes:
> In the System catalog/pg_attrdef documentation, there is a reference to
> pg_attribute with the text "see below". That makes sense in the PDF version
> (and similar renderings), but in the web version it seems a bit odd as
> pg_attribute is on the next page, not below.

> The attached patch changes it to an actual link instead, but simply removing
> the "see below" bit is another approach which isn't out of line with other
> parts of the documentation (I opted for link since I personally prefer that).

I agree with your change, but I wonder if the sentence after this one
doesn't need some work too. It seems to predate ALTER COLUMN SET DEFAULT.
We could add a mention of that, or just stop trying to describe the
preconditions, and say something like "only columns for which a default
value has been explicitly set will have an entry here".

regards, tom lane

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Oleg Bartunov 2018-10-22 05:57:46 Re: remove deprecated @@@ operator ?
Previous Message Alexander Korotkov 2018-10-21 21:33:42 Re: bloom documentation patch