GNU bug report logs - #33440
26.1; grouping `forms' in info:elisp#Index

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 33440 in the body.
You can then email your comments to 33440 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Van L <van <at> scratch.space>
To: bug-gnu-emacs <at> gnu.org
Subject: 26.1; grouping `forms' in info:elisp#Index
Date: Tue, 20 Nov 2018 14:22:21 +1100

Hello,

This is a suggestion not a bug.

At (info "(elisp)" Index)
grouping on a common prefix
all the entries associated with 'forms'
at the following context is useful, note that
'form' itself occurs further above 'format'.

And, for (info "(elisp) Forms")
to go in the index. A first search finds
all but one entry refer to special forms.

* formatting time values:                Time Parsing.        (line   6)
* formfeed:                              Basic Char Syntax.   (line  27)
* forward-button:                        Button Buffer Commands.
                                                              (line  32)
* forward-char:                          Character Motion.    (line  24)


The grouping on common prefix 'forms' would be like how tooltip is arranged:

* tooltip face:                          Tooltips.            (line  42)
* tooltip for help strings:              Special Properties.  (line  83)
* tooltip frames:                        Tooltips.            (line  26)
* tooltip-event-buffer:                  Tooltips.            (line  59)
* tooltip-frame-parameters:              Tooltips.            (line  31)
* tooltip-functions:                     Tooltips.            (line  46)
* tooltip-help-tips:                     Tooltips.            (line  46)
* tooltip-mode:                          Tooltips.            (line  13)
* tooltips:                              Tooltips.            (line   6)

or how cl/CL is:

* cl:                                    Lisp History.        (line  28)
* CL note—allocate more storage:         Garbage Collection.  (line  51)
* CL note—case of letters:               Symbol Type.         (line  38)
* CL note—default optional arg:          Argument List.       (line  46)
* CL note—integers vrs eq:               Comparison of Numbers.
                                                              (line  39)
* CL note—interning existing symbol:     Creating Symbols.    (line 116)
* CL note—lack union, intersection:      Sets And Lists.      (line  13)
* CL note—no continuable errors:         Signaling Errors.    (line  98)
* CL note—no setf functions:             Adding Generalized Variables.
                                                              (line  53)
* CL note—only throw in Emacs:           Catch and Throw.     (line  54)
* CL note—rplaca vs setcar:              Modifying Lists.     (line  10)
* CL note—special forms compared:        Special Forms.       (line  99)
* CL note—symbol in obarrays:            Creating Symbols.    (line  65)
* cl-call-next-method:                   Generic Functions.   (line 196)
* cl-defgeneric:                         Generic Functions.   (line  49)
* cl-defmethod:                          Generic Functions.   (line  71)
* cl-next-method-p:                      Generic Functions.   (line 204)
* cl-old-struct-compat-mode:             Backward Compatibility.
                                                              (line  12)

Message #8 received at 33440 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Van L <van <at> scratch.space>
Cc: 33440 <at> debbugs.gnu.org
Subject: Re: bug#33440: 26.1; grouping `forms' in info:elisp#Index
Date: Tue, 20 Nov 2018 17:49:48 +0200

> From: Van L <van <at> scratch.space>
> Date: Tue, 20 Nov 2018 14:22:21 +1100
> 
> This is a suggestion not a bug.
> 
> At (info "(elisp)" Index)
> grouping on a common prefix
> all the entries associated with 'forms'
> at the following context is useful, note that
> 'form' itself occurs further above 'format'.
> 
> And, for (info "(elisp) Forms")
> to go in the index. A first search finds
> all but one entry refer to special forms.
> 
> * formatting time values:                Time Parsing.        (line   6)
> * formfeed:                              Basic Char Syntax.   (line  27)
> * forward-button:                        Button Buffer Commands.
>                                                               (line  32)
> * forward-char:                          Character Motion.    (line  24)
> 
> 
> The grouping on common prefix 'forms' would be like how tooltip is arranged:

I'm not sure I understand the request.  Are you asking for index
entries like "forms, self-evaluating", "forms, symbol", "forms, list",
etc.?

Message #11 received at 33440 <at> debbugs.gnu.org (full text, mbox):

From: Van L <van <at> scratch.space>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 33440 <at> debbugs.gnu.org
Subject: Re: bug#33440: 26.1; grouping `forms' in info:elisp#Index
Date: Thu, 22 Nov 2018 23:31:02 +1100

> I'm not sure I understand the request.  Are you asking for index
> entries like "forms, self-evaluating", "forms, symbol", "forms, list",
> etc.?

I don’t know the forms there, a sampling is the following:

* form:                                  Intro Eval.          (line  12)
* special form descriptions:             A Sample Function Description.
                                                              (line   6)
* special forms:                         Special Forms.       (line   6)
* special forms for control structures:  Control Structures.  (line   6)

The above would be indexed together with a common prefix.

Message #16 received at 33440-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Van L <van <at> scratch.space>
Cc: 33440-done <at> debbugs.gnu.org
Subject: Re: bug#33440: 26.1; grouping `forms' in info:elisp#Index
Date: Sat, 24 Nov 2018 10:02:23 +0200

> From: Van L <van <at> scratch.space>
> Date: Thu, 22 Nov 2018 23:31:02 +1100
> Cc: 33440 <at> debbugs.gnu.org
> 
> > I'm not sure I understand the request.  Are you asking for index
> > entries like "forms, self-evaluating", "forms, symbol", "forms, list",
> > etc.?
> 
> I don’t know the forms there, a sampling is the following:
> 
> * form:                                  Intro Eval.          (line  12)
> * special form descriptions:             A Sample Function Description.
>                                                               (line   6)
> * special forms:                         Special Forms.       (line   6)
> * special forms for control structures:  Control Structures.  (line   6)
> 
> The above would be indexed together with a common prefix.

Done, thanks.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.