Re: [PATCHES] minor doc work

2004-03-09 Thread Peter Eisentraut
Neil Conway wrote:
   If commandSET/ is allowed, it overrides all other sources of
 ! values for the parameter.  Superusers are allowed to
 ! commandSET/ more values than ordinary users.  Some parameters
 ! cannot be commandSET/command even by superusers: for example,

Please don't use marked up command names as verbs.  Next week you'll be
commandUPDATE/commanding or something.  Here, there is no chance for
confusion, so just write cannot be set or cannot be changed with
commandSET/command.  In fact, the latter is even clearer.

 ! if they control behavior that cannot reasonably be changed without
 ! restarting productnamePostgreSQL/productname.


---(end of broadcast)---
TIP 2: you can get off all lists at once with the unregister command
(send unregister YourEmailAddressHere to [EMAIL PROTECTED])


[PATCHES] minor doc work

2004-03-06 Thread Neil Conway
I've applied the two attached minor documentation patches to HEAD. 
Each patch makes a few minor improvements to a particular section of 
the docs (the discussion of IS NULL and the discussion of SET, 
respectively).

Cheers,

Neil
Index: doc/src/sgml/func.sgml
===
RCS file: /var/lib/cvs/pgsql-server/doc/src/sgml/func.sgml,v
retrieving revision 1.191
diff -c -r1.191 func.sgml
*** a/doc/src/sgml/func.sgml	5 Mar 2004 02:41:14 -	1.191
--- b/doc/src/sgml/func.sgml	5 Mar 2004 19:50:42 -
***
*** 301,320 
  literalreplaceableexpression/replaceable = NULL/literal
  because literalNULL/ is not quoteequal to/quote
  literalNULL/.  (The null value represents an unknown value,
! and it is not known whether two unknown values are equal.)
 /para
  
 para
! Some applications may (incorrectly) require that
  literalreplaceableexpression/replaceable = NULL/literal
  returns true if replaceableexpression/replaceable evaluates to
! the null value.  To support these applications, the run-time option
! varnametransform_null_equals/varname can be turned on (e.g.,
! literalSET transform_null_equals TO ON;/literal).
! productnamePostgreSQL/productname will then convert
! literalx = NULL/literal clauses to
! literalx IS NULL/literal.  This was 
! the default behavior in releases 6.5 through 7.1.
 /para
  
 para
--- 301,322 
  literalreplaceableexpression/replaceable = NULL/literal
  because literalNULL/ is not quoteequal to/quote
  literalNULL/.  (The null value represents an unknown value,
! and it is not known whether two unknown values are equal.) This
! behavior conforms to the SQL standard.
 /para
  
 para
! Some applications may expect that
  literalreplaceableexpression/replaceable = NULL/literal
  returns true if replaceableexpression/replaceable evaluates to
! the null value.  It is highly recommended that these applications
! be modified to comply with the SQL standard. However, if that
! cannot be done the varnametransform_null_equals/varname
! configuration variable is available. If it is enabled,
! productnamePostgreSQL/productname will convert literalx =
! NULL/literal clauses to literalx IS NULL/literal.  This was
! the default behavior in productnamePostgreSQL/productname
! releases 6.5 through 7.1.
 /para
  
 para
Index: doc/src/sgml/runtime.sgml
===
RCS file: /var/lib/cvs/pgsql-server/doc/src/sgml/runtime.sgml,v
retrieving revision 1.244
diff -c -r1.244 runtime.sgml
*** a/doc/src/sgml/runtime.sgml	5 Mar 2004 23:16:17 -	1.244
--- b/doc/src/sgml/runtime.sgml	7 Mar 2004 00:59:19 -
***
*** 541,548 
  SET ENABLE_SEQSCAN TO OFF;
  /screen
  If commandSET/ is allowed, it overrides all other sources of
! values for the parameter.  Superusers are allowed to commandSET/
! more values than ordinary users.
 /para
  
 para
--- 541,551 
  SET ENABLE_SEQSCAN TO OFF;
  /screen
  If commandSET/ is allowed, it overrides all other sources of
! values for the parameter.  Superusers are allowed to
! commandSET/ more values than ordinary users.  Some parameters
! cannot be commandSET/command even by superusers: for example,
! if they control behavior that cannot reasonably be changed without
! restarting productnamePostgreSQL/productname.
 /para
  
 para

---(end of broadcast)---
TIP 1: subscribe and unsubscribe commands go to [EMAIL PROTECTED]