Thread: user's guide

user's guide

From
José Soares
Date:
I'm reading user's guide pages and I see that some command descriptions
are not
updated, compared with man pages there are some differences.
Here some examples:

-------------------------------------------------------------
Command                                    userGuide            manPage
-------------------------------------------------------------
BEGIN                                        notUpd                upd
LOCK                                         notUpd                upd
SELECT FOR UPDATE             notUpd                upd
CREATE TEMP                          notUpd                upd
DECLARE                                   upd                     notUpd


What about to have only one version for both of them?

José



Re: [DOCS] user's guide

From
Thomas Lockhart
Date:
> I'm reading user's guide pages and I see that some command
> descriptions are not updated, compared with man pages there
> are some differences.

Hmm. At least LOCK was updated by Vadim for his recent features; from
CVS logs it isn't clear that other changes had been made unless I
managed to revert something accidentally. What is the nature of the
problem for, e.g., the LOCK information? Would you (or someone else)
have time to refresh the sgml versions? In any case, thanks for the
info.

> What about to have only one version for both of them?

That has been a goal, and I was hoping that it would be done by now.
I'm planning on looking at it some more myself for the next release,
unless someone else comes through before then (hint, hint).

fwiw, other docs projects using the same tools as us need to solve
this problem too, so something should come soon.

                    - Thomas

--
Thomas Lockhart                lockhart@alumni.caltech.edu
South Pasadena, California