Re: problems in vacuumdb.1

esr(at)thyrsus(dot)com wrote:
> Problems with vacuumdb.1:
>
> 1. Broken command synopsis syntax. This may mean you're using a
> construction in the command synopsis other than the standard
> [ ] | { }, or it may mean you have running text in the command
> synopsis section (the latter is not technically an error, but it's
> impossible to translate into DocBook markup).

Look at the original DocBook source:

<cmdsynopsis>
<command>vacuumdb</command>
<arg rep="repeat"><replaceable>connection-option</replaceable></arg>
<group><arg>--full</arg><arg>-f</arg></group>
<group><arg>--verbose</arg><arg>-v</arg></group>
<group><arg>--analyze</arg><arg>-z</arg></group>
<arg>--table | -t <replaceable>table</replaceable>
<arg>( <replaceable class="parameter">column</replaceable>
[,...] )</arg>
</arg>
<arg><replaceable>dbname</replaceable></arg>
<sbr>
<command>vacuumdb</command>
<arg rep="repeat"><replaceable>connection-options</replaceable></arg>
<group><arg>--all</arg><arg>-a</arg></group>
<group><arg>--full</arg><arg>-f</arg></group>
<group><arg>--verbose</arg><arg>-v</arg></group>
<group><arg>--analyze</arg><arg>-z</arg></group>
</cmdsynopsis>

If you have a suggestion how to mark up the [, ...] then we would
welcome it, but I don't think your proposed patch will do it.

--
Peter Eisentraut
http://developer.postgresql.org/~petere/