From 1715ff112809bca5218ddb6eccfda2c20dc420b5 Mon Sep 17 00:00:00 2001 From: Peter Eisentraut Date: Thu, 3 May 2012 22:50:04 +0300 Subject: doc: Fix for too many brackets in command synopses on man pages The default for the choice attribute of the element is "opt", which would normally put the argument inside brackets. But the DSSSL stylesheets contain a hack that treats directly inside specially, so that -x-y 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 and 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. --- doc/src/sgml/ref/createlang.sgml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'doc/src/sgml/ref/createlang.sgml') diff --git a/doc/src/sgml/ref/createlang.sgml b/doc/src/sgml/ref/createlang.sgml index 4ca32fba39a..2bc43627e54 100644 --- a/doc/src/sgml/ref/createlang.sgml +++ b/doc/src/sgml/ref/createlang.sgml @@ -24,14 +24,14 @@ PostgreSQL documentation createlang connection-option langname - dbname + dbname createlang connection-option - - dbname + + dbname -- cgit v1.2.3