Received: from localhost (unknown [200.46.204.184]) by postgresql.org (Postfix) with ESMTP id E35A22E2D77 for ; Thu, 31 Jan 2008 21:54:54 -0400 (AST) Received: from postgresql.org ([200.46.204.71]) by localhost (mx1.hub.org [200.46.204.184]) (amavisd-maia, port 10024) with ESMTP id 12877-02-3 for ; Thu, 31 Jan 2008 21:54:43 -0400 (AST) Received: from momjian.us (momjian.us [70.90.9.53]) by postgresql.org (Postfix) with ESMTP id 94B6A2E00B3 for ; Thu, 31 Jan 2008 19:19:18 -0400 (AST) Received: (from bruce@localhost) by momjian.us (8.11.6/8.11.6) id m0VNJFe25739; Thu, 31 Jan 2008 18:19:15 -0500 (EST) From: Bruce Momjian Message-Id: <200801312319.m0VNJFe25739@momjian.us> Subject: Re: Lack of docs for libpq C Library In-Reply-To: <20080131180459.GI8602@alvh.no-ip.org> To: Alvaro Herrera Date: Thu, 31 Jan 2008 18:19:15 -0500 (EST) CC: Tom Lane , Pavel Golub , pgsql-docs@postgresql.org X-Mailer: ELM [version 2.4ME+ PL124 (25)] MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="US-ASCII" X-Virus-Scanned: Maia Mailguard 1.0.1 X-Archive-Number: 200801/62 X-Sequence-Number: 4791 Alvaro Herrera wrote: > Bruce Momjian wrote: > > > 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. > > If you really like that page, you could link to archive.org's version of > it: > > http://web.archive.org/web/20060903180210/http://h71000.www7.hp.com/DOC/83final/BA554_90007/ch04s02.html Basically, given the URL has been unchanged since at least September 2006 and because it is hard to find via Google, I think we should keep the HP URL (to give them credit) and fall back to archive.org in case the URL ever becomes inactive. SSL is not an easy thing to underestand so having links to good documentation is a big plus for us. Using that documentation I was able to understand SSL enough to make some improvements to the SSL code that I will apply for 8.4. -- Bruce Momjian http://momjian.us EnterpriseDB http://postgres.enterprisedb.com + If your life is a hard drive, Christ can be your backup. +