Re: Add clarification example to EXEC SQL CONNECT with password - Mailing list pgsql-docs

From Tom Lane
Subject Re: Add clarification example to EXEC SQL CONNECT with password
Date
Msg-id 14376.1359134732@sss.pgh.pa.us
Whole thread Raw
In response to Re: Add clarification example to EXEC SQL CONNECT with password  (Bruce Momjian <bruce@momjian.us>)
Responses Re: Add clarification example to EXEC SQL CONNECT with password  (Bruce Momjian <bruce@momjian.us>)
List pgsql-docs
Bruce Momjian <bruce@momjian.us> writes:
> *** a/doc/src/sgml/ecpg.sgml
> --- b/doc/src/sgml/ecpg.sgml
> *************** EXEC SQL CONNECT TO unix:postgresql://sq
> *** 194,202 ****
>   EXEC SQL BEGIN DECLARE SECTION;
>   const char *target = "mydb@sql.mydomain.com";
>   const char *user = "john";
>   EXEC SQL END DECLARE SECTION;
>    ...
> ! EXEC SQL CONNECT TO :target USER :user;
>   </programlisting>
>      The last form makes use of the variant referred to above as
>      character variable reference.  You will see in later sections how C
> --- 194,205 ----
>   EXEC SQL BEGIN DECLARE SECTION;
>   const char *target = "mydb@sql.mydomain.com";
>   const char *user = "john";
> + const char *passwd = "secret";
>   EXEC SQL END DECLARE SECTION;
>    ...
> ! EXEC SQL CONNECT TO :target USER :user USING :passwd;
> !
> ! EXEC SQL CONNECT TO :target USER :user/:passwd;
>   </programlisting>
>      The last form makes use of the variant referred to above as
>      character variable reference.  You will see in later sections how C

This sure looks like it has broken the intention of the paragraph
immediately after the example.  Also, it seems like you are providing
two alternative ways of doing the same thing, but not explaining that.
How is a reader supposed to know that he doesn't have to do both
commands?

            regards, tom lane


pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: Add clarification example to EXEC SQL CONNECT with password
Next
From: Bruce Momjian
Date:
Subject: Re: Add clarification example to EXEC SQL CONNECT with password