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: Trunk still not open Date: Fri, 14 Mar 2014 17:29:17 +0200 Message-ID: <838uscdcj6.fsf@gnu.org> References: <6xwqfxhl88.fsf@fencepost.gnu.org> <83txb1mcsy.fsf@gnu.org> <87siqlku0i.fsf@uwakimon.sk.tsukuba.ac.jp> <87wqfxari2.fsf@yandex.ru> <87r464luge.fsf@uwakimon.sk.tsukuba.ac.jp> <532318E6.6030706@yandex.ru> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1394810972 22201 80.91.229.3 (14 Mar 2014 15:29:32 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 14 Mar 2014 15:29:32 +0000 (UTC) Cc: stephen@xemacs.org, emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Mar 14 16:29: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 1WOU3H-0004V0-0v for ged-emacs-devel@m.gmane.org; Fri, 14 Mar 2014 16:29:39 +0100 Original-Received: from localhost ([::1]:45349 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WOU3G-0007gH-JR for ged-emacs-devel@m.gmane.org; Fri, 14 Mar 2014 11:29:38 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:60882) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WOU38-0007Zs-S8 for emacs-devel@gnu.org; Fri, 14 Mar 2014 11:29:36 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WOU31-0000qp-8Q for emacs-devel@gnu.org; Fri, 14 Mar 2014 11:29:30 -0400 Original-Received: from mtaout25.012.net.il ([80.179.55.181]:37329) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WOU31-0000qa-0F for emacs-devel@gnu.org; Fri, 14 Mar 2014 11:29:23 -0400 Original-Received: from conversion-daemon.mtaout25.012.net.il by mtaout25.012.net.il (HyperSendmail v2007.08) id <0N2F00A00MIVW600@mtaout25.012.net.il> for emacs-devel@gnu.org; Fri, 14 Mar 2014 17:27:35 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout25.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0N2F004LCMXZGD70@mtaout25.012.net.il>; Fri, 14 Mar 2014 17:27:35 +0200 (IST) In-reply-to: <532318E6.6030706@yandex.ru> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 80.179.55.181 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:170364 Archived-At: > Date: Fri, 14 Mar 2014 16:57:42 +0200 > From: Dmitry Gutov > Cc: emacs-devel@gnu.org > > On 14.03.2014 16:34, Stephen J. Turnbull wrote: > > Anyway, they're closely related. If you don't have docs, you don't > > know what to test. > > If I only have docstrings, I can know what to test pretty well. Not necessarily. You will know how to test a function, but without some overview docs, you will have no idea how to test a complex feature that is built of several functions and variables, and relies on some internals on top of that. Also, internal functions many times don't have doc strings -- a practice that Emacs development accepts as valid. As another example, testing of infrastructure and C code using just the doc strings is an impossible task. E.g., in what doc string will you find what a 'display' property is supposed to do?