Re: Lack of docs for libpq C Library - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: Lack of docs for libpq C Library
Date
Msg-id 200801311714.m0VHEsW20162@momjian.us
Whole thread Raw
In response to Re: Lack of docs for libpq C Library  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: Lack of docs for libpq C Library
Re: Lack of docs for libpq C Library
List pgsql-docs
Tom Lane wrote:
> Bruce Momjian <bruce@momjian.us> writes:
> > Tom Lane wrote:
> >> PQinitSSL *is* documented, though looking at the para immediately raises
> >> the question what the heck we are doing pointing to a random hp.com page
> >> for SSL documentation.
>
> > I added that for 8.3.  The HP documentation seemed excellent, which is
> > why I added it.
>
> The question is not about whether that doc is good, bad, or indifferent;
> it is about the likely lifespan of the URL.  A URL containing mostly
> random numbers instead of words does not fill me with confidence.

True, and Magnus was concerned about that as well.  What I liked about
it was the diagrams which I haven't seen anywhere else.  Our doc
reference is:

    (See http://h71000.www7.hp.com/DOC/83final/BA554_90007/ch04s02.html  for
    diagrams showing SSL certificate usage.)

I put it in parentheses to highlight the URL is only for reference to
the diagrams and explaination.  We can either remove the URL or remove
it if the URL changes.

SSL is pretty complicated so when I saw something that made it clearer,
I added it.

> Furthermore HP is hardly the authoritative reference on SSL.  Can't
> we find an RFC or something?

See above.

--
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://postgres.enterprisedb.com

  + If your life is a hard drive, Christ can be your backup. +

pgsql-docs by date:

Previous
From: Tom Lane
Date:
Subject: Re: Lack of docs for libpq C Library
Next
From: Tom Lane
Date:
Subject: Re: Supported platforms list