Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1UXbi5-0003Yp-2i for pgsql-hackers@arkaria.postgresql.org; Wed, 01 May 2013 18:24:57 +0000 Received: from localhost ([127.0.0.1] helo=postgresql.org) by malur.postgresql.org with smtp (Exim 4.72) (envelope-from ) id 1UXbi3-00089J-TU for pgsql-hackers@arkaria.postgresql.org; Wed, 01 May 2013 18:24:55 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1UXbhs-0007ux-8u for pgsql-hackers@postgresql.org; Wed, 01 May 2013 18:24:44 +0000 Received: from 74-95-152-129-atlanta.hfc.comcastbusiness.net ([74.95.152.129] helo=satori-assoc.com) by magus.postgresql.org with esmtp (Exim 4.72) (envelope-from ) id 1UXbhY-0000pP-B4 for pgsql-hackers@postgresql.org; Wed, 01 May 2013 18:24:37 +0000 Received: from [192.168.10.126] by satori-assoc.com (Cipher TLSv1:-SHA:128) (MDaemon PRO v13.0.5) with ESMTP id md50010131197.msg for ; Wed, 01 May 2013 14:24:13 -0400 X-Spam-Processed: satori-assoc.com, Wed, 01 May 2013 14:24:13 -0400 (not processed: message from trusted or authenticated source) X-Authenticated-Sender: dru@satori-assoc.com X-MDRemoteIP: 192.168.10.126 X-Return-Path: prvs=1833a81212=dru@druware.com X-Envelope-From: dru@druware.com X-MDaemon-Deliver-To: pgsql-hackers@postgresql.org Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Mac OS X Mail 6.3 \(1503\)) Subject: Re: Documentation epub format From: Andrew Satori In-Reply-To: <51815AEC.80901@commandprompt.com> Date: Wed, 1 May 2013 14:24:08 -0400 Cc: Tom Lane , Fabien COELHO , PostgreSQL Developers Content-Transfer-Encoding: quoted-printable Message-Id: References: <518143D3.8060007@commandprompt.com> <25988.1367430763@sss.pgh.pa.us> <51815AEC.80901@commandprompt.com> To: "Joshua D. Drake" X-Mailer: Apple Mail (2.1503) X-Pg-Spam-Score: -0.9 (/) List-Archive: List-Help: List-ID: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-Mailing-List: pgsql-hackers Precedence: bulk Sender: pgsql-hackers-owner@postgresql.org On May 1, 2013, at 2:11 PM, "Joshua D. Drake" wrote: >=20 > On 05/01/2013 10:52 AM, Tom Lane wrote: >> "Joshua D. Drake" writes: >>> Once upon a time we had multiple books as documentation, then at some >>> point we merged them. It was quite a few years ago. >>> I would agree at this point that we need to consider breaking them up >>> again. The documentation is unwieldy. >>=20 >> The reason we merged them was to allow hyperlink cross-references between >> different parts of the docs. I would be sad to lose that.\ >=20 > Defintely. Is there no way to cross reference multiple documents? >=20 > Peter? >=20 The weakness (IMO) is that you are trading off one large file for several s= maller ones. The documentation is unwieldily because of the depth and brea= dth, not the size of the file. Thinking in terms of common use cases, you = would have the the published document on an offline device. For external l= inking you would have to assume a directory structure, or multiple files al= l local in the same directory, and that's assuming the various formats for = doing the linking. While there is fairly broad support for link points wit= hin a document, or to an http(s) url in formats like epub and pdf. file://= uri's are far less robust in support, and it is quite hit or miss in the v= arious readers. Other than local HTML, I cannot think of a format that has= good local file/relative path support for linking multiple documents, and = broad device/platform support. Dru --=20 Sent via pgsql-hackers mailing list (pgsql-hackers@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-hackers