From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Thien-Thi Nguyen Newsgroups: gmane.emacs.devel Subject: Re: window--dump-frame Date: Fri, 23 May 2014 09:32:28 +0200 Message-ID: <87lhtthrw3.fsf@zigzag.favinet> References: <537DA243.9070306@gmx.at> <8761kxrdm6.fsf@zigzag.favinet> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" X-Trace: ger.gmane.org 1400830188 10173 80.91.229.3 (23 May 2014 07:29:48 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 23 May 2014 07:29:48 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri May 23 09:29:41 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 1WnjvA-00015H-ID for ged-emacs-devel@m.gmane.org; Fri, 23 May 2014 09:29:40 +0200 Original-Received: from localhost ([::1]:41456 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WnjvA-00045t-2z for ged-emacs-devel@m.gmane.org; Fri, 23 May 2014 03:29:40 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53116) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Wnjv1-00044r-NZ for emacs-devel@gnu.org; Fri, 23 May 2014 03:29:37 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Wnjuv-0001kr-RJ for emacs-devel@gnu.org; Fri, 23 May 2014 03:29:31 -0400 Original-Received: from smtp208.alice.it ([82.57.200.104]:8779) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Wnjuv-0001kY-FE for emacs-devel@gnu.org; Fri, 23 May 2014 03:29:25 -0400 Original-Received: from zigzag.favinet (79.40.15.68) by smtp208.alice.it (8.6.060.28) id 52443B822C859703 for emacs-devel@gnu.org; Fri, 23 May 2014 09:29:24 +0200 Original-Received: from ttn by zigzag.favinet with local (Exim 4.80) (envelope-from ) id 1Wnjy4-00013E-FU for emacs-devel@gnu.org; Fri, 23 May 2014 09:32:40 +0200 Mail-Followup-To: emacs-devel@gnu.org In-Reply-To: (Stefan Monnier's message of "Thu, 22 May 2014 17:06:09 -0400") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 82.57.200.104 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:172039 Archived-At: --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable () Stefan Monnier () Thu, 22 May 2014 17:06:09 -0400 No, "--" means it's "internal", but it's perfectly OK to have commands designed solely for debugging purposes, i.e. "internal use". Sure, for the programmer. Unfortunately, the distinction is not readily comprehensible (and more to the point, respected) by the non-programmer. If it shows up in =E2=80=98apropos-command=E2=80=99, it will be tried and m= aybe trusted. Betraying the trust, for reasons even justifiable, is Not Cool. I stand by my gut feelings: Best to avoid "don't do that" in a future mailing list post by not making "that" doable. Next best would be to add hugely fearsome disclaimers in the docstring, i suppose. Then "don't do that" becomes "RTFM", which is only slightly more mellifluous. (In times past, i would have optimistically imagined another message: "read the source, luke!". Maybe that optimism will return, who knows. No man is an island, but the puddles are damnably prevalent...) =2D-=20 Thien-Thi Nguyen GPG key: 4C807502 (if you're human and you know it) read my lisp: (responsep (questions 'technical) (not (via 'mailing-list))) =3D> nil --=-=-= Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.12 (GNU/Linux) iEYEARECAAYFAlN++ZEACgkQZwMiJEyAdQLWMwCfZCLmF+VcUEnhyboiFfzkYUXn UwAAnj+BrAPtjm1mgTtL8BMyGEjcZ4y8 =a3Vv -----END PGP SIGNATURE----- --=-=-=--