From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.bugs Subject: bug#28790: [PATCH] Replaced "which see" with "q.v.". Date: Sun, 15 Oct 2017 21:55:31 -0400 Message-ID: References: <838tggoo8m.fsf@gnu.org> <87po9pi7p4.fsf@gmail.com> <8d2e2b63-15f9-49b9-b29b-cd20656ebbd2@default> Reply-To: rms@gnu.org NNTP-Posting-Host: blaine.gmane.org Content-Type: text/plain; charset=Utf-8 X-Trace: blaine.gmane.org 1508118981 9131 195.159.176.226 (16 Oct 2017 01:56:21 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 16 Oct 2017 01:56:21 +0000 (UTC) Cc: joaotavora@gmail.com, 28790@debbugs.gnu.org, jrw@pobox.com To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Oct 16 03:56:17 2017 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1e3udW-00013j-BP for geb-bug-gnu-emacs@m.gmane.org; Mon, 16 Oct 2017 03:56:10 +0200 Original-Received: from localhost ([::1]:58951 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1e3udd-0006Yw-J1 for geb-bug-gnu-emacs@m.gmane.org; Sun, 15 Oct 2017 21:56:17 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35256) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1e3udP-0006Ww-V0 for bug-gnu-emacs@gnu.org; Sun, 15 Oct 2017 21:56:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1e3udP-000740-8T for bug-gnu-emacs@gnu.org; Sun, 15 Oct 2017 21:56:04 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:33496) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1e3udP-00073n-5H for bug-gnu-emacs@gnu.org; Sun, 15 Oct 2017 21:56:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1e3udO-0003uK-SI for bug-gnu-emacs@gnu.org; Sun, 15 Oct 2017 21:56:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Richard Stallman Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 16 Oct 2017 01:56:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 28790 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch Original-Received: via spool by 28790-submit@debbugs.gnu.org id=B28790.150811894814999 (code B ref 28790); Mon, 16 Oct 2017 01:56:01 +0000 Original-Received: (at 28790) by debbugs.gnu.org; 16 Oct 2017 01:55:48 +0000 Original-Received: from localhost ([127.0.0.1]:42177 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1e3udA-0003tr-Di for submit@debbugs.gnu.org; Sun, 15 Oct 2017 21:55:48 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:44084) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1e3ud8-0003te-Gw for 28790@debbugs.gnu.org; Sun, 15 Oct 2017 21:55:46 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1e3ud2-0006oa-CO for 28790@debbugs.gnu.org; Sun, 15 Oct 2017 21:55:41 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:44732) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1e3ucu-0006kb-0n; Sun, 15 Oct 2017 21:55:32 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1e3uct-0005iE-JM; Sun, 15 Oct 2017 21:55:31 -0400 In-reply-to: <8d2e2b63-15f9-49b9-b29b-cd20656ebbd2@default> (message from Drew Adams on Sun, 15 Oct 2017 08:31:14 -0700 (PDT)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:138486 Archived-At: [[[ To any NSA and FBI agents reading my email: please consider ]]] [[[ whether defending the US Constitution against all enemies, ]]] [[[ foreign or domestic, requires you to follow Snowden's example. ]]] > Yes, this is true. It is conventional and clear to say > "See XXX for information about YYY." IOW, it's good to > make very clear (a) what you're pointing to and (b) why. I think it is good to make doc strings clearer in that sort of way. -- Dr Richard Stallman President, Free Software Foundation (gnu.org, fsf.org) Internet Hall-of-Famer (internethalloffame.org) Skype: No way! See stallman.org/skype.html.