X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org
Received: from localhost (unknown [200.46.204.144])
	by svr1.postgresql.org (Postfix) with ESMTP id DD6D23A3C44
	for <pgsql-docs-postgresql.org@localhost.postgresql.org>;
	Tue, 23 Nov 2004 07:28:35 +0000 (GMT)
Received: from svr1.postgresql.org ([200.46.204.71])
	by localhost (av.hub.org [200.46.204.144]) (amavisd-new, port 10024)
	with ESMTP id 42806-01
	for <pgsql-docs-postgresql.org@localhost.postgresql.org>;
	Tue, 23 Nov 2004 07:28:12 +0000 (GMT)
Received: from mail.gmx.net (pop.gmx.de [213.165.64.20])
	by svr1.postgresql.org (Postfix) with SMTP id 398633A3C9A
	for <pgsql-docs@postgresql.org>; Tue, 23 Nov 2004 07:28:11 +0000 (GMT)
Received: (qmail 9528 invoked by uid 65534); 23 Nov 2004 07:28:09 -0000
Received: from dsl-082-082-229-077.arcor-ip.net (EHLO localhost)
 (82.82.229.77)
	by mail.gmx.net (mp016) with SMTP; 23 Nov 2004 08:28:09 +0100
X-Authenticated: #495269
From: Peter Eisentraut <peter_e@gmx.net>
To: esr@thyrsus.com
Subject: Re: problems in vacuumdb.1
Date: Tue, 23 Nov 2004 08:28:01 +0100
User-Agent: KMail/1.6.2
Cc: pgsql-docs@postgresql.org
References: <200411210402.iAL42VuP014411@snark.thyrsus.com>
In-Reply-To: <200411210402.iAL42VuP014411@snark.thyrsus.com>
MIME-Version: 1.0
Content-Disposition: inline
Content-Type: text/plain;
  charset="iso-8859-15"
Content-Transfer-Encoding: 7bit
Message-Id: <200411230828.01426.peter_e@gmx.net>
X-Virus-Scanned: by amavisd-new at hub.org
X-Spam-Status: No, hits=0.0 tagged_above=0.0 required=5.0 tests=
X-Spam-Level: 
X-Archive-Number: 200411/50
X-Sequence-Number: 2685

esr@thyrsus.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/