diff options
| author | Peter Eisentraut <peter_e@gmx.net> | 2012-05-03 22:50:04 +0300 |
|---|---|---|
| committer | Peter Eisentraut <peter_e@gmx.net> | 2012-05-03 22:58:00 +0300 |
| commit | 1715ff112809bca5218ddb6eccfda2c20dc420b5 (patch) | |
| tree | af19faa1d5bc727fb90b27e55b7c3c452f556570 /doc/src/sgml/ref/pg_resetxlog.sgml | |
| parent | ebcaa5fcde8411786e3765414465174e6d31c8e6 (diff) | |
doc: Fix for too many brackets in command synopses on man pages
The default for the choice attribute of the <arg> element is "opt",
which would normally put the argument inside brackets. But the DSSSL
stylesheets contain a hack that treats <arg> directly inside <group>
specially, so that <group><arg>-x</arg><arg>-y</arg></group> comes out
as [ -x | -y ] rather than [ [-x] | [-y] ], which it would technically
be. But when building man pages, this doesn't work, and so the
command synopses on the man pages contain lots of extra brackets.
By putting choice="opt" or choice="plain" explicitly on every <arg>
and <group> element, we avoid any toolchain dependencies like that,
and it also makes it clearer in the source code what is meant.
In passing, make some small corrections in the documentation about
which arguments are really optional or not.
Diffstat (limited to 'doc/src/sgml/ref/pg_resetxlog.sgml')
| -rw-r--r-- | doc/src/sgml/ref/pg_resetxlog.sgml | 16 |
1 files changed, 8 insertions, 8 deletions
diff --git a/doc/src/sgml/ref/pg_resetxlog.sgml b/doc/src/sgml/ref/pg_resetxlog.sgml index 3a7dfb3c73e..fe67a3d1f20 100644 --- a/doc/src/sgml/ref/pg_resetxlog.sgml +++ b/doc/src/sgml/ref/pg_resetxlog.sgml @@ -22,14 +22,14 @@ PostgreSQL documentation <refsynopsisdiv> <cmdsynopsis> <command>pg_resetxlog</command> - <arg><option>-f</option></arg> - <arg><option>-n</option></arg> - <arg><option>-o</option> <replaceable class="parameter">oid</replaceable></arg> - <arg><option>-x</option> <replaceable class="parameter">xid</replaceable></arg> - <arg><option>-e</option> <replaceable class="parameter">xid_epoch</replaceable></arg> - <arg><option>-m</option> <replaceable class="parameter">mxid</replaceable></arg> - <arg><option>-O</option> <replaceable class="parameter">mxoff</replaceable></arg> - <arg><option>-l</option> <replaceable class="parameter">timelineid</replaceable>,<replaceable class="parameter">fileid</replaceable>,<replaceable class="parameter">seg</replaceable></arg> + <arg choice="opt"><option>-f</option></arg> + <arg choice="opt"><option>-n</option></arg> + <arg choice="opt"><option>-o</option> <replaceable class="parameter">oid</replaceable></arg> + <arg choice="opt"><option>-x</option> <replaceable class="parameter">xid</replaceable></arg> + <arg choice="opt"><option>-e</option> <replaceable class="parameter">xid_epoch</replaceable></arg> + <arg choice="opt"><option>-m</option> <replaceable class="parameter">mxid</replaceable></arg> + <arg choice="opt"><option>-O</option> <replaceable class="parameter">mxoff</replaceable></arg> + <arg choice="opt"><option>-l</option> <replaceable class="parameter">timelineid</replaceable>,<replaceable class="parameter">fileid</replaceable>,<replaceable class="parameter">seg</replaceable></arg> <arg choice="plain"><replaceable>datadir</replaceable></arg> </cmdsynopsis> </refsynopsisdiv> |