bug#56260: 29.0.50; Provide a way to define shortdoc groups without loading shortdoc.el

bug#56260: 29.0.50; Provide a way to define shortdoc groups without loading shortdoc.el

[daanturo]

Currently to use `define-short-documentation-group`, we must first load
`shortdoc.el`, but loading it isn't exactly a cheap task: my startup is
slowed down by ~0.0186s.

We can achieve this with an autoloaded progn:

```elisp

;; Allow registering shortdoc groups without loading this file

;;;###autoload
(progn
  (defvar shortdoc--groups nil)

  (defmacro define-short-documentation-group (group &rest functions)
    ;; docstring
    (declare (indent defun))
    `(progn
       (setq shortdoc--groups (delq (assq ',group shortdoc--groups)
                                    shortdoc--groups))
       (push (cons ',group ',functions) shortdoc--groups))))

```

-- 
Daanturo.

bug#56260: 29.0.50; Provide a way to define shortdoc groups without loading shortdoc.el

[Lars Ingebrigtsen]

daanturo <daanturo@gmail.com> writes:

> Currently to use `define-short-documentation-group`, we must first load
> `shortdoc.el`, but loading it isn't exactly a cheap task: my startup is
> slowed down by ~0.0186s.
>
> We can achieve this with an autoloaded progn:
>
> ```elisp
>
> ;; Allow registering shortdoc groups without loading this file

I've now done this in Emacs 29.  An alternative approach would be to
move all the definitions of groups out of shortdoc.el into a different
file so that loading shortdoc.el would be fast.

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

bug#56260: 29.0.50; Provide a way to define shortdoc groups without loading shortdoc.el

[Basil L. Contovounesios via Bug reports for GNU Emacs, the Swiss army knife of text editors]

Lars Ingebrigtsen [2022-06-28 14:42 +0200] wrote:

> daanturo <daanturo@gmail.com> writes:
>
>> Currently to use `define-short-documentation-group`, we must first load
>> `shortdoc.el`, but loading it isn't exactly a cheap task: my startup is
>> slowed down by ~0.0186s.
>>
>> We can achieve this with an autoloaded progn:
>
> I've now done this in Emacs 29.  An alternative approach would be to
> move all the definitions of groups out of shortdoc.el into a different
> file so that loading shortdoc.el would be fast.

See also this thread that hypothesised about some alternative
approaches: https://lists.gnu.org/r/emacs-devel/2021-09/msg01719.html

Thanks,

-- 
Basil