From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: On being web-friendly and why info must die Date: Mon, 08 Dec 2014 19:00:52 +0200 Message-ID: <83mw6yxeij.fsf@gnu.org> References: <20141205123549.GA29331@thyrsus.com> <2815659.zRQ0WWWeRr@descartes> <20141205175810.GD3120@thyrsus.com> <87lhmlncb1.fsf@earlgrey.lan> <20141205193643.GB5067@thyrsus.com> <83egsd3kyi.fsf@gnu.org> <871toapbh9.fsf@newcastle.ac.uk> <83ppbuxgxx.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1418058104 15278 80.91.229.3 (8 Dec 2014 17:01:44 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 8 Dec 2014 17:01:44 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Dec 08 18:01:39 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 1Xy1go-0005JD-QZ for ged-emacs-devel@m.gmane.org; Mon, 08 Dec 2014 18:01:38 +0100 Original-Received: from localhost ([::1]:35080 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xy1go-00055H-Dp for ged-emacs-devel@m.gmane.org; Mon, 08 Dec 2014 12:01:38 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54558) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xy1gL-0004LE-7K for emacs-devel@gnu.org; Mon, 08 Dec 2014 12:01:14 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xy1gF-0005Pz-7X for emacs-devel@gnu.org; Mon, 08 Dec 2014 12:01:08 -0500 Original-Received: from mtaout20.012.net.il ([80.179.55.166]:65078) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xy1gE-0005PV-WB for emacs-devel@gnu.org; Mon, 08 Dec 2014 12:01:03 -0500 Original-Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0NG900K00WLAR700@a-mtaout20.012.net.il> for emacs-devel@gnu.org; Mon, 08 Dec 2014 19:01:01 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NG900KTVWLOBJ80@a-mtaout20.012.net.il> for emacs-devel@gnu.org; Mon, 08 Dec 2014 19:01:01 +0200 (IST) In-reply-to: X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 X-Received-From: 80.179.55.166 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:179411 Archived-At: > From: Ted Zlatanov > Date: Mon, 08 Dec 2014 11:29:37 -0500 > > On Mon, 08 Dec 2014 18:08:26 +0200 Eli Zaretskii wrote: > > EZ> What I had in mind was some evidence, even anecdotal one, that people > EZ> considered contributing a chunk of docs, but decided against that > EZ> because of Texinfo. > > It's always been a nasty hurdle for me, discouraging me from writing new > stuff. I can never remember the syntax (I deal with Markdown and other > formats all day, and texinfo gets pushed out). (Some of) the syntax gets taken care of by the various Texinfo mode commands. We could also add items to the menu, if that's useful. > I also hate having to list section names twice You don't need to. > and the index and all the other nonsense. Indexing is part of the real effort -- it's a human activity for which there's no automated replacement. Like writing the text itself -- there's no alternative to doing that yourself, in any documentation system. But I will offer you a deal: write plain ASCII, and I will add markup. Deal?