Re: minor doc improvements

From: Peter Eisentraut <peter_e(at)gmx(dot)net>
To: Neil Conway <neilc(at)samurai(dot)com>, pgsql-patches(at)postgresql(dot)org
Subject: Re: minor doc improvements
Date: 2004-03-04 02:14:23
Message-ID: 200403040314.23753.peter_e@gmx.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-patches

Neil Conway wrote:
> I've applied the attached patch to HEAD. It does the following:
>
> Add a few more cross-references where appropriate, add more text
> about the FROM clause and an example to the UPDATE reference page,
> and make a few other SGML tweaks.
>
> Suggestions for further improvement (for example, to the UPDATE ref
> page) are welcome.

ISTM that the linking changes you propose are stretching the semantics
of DocBook. If you want to link, why not just use <link>. By using
<xref> plus endterm you're doing the same thing indirectly and you rely
on the remote endterm having a sensible grammatical structure that fits
into the local sentence.

In response to

Responses

Browse pgsql-patches by date

  From Date Subject
Next Message Neil Conway 2004-03-04 02:32:12 Re: minor doc improvements
Previous Message Neil Conway 2004-03-04 02:12:28 tighten input to float4/float8/oid