From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: docstrings and elisp reference Date: Fri, 09 Jun 2017 10:08:34 +0300 Message-ID: <83poed7i4t.fsf@gnu.org> References: <0BB64F35-233A-471F-B99F-51F96C4E6CCB@gmail.com> <8360g99n07.fsf@gnu.org> <86lgp4q2xa.fsf@stephe-leake.org> <7acc7d4f-23cc-4b6a-b062-ef92805e465b@default> <878tl3rz38.fsf@x230.lts> <877f0ln3dx.fsf@x230.lts> Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: blaine.gmane.org 1496992134 10137 195.159.176.226 (9 Jun 2017 07:08:54 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Fri, 9 Jun 2017 07:08:54 +0000 (UTC) Cc: stephen_leake@stephe-leake.org, rms@gnu.org, drew.adams@oracle.com, emacs-devel@gnu.org To: Etienne =?utf-8?Q?Prud=E2=80=99homme?= Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jun 09 09:08:46 2017 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dJE2I-0002Ek-Fx for ged-emacs-devel@m.gmane.org; Fri, 09 Jun 2017 09:08:46 +0200 Original-Received: from localhost ([::1]:53135 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dJE2N-0003ww-IC for ged-emacs-devel@m.gmane.org; Fri, 09 Jun 2017 03:08:51 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39259) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dJE2H-0003wq-TP for emacs-devel@gnu.org; Fri, 09 Jun 2017 03:08:46 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dJE2E-0003I3-Px for emacs-devel@gnu.org; Fri, 09 Jun 2017 03:08:45 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:35886) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dJE2E-0003Hy-MM; Fri, 09 Jun 2017 03:08:42 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:1846 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1dJE27-0003er-7e; Fri, 09 Jun 2017 03:08:35 -0400 In-reply-to: <877f0ln3dx.fsf@x230.lts> (message from Etienne =?utf-8?Q?Pru?= =?utf-8?Q?d=E2=80=99homme?= on Fri, 09 Jun 2017 01:20:26 -0400) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:215538 Archived-At: > From: Etienne Prud’homme > Date: Fri, 09 Jun 2017 01:20:26 -0400 > Cc: stephen_leake@stephe-leake.org, drew.adams@oracle.com, emacs-devel@gnu.org I think I've said enough in this thread, so just 2 more comments: > That is where _most_ GNU projects seem to lack the capability. It looks > like Jean-Christophe was right in pointing out it might be because we’re > not using HTML exporting templates at its best. > > GNU projects are usually harder to index because of that. Thus we have > a minority of GNU tools listed. I’m not saying that for criticizing > GNU, but I think it’s an important issue we could address in the near > future. Texinfo can produce HTML (which can be customized) and XML from the Texinfo sources. These facilities can be used to enhance the "indexing" (I'd call it "tagging" instead, to discern from the indices we have in the manuals) of the produced documentation, if that is the feature you think is missing in the Info manuals. Then preparing a document in the structure you want for any GNU project should be very easy. It's possible that the Texinfo language might need some additions to support some of that, but that should be no problem, given the active development of the Texinfo package. > Of course, this discussion is about Emacs. And therein is my second issue: reading the Bash and the ELisp manuals in Zeal, I'm presented with exactly the same contents as when I read them in Emacs's Info. IOW, what I have in Zeal is an Info browser without the index-searching facilities which make Info so efficient for me. So for me, and especially in the context of Emacs, it makes very little sense to talk about these browsers, because they seem to give be a subset of what we already have in Info. Perhaps I'm missing something important.