Another small patch...

Guillaume Lelarge wrote:

... this time, for maintenance.sgml.

Applied, thanks. I'm wondering whether this should be

<para>
! <productname>PostgreSQL</productname>'s
! <xref linkend="sql-vacuum" endterm="sql-vacuum-title"> command has to run on
! a regular basis for several reasons:

instead. I didn't try to compile it so maybe the output is not OK.

--
Alvaro Herrera http://www.PlanetPostgreSQL.org/
"The only difference is that Saddam would kill you on private, where the
Americans will kill you in public" (Mohammad Saleh, 39, a building contractor)

Alvaro Herrera wrote:

Guillaume Lelarge wrote:

... this time, for maintenance.sgml.

Applied, thanks. I'm wondering whether this should be

<para>
! <productname>PostgreSQL</productname>'s
! <xref linkend="sql-vacuum" endterm="sql-vacuum-title"> command has to run on
! a regular basis for several reasons:

instead. I didn't try to compile it so maybe the output is not OK.

OK, I need opinions on this issue. We currently have output that looks
like

"PostgreSQL's Vacuum (/Section 10.4.2/) command has to run ..."
(the part between // is a clickable link)

but with the patch above, it would show up as
"PostgreSQL's /Vacuum/ command has to run ..."

Is there a preferred way to link? I notice there is plenty of usage of
both forms.

I wonder what does printed output look like? Does it just just lose the
reference?

--
Alvaro Herrera Developer, http://www.PostgreSQL.org/
Al principio era UNIX, y UNIX habl� y dijo: "Hello world\n".
No dijo "Hello New Jersey\n", ni "Hello USA\n".

Alvaro Herrera <alvherre@commandprompt.com> writes:

OK, I need opinions on this issue. We currently have output that looks
like

"PostgreSQL's Vacuum (/Section 10.4.2/) command has to run ..."
(the part between // is a clickable link)

but with the patch above, it would show up as
"PostgreSQL's /Vacuum/ command has to run ..."

Is there a preferred way to link?

I'd vote for the latter, at least in cases like this. I think here
you're just providing a courtesy link that you don't expect people
to follow all that often, and so minimizing its visual impact is
a good thing.

regards, tom lane