all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* bug#27996: open-dribble-file docstring improvement
@ 2017-08-07  0:56 積丹尼 Dan Jacobson
  2019-07-15 17:56 ` Lars Ingebrigtsen
  0 siblings, 1 reply; 2+ messages in thread
From: 積丹尼 Dan Jacobson @ 2017-08-07  0:56 UTC (permalink / raw)
  To: 27996

open-dribble-file is an interactive built-in function in ‘C source code’.

> 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.





^ permalink raw reply	[flat|nested] 2+ messages in thread

* bug#27996: open-dribble-file docstring improvement
  2017-08-07  0:56 bug#27996: open-dribble-file docstring improvement 積丹尼 Dan Jacobson
@ 2019-07-15 17:56 ` Lars Ingebrigtsen
  0 siblings, 0 replies; 2+ messages in thread
From: Lars Ingebrigtsen @ 2019-07-15 17:56 UTC (permalink / raw)
  To: 積丹尼 Dan Jacobson; +Cc: 27996

積丹尼 Dan Jacobson <jidanni@jidanni.org> writes:

> open-dribble-file is an interactive built-in function in ‘C source code’.
>
>> 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.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no





^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2019-07-15 17:56 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2017-08-07  0:56 bug#27996: open-dribble-file docstring improvement 積丹尼 Dan Jacobson
2019-07-15 17:56 ` Lars Ingebrigtsen

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.