[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Provide sane default for the @direntry
From: |
Ihor Radchenko |
Subject: |
Re: Provide sane default for the @direntry |
Date: |
Wed, 28 Feb 2024 10:35:13 +0000 |
Stefan Monnier <monnier@iro.umontreal.ca> writes:
> When exporting to Texinfo, the patch below makes it easier to generate
> a good `@direntry` by using sane defaults.
> For most files, you'll just need
>
> #+TEXINFO_DIR_CATEGORY: {my-category}
>
> I believe it also makes it a bit harder to shoot oneself in the foot and
> generate an invalid entry (e.g. with a missing or wrong file name).
May you please supply a ChangeLog entry? I am not sure if I understand
the purpose of each change in the diff.
Also, it looks like you introduce some DWIM behaviour for auto-generating
@direntry contents. Such new behaviour ought to be documented in the
manual and announced in the news.
--
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>