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

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

[Drew Adams]

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''

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

[Eli Zaretskii]

> Date: Tue, 16 May 2017 06:52:19 -0700 (PDT)
> From: Drew Adams <drew.adams@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".

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

[Stefan Kangas]

Eli Zaretskii <eliz@gnu.org> writes:

>> Date: Tue, 16 May 2017 06:52:19 -0700 (PDT)
>> From: Drew Adams <drew.adams@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@gnu.org> writes:

>> Date: Tue, 16 May 2017 12:04:35 -0700 (PDT)
>> From: Drew Adams <drew.adams@oracle.com>
>> Cc: 26951@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#26951: 25.2; `calc-mode': autoload?

[Drew Adams]

> > 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.

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

[Eli Zaretskii]

> Date: Tue, 16 May 2017 12:04:35 -0700 (PDT)
> From: Drew Adams <drew.adams@oracle.com>
> Cc: 26951@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.