delorie.com/archives/browse.cgi   search  
Mail Archives: djgpp-workers/2003/02/04/02:38:06

Date: Tue, 4 Feb 2003 09:32:36 +0200 (IST)
From: Eli Zaretskii <eliz AT is DOT elta DOT co DOT il>
X-Sender: eliz AT is
To: Richard Dawe <rich AT phekda DOT freeserve DOT co DOT uk>
cc: djgpp-workers AT delorie DOT com
Subject: Re: Add @tindex for types in docs [PATCH]
In-Reply-To: <E18fmrW-0000gG-00@phekda.freeserve.co.uk>
Message-ID: <Pine.SUN.3.91.1030204092531.22830I-100000@is>
MIME-Version: 1.0
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

On Mon, 3 Feb 2003, Richard Dawe wrote:

> Here is a patch to @vindex to the docs for all the structs and typedefs.

I'm not sure we should prefix each struct name with the word "struct": 
that would make almost all of the index entries start with that word.  
Imagine someone who types "i struct TAB" inside Info and gets a very long 
list of possible completions.

How about reversing the word order, like this:

  @tindex stat AT r{ structure}
  @tindex div_t AT r{ type}

(etc., you get the idea)?

I originally thought about simply "@tindex stat" etc., but that would make 
two index entries for "stat" with no easy way to understand where each one 
of them leads.  Thus the addition of "structure" and "type" (or maybe we 
should use "data type" for the latter).

Comments?

- Raw text -


  webmaster     delorie software   privacy  
  Copyright 2019   by DJ Delorie     Updated Jul 2019