Re: Lack of docs for libpq C Library

Поиск
Список
Период
Сортировка
От Bruce Momjian
Тема Re: Lack of docs for libpq C Library
Дата
Msg-id 200801311714.m0VHEsW20162@momjian.us
обсуждение исходный текст
Ответ на Re: Lack of docs for libpq C Library  (Tom Lane <tgl@sss.pgh.pa.us>)
Ответы Re: Lack of docs for libpq C Library
Re: Lack of docs for libpq C Library
Список 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 по дате отправления:

Предыдущее
От: Tom Lane
Дата:
Сообщение: Re: Lack of docs for libpq C Library
Следующее
От: Tom Lane
Дата:
Сообщение: Re: Supported platforms list