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 07:51:52 +0100 Message-ID: <87d27xqnhz.fsf@fencepost.gnu.org> References: <20141205123549.GA29331@thyrsus.com> <2815659.zRQ0WWWeRr@descartes> <20141205175810.GD3120@thyrsus.com> <87lhmlncb1.fsf@earlgrey.lan> <20141205193643.GB5067@thyrsus.com> <87tx19rd1b.fsf@fencepost.gnu.org> <20141205215138.GF7784@thyrsus.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1417857014 18231 80.91.229.3 (6 Dec 2014 09:10:14 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 6 Dec 2014 09:10:14 +0000 (UTC) Cc: emacs-devel@gnu.org To: "Eric S. Raymond" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 06 10:10:10 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 1XxBNR-0000dw-Ss for ged-emacs-devel@m.gmane.org; Sat, 06 Dec 2014 10:10:10 +0100 Original-Received: from localhost ([::1]:53815 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxBNR-00087D-DG for ged-emacs-devel@m.gmane.org; Sat, 06 Dec 2014 04:10:09 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54778) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxBND-00086q-Vn for emacs-devel@gnu.org; Sat, 06 Dec 2014 04:09:56 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XxBN6-0006Az-8W for emacs-devel@gnu.org; Sat, 06 Dec 2014 04:09:55 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:43052) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxBN6-0006Av-5u for emacs-devel@gnu.org; Sat, 06 Dec 2014 04:09:48 -0500 Original-Received: from localhost ([127.0.0.1]:50228 helo=lola) by fencepost.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxBN5-0008Lh-GF; Sat, 06 Dec 2014 04:09:47 -0500 Original-Received: by lola (Postfix, from userid 1000) id B81A7DF276; Sat, 6 Dec 2014 07:51:52 +0100 (CET) In-Reply-To: <20141205215138.GF7784@thyrsus.com> (Eric S. Raymond's message of "Fri, 5 Dec 2014 16:51:38 -0500") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2001:4830:134:3::e 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:179116 Archived-At: "Eric S. Raymond" writes: > David Kastrup : >> > But it would still be Texinfo, still be an essentially pointless >> > barrier to learning how to contribute. >> >> As opposed to AsciiDoc? Really? > > Yes, asciidoc is far easier. I speak as an experienced user of both. I count 5 patches touching Documentation/ from you in Git, the only major project basing its documentation on AsciiDoc. That's less than even my few patches. Which, by the way, include commit 4739809cd0ea12a8de006f9f086fdff9285189b8 Author: David Kastrup Date: Mon Aug 6 12:22:57 2007 +0200 Add support for an info version of the user manual These patches use docbook2x in order to create an info version of the git user manual. No existing Makefile targets (including "all") are touched, so you need to explicitly say make info sudo make install-info to get git.info created and installed. If the info target directory does not already contain a "dir" file, no directory entry is created. This facilitates $(DESTDIR)-based installations. The same could be achieved with sudo make INSTALL_INFO=: install-info explicitly. perl is used for patching up sub-par file and directory information in the Texinfo file. It would be cleaner to place the respective info straight into user-manual.txt or the conversion configurations, but I find myself unable to find out how to do this with Asciidoc/Texinfo. Signed-off-by: David Kastrup >> So if we don't have better alternatives, why not stick with what we >> have? > > Because it's ugly, heavyweight, and a barrier to entry. I know you > do not understand this. It must be hard for you being the only intelligent being in a world of idiots, but it's not like this is a new experience for you. > Alas, your failure to understand it does not prevent it from being a > problem. Rebasing Emacs documentation on a system for reasons only singularly intelligent beings like you understand would appear to be a dangerous move since you will not be available to save Emacs from the follies of its programmers for all eternity. So if you want to make a convincing pitch, you better come off your condescending horse. -- David Kastrup