GNU bug report logs - #26951
25.2; `calc-mode': autoload?

Previous Next

Package: emacs;

Reported by: Drew Adams <drew.adams <at> oracle.com>

Date: Tue, 16 May 2017 13:53:01 UTC

Severity: wishlist

Found in version 25.2

Done: Stefan Kangas <stefan <at> marxist.se>

Bug is archived. No further changes may be made.

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

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

View this report as an mbox folder, status mbox, maintainer mbox


Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#26951; Package emacs. (Tue, 16 May 2017 13:53:02 GMT) Full text and rfc822 format available.

Acknowledgement sent to Drew Adams <drew.adams <at> oracle.com>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Tue, 16 May 2017 13:53:02 GMT) Full text and rfc822 format available.

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

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 25.2; `calc-mode': autoload?
Date: Tue, 16 May 2017 06:52:19 -0700 (PDT)
emacs -Q

C-h f calc-mode  ; No match
C-h v calc-mode  ; No match

C-h f calc

  calc is an interactive autoloaded Lisp function in ‘calc.el’.

  It is bound to <menu-bar> <tools> <calc>.

  (calc &optional ARG FULL-DISPLAY INTERACTIVE)

  The Emacs Calculator.  Full documentation is listed under "calc-mode".
                         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Huh?  We send users off to consult the "full documentation"
