On 12/13/2012 09:24:24 PM, Josh Kupershmidt wrote: > On Thu, Dec 13, 2012 at 7:24 PM, Karl O. Pinc <k...@meme.com> wrote:
> > As a fallback I'd do to the clusterdb, reindexdb, and vacuumdb > > syntax summaries what was done to the pg_dump and pg_restore > > syntax summaries. Remove all the detail. This is sucky, > > and _still_ leaves the reference pages with a syntax summary syntax > > that differs from regular man pages, but because the text > > is relatively information free nobody notices. > > That should be how the v2 patch has it. No. The v2 patch does not touch the syntax synopsis. > > > My inclination, since you can't make it work > > and we don't seem to be getting any help here, > > is to remove all the detail in the syntax summaries, > > push it through to a committer, and get some feedback that way. > > If someone out there feels that the formatting of these commands' > synopses should look like: > [ --table | -t table ] ... > > and knows how to massage the SGML to get that, I'm happy to > accommodate the change. Otherwise, I think either the v4 or v2 patch > should be acceptable. My brain seems to have turned itself on. I went and (re)read the docbook manual and was able to come up with this, which works: <arg choice="plain" rep="repeat"><arg choice="opt"> <group choice="plain"> <arg choice="plain"><option>--table</option></arg> <arg choice="plain"><option>-t</option></arg> </group> <replaceable>table</replaceable> </arg></arg> Yay! (indentation et-al aside) Sorry to be so persnickety, and unhelpful until now. It seemed like it should be doable, but something was going wrong between keyboard and chair. I guess I should be doing this when better rested. Regards, Karl <k...@meme.com> Free Software: "You don't pay back, you pay forward." -- Robert A. Heinlein -- Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-hackers