From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Eric S. Raymond" Newsgroups: gmane.emacs.devel Subject: Re: On being web-friendly and why info must die Date: Fri, 5 Dec 2014 17:39:55 -0500 Organization: Eric Conspiracy Secret Labs Message-ID: <20141205223955.GJ7784@thyrsus.com> References: <20141205123549.GA29331@thyrsus.com> <87mw72lyzs.fsf@earlgrey.lan> <20141205190925.GA5067@thyrsus.com> <83h9x93leo.fsf@gnu.org> <20141205205320.GA7237@thyrsus.com> <87lhmlrcp1.fsf@fencepost.gnu.org> Reply-To: esr@thyrsus.com NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1417819243 17082 80.91.229.3 (5 Dec 2014 22:40:43 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 5 Dec 2014 22:40:43 +0000 (UTC) Cc: emacs-devel@gnu.org To: David Kastrup Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Dec 05 23:40:38 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 1Xx1YE-0005hs-7Z for ged-emacs-devel@m.gmane.org; Fri, 05 Dec 2014 23:40:38 +0100 Original-Received: from localhost ([::1]:52734 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xx1YD-0005ye-KU for ged-emacs-devel@m.gmane.org; Fri, 05 Dec 2014 17:40:37 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:36683) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xx1Xk-0005w1-L9 for emacs-devel@gnu.org; Fri, 05 Dec 2014 17:40:12 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xx1Xe-0000lK-A2 for emacs-devel@gnu.org; Fri, 05 Dec 2014 17:40:08 -0500 Original-Received: from static-71-162-243-5.phlapa.fios.verizon.net ([71.162.243.5]:58921 helo=snark.thyrsus.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xx1XY-0000h2-FZ; Fri, 05 Dec 2014 17:39:56 -0500 Original-Received: by snark.thyrsus.com (Postfix, from userid 1000) id D4C373836F4; Fri, 5 Dec 2014 17:39:55 -0500 (EST) Content-Disposition: inline In-Reply-To: <87lhmlrcp1.fsf@fencepost.gnu.org> X-Eric-Conspiracy: There is no conspiracy User-Agent: Mutt/1.5.21 (2010-09-15) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 71.162.243.5 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:179046 Archived-At: David Kastrup : > When looking at existing Texinfo source, I get a good idea of how to > write Texinfo markup of my own. When looking at AsciiDoc, I have no > clue since it is not apparent what is formatting, and what is content. That's a feature, not a bug. I used to be a fan of heavy, explicit document markup; DocBookXML was my weapon of choice for large documents. It took a bit of mental readjustment when I first experimented with minimal, new-school markups like markdown and asciidoc. But then my perspective shifted. Now I like the fact that that the markup obtrudes very little on the actual content. I get to write *foo* instead of foo and you know what? It's better - lower overhead not just in typed characters but in the amount of attention required to read it structurally. I also found that I had underestimated the practical value of not having to render a document to get it to a plain-ASCII format friendly to a human eyeball. This cuts out a lot of friction that you won't notice until it's gone. -- Eric S. Raymond