From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: =?UTF-8?Q?=E7=A9=8D=E4=B8=B9=E5=B0=BC?= Dan Jacobson Newsgroups: gmane.emacs.bugs Subject: bug#27996: open-dribble-file docstring improvement Date: Mon, 07 Aug 2017 08:56:36 +0800 Message-ID: <87poc8kxff.fsf@jidanni.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1502072005 8323 195.159.176.226 (7 Aug 2017 02:13:25 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 7 Aug 2017 02:13:25 +0000 (UTC) To: 27996@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Aug 07 04:13:21 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 1deXXh-0001ha-PQ for geb-bug-gnu-emacs@m.gmane.org; Mon, 07 Aug 2017 04:13:17 +0200 Original-Received: from localhost ([::1]:35003 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1deXXk-0001Sw-N9 for geb-bug-gnu-emacs@m.gmane.org; Sun, 06 Aug 2017 22:13:20 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45384) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1deXXY-0001SU-Ez for bug-gnu-emacs@gnu.org; Sun, 06 Aug 2017 22:13:09 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1deXXU-0004gE-7C for bug-gnu-emacs@gnu.org; Sun, 06 Aug 2017 22:13:08 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:42447) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1deXXU-0004gA-3J for bug-gnu-emacs@gnu.org; Sun, 06 Aug 2017 22:13:04 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1deXXT-0002br-U3 for bug-gnu-emacs@gnu.org; Sun, 06 Aug 2017 22:13:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: =?UTF-8?Q?=E7=A9=8D=E4=B8=B9=E5=B0=BC?= Dan Jacobson Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 07 Aug 2017 02:13:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 27996 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.15020719759977 (code B ref -1); Mon, 07 Aug 2017 02:13:03 +0000 Original-Received: (at submit) by debbugs.gnu.org; 7 Aug 2017 02:12:55 +0000 Original-Received: from localhost ([127.0.0.1]:45117 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1deXXL-0002ap-BQ for submit@debbugs.gnu.org; Sun, 06 Aug 2017 22:12:55 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:54231) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1deXXJ-0002aL-Lz for submit@debbugs.gnu.org; Sun, 06 Aug 2017 22:12:53 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1deXXD-0004Zm-K3 for submit@debbugs.gnu.org; Sun, 06 Aug 2017 22:12:48 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:35985) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1deXXD-0004Zi-ID for submit@debbugs.gnu.org; Sun, 06 Aug 2017 22:12:47 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45159) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1deXXC-0001Oq-El for bug-gnu-emacs@gnu.org; Sun, 06 Aug 2017 22:12:47 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1deXXB-0004YL-1Q for bug-gnu-emacs@gnu.org; Sun, 06 Aug 2017 22:12:46 -0400 Original-Received: from homie.mail.dreamhost.com ([208.97.132.208]:40024 helo=homiemail-a9.g.dreamhost.com) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1deXXA-0004Xv-Qo for bug-gnu-emacs@gnu.org; Sun, 06 Aug 2017 22:12:44 -0400 Original-Received: from homiemail-a9.g.dreamhost.com (localhost [127.0.0.1]) by homiemail-a9.g.dreamhost.com (Postfix) with ESMTP id D974C5BE06B for ; Sun, 6 Aug 2017 19:12:43 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=jidanni.org; h=from:to :subject:date:message-id:mime-version:content-type: content-transfer-encoding; s=jidanni.org; bh=NEEmLWd7uG6tObUU6X7 DLitChBo=; b=acSES/EzMkfkiglwMT3tAa4XSX+qvgT7I8OogZhqmR/fhQk75Rt u+Cw6fkd5E9ULBzxLr4QYs4luc2hxjNRkzzQTBYOHn1Gb0lYpF49NTJas76t6e7v koTxZ6OPc9mJj9okHDfKaPWa0qCuZwLT/xtdFuLtwyKJx7bY/Pwid77M= Original-Received: from jidanni.org (114-46-60-214.dynamic-ip.hinet.net [114.46.60.214]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) (Authenticated sender: jidanni@jidanni.org) by homiemail-a9.g.dreamhost.com (Postfix) with ESMTPSA id 8DB945BE064 for ; Sun, 6 Aug 2017 19:12:43 -0700 (PDT) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x (no timestamps) [generic] [fuzzy] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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:135523 Archived-At: 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? Also when one does C-x C-s etc.