From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: docstrings and elisp reference Date: Wed, 07 Jun 2017 08:20:11 +0300 Message-ID: <83shjc8jck.fsf@gnu.org> References: Reply-To: Eli Zaretskii NNTP-Posting-Host: blaine.gmane.org X-Trace: blaine.gmane.org 1496812859 11480 195.159.176.226 (7 Jun 2017 05:20:59 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Wed, 7 Jun 2017 05:20:59 +0000 (UTC) Cc: jean.christophe.helary@gmail.com, rms@gnu.org, emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Jun 07 07:20:55 2017 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1dITOo-0002lo-R4 for ged-emacs-devel@m.gmane.org; Wed, 07 Jun 2017 07:20:54 +0200 Original-Received: from localhost ([::1]:41272 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dITOu-0006kS-4R for ged-emacs-devel@m.gmane.org; Wed, 07 Jun 2017 01:21:00 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:58122) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dITON-0006kM-HD for emacs-devel@gnu.org; Wed, 07 Jun 2017 01:20:28 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dITOK-0003jH-BL for emacs-devel@gnu.org; Wed, 07 Jun 2017 01:20:27 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:43207) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dITOK-0003jB-7T; Wed, 07 Jun 2017 01:20:24 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:3586 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1dITOC-0005cd-C2; Wed, 07 Jun 2017 01:20:16 -0400 In-reply-to: (message from Dmitry Gutov on Wed, 7 Jun 2017 01:49:18 +0300) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 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" Xref: news.gmane.org gmane.emacs.devel:215492 Archived-At: > From: Dmitry Gutov > Date: Wed, 7 Jun 2017 01:49:18 +0300 > Cc: emacs-devel@gnu.org > > On 6/7/17 1:42 AM, Richard Stallman wrote: > > > Meanwhile, common material should be stated only > > once. > > Stated where? Somewhere in the vicinity, often in the same node, but sometimes in a sibling or parent node which discuss the general attributes and features of a family of related functions/features. (If the common material is far away from the place where it's relevant, there should be a cross-reference to it, for those who read only about a specific feature.)