From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Glenn Morris Newsgroups: gmane.emacs.devel Subject: Re: Trunk still not open Date: Sat, 15 Mar 2014 21:27:58 -0400 Message-ID: References: <6xwqfxhl88.fsf@fencepost.gnu.org> <83txb1mcsy.fsf@gnu.org> <87siqlku0i.fsf@uwakimon.sk.tsukuba.ac.jp> <87wqfxari2.fsf@yandex.ru> <87zjksrvqr.fsf@yandex.ru> <834n2zdf3s.fsf@gnu.org> <5324F11E.1090800@yandex.ru> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1394933276 17689 80.91.229.3 (16 Mar 2014 01:27:56 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 16 Mar 2014 01:27:56 +0000 (UTC) Cc: Eli Zaretskii , emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Mar 16 02:28:06 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 1WOzrv-0004wO-DN for ged-emacs-devel@m.gmane.org; Sun, 16 Mar 2014 02:28:03 +0100 Original-Received: from localhost ([::1]:51968 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WOzrv-0002lg-0C for ged-emacs-devel@m.gmane.org; Sat, 15 Mar 2014 21:28:03 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54524) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WOzrs-0002lP-2W for emacs-devel@gnu.org; Sat, 15 Mar 2014 21:28:00 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WOzrr-0002gO-CE for emacs-devel@gnu.org; Sat, 15 Mar 2014 21:28:00 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:50391) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WOzrr-0002gK-9J for emacs-devel@gnu.org; Sat, 15 Mar 2014 21:27:59 -0400 Original-Received: from rgm by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1WOzrq-0001Xy-FQ; Sat, 15 Mar 2014 21:27:58 -0400 X-Spook: CIA illuminati AUTODIN Elvis Lexis-Nexis CipherTAC-2000 X-Ran: qq`_z<=J}]I@!Hban;J`B"gbA@50pjT*"t?pR@?"CJ"k2G%,vRVw7D;7f5;ZY4Td@bZ!qH X-Hue: blue X-Attribution: GM In-Reply-To: <5324F11E.1090800@yandex.ru> (Dmitry Gutov's message of "Sun, 16 Mar 2014 02:32:30 +0200") User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) 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:170406 Archived-At: Dmitry Gutov wrote: > I see that no one has commented on "documenting the changes in triplicate". The Emacs manual and the lispref should not duplicate each other (in non-trivial ways). The manual describes the user-level interface, and the lispref the programmer-level interface (the distinction between the two can be a bit grey of course), and they should cross-reference each other where relevant. In this specific case, I think you found an example where the lispref repeats too much information from the manual. The manual should document what blink-matching-paren does, and how to turn it off, and what (main) customization options exists. The lispref should contain the stuff about blink-paren-function and blink-matching-open. The descriptions of blink-matching-paren, blink-matching-paren-distance, blink-matching-delay should probably be removed from the lispref in favour of a cross-reference to the Emacs manual.