[Top][All Lists]

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

Re: Trunk still not open

From: Dmitry Gutov
Subject: Re: Trunk still not open
Date: Sun, 16 Mar 2014 02:39:54 +0200
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.3.0

On 15.03.2014 10:22, Eli Zaretskii wrote:

Texinfo is almost plain text, the markup you need to learn is quite
minimal, and fairly similar semantically to HTML.  The markup is also
quite a mechanical part of writing the docs, and you will quickly
learn to do it correctly given the comments for your first

It can be easy to change some small part of an existing page. Writing a new one would be a bit harder. I think it would cut down on casual contributions either way.

Take a look at gdb-patches mailing list, where we have people writing
docs for every patch, and see for yourself how this works.  There are
a few of them there for whom writing English is much more difficult
than writing C or Python, and yet they still do this.

As a program written in C, GDB doesn't have the same concept of docstrings visible to the user. So the manual is necessary, and if the author of a patch doesn't do it, AFAICT in many cases that won't be practical to do post-factum.

At least they don't have to duplicate the text.

reply via email to

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