From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: David Kastrup Newsgroups: gmane.emacs.devel Subject: Re: On being web-friendly and why info must die Date: Sat, 06 Dec 2014 10:48:30 +0100 Organization: Organization?!? Message-ID: <87r3wdp0r5.fsf@fencepost.gnu.org> References: <20141205123549.GA29331@thyrsus.com> <87mw72lyzs.fsf@earlgrey.lan> <20141205190925.GA5067@thyrsus.com> <20141206061019.GC14890@thyrsus.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1417859346 18319 80.91.229.3 (6 Dec 2014 09:49:06 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 6 Dec 2014 09:49:06 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 06 10:49:00 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 1XxBz2-0000Ou-8w for ged-emacs-devel@m.gmane.org; Sat, 06 Dec 2014 10:49:00 +0100 Original-Received: from localhost ([::1]:53889 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxBz1-0006nG-Tr for ged-emacs-devel@m.gmane.org; Sat, 06 Dec 2014 04:48:59 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:32983) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxByu-0006n4-Bx for emacs-devel@gnu.org; Sat, 06 Dec 2014 04:48:57 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XxByo-0003j9-RO for emacs-devel@gnu.org; Sat, 06 Dec 2014 04:48:52 -0500 Original-Received: from plane.gmane.org ([80.91.229.3]:59192) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxByo-0003j3-K3 for emacs-devel@gnu.org; Sat, 06 Dec 2014 04:48:46 -0500 Original-Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1XxByl-0000Gq-1C for emacs-devel@gnu.org; Sat, 06 Dec 2014 10:48:43 +0100 Original-Received: from x2f51fab.dyn.telefonica.de ([2.245.31.171]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sat, 06 Dec 2014 10:48:43 +0100 Original-Received: from dak by x2f51fab.dyn.telefonica.de with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Sat, 06 Dec 2014 10:48:43 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 58 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: x2f51fab.dyn.telefonica.de X-Face: 2FEFf>]>q>2iw=B6, xrUubRI>pR&Ml9=ao@P@i)L:\urd*t9M~y1^:+Y]'C0~{mAl`oQuAl \!3KEIp?*w`|bL5qr,H)LFO6Q=qx~iH4DN; i"; /yuIsqbLLCh/!U#X[S~(5eZ41to5f%E@'ELIi$t^ Vc\LWP@J5p^rst0+('>Er0=^1{]M9!p?&:\z]|;&=NP3AhB!B_bi^]Pfkw User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) Cancel-Lock: sha1:ivVYr0al6balxzf5MTXdrtKPLzQ= X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 80.91.229.3 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:179127 Archived-At: "Eric S. Raymond" writes: > Stefan Monnier : >> But I can't help point out that there are 2 issues: the source format. >> And the doc-viewer (which may or may not require translation of the >> source format to some other format). > > The doc viewer would be a web browser. A web browser is not at my fingertips when I am working. Emacs is. A web browser's display colors and fonts are optimized for prettiness rather than efficiency and systematic navigation is not the first thing on its mind. As opposed to Info. > We don't have to solve that problem - not having a separate doc viewer > would be the point of the change, technically speaking. As long as the other viewers suck so much, that's not a point in favor. I actually do the proofreading of LilyPond web pages (which are generated from Texinfo) in the Info rendition. And that's also what I use to look up any other documentation. I have pointed out the LilyPond documentation and web presence several times in this thread, and you have ignored it. If you are unable to point out any inherent deficiencies with it according to your "shiny is better" metrics, it would appear that Texinfo-generated HTML is not problematic as such. >> Until there is a documentation viewer available in Elisp that is almost >> as good as Info-mode while being prettier, > > Does a web browser not qualify? If not, why not? You are not being serious? Instant response, permuted indexes with autocompletion that are a keypress away, instantaneous document-wide search (even while only one node is actively displayed at any time). I frequently point people to particular nodes of our online HTML manuals that could answer their question. The way I do that is to find the information in Info, then copy&paste some recognizably unique text phrase into a web search engine, check that the reference this turns up is the corresponding online version of the Info manual and then post the HTML link. There is no mechanism that will get me results straight from HTML without at least a tenfold investment of time and effort. There are search boxes and indexes in the HTML version as well but they are much much more cumbersome (for using the indexes) and/or with worse results (for using the search box). The only meaningful way to use browser search is to look in a "single-page" version, and that costs a bunch of rendering time, and try dragging a scrollbar on some document a few hundred pages long. Navigation becomes really awkward. -- David Kastrup