public inbox for [email protected]  

help / color / mirror / Atom feed

From: Tom Lane <[email protected]>
To: Josh Berkus <[email protected]>
Cc: Peter Eisentraut <[email protected]>
Cc: [email protected]
Subject: Re: Need help with SGML again
Date: Wed, 15 Oct 2003 13:22:13 -0400
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>

Josh Berkus <[email protected]> writes:
> Peter,
>> 1. Linking to anything that is not a formal object (having a title and a
>> number) does not render well in print.  ("for more information, see
>> paragraph 3 on page 15"?)

> I see what you mean.   Given that I do 95% of my doc browsing in HTML, this 
> seems very redundant to me, though; I think it would be interesting to see 
> how many users refer to a paper version of the docs.  We may find it's a tiny
> minority.

That was my reaction as well.  While I don't want to make the paper
version unusable, I think that the HTML version is considerably more
important.

The compromise I would propose is to do the cross-linking as Josh
wanted, and to have the links in the HTML version go directly to the
paragraphs describing the variables, but in the paper version have the
links just refer to the containing numbered subsections.  (Dunno how
practical this is to implement, though.)

I don't much care for any of the three alternatives Josh mentions,
although if pressed I would opt for duplicating the info.  That might
be the best answer anyway, since the descriptions appropriate in the
main listing might be too terse for novices; that is, I'm not sure the
duplication would or should be exact.

			regards, tom lane

view thread (17+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected]
  Subject: Re: Need help with SGML again
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox