From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: =?utf-8?Q?Bj=C3=B6rn?= Bidar Newsgroups: gmane.emacs.devel Subject: Re: Improve access to documentation in Info format Date: Sat, 04 Jan 2025 02:55:51 +0200 Message-ID: <25489.7838503652$1735952209@news.gmane.org> References: <87ser8c230.fsf@jeremybryant.net> <86ser87rut.fsf@gnu.org> <871pygyjqt.fsf_-_@gmail.com> <87zfl2mhoz.fsf@gmail.com> <878qruqm8w.fsf@gmail.com> <871pxk8o1e.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="34230"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: Richard Stallman , emacs-devel@gnu.org To: Suhail Singh Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Jan 04 01:56:41 2025 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1tTsT2-0008iJ-C2 for ged-emacs-devel@m.gmane-mx.org; Sat, 04 Jan 2025 01:56:40 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tTsSO-0006z0-Mj; Fri, 03 Jan 2025 19:56:00 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tTsSM-0006yp-Fl for emacs-devel@gnu.org; Fri, 03 Jan 2025 19:55:58 -0500 Original-Received: from thaodan.de ([185.216.177.71]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tTsSK-0003qd-Oy; Fri, 03 Jan 2025 19:55:58 -0500 Original-Received: from odin (dsl-trebng12-50dc7b-49.dhcp.inet.fi [80.220.123.49]) by thaodan.de (Postfix) with ESMTPSA id 3A4BFD00049; Sat, 4 Jan 2025 02:55:52 +0200 (EET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=thaodan.de; s=mail; t=1735952152; bh=4s2CKDkwBODsTqipaPRJ5v6Ty2gVnqCMn+lJrcXp/QM=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=ovd7CiS3ySGB6vW56JfxOCm2EXSZUhyBjvVbENTX3E2C7GX1DUkW05M155ncfpPMv 0hfyFbObroFKglur7lGlXTpi6CjaB1gTm+FJJZWN/bN7TGeEqZr9eMgREuuNa1A/2P lyeopFplD0EB5dS+6sCsYTJT/m4R9Pk86xtwz6Ts32hlQtiq/XIzmApqKstbk7uvRA tU2B4QOQgia0HqqmddJpnWTLP9UTywXJ43cWjCYyWi/2XJgiPJuUnLaW7KdDmNAXmI F+LVOdBHJgzYbWlxmmUqIi1/fYuAfX0MhxhmmZ1ueH7/k+FsCGYVvCgMxJiBSkWaZy RXq1YOn6SzSlPNnJJ4mt5YR5bQrIowPcjfRnyeFzA4mpnQdg+uGCujaKTB1bQa9UIV HO2mMJq/Ml/4NtbhsqdjWtwmyJiWdQZ9RPNuIZaZNci9KEiA0VFJ1xmc5he+I6v06V q1pJsnwmcfC89k47mi4WnTp4odWHRObdmVDhOlmwiOdUgECD9hWsYxzsqCSCJhQMRJ B9vEIbqtlkp7kGxuQ9oZV7CFi+MneIdmE/3oTflwpEkd1L3EwLR618UtD4vVv/13XP PEp25IH1DG0sjkkr5Ir0cyYXK+57k7c8mx/lr3EArSJC/CcwyKo31KCPl8MrUwqXNk bokoF7pkFS9qHhuVAGZAtV9E= In-Reply-To: <871pxk8o1e.fsf@gmail.com> (Suhail Singh's message of "Fri, 03 Jan 2025 00:27:41 -0500") Autocrypt: addr=bjorn.bidar@thaodan.de; prefer-encrypt=nopreference; keydata= mDMEZNfpPhYJKwYBBAHaRw8BAQdACBEmr+0xwIIHZfIDlZmm7sa+lHHSb0g9FZrN6qE6ru60JUJq w7ZybiBCaWRhciA8Ympvcm4uYmlkYXJAdGhhb2Rhbi5kZT6IlgQTFgoAPgIbAwULCQgHAgIiAgYV CgkICwIEFgIDAQIeBwIXgBYhBFHxdut1RzAepymoq1wbdKFlHF9oBQJk1/YmAhkBAAoJEFwbdKFl HF9oB9cBAJoIIGQKXm4cpap+Flxc/EGnYl0123lcEyzuduqvlDT0AQC3OlFKm/OiqJ8IMTrzJRZ8 phFssTkSrrFXnM2jm5PYDoiTBBMWCgA7FiEEUfF263VHMB6nKairXBt0oWUcX2gFAmTX6T4CGwMF CwkIBwICIgIGFQoJCAsCBBYCAwECHgcCF4AACgkQXBt0oWUcX2hbCQEAtru7kvM8hi8zo6z9ux2h K+B5xViKuo7Z8K3IXuK5ugwA+wUfKzomzdBPhfxDsqLcEziGRxoyx0Q3ld9aermBUccHtBxCasO2 cm4gQmlkYXIgPG1lQHRoYW9kYW4uZGU+iJMEExYKADsCGwMFCwkIBwICIgIGFQoJCAsCBBYCAwEC HgcCF4AWIQRR8XbrdUcwHqcpqKtcG3ShZRxfaAUCZNf2FQAKCRBcG3ShZRxfaCzSAP4hZ7cSp0YN XYpcjHdsySh2MuBhhoPeLGXs+2kSiqBiOwD/TP8AgPEg/R+SI9GI9on7fBJJ0mp2IT8kZ2rhDOjg gA6IkwQTFgoAOxYhBFHxdut1RzAepymoq1wbdKFlH Received-SPF: pass client-ip=185.216.177.71; envelope-from=bjorn.bidar@thaodan.de; helo=thaodan.de X-Spam_score_int: -14 X-Spam_score: -1.5 X-Spam_bar: - X-Spam_report: (-1.5 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, INVALID_MSGID=0.568, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:327642 Archived-At: Suhail Singh writes: > Richard Stallman 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. If we want to improve info in general, Emacs package.el repositories are not the best option. It should be easy to package the missing manuals for the major package formats and possibly provide packages for other distribution which don't include the manuals. The last option would be to provide download options for the info files. Fixing the license of the manuals would also go a long way of including these manuals. Trying to use the resources of the FSF to reach out and try to rectify such long standing issues would help very much. Such things are not possible for individual contributors I'd say. > 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. > Emacs specific.