Re: PG 13 release notes, first draft

On Fri, May 15, 2020 at 03:55:19PM +0900, Fujii Masao wrote:
>
>
> On 2020/05/05 12:16, Bruce Momjian wrote:
> > I have committed the first draft of the PG 13 release notes. You can
> > see them here:
> >
> > https://momjian.us/pgsql_docs/release-13.html
> >
> > It still needs markup, word wrap, and indenting. The community doc
> > build should happen in a few hours.
>
> Many thanks for working on this!
>
> When I did "make html", I got the following message.
>
> Link element has no content and no Endterm. Nothing to show in the link to sepgsql
>
> "Allow <link linkend="sepgsql"/> to control access to the" in release-13.sgml
> seems to have caused this. Also I found it's converted into "Allow ??? to
> control access to the", i.e., ??? was used.
>
> - Allow <link linkend="sepgsql"/> to control access to the
> + Allow <link linkend="sepgsql">sepgsql</link> to control access to the
>
> Shouldn't we change that as the above?

Actually, it should be:

<xref linkend="sepgsql"/>

because we are using the text from the link. See
doc/src/sgml/README.links for details on xref links. Release notes
updated. Odd I got no warning for this on 'make check'.

--
Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
EnterpriseDB https://enterprisedb.com

+ As you are, so once was I. As I am, so you will be. +
+ Ancient Roman grave inscription +