From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel Subject: Re: master 2a7488d: Add support for displaying short documentation for function groups Date: Mon, 19 Oct 2020 11:05:19 +0300 Organization: LINKOV.NET Message-ID: <874kmqiqoc.fsf@mail.linkov.net> References: <20201011035127.7723.3256@vcs0.savannah.gnu.org> <20201011035128.E3FD320667@vcs0.savannah.gnu.org> <87k0vxquvo.fsf@gnus.org> <87eem2ey3n.fsf@mail.linkov.net> <87a6wp1m4p.fsf@gnus.org> <87k0vt5jol.fsf@mail.linkov.net> <875z7c0z1d.fsf@gnus.org> <87v9f7coc2.fsf@mail.linkov.net> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="30143"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (x86_64-pc-linux-gnu) Cc: larsi@gnus.org, monnier@iro.umontreal.ca, emacs-devel@gnu.org To: Richard Stallman Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Oct 19 10:16:35 2020 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 1kUQLK-0007hp-L4 for ged-emacs-devel@m.gmane-mx.org; Mon, 19 Oct 2020 10:16:34 +0200 Original-Received: from localhost ([::1]:50288 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kUQLI-0004WK-La for ged-emacs-devel@m.gmane-mx.org; Mon, 19 Oct 2020 04:16:32 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:59472) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kUQJl-0003AL-HG for emacs-devel@gnu.org; Mon, 19 Oct 2020 04:14:57 -0400 Original-Received: from relay8-d.mail.gandi.net ([217.70.183.201]:35381) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kUQJj-0007PE-PC; Mon, 19 Oct 2020 04:14:57 -0400 X-Originating-IP: 91.129.102.160 Original-Received: from mail.gandi.net (m91-129-102-160.cust.tele2.ee [91.129.102.160]) (Authenticated sender: juri@linkov.net) by relay8-d.mail.gandi.net (Postfix) with ESMTPSA id 8B2CD1BF20C; Mon, 19 Oct 2020 08:14:51 +0000 (UTC) In-Reply-To: (Richard Stallman's message of "Sun, 18 Oct 2020 23:47:04 -0400") Received-SPF: pass client-ip=217.70.183.201; envelope-from=juri@linkov.net; helo=relay8-d.mail.gandi.net X-detected-operating-system: by eggs.gnu.org: First seen = 2020/10/19 04:14:45 X-ACL-Warn: Detected OS = Linux 3.11 and newer [fuzzy] X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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" Xref: news.gmane.io gmane.emacs.devel:258099 Archived-At: > > For example, with a dynamically generated Info manual with groups of functions > > and the addressing scheme such as (info "(shortdoc) regexp functions"), > > would the users of the standalone Info reader expect that visiting > > the same Info location should produce the same documentation to them > > in the standalone Info reader? > > I think it ought to work for that if possible. > > Why can't the dynamically generated manual be written into Info files > which are then accessible in all the usual ways? It would require an additional step of running 'make' to update the generated manuals, whereas most Help commands have the advantage of immediately displaying the most recent information. However, the Emacs Info reader could display the most recent information, but for the users of the standalone Info read we could write that into Info files.