From: Suhail Singh <suhailsingh247@gmail.com>
To: Richard Stallman <rms@gnu.org>
Cc: Suhail Singh <suhailsingh247@gmail.com>, emacs-devel@gnu.org
Subject: Re: Improve access to documentation in Info format
Date: Fri, 03 Jan 2025 00:27:41 -0500 [thread overview]
Message-ID: <871pxk8o1e.fsf@gmail.com> (raw)
In-Reply-To: <E1tTZM3-00019s-V6@fencepost.gnu.org> (Richard Stallman's message of "Thu, 02 Jan 2025 23:32:11 -0500")
Richard Stallman <rms@gnu.org> writes:
> > Agreed, natural markup may not be a substitute for Texinfo. And yet,
> > there may still be utility in providing _best effort_ but "visibly
> > wrong" Info manuals for packages that use other documentation generation
> > systems (for instance, Sphinx).
>
> I agree -- and isn't this what they do now?
It depends on who you mean by "they".
If by "they" you mean packagers, then no that is not what generally
happens. If by "they" you mean users who are interested in perusing
documentation in Info format, then they _could_ do so, but that misses
the "value" I was alluding to - which was about making something which
is possible today, convenient (as opposed to making something that's not
possible today, possible).
However, going back to our exchange from a few responses before, if we
make progress on [1] then the above (access to Info manuals generated by
translating-from-other-formats) would also improve over time.
[1]: Providing an "easy" way for users to see available info manuals and
install them.
You suggested:
> The way I see is involves two steps:
>
> a, Set up some sort of download repo with all the Info manuals.
A candidate for this could be an ELPA repository (say, NonGNU ELPA).
Alternatively, this could be the main Guix channel (or another Guix
channel).
Of these the easiest (from an Emacs user's perspective) would be an ELPA
repository. Note that having these be collected in an ELPA archive
wouldn't preclude them also being packaged in Guix (as happens today
with various Emacs packages available on various ELPA repositories).
Packages from NonGNU ELPA are easily available for users to install in
recent versions of Emacs. Further, since NonGNU ELPA doesn't seek
copyright assignment from packages, it is more suited to the goal at
hand.
Are there reasons why NonGNU ELPA wouldn't be a good place to host such
Info manuals?
> b. Write software to find the desired manual, fetch it, and install it
> on your computer.
If the Info manuals were hosted on NonGNU ELPA, then package.el already
provides this.
> Would people like tp vplunteer to work on this?
To this end, would it be sufficient if people volunteered packages (that
provide Info manuals) to NonGNU ELPA?
--
Suhail
next prev parent reply other threads:[~2025-01-03 5:27 UTC|newest]
Thread overview: 118+ 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 ` Improve access to documentation in Info format (was: Proposal: Include C Manual from RMS in Emacs git, and/or release) Suhail Singh
2024-12-11 4:37 ` Richard Stallman
2024-12-11 14:13 ` Improve access to documentation in Info format Suhail Singh
2025-01-01 4:08 ` Richard Stallman
2025-01-01 21:04 ` Suhail Singh
2025-01-03 4:32 ` Richard Stallman
2025-01-03 5:27 ` Suhail Singh [this message]
2025-01-04 0:55 ` Björn Bidar
[not found] ` <67788718.170a0220.116636.4451SMTPIN_ADDED_BROKEN@mx.google.com>
2025-01-04 1:28 ` Suhail Singh
2025-01-04 2:20 ` Björn Bidar
[not found] ` <67789ad4.050a0220.196b31.88fdSMTPIN_ADDED_BROKEN@mx.google.com>
2025-01-04 2:57 ` Suhail Singh
2025-01-05 4:16 ` Richard Stallman
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
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=871pxk8o1e.fsf@gmail.com \
--to=suhailsingh247@gmail.com \
--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 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).