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 Date: Thu, 02 Jan 2025 23:32:11 -0500 Message-ID: References: <87ser8c230.fsf@jeremybryant.net> <86ser87rut.fsf@gnu.org> <871pygyjqt.fsf_-_@gmail.com> <87zfl2mhoz.fsf@gmail.com> <878qruqm8w.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="29090"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Suhail Singh Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Jan 03 05:33:11 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 1tTZN0-0007SK-VO for ged-emacs-devel@m.gmane-mx.org; Fri, 03 Jan 2025 05:33:11 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tTZM7-0003td-3R; Thu, 02 Jan 2025 23:32:15 -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 1tTZM4-0003tC-LN for emacs-devel@gnu.org; Thu, 02 Jan 2025 23:32:12 -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 1tTZM4-0005Jg-DD; Thu, 02 Jan 2025 23:32:12 -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=G9WXelcTg9V/ee4qUfgqoV+GYhkkBOr43fp8E2D1VJs=; b=RaCd1wtvqSVp dnJuClQFG7XffGvlMdclo6XgkrZA/tyf/IBC2SEIgpxb4F7JrF6M2ghvbEITbJjEfUdQFq+WthBNe k3YmMS3LB+VHMfVb9Qx3sfbzPcX9qJS2l+zRQvhHcbRf43f9e0nwGBMcQvAx/t2heFPLUcYdlV+YY TIgRzSy3zQlYoGqfy/EBVFgh2eLk3peIahfQqCJXwlfShp45zmBTqj9o2hVe8KgQuO5bJMSGe6wXA al686fLlptZXf8ymHC2IDFd3JJhSdZMeDc3DbhQk/C1wqtR2sAjGB1jBV0soB+5ToJL3VIdCtVuMK Kx/1rKwrjKCJ5izkMbU2Vw==; Original-Received: from rms by fencepost.gnu.org with local (Exim 4.90_1) (envelope-from ) id 1tTZM3-00019s-V6; Thu, 02 Jan 2025 23:32:11 -0500 In-Reply-To: <878qruqm8w.fsf@gmail.com> (message from Suhail Singh on Wed, 01 Jan 2025 16:04:31 -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:327605 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. ]]] > To paraphrase, the user-facing features that would no longer work with > such "visibly wrong" translated-from-other-formats Info manuals is the > ability to generate output that looks similar in one output format while > looking different in other output formats. Yes, that's it. > 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? That half-measured approach is better than nothing, but I would like to see the adoption of a _good_ solution that does the whole job well. -- 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)