From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stephen Leake Newsgroups: gmane.emacs.devel Subject: Re: On being web-friendly and why info must die Date: Sat, 06 Dec 2014 13:06:19 -0600 Message-ID: <85y4qkha38.fsf@stephe-leake.org> References: <20141205123549.GA29331@thyrsus.com> <87mw72lyzs.fsf@earlgrey.lan> <20141205190925.GA5067@thyrsus.com> <20141206061019.GC14890@thyrsus.com> <83ppbx1aag.fsf@gnu.org> <20141206110310.GE19750@thyrsus.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1417892803 21163 80.91.229.3 (6 Dec 2014 19:06:43 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 6 Dec 2014 19:06:43 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 06 20:06:37 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1XxKgf-0006VE-Fd for ged-emacs-devel@m.gmane.org; Sat, 06 Dec 2014 20:06:37 +0100 Original-Received: from localhost ([::1]:55300 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxKge-0000Lw-Ap for ged-emacs-devel@m.gmane.org; Sat, 06 Dec 2014 14:06:36 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:36009) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxKgW-0000LV-SE for emacs-devel@gnu.org; Sat, 06 Dec 2014 14:06:34 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XxKgQ-00015w-GO for emacs-devel@gnu.org; Sat, 06 Dec 2014 14:06:28 -0500 Original-Received: from dnvrco-outbound-snat.email.rr.com ([107.14.73.232]:22751 helo=dnvrco-oedge-vip.email.rr.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxKgQ-00015S-BK for emacs-devel@gnu.org; Sat, 06 Dec 2014 14:06:22 -0500 Original-Received: from [70.94.38.149] ([70.94.38.149:52787] helo=TAKVER) by dnvrco-oedge02 (envelope-from ) (ecelerity 3.5.0.35861 r(Momo-dev:tip)) with ESMTP id 2C/2A-05421-CA353845; Sat, 06 Dec 2014 19:06:20 +0000 In-Reply-To: <20141206110310.GE19750@thyrsus.com> (Eric S. Raymond's message of "Sat, 6 Dec 2014 06:03:10 -0500") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.94 (windows-nt) X-RR-Connecting-IP: 107.14.64.130:25 X-Authority-Analysis: v=2.1 cv=NtdfcqtJ c=1 sm=1 tr=0 a=AppmJ/7ZOOFWL/q6u6u93g==:117 a=AppmJ/7ZOOFWL/q6u6u93g==:17 a=ayC55rCoAAAA:8 a=fNEgcOh0sVsA:10 a=9i_RQKNPAAAA:8 a=Nby5tkL7AAAA:8 a=mDV3o1hIAAAA:8 a=GD3ZO5y_vz6LP08yPNIA:9 a=emHD894NyOgA:10 X-Cloudmark-Score: 0 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 107.14.73.232 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:179205 Archived-At: "Eric S. Raymond" writes: > Eli Zaretskii : >> And also because the index-searching commands, without which you are >> lost in a large manual, don't exist in the Web browsers out there. > > This is not at *all* hard to solve. I have written HTML generators > that produce index links myself in different contexts. I'm not sure that "produce index links" and "index-searching commands" are the same thing; Eli, could you elaborate on what commands you mean? When I browse info, I use M-/ and/or C-s to search the index listings. In any case, Texinfo produces index listings in html format; http://www.gnu.org/software/emacs/manual/html_node/emacs/Key-Index.html#Key-Index Why reinvent this particular wheel? >> And finally because Emacs documentation commands have >> links that go to the respective manual and chapter, but no similar >> features exist for external browsers. > > Generating that kind of link structure from any modern markup is > almost trivial. Sure, it's trivial; so trivial that even Texinfo has it. >> In sum, switching to a Web browser as the means to read documentation >> is a regression. > > Except to pretty much the entire universe of new developers we need to > recruit. We are already meeting that need: http://www.gnu.org/software/emacs/manual/ I've added that link to ./CONTRIBUTE; where else does it need to be? -- -- Stephe