From: Glenn Morris <rgm@gnu.org>
To: Richard Stallman <rms@gnu.org>
Cc: larsi@gnus.org, p.stephani2@gmail.com, jonas@bernoul.li,
53316@debbugs.gnu.org
Subject: bug#53316: 28.0.91; Missing Transient manual in Emacs
Date: Sat, 19 Feb 2022 04:27:27 -0500 [thread overview]
Message-ID: <66mtin2olc.fsf@fencepost.gnu.org> (raw)
In-Reply-To: <E1nLHoU-0007Qd-De@fencepost.gnu.org> (Richard Stallman's message of "Fri, 18 Feb 2022 23:57:42 -0500")
My summary would be:
Transient is an Emacs library developed externally to Emacs.
A copy has now been added to Emacs for Emacs 28.
(I assume there is no intent to move development to Emacs.)
It has a manual written in Org format.
The Texinfo file is automatically generated from that Org source.
Originally the Transient manual was not in Emacs at all.
Now the generated Texinfo file has been added to Emacs, but not the
original Org source.
I previously reported a similar case as
Subject: bug#45143: Missing source for some doc/misc manuals?
for the manuals for Org and Modus Themes.
You commented in several messages in Feb 2021, such as
Message-Id: <E1lBsmZ-0004KA-FC@fencepost.gnu.org>
Message-Id: <E1lE4bt-0006mL-5e@fencepost.gnu.org>
Since the generated transient.texi file was added to Emacs, it has been
manually edited, because, as was already known, Texi-generated-from-Org
isn't as good as hand-written Texi.
(I assume there is no intent for the upstream Transient to switch its
manual from being written in Org to being written in Texinfo,
in the same way that neither Org nor Modus Themes did.)
To resolve bug#45143, I implemented Make machinery in Emacs to generate
.texi files for those manuals from their Org sources. (Sadly these changes
were not included in Emacs 27.2, so that release does not IMO
include the preferred form for the Org manual.)
Apparently generating transient.texi from transient.org requires some
changes to Org itself, which currently only exist in upstream Org, not
in Emacs master or release branch. So it isn't possible to generate the
texi file for this package with just the Emacs sources.
prev parent reply other threads:[~2022-02-19 9:27 UTC|newest]
Thread overview: 24+ messages / expand[flat|nested] mbox.gz Atom feed top
2022-01-17 13:07 bug#53316: 28.0.91; Missing Transient manual in Emacs Philipp Stephani
2022-01-21 11:29 ` Lars Ingebrigtsen
2022-01-25 20:30 ` Jonas Bernoulli
2022-01-25 20:41 ` Philipp Stephani
2022-01-25 21:15 ` Jonas Bernoulli
2022-02-15 16:57 ` Jonas Bernoulli
2022-01-26 9:08 ` Michael Albinus
2022-02-15 16:53 ` Jonas Bernoulli
2022-02-15 19:09 ` Eli Zaretskii
2022-02-15 21:39 ` Jonas Bernoulli
2022-02-16 3:25 ` Eli Zaretskii
2022-02-15 20:17 ` Glenn Morris
2022-02-15 21:46 ` Jonas Bernoulli
2022-02-16 21:09 ` Glenn Morris
2022-02-17 6:23 ` Eli Zaretskii
2022-02-19 4:57 ` Richard Stallman
2022-02-19 8:46 ` Eli Zaretskii
2022-02-21 4:34 ` Richard Stallman
2022-02-21 5:47 ` Eli Zaretskii
2022-02-23 6:45 ` Richard Stallman
2022-02-23 12:18 ` Jonas Bernoulli
2022-02-25 5:00 ` Richard Stallman
2022-02-23 12:45 ` Eli Zaretskii
2022-02-19 9:27 ` Glenn Morris [this message]
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=66mtin2olc.fsf@fencepost.gnu.org \
--to=rgm@gnu.org \
--cc=53316@debbugs.gnu.org \
--cc=jonas@bernoul.li \
--cc=larsi@gnus.org \
--cc=p.stephani2@gmail.com \
--cc=rms@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).