Re: PG 13 release notes, first draft

On 2020/05/15 21:29, Bruce Momjian wrote:
> 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.

Yes, this works.

> See
> doc/src/sgml/README.links for details on xref links. Release notes
> updated.

Thanks!

> Odd I got no warning for this on 'make check'.

I'm not sure why, but btw I got the message when I compiled the document on Mac.

Regards,

--
Fujii Masao
Advanced Computing Technology Center
Research and Development Headquarters
NTT DATA CORPORATION