From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Lars Ingebrigtsen Newsgroups: gmane.emacs.bugs Subject: bug#27996: open-dribble-file docstring improvement Date: Mon, 15 Jul 2019 19:56:03 +0200 Message-ID: <874l3nb2rw.fsf@mouse.gnus.org> References: <87poc8kxff.fsf@jidanni.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="208928"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) Cc: 27996@debbugs.gnu.org To: =?UTF-8?Q?=E7=A9=8D=E4=B8=B9=E5=B0=BC?= Dan Jacobson Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jul 15 19:57:15 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hn5Dt-000sAq-4P for geb-bug-gnu-emacs@m.gmane.org; Mon, 15 Jul 2019 19:57:13 +0200 Original-Received: from localhost ([::1]:41600 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hn5Ds-0006ML-2B for geb-bug-gnu-emacs@m.gmane.org; Mon, 15 Jul 2019 13:57:12 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:52245) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hn5Dp-0006M7-ON for bug-gnu-emacs@gnu.org; Mon, 15 Jul 2019 13:57:10 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hn5Dk-0003uo-QY for bug-gnu-emacs@gnu.org; Mon, 15 Jul 2019 13:57:07 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:40183) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hn5Di-0003mc-BL for bug-gnu-emacs@gnu.org; Mon, 15 Jul 2019 13:57:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hn5Di-0000JL-8D for bug-gnu-emacs@gnu.org; Mon, 15 Jul 2019 13:57:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 15 Jul 2019 17:57:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 27996 X-GNU-PR-Package: emacs Original-Received: via spool by 27996-submit@debbugs.gnu.org id=B27996.15632133731094 (code B ref 27996); Mon, 15 Jul 2019 17:57:02 +0000 Original-Received: (at 27996) by debbugs.gnu.org; 15 Jul 2019 17:56:13 +0000 Original-Received: from localhost ([127.0.0.1]:49001 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hn5Cs-0000HY-GC for submit@debbugs.gnu.org; Mon, 15 Jul 2019 13:56:10 -0400 Original-Received: from quimby.gnus.org ([80.91.231.51]:46238) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hn5Cq-0000HH-WA for 27996@debbugs.gnu.org; Mon, 15 Jul 2019 13:56:09 -0400 Original-Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=sandy) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1hn5Cm-0001ov-DE; Mon, 15 Jul 2019 19:56:06 +0200 In-Reply-To: <87poc8kxff.fsf@jidanni.org> ("=?UTF-8?Q?=E7=A9=8D=E4=B8=B9=E5=B0=BC?= Dan Jacobson"'s message of "Mon, 07 Aug 2017 08:56:36 +0800") 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: 209.51.188.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:163152 Archived-At: =E7=A9=8D=E4=B8=B9=E5=B0=BC Dan Jacobson writes: > open-dribble-file is an interactive built-in function in =E2=80=98C sourc= e code=E2=80=99. > >> Start writing all keyboard characters to a dribble file called FILE. >> If FILE is nil, close any open dribble file. >> The file will be closed when Emacs exits. > > On the last line I would say > > < Else the file will be closed when Emacs exits. > > as some readers wouldn't notice the second line as that is just talking > about parameters. > > Also mention how often it is written. Every keystroke? Every newline? I've now clarified these two things. > Also when one does C-x C-s etc. But not that thing, because it's superfluous. --=20 (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no