Re: Multiple --table options for other commands

On Thu, Dec 13, 2012 at 6:05 AM, Karl O. Pinc <kop(at)meme(dot)com> wrote:
> On 12/13/2012 12:35:14 AM, Karl O. Pinc wrote:
>
>> On 12/12/2012 11:04:53 PM, Josh Kupershmidt wrote:
>> > On Wed, Dec 12, 2012 at 8:14 AM, Karl O. Pinc <kop(at)meme(dot)com> wrote:
>> > > On 12/11/2012 10:25:43 PM, Josh Kupershmidt wrote:
>> > >> On Tue, Dec 11, 2012 at 11:46 AM, Karl O. Pinc <kop(at)meme(dot)com>
>> > wrote:
>> > >> >> I believe you need ellipses behind --table in the syntax
>> > summaries
>> > >> >> of the command reference docs.
>>
>>
>> > > Yes. I see. I didn't look at all the command's reference pages
>> > > but did happen to look at clusterdb, which does have --table
>> > > in the syntax summary. I just checked and you need to fix
>> > > clusterdb, reindexdb, and vacuumdb.
>> >
>> > OK, I made some changes to the command synopses for these three
>> > commands.
>
>> I want the ... outside the square braces, because the --table (or -t)
>> must repeat for each table specified. Like:
>>
>> vacuumdb [connection-option...] [option...] [ --table | -t table
>> [( column [,...] )] ]... [dbname]
>>
>> reindexdb [connection-option...] [ --table | -t table ]... [ --index
>> |
>>
>> -i index ]... [dbname]
>
>> Have you had trouble getting this to work?
>
> Perhaps <arg choice="opt"><arg rep="repeat"> ... would work?

Well, I fooled around with the SGML for a bit and came up with
something which has the ellipses in brackets:

[ --table | -t table ] [...]

which I like a little better than not having the second set of
brackets. New version attached.

Josh