minor doc work
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
Neil Conway wrote:
If <command>SET</> is allowed, it overrides all other sources of
! values for the parameter. Superusers are allowed to
! <command>SET</> more values than ordinary users. Some parameters
! cannot be <command>SET</command> even by superusers: for example,
Please don't use marked up command names as verbs. Next week you'll be
<command>UPDATE</command>ing or something. Here, there is no chance for
confusion, so just write "cannot be set" or "cannot be changed with
<command>SET</command>". In fact, the latter is even clearer.
Show quoted text
! if they control behavior that cannot reasonably be changed without
! restarting <productname>PostgreSQL</productname>.
Peter Eisentraut <peter_e@gmx.net> writes:
Please don't use marked up command names as verbs. Next week you'll
be <command>UPDATE</command>ing or something.
The existing documentation does this -- indeed, the very section of
the docs that I modified *already* did it:
If <command>SET</> is allowed, it overrides all other sources of
! values for the parameter. Superusers are allowed to <command>SET</>
! more values than ordinary users.
(which was the original text)
I've modified this particular section per your suggestion, but I
haven't made any wider changes (i.e. this style is still used in other
places).
-Neil