[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: GDP NR talking about IR
From: |
Graham Percival |
Subject: |
Re: GDP NR talking about IR |
Date: |
Mon, 11 Aug 2008 14:43:36 -0700 |
On Mon, 11 Aug 2008 16:53:06 +0100
"Trevor Daniels" <address@hidden> wrote:
> Robin Bannister wrote Monday, August 11, 2008 1:32 PM
> >
> > where the current HTML version says just
> >> See also
> >> Internals Reference: Fingering.
> >> Follow the link to Fingering.
>
> There are several sections which are conditional on the
> type of manual; this is one of them.
I really discourage this kind of thing; they should be rewritten
entirely. For example, the tutorial discusses how you can click
on graphics in the HTML version -- people viewing the pdf won't
benefit from this discussion if they stick to pdf, but it might
encourage them to switch to HTML, so I left it in there.
Output-specific conditionals -- with the possible exception of
@ruser{} producing different links depending on the output -- are
a stupid idea that doesn't solve any problems that can't be solved
better by spending five minutes rewriting confusing sentences.
(the above is a prime example of a confusing sentence, however)
> > Does this mean I shouldn't check/search/quote/etc. the PDF version?
>
> Not at all, but it is probably more productive for you to
> concentrate on the sections of the manuals in development
> which have been completed,
Just to clarify the material in question: looking up properties is
*much* easier in the HTML version, because there's a ton of
cross-references you need to read. If you're doing a lot of that,
I'd recommend switching to html instead of trying to use pdf for
that.
Cheers,
- Graham