unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
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.





      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).