From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Dmitry Gutov Newsgroups: gmane.emacs.devel Subject: Re: Trunk still not open Date: Sun, 16 Mar 2014 02:39:54 +0200 Message-ID: <5324F2DA.9090204@yandex.ru> References: <6xwqfxhl88.fsf@fencepost.gnu.org> <83txb1mcsy.fsf@gnu.org> <87siqlku0i.fsf@uwakimon.sk.tsukuba.ac.jp> <87wqfxari2.fsf@yandex.ru> <87ha70kyy3.fsf@uwakimon.sk.tsukuba.ac.jp> <5323B66B.5070405@yandex.ru> <837g7vdg70.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1394930431 20509 80.91.229.3 (16 Mar 2014 00:40:31 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 16 Mar 2014 00:40:31 +0000 (UTC) Cc: stephen@xemacs.org, emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Mar 16 01:40: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 1WOz82-0005Eq-Ap for ged-emacs-devel@m.gmane.org; Sun, 16 Mar 2014 01:40:38 +0100 Original-Received: from localhost ([::1]:51581 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WOz81-0003xp-S0 for ged-emacs-devel@m.gmane.org; Sat, 15 Mar 2014 20:40:37 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:41413) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WOz7p-0003h6-80 for emacs-devel@gnu.org; Sat, 15 Mar 2014 20:40:33 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WOz7g-0004Nu-N8 for emacs-devel@gnu.org; Sat, 15 Mar 2014 20:40:25 -0400 Original-Received: from mail-ee0-x22c.google.com ([2a00:1450:4013:c00::22c]:32979) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WOz7O-00045A-Tz; Sat, 15 Mar 2014 20:39:59 -0400 Original-Received: by mail-ee0-f44.google.com with SMTP id e49so2777559eek.3 for ; Sat, 15 Mar 2014 17:39:57 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:message-id:date:from:user-agent:mime-version:to:cc:subject :references:in-reply-to:content-type:content-transfer-encoding; bh=eLSZ3L/72JlJHVyKEXrJyUPp0WvxkqgHiE+7b2bcK10=; b=eHvNlQfNskZaZvGphcSl5sFoZSTKtLEjyTgfTo4i+gFUFxncWVIM8TyNBSOw9m77dX mG4u1E9rj3JnWmnCC9DSEc3IkusuSB1+pySbupc5+nY63chqTrXb/KlN1HO4Z7XZHIj5 qBRx/x6ZrNnM4nfwI/dt93Iztctw5CPDzoPmyeCtsR+MjqduOp1RVhWzkN8yXHteXOcA XP8zXWgtoqPFoaDVHiUwVt5mgBVIVRWQfw2ov/ZyQSOAuwE3dRG0xgx+PQ9iQnx63w9n WX0nC7p1dIxCCC/Nsecl6+A4JiYaxWyrn3oPBKmVQTH3eE1rCsutZAv/C4B6C19TakVa pEcg== X-Received: by 10.15.49.65 with SMTP id i41mr665423eew.87.1394930397684; Sat, 15 Mar 2014 17:39:57 -0700 (PDT) Original-Received: from [192.168.10.2] (62-27-225.netrun.cytanet.com.cy. [62.228.27.225]) by mx.google.com with ESMTPSA id p8sm16015006eef.26.2014.03.15.17.39.55 for (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Sat, 15 Mar 2014 17:39:57 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:24.0) Gecko/20100101 Thunderbird/24.3.0 In-Reply-To: <837g7vdg70.fsf@gnu.org> X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2a00:1450:4013:c00::22c 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:170402 Archived-At: 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 > submissions. 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.