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: Fri, 05 Dec 2014 22:40:16 +0100 Organization: Organization?!? Message-ID: <87tx19rd1b.fsf@fencepost.gnu.org> References: <20141205123549.GA29331@thyrsus.com> <2815659.zRQ0WWWeRr@descartes> <20141205175810.GD3120@thyrsus.com> <87lhmlncb1.fsf@earlgrey.lan> <20141205193643.GB5067@thyrsus.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1417815655 16000 80.91.229.3 (5 Dec 2014 21:40:55 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 5 Dec 2014 21:40:55 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Dec 05 22:40:48 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 1Xx0cJ-0000IS-Pr for ged-emacs-devel@m.gmane.org; Fri, 05 Dec 2014 22:40:47 +0100 Original-Received: from localhost ([::1]:52572 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xx0cJ-00072o-F0 for ged-emacs-devel@m.gmane.org; Fri, 05 Dec 2014 16:40:47 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49952) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xx0c8-00072X-JK for emacs-devel@gnu.org; Fri, 05 Dec 2014 16:40:41 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xx0c3-0002Qx-5q for emacs-devel@gnu.org; Fri, 05 Dec 2014 16:40:36 -0500 Original-Received: from plane.gmane.org ([80.91.229.3]:37726) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xx0c2-0002QS-UX for emacs-devel@gnu.org; Fri, 05 Dec 2014 16:40:31 -0500 Original-Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1Xx0bz-00007f-Ph for emacs-devel@gnu.org; Fri, 05 Dec 2014 22:40:27 +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 ; Fri, 05 Dec 2014 22:40:27 +0100 Original-Received: from dak by x2f51fab.dyn.telefonica.de with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 05 Dec 2014 22:40:27 +0100 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 55 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:IKix398/qMc/CSIXdD4yFdiq4Co= 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:179025 Archived-At: "Eric S. Raymond" writes: > Christopher Allan Webber : >> I think changing things for emacs to make it more modern is good... when >> it came to changing to a new DVCS, I agree with the move to git Git; in >> terms of usage, this is the clear winner. But who is using asciidoc >> these days? > > The Linux kernel, for one. All their internal documentation and their webbed > documentation is mastered in asciidoc. Example? > Also true of the git project. That is the only project of which I know it uses AsciiDoc, and it has versioning problems, not able to use the current AsciiDoc version for everything. >> But a lot of this is cosmetic. We could improve Texinfo to look much >> better probably (and that would positively affect a lot of existing >> GNU projects). > > But it would still be Texinfo, still be an essentially pointless > barrier to learning how to contribute. As opposed to AsciiDoc? Really? >> But I really do not understand the choice of asciidoc. Could you >> explain further your reasoning? > > I think (and I believe RMS agrees) that we need a master format that > will (a) play nice with Web, and (b) attract new contributors rather > than repelling them. > > The latter criterion argues strongly for a modern, leightweignt markup > in general use outside the Emacs project. Which rules out AsciiDoc. It is in less use outside the Emacs project than even Texinfo. > What are the alternatives, really? asciidoc. rST. Sphinx. Some > flavor of markdown. So if we don't have better alternatives, why not stick with what we have? > I think markdown is right out because of the death-of-a-thousand > dialects problem it has. AsciiDoc is not even compatible with its "canonical" implementation in different versions. -- David Kastrup