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: Thu, 11 Dec 2014 09:54:12 +0100 Organization: Organization?!? Message-ID: <87d27qin2j.fsf@fencepost.gnu.org> References: <20141205123549.GA29331@thyrsus.com> <54823617.4000406@cs.ucla.edu> <83k325195l.fsf@gnu.org> <5482D94B.2070102@cs.ucla.edu> <5484FF31.5010808@cs.ucla.edu> <5485FC59.5030700@cs.ucla.edu> <87388p6glt.fsf@engster.org> <871to9lw6g.fsf@fencepost.gnu.org> <5486A704.6090305@cs.ucla.edu> <87k321jj4e.fsf@fencepost.gnu.org> <54876F7F.9000607@cs.ucla.edu> <87y4qfj2u9.fsf@fencepost.gnu.org> <54889A57.5060905@cs.ucla.edu> <87vbljb9f4.fsf@wanadoo.es> <54889F6D.6060408@cs.ucla.edu> <87r3w7b83a.fsf@wanadoo.es> <5488C710.3000209@cs.ucla.edu> <871to7ayv9.fsf@wanadoo.es> <5488DC0C.2070402@cs.ucla.edu> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Trace: ger.gmane.org 1418288102 16071 80.91.229.3 (11 Dec 2014 08:55:02 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 11 Dec 2014 08:55:02 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Dec 11 09:54:55 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 1XyzWQ-00016F-Un for ged-emacs-devel@m.gmane.org; Thu, 11 Dec 2014 09:54:55 +0100 Original-Received: from localhost ([::1]:49846 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XyzWQ-0006GN-8d for ged-emacs-devel@m.gmane.org; Thu, 11 Dec 2014 03:54:54 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:32874) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XyzW7-0006GF-Di for emacs-devel@gnu.org; Thu, 11 Dec 2014 03:54:41 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XyzW1-00046M-CH for emacs-devel@gnu.org; Thu, 11 Dec 2014 03:54:35 -0500 Original-Received: from plane.gmane.org ([80.91.229.3]:49242) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XyzW1-00046I-5k for emacs-devel@gnu.org; Thu, 11 Dec 2014 03:54:29 -0500 Original-Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1XyzVx-0000oW-Vi for emacs-devel@gnu.org; Thu, 11 Dec 2014 09:54:26 +0100 Original-Received: from x2f3c047.dyn.telefonica.de ([2.243.192.71]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 11 Dec 2014 09:54:25 +0100 Original-Received: from dak by x2f3c047.dyn.telefonica.de with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 11 Dec 2014 09:54:25 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 31 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: x2f3c047.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:t/diBUB1vdj5mhfYWjmBhsrl3V8= 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:179726 Archived-At: Paul Eggert writes: > Óscar Fuentes wrote: > >> Some formats (like Org) are "final", in the sense that the source text >> (the equivalent of *.texi) is intended for consumption (it is the *.info >> too, although not as pretty as some of its other representations such as >> HTML.) Failures on the structure are visible, links can be checked right >> away, etc. > > This is an advantage of Org mode over Texinfo. It's also a disadvantage since it means that one simple text-based output format has to contain the full information relevant for all other output formats. Which causes visual clutter not relevant for the text-based output format. I have no idea what you mean by "Failures on the structure are visible" when one can only see the source text. > Besides, we need to be realistic: we don't have an army of > documentation developers and we're unlikely to gain one while our doc > tools are more awkward than they need to be. If we stick with our > current development process this problem will likely just fester. Again: Texinfo is not a relevant hurdle. Elisp is. Org most certainly would be a larger hurdle for me. -- David Kastrup