Subject: bug#34784: 26.1; Doc of pseudofunction key `<timeout>'

From: Eli Zaretskii <[email-masked]>
Date: Fri, 08 Mar 2019 21:48:39 +0200

> Date: Fri, 8 Mar 2019 11:39:29 -0800 (PST)
> From: Drew Adams <[email-masked]>
> Cc: [email-masked]
> 
> > > > > Anyway, back to the point of this bug report: How
> > > > > is a user to know this info about `<timeout>',
> > > > > without digging into the code?
> > > >
> > > > Why should they?  This is an internal matter between CUA and itself, a
> > > > detail of its implementation.
> > >
> > > Huh? Why shouldn't they?
> > 
> > Because it's an implementation detail.
> 
> How so - what makes you think that?

Because I've read the code.

> > > and s?he wants to know how to invoke
> > > `copy-region-as-kill' starting with prefix `C-c',
> > > where is s?he supposed to turn for that info?
> > 
> > To the source code, of course.
> 
> To understand an external, user-visible, external, key
> description from `C-h' a user needs to dig into the
> source code?  That's a sorry stance for Emacs help to
> take, I think.

No, it's just a (mildly unfortunate) consequence of the fact that
internal details are visible in user-level commands.