From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: Improve access to documentation in Info format (was: Proposal: Include C Manual from RMS in Emacs git, and/or release) Date: Tue, 10 Dec 2024 23:37:21 -0500 Message-ID: References: <87ser8c230.fsf@jeremybryant.net> <86ser87rut.fsf@gnu.org> <871pygyjqt.fsf_-_@gmail.com> Reply-To: rms@gnu.org Content-Type: text/plain; charset=Utf-8 Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="13699"; mail-complaints-to="usenet@ciao.gmane.io" Cc: bjorn.bidar@thaodan.de, emacs-devel@gnu.org To: Suhail Singh Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Dec 11 05:37:30 2024 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 1tLETa-0003OX-En for ged-emacs-devel@m.gmane-mx.org; Wed, 11 Dec 2024 05:37:30 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tLETV-0006xM-Im; Tue, 10 Dec 2024 23:37:25 -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 1tLETT-0006wt-Ik for emacs-devel@gnu.org; Tue, 10 Dec 2024 23:37:23 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tLETT-0004vh-3V; Tue, 10 Dec 2024 23:37:23 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=Date:References:Subject:In-Reply-To:To:From: mime-version; bh=BbcZaGoOCKKNL/+m954lsPwzRY8Spd75WJo4tFIcivw=; b=ZeeT6jUD6Gj4 1sHaVdqj63c8DN1DqL/plvZOVsqOxR58dH8SP+P3OFWw4kfbFQpw0d7o2yLatHPHEgKlq4dmNia7i sfdiP/GAOs2ll8KAk9odWAuhfKinib/IwdZNUrV9GmA1tngzyX7rdlYN7ipq4Q2qNXNo0lV23iBpZ Q5bAmcC4IVeoEOIJOXABp5NDRuoBdqFBRvHyXxxOYa9weCP5Gb03Ia14YLCU3xeua9EXDcWYjcg+o WzC74Qj/mzwaFuSp+AI593JlGHzAqiO4vVNHGNaqIxuzRQbqZGbLvjxtjLvIvBC1X4GZfIj8EaOm9 k8BUoqNVSOfT3T/taFB3Ww==; Original-Received: from rms by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1tLETR-0001ha-NQ; Tue, 10 Dec 2024 23:37:22 -0500 In-Reply-To: <871pygyjqt.fsf_-_@gmail.com> (message from Suhail Singh on Mon, 09 Dec 2024 10:11:06 -0500) 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:326325 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > 1. Providing an "easy" way for users to see available info manuals and > install them. I think we should be able to do this. The way I see is involves two steps: a, Set up some sort of download repo with all the Info manuals. b. Write software to find the desired manual, fetch it, and install it on your computer. Would people like tp vplunteer to work on this? > 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. In principle I think this is a good idea, but there is a technical difficulty: it is impossible to produce a fully correct Info manual from those other formats. because those other formats do not make the necessary distincions. It would not be terribly hard to write software which would do this job _as well as could be done given the current formats_, but the results will be visibly wrong. What would be terribly hard is to do a better job than that. -- Dr Richard Stallman (https://stallman.org) Chief GNUisance of the GNU Project (https://gnu.org) Founder, Free Software Foundation (https://fsf.org) Internet Hall-of-Famer (https://internethalloffame.org)