[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: On being web-friendly and why info must die

From: David Kastrup
Subject: Re: On being web-friendly and why info must die
Date: Sat, 06 Dec 2014 07:51:52 +0100
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/25.0.50 (gnu/linux)

"Eric S. Raymond" <address@hidden> writes:

> David Kastrup <address@hidden>:
>> > 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 <address@hidden>
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
    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 <address@hidden>

>> 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

reply via email to

[Prev in Thread] Current Thread [Next in Thread]