From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: docstrings and elisp reference Date: Sat, 17 Jun 2017 11:13:25 -0400 Message-ID: References: <0BB64F35-233A-471F-B99F-51F96C4E6CCB@gmail.com> <8360g99n07.fsf@gnu.org> <86lgp4q2xa.fsf@stephe-leake.org> <13fd66c8-b22b-5b87-bd8c-34dbe0c7ec38@yandex.ru> <3d5a1ca0-645f-421f-8044-f344c586705d@default> <0d081c78-3e64-4cc3-afdd-471b49f21f24@yandex.ru> <83r2yw8iyu.fsf@gnu.org> <8241d6cf-0902-5f3b-9060-8bb445c02fed@yandex.ru> <83mv96zouv.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1497712420 12160 195.159.176.226 (17 Jun 2017 15:13:40 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 17 Jun 2017 15:13:40 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.0.50 (gnu/linux) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Jun 17 17:13:37 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 1dMFPt-0002vu-1A for ged-emacs-devel@m.gmane.org; Sat, 17 Jun 2017 17:13:37 +0200 Original-Received: from localhost ([::1]:35389 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dMFPy-0001px-BW for ged-emacs-devel@m.gmane.org; Sat, 17 Jun 2017 11:13:42 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:41552) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dMFPs-0001pq-Op for emacs-devel@gnu.org; Sat, 17 Jun 2017 11:13:37 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dMFPp-00007t-Gd for emacs-devel@gnu.org; Sat, 17 Jun 2017 11:13:36 -0400 Original-Received: from [195.159.176.226] (port=38375 helo=blaine.gmane.org) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1dMFPp-00007T-A8 for emacs-devel@gnu.org; Sat, 17 Jun 2017 11:13:33 -0400 Original-Received: from list by blaine.gmane.org with local (Exim 4.84_2) (envelope-from ) id 1dMFPh-0002Ll-Ik for emacs-devel@gnu.org; Sat, 17 Jun 2017 17:13:25 +0200 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 17 Original-X-Complaints-To: usenet@blaine.gmane.org Cancel-Lock: sha1:oRfcc8rxamfw05XsUP+YxqxUDv8= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 195.159.176.226 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:215699 Archived-At: >> > The original proposal was for a literal copying of the same text. >> > Drew was talking about duplicating the information, but expressed >> > in a different, sometimes very different, form. >> And my problem is that it's very often expressed in a very similar form, >> if not copied verbatim. > Sometimes that is appropriate. Other times it isn't. My proposal was to enhance our tooling so that instead of manually copying the text, the copying is done dynamically, based on special references. It wouldn't prevent us from having manually written docs for those cases where "copied verbatim" is not appropriate. Of course, it would encourage the "verbatim copy", and hence discourage the "specially hand crafted doc". Stefan