From: Suhail Singh <suhailsingh247@gmail.com>
To: Richard Stallman <rms@gnu.org>
Cc: "Björn Bidar" <bjorn.bidar@thaodan.de>, emacs-devel@gnu.org
Subject: Improve access to documentation in Info format (was: Proposal: Include C Manual from RMS in Emacs git, and/or release)
Date: Mon, 09 Dec 2024 10:11:06 -0500 [thread overview]
Message-ID: <871pygyjqt.fsf_-_@gmail.com> (raw)
In-Reply-To: <E1tK9Z2-0006ZB-59@fencepost.gnu.org> (Richard Stallman's message of "Sun, 08 Dec 2024 00:10:40 -0500")
Richard Stallman <rms@gnu.org> writes:
> Should we recruit people to package it for various kinds of distros?
While I am unable to volunteer time for this, I can nevertheless point
out two constructive steps that could be taken that would improve
matters for users. In no particular order:
1. Providing an "easy" way for users to see available info manuals and
install them. Easiness here is defined in terms of number of
invocations (either in Bash or within Emacs) that are necessary for
users to either view the list of available manuals or to install some
of them. This could be done by spending development effort to
provide packages for various distributions. Alternatively, effort
could perhaps be better utilized by packaging the existing info
manuals into a (relatively) distribution-agnostic packaging system
such as, say, Guix or GNU ELPA or NonGNU ELPA.
2. Make it easier to generate and perhaps also provide, via 1, Info
manuals for packages that use other documentation generation systems.
A popular candidate to target in this regard is Sphinx. Sphinx has
some existing support, IIUC, to generate Texinfo output. However,
that generation can, at times, have warts/bugs. My understanding is
that resolution of these bugs isn't prioritized by the existing
Sphinx community. It is possible that they simply aren't aware of
these issues. Investing effort into reporting and resolving such
issues to improve Sphinx's support for output in Texinfo format would
help.
--
Suhail
next prev parent reply other threads:[~2024-12-09 15:11 UTC|newest]
Thread overview: 109+ messages / expand[flat|nested] mbox.gz Atom feed top
2024-11-30 12:56 Proposal: Include C Manual from RMS in Emacs git, and/or release Jeremy Bryant
2024-11-30 13:25 ` Philip Kaludercic
2024-11-30 13:38 ` Arsen Arsenović
2024-11-30 14:12 ` Eli Zaretskii
2024-11-30 18:08 ` Arsen Arsenović
2024-11-30 20:05 ` Eli Zaretskii
2024-11-30 21:09 ` [External] : " Drew Adams
2024-12-01 6:15 ` Eli Zaretskii
2024-12-02 3:00 ` Texinfo reputation (was: Re: [External] : Re: Proposal: Include C Manual from RMS in Emacs git, and/or release) Max Nikulin
2024-12-02 12:47 ` Eli Zaretskii
2024-12-03 2:51 ` Texinfo reputation Max Nikulin
2024-12-03 12:38 ` Eli Zaretskii
2024-12-03 18:51 ` Dr. Arne Babenhauserheide
2024-12-05 4:56 ` Max Nikulin
2024-12-05 7:45 ` Dr. Arne Babenhauserheide
2024-12-06 4:47 ` Richard Stallman
2024-12-01 9:53 ` Proposal: Include C Manual from RMS in Emacs git, and/or release Arsen Arsenović
2024-12-01 10:12 ` Eli Zaretskii
2024-12-01 10:54 ` Arsen Arsenović
2024-12-01 13:04 ` Johan Myréen
2024-12-04 6:09 ` Richard Stallman
2024-11-30 13:50 ` Eli Zaretskii
2024-12-01 4:02 ` Sean Whitton
2024-12-01 7:45 ` Eli Zaretskii
2024-12-01 8:36 ` Sean Whitton
2024-12-01 10:01 ` Eli Zaretskii
2024-12-01 11:13 ` Sean Whitton
2024-12-05 5:05 ` Making the GNU C Manual easier to find in Info Richard Stallman
2024-12-05 6:30 ` Eli Zaretskii
2024-12-05 7:25 ` Integration of Info manuals in programming modes; was: " Dr. Arne Babenhauserheide
2024-12-05 7:46 ` Integration of Info manuals in programming modes Eli Zaretskii
2024-12-05 8:52 ` Visuwesh
2024-12-05 9:14 ` Eli Zaretskii
2024-12-05 9:49 ` Visuwesh
2024-12-05 11:17 ` Eli Zaretskii
2024-12-05 11:28 ` Visuwesh
2024-12-05 12:01 ` Eli Zaretskii
2024-12-05 12:39 ` Visuwesh
2024-12-05 14:26 ` Eli Zaretskii
2024-12-15 8:26 ` Visuwesh
2024-12-08 8:13 ` Integration of Info manuals in programming modes, " James Thomas
2024-12-08 8:38 ` James Thomas
2024-12-08 11:34 ` Eli Zaretskii
2024-12-08 20:10 ` Björn Bidar
[not found] ` <86msh5b48w.fsf@gmx.net>
2024-12-10 1:08 ` James Thomas
[not found] ` <87zfl60wbw.fsf@>
2024-12-08 20:46 ` Eli Zaretskii
2024-12-11 4:32 ` Richard Stallman
2024-12-13 23:54 ` Björn Bidar
[not found] ` <87msgzp2a9.fsf@>
2024-12-14 19:11 ` Dr. Arne Babenhauserheide
2024-12-16 4:02 ` Richard Stallman
2024-12-05 10:06 ` Stephen Berman
2024-12-05 15:07 ` Dr. Arne Babenhauserheide
2024-12-05 16:04 ` Eli Zaretskii
2024-12-09 4:58 ` Integration of Info manuals in programming modes; was: Making the GNU C Manual easier to find in Info Richard Stallman
2024-12-09 22:49 ` Dr. Arne Babenhauserheide
2024-12-11 4:35 ` Richard Stallman
2024-12-02 4:10 ` Proposal: Include C Manual from RMS in Emacs git, and/or release Richard Stallman
2024-12-02 12:57 ` Eli Zaretskii
2024-12-03 23:03 ` [ELPA] New package c-intro-and-ref -- was " Jeremy Bryant
2024-12-04 12:33 ` Eli Zaretskii
2024-12-04 22:58 ` Jeremy Bryant
2024-12-05 5:45 ` Eli Zaretskii
2024-12-07 13:30 ` Improving info-look.el for (c) -was- " Jeremy Bryant
2024-12-07 15:09 ` Eli Zaretskii
2024-12-05 5:03 ` Max Nikulin
2024-12-05 18:47 ` Philip Kaludercic
2024-12-05 19:04 ` Eli Zaretskii
2024-12-06 10:44 ` Philip Kaludercic
2024-12-06 12:10 ` Eli Zaretskii
2024-12-06 22:40 ` Philip Kaludercic
2024-12-05 19:17 ` Stefan Monnier
2024-12-05 20:35 ` chad
2024-12-06 4:57 ` Visuwesh
2024-12-06 10:42 ` Philip Kaludercic
2024-12-06 14:58 ` Max Nikulin
2024-12-06 16:30 ` Eli Zaretskii
2024-12-08 16:41 ` Max Nikulin
2024-12-08 5:15 ` Richard Stallman
2024-12-08 7:15 ` Xiyue Deng
2024-12-08 16:50 ` Max Nikulin
2024-12-11 4:32 ` Richard Stallman
2024-12-12 3:22 ` Debian package with GNU manuals (was: Re: [ELPA] New package c-intro-and-ref) Max Nikulin
2024-12-04 20:02 ` [ELPA] New package c-intro-and-ref -- was Re: Proposal: Include C Manual from RMS in Emacs git, and/or release Suhail Singh
[not found] ` <87wmgf9h70.fsf@jeremybryant.net>
2024-12-04 23:52 ` Suhail Singh
2024-12-07 13:21 ` Jeremy Bryant
2024-12-08 20:44 ` Suhail Singh
2024-12-07 4:22 ` Richard Stallman
2024-12-07 12:29 ` Jeremy Bryant
2024-12-07 14:55 ` Björn Bidar
[not found] ` <87h67fr18v.fsf@>
2024-12-10 5:38 ` Richard Stallman
2024-12-13 23:44 ` Björn Bidar
[not found] ` <87r06bp2qm.fsf@>
2024-12-14 21:19 ` Dr. Arne Babenhauserheide
2024-12-15 6:31 ` Eli Zaretskii
2024-12-16 4:02 ` Richard Stallman
2024-12-05 5:05 ` Richard Stallman
2024-12-05 6:27 ` Eli Zaretskii
2024-12-03 20:07 ` Björn Bidar
[not found] ` <87cyi8h6n8.fsf@>
2024-12-07 16:02 ` Björn Bidar
2024-12-08 5:10 ` Richard Stallman
2024-12-08 20:07 ` Björn Bidar
2024-12-09 15:11 ` Suhail Singh [this message]
2024-12-11 4:37 ` Improve access to documentation in Info format (was: Proposal: Include C Manual from RMS in Emacs git, and/or release) Richard Stallman
2024-12-11 14:13 ` Improve access to documentation in Info format Suhail Singh
2024-12-13 23:41 ` Björn Bidar
[not found] ` <87v7vnp2vx.fsf@>
2024-12-14 21:16 ` Dr. Arne Babenhauserheide
2024-12-16 4:03 ` Richard Stallman
2024-12-16 4:03 ` Richard Stallman
[not found] ` <874j3e2b2i.fsf@>
2024-12-11 4:32 ` Proposal: Include C Manual from RMS in Emacs git, and/or release Richard Stallman
2024-12-08 23:03 ` John ff
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
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=871pygyjqt.fsf_-_@gmail.com \
--to=suhailsingh247@gmail.com \
--cc=bjorn.bidar@thaodan.de \
--cc=emacs-devel@gnu.org \
--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 external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.