Date: Sat, 01 Mar 2003 12:31:54 +0200
From: "Eli Zaretskii" <eliz AT elta DOT co DOT il>
Sender: halo1 AT zahav DOT net DOT il
To: rich AT phekda DOT freeserve DOT co DOT uk
Message-Id: <3405-Sat01Mar2003123153+0200-eliz@elta.co.il>
X-Mailer: emacs 21.3.50 (via feedmail 8 I) and Blat ver 1.8.9
CC: djgpp-workers AT delorie DOT com
In-reply-to: <3E5F480A.E5296747@phekda.freeserve.co.uk> (message from Richard
	Dawe on Fri, 28 Feb 2003 11:29:14 +0000)
Subject: Re: Add vindex entries for environment variables [PATCH]
References: <E18oQ6g-0001I2-00 AT phekda DOT freeserve DOT co DOT uk> <Pine DOT OSF DOT 4 DOT 51 DOT 0302281223050 DOT 16978 AT sirppi DOT helsinki DOT fi> <3E5F480A DOT E5296747 AT phekda DOT freeserve DOT co DOT uk>
Reply-To: djgpp-workers AT delorie DOT com
Errors-To: nobody AT delorie DOT com
X-Mailing-List: djgpp-workers AT delorie DOT com
X-Unsubscribes-To: listserv AT delorie DOT com
Precedence: bulk

> Date: Fri, 28 Feb 2003 11:29:14 +0000
> From: Richard Dawe <rich AT phekda DOT freeserve DOT co DOT uk>
> 
> * LFN environment variable <1>:          glob.
> * LFN environment variable <2>:          _crt0_startup_flags.
> * LFN environment variable <3>:          _preserve_fncase.
> * LFN environment variable <4>:          _rename.
> * LFN environment variable:              _use_lfn.

This is indeed what happens with identical entries.  But that's also a
reason not to use such identical entries: imagine a user who is
presented with the above list--how would she decide which one to
select to read about LFN?

So it's better to disambiguate the entries by adding some text to
those of them which do not describe the variable in general, but
rather mention how does it affect subtle aspects of this or that
library function.  That is, it's better to leave "@vindex LFN" in
_use_lfn.txh only, and do something like the following in the other
files:

  @vindex LFN AT r{ environment variable, and file-name globbing}
  @vindex LFN AT r{ environment variable, how to disable at startup}

etc.  This surely requires more creative work, but it improves a lot
on the efficiency of index searches, both in the on-line and in the
printed manuals.