of "calc-mode" (which presumably should be `calc-mode')?
And just where should a user expect that documentation
"calc-mode" to be "listed"?

Something is wrong here, at least from a user point of view.

C-h r

i calc  ; No match

Something is wrong here too.  Calc should at least be mentioned
in the Emacs manual.  There should be a cross reference there
to the Calc manual.  Searching for `calc' in the Emacs manual
finds only one reference:

 • David Gillespie wrote the Common Lisp compatibility packages;
   ‘Calc’, an advanced calculator and mathematical tool, since
   maintained and developed by Jay Belanger; ‘complete.el’, a partial
   completion mechanism; and ‘edmacro.el’, a package for editing
   keyboard macros.

In GNU Emacs 25.2.1 (x86_64-w64-mingw32)
 of 2017-04-24 built on LAPHROAIG
Windowing system distributor 'Microsoft Corp.', version 6.1.7601
Configured using:
 'configure --without-dbus --without-compress-install 'CFLAGS=-O2
 -static -g3''




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#26951; Package emacs. (Tue, 16 May 2017 18:47:01 GMT) Full text and rfc822 format available.

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 26951 <at> debbugs.gnu.org
Subject: Re: bug#26951: 25.2; `calc-mode': autoload?
Date: Tue, 16 May 2017 21:45:53 +0300
> Date: Tue, 16 May 2017 06:52:19 -0700 (PDT)
> From: Drew Adams <drew.adams <at> oracle.com>
> 
> C-h r
> 
> i calc  ; No match
> 
> Something is wrong here too.  Calc should at least be mentioned
> in the Emacs manual.  There should be a cross reference there
> to the Calc manual.

I don't see why.  We don't have such references for other packages
documented in their separate manuals.  The Emacs manual is not the
Hub" of Emacs-related documentation; the "dir" node is.

> Searching for `calc' in the Emacs manual finds only one reference:

You forgot "M-x info-apropos".




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#26951; Package emacs. (Tue, 16 May 2017 19:05:01 GMT) Full text and rfc822 format available.

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

From: Drew Adams <drew.adams <at> oracle.com>
To: Eli Zaretskii <eliz <at> gnu.org>, Drew Adams <drew.adams <at> oracle.com>
Cc: 26951 <at> debbugs.gnu.org
Subject: RE: bug#26951: 25.2; `calc-mode': autoload?
Date: Tue, 16 May 2017 12:04:35 -0700 (PDT)
> > C-h r
> >
> > i calc  ; No match
> >
> > Something is wrong here too.  Calc should at least be mentioned
> > in the Emacs manual.  There should be a cross reference there
> > to the Calc manual.
> 
> I don't see why.  We don't have such references for other packages
> documented in their separate manuals.  The Emacs manual is not the
> Hub" of Emacs-related documentation; the "dir" node is.

OK by me.

> > Searching for `calc' in the Emacs manual finds only one reference:
                                ^^^^^
> 
> You forgot "M-x info-apropos".

No I didn't.  That doesn't find `calc' in the Emacs manual.




Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#26951; Package emacs. (Tue, 16 May 2017 19:31:02 GMT) Full text and rfc822 format available.

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 26951 <at> debbugs.gnu.org
Subject: Re: bug#26951: 25.2; `calc-mode': autoload?
Date: Tue, 16 May 2017 22:30:30 +0300
> Date: Tue, 16 May 2017 12:04:35 -0700 (PDT)
> From: Drew Adams <drew.adams <at> oracle.com>
> Cc: 26951 <at> debbugs.gnu.org
> 
> > You forgot "M-x info-apropos".
> 
> No I didn't.  That doesn't find `calc' in the Emacs manual.

Because 'calc' is not in the Emacs manual.  The command does find
'calc' in the manual where it is described.  Which is what that
command is for: to find stuff you don't know which manual to search it
for.

IOW, if you cannot find something in the manual(s) you think that
something should be in, try the 'd' command or info-apropos as the
last resort.




Reply sent to Stefan Kangas <stefan <at> marxist.se>:
You have taken responsibility. (Sun, 29 Sep 2019 03:00:02 GMT) Full text and rfc822 format available.

Notification sent to Drew Adams <drew.adams <at> oracle.com>:
bug acknowledged by developer. (Sun, 29 Sep 2019 03:00:02 GMT) Full text and rfc822 format available.

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

From: Stefan Kangas <stefan <at> marxist.se>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 26951-done <at> debbugs.gnu.org, Drew Adams <drew.adams <at> oracle.com>
Subject: Re: bug#26951: 25.2; `calc-mode': autoload?
Date: Sun, 29 Sep 2019 04:59:16 +0200
Eli Zaretskii <eliz <at> gnu.org> writes:

>> Date: Tue, 16 May 2017 06:52:19 -0700 (PDT)
>> From: Drew Adams <drew.adams <at> oracle.com>
>>
>> C-h r
>>
>> i calc  ; No match
>>
>> Something is wrong here too.  Calc should at least be mentioned
>> in the Emacs manual.  There should be a cross reference there
>> to the Calc manual.
>
> I don't see why.  We don't have such references for other packages
> documented in their separate manuals.  The Emacs manual is not the
> Hub" of Emacs-related documentation; the "dir" node is.
>
>> Searching for `calc' in the Emacs manual finds only one reference:
>
> You forgot "M-x info-apropos".

Eli Zaretskii <eliz <at> gnu.org> writes:

>> Date: Tue, 16 May 2017 12:04:35 -0700 (PDT)
>> From: Drew Adams <drew.adams <at> oracle.com>
>> Cc: 26951 <at> debbugs.gnu.org
>>
>> > You forgot "M-x info-apropos".
>>
>> No I didn't.  That doesn't find `calc' in the Emacs manual.
>
> Because 'calc' is not in the Emacs manual.  The command does find
> 'calc' in the manual where it is described.  Which is what that
> command is for: to find stuff you don't know which manual to search it
> for.
>
> IOW, if you cannot find something in the manual(s) you think that
> something should be in, try the 'd' command or info-apropos as the
> last resort.

From the above, it seems like there is nothing more to do here, and I'm
therefore closing this bug report.

If anyone disagrees, feel free to reopen it.

Best regards,
Stefan Kangas




bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Sun, 27 Oct 2019 11:24:10 GMT) Full text and rfc822 format available.

This bug report was last modified 4 years and 154 days ago.

Previous Next


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