unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
From: "Fran Burstall (Gmail)" <fran.burstall@gmail.com>
To: Eli Zaretskii <eliz@gnu.org>
Cc: 74995@debbugs.gnu.org
Subject: bug#74995: 30.0.93; shortdoc-function-examples not autoloaded
Date: Fri, 20 Dec 2024 17:08:34 +0000	[thread overview]
Message-ID: <CADxS8ijC9+STfeSAbGPx5cZnWJxfyY-aF10jKZ_-YkvppbxiBw@mail.gmail.com> (raw)
In-Reply-To: <86h66y9wlt.fsf@gnu.org>

[-- Attachment #1: Type: text/plain, Size: 1532 bytes --]

Sorry.  It seems that things are slightly more complicated.  I get the same
as you from emacs -Q.

To get what I saw, from emacs -Q, put

(require 'help-fns)  ; something I load, loads this.

(add-hook 'help-fns-describe-function-functions
  #'shortdoc-help-fns-examples-function)

into *scratch* and evaluate both forms.  Now doing "C-h append RET" causes:

help-fns--run-describe-functions: Symbol’s function definition is void:
shortdoc-help-fns-examples-function

Thanks,

---Fran


On Fri, 20 Dec 2024 at 15:56, Eli Zaretskii <eliz@gnu.org> wrote:

> > From: Fran Burstall <fran.burstall@gmail.com>
> > Date: Fri, 20 Dec 2024 15:44:25 +0000
> >
> >
> > According to the NEWS, there are new functions
> >
> > shortdoc-function-examples
> > shortdoc-help-fns-examples-function
> >
> > and a suggestion to
> >
> > (add-hook 'help-fns-describe-function-functions
> >     #'shortdoc-help-fns-examples-function)
> >
> > However, neither function is available until the shortdoc
> > package is loaded.
> >
> > Perhaps a couple of autoload cookies are needed here?
>
> I started "emacs -Q", inserted
>
>     (add-hook 'help-fns-describe-function-functions
>         #'shortdoc-help-fns-examples-function)
>
> into *scratch*, evaluated it, then typed "C-h f string-replace RET"
> and got a *Help* buffer with an example of using string-replace.  So
> I'm not sure why you say we need autoload cookies, since the advice in
> NEWS seems to work OOTB.  What did I miss?
>
> Thanks.
>

[-- Attachment #2: Type: text/html, Size: 3298 bytes --]

  reply	other threads:[~2024-12-20 17:08 UTC|newest]

Thread overview: 4+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-12-20 15:44 bug#74995: 30.0.93; shortdoc-function-examples not autoloaded Fran Burstall
2024-12-20 15:56 ` Eli Zaretskii
2024-12-20 17:08   ` Fran Burstall (Gmail) [this message]
2024-12-20 20:07     ` Eli Zaretskii

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=CADxS8ijC9+STfeSAbGPx5cZnWJxfyY-aF10jKZ_-YkvppbxiBw@mail.gmail.com \
    --to=fran.burstall@gmail.com \
    --cc=74995@debbugs.gnu.org \
    --cc=eliz@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public 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 read-only IMAP folder(s) and NNTP newsgroup(s).