unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
* C-h S and "misc" manuals
@ 2021-09-15  8:38 João Távora
  2021-09-15  8:53 ` martin rudalics
  2021-09-15  9:14 ` Lars Ingebrigtsen
  0 siblings, 2 replies; 5+ messages in thread
From: João Távora @ 2021-09-15  8:38 UTC (permalink / raw)
  To: emacs-devel, eliz

Hi,

Apologies if there is an existing bug for this.

If I do 'C-h S' (info-lookup-symbol) and then type
'completion-at-point-functions' I'm happily taken to the 'elisp' manual
node about that variable.  Nice.  But if I type 'C-h S' with
'flymake-diagnostic-functions' I get nothing, even if there is a @vindex
entry for it in the Flymake manual.

I don't think it should be like this.  In part it makes a very nice
command such as 'C-h S' seem less trustworthy, which hurts the
discoverability of the manual.  So either the manuals under doc/misc
should also be indexed by this command or the Flymake and other manuals
should be integrated into the Emacs and elisp manuals.

What do you think?

João



^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: C-h S and "misc" manuals
  2021-09-15  8:38 C-h S and "misc" manuals João Távora
@ 2021-09-15  8:53 ` martin rudalics
  2021-09-15  9:26   ` João Távora
  2021-09-15  9:14 ` Lars Ingebrigtsen
  1 sibling, 1 reply; 5+ messages in thread
From: martin rudalics @ 2021-09-15  8:53 UTC (permalink / raw)
  To: João Távora, emacs-devel, eliz

 > Apologies if there is an existing bug for this.

Please fix

make -C doc/misc info
make[1]: Verzeichnis „/home/martin/emacs-git/trunk/obj-opt/doc/misc“ wird betreten
   GEN      ../../../doc/misc/../../info/flymake.info
../../../doc/misc/flymake.texi:7: @include: ../docstyle.texi konnte nicht gefunden werden
make[1]: Verzeichnis „/home/martin/emacs-git/trunk/obj-opt/doc/misc“ wird verlassen

Replacing

@include ../emacs/docstyle.texi

in flymake.texi with

@include docstyle.texi

does it.

Thanks, martin




^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: C-h S and "misc" manuals
  2021-09-15  8:38 C-h S and "misc" manuals João Távora
  2021-09-15  8:53 ` martin rudalics
@ 2021-09-15  9:14 ` Lars Ingebrigtsen
  1 sibling, 0 replies; 5+ messages in thread
From: Lars Ingebrigtsen @ 2021-09-15  9:14 UTC (permalink / raw)
  To: João Távora; +Cc: eliz, emacs-devel

João Távora <joaotavora@gmail.com> writes:

> Apologies if there is an existing bug for this.
>
> If I do 'C-h S' (info-lookup-symbol) and then type
> 'completion-at-point-functions' I'm happily taken to the 'elisp' manual
> node about that variable.  Nice.  But if I type 'C-h S' with
> 'flymake-diagnostic-functions' I get nothing, even if there is a @vindex
> entry for it in the Flymake manual.

Yup; see bug#42753.  

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no



^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: C-h S and "misc" manuals
  2021-09-15  8:53 ` martin rudalics
@ 2021-09-15  9:26   ` João Távora
  2021-09-15  9:32     ` martin rudalics
  0 siblings, 1 reply; 5+ messages in thread
From: João Távora @ 2021-09-15  9:26 UTC (permalink / raw)
  To: martin rudalics; +Cc: eliz, emacs-devel

martin rudalics <rudalics@gmx.at> writes:

>> Apologies if there is an existing bug for this.
>
> Please fix
>
> make -C doc/misc info
> make[1]: Verzeichnis „/home/martin/emacs-git/trunk/obj-opt/doc/misc“ wird betreten
>   GEN      ../../../doc/misc/../../info/flymake.info
> ../../../doc/misc/flymake.texi:7: @include: ../docstyle.texi konnte nicht gefunden werden
> make[1]: Verzeichnis „/home/martin/emacs-git/trunk/obj-opt/doc/misc“ wird verlassen

Donen. Ich habe es gefixt.

> @include ../emacs/docstyle.texi

That's another annoyance by the way.  Without that line, I can't easily
preview the doc/misc/flymake.info manual with C-c RET C-b.  So I add in
that line while I work on the manual, and then forget to remove it.

João



^ permalink raw reply	[flat|nested] 5+ messages in thread

* Re: C-h S and "misc" manuals
  2021-09-15  9:26   ` João Távora
@ 2021-09-15  9:32     ` martin rudalics
  0 siblings, 0 replies; 5+ messages in thread
From: martin rudalics @ 2021-09-15  9:32 UTC (permalink / raw)
  To: João Távora; +Cc: eliz, emacs-devel

 > Donen. Ich habe es gefixt.

Thanks, martin



^ permalink raw reply	[flat|nested] 5+ messages in thread

end of thread, other threads:[~2021-09-15  9:32 UTC | newest]

Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-09-15  8:38 C-h S and "misc" manuals João Távora
2021-09-15  8:53 ` martin rudalics
2021-09-15  9:26   ` João Távora
2021-09-15  9:32     ` martin rudalics
2021-09-15  9:14 ` Lars Ingebrigtsen

Code repositories for project(s) associated with this inbox:

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).