[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: jargon translation up-front in doc (was: Menu suggestion)
From: |
Kevin Rodgers |
Subject: |
Re: jargon translation up-front in doc (was: Menu suggestion) |
Date: |
Thu, 29 Apr 2004 09:44:11 -0600 |
User-agent: |
Mozilla/5.0 (X11; U; SunOS i86pc; en-US; rv:0.9.4.1) Gecko/20020406 Netscape6/6.2.2 |
Drew Adams wrote:
> Suggestion #2: Mention such common terms in doc strings, parenthetically,
> for a touchstone.
>
> Since some new users are likely to see `C-h k' help for commonly used keys
> before they read the doc or run through the tutorial, it wouldn't hurt to
> add the associated "common" term(s) somewhere in the doc strings of a
> **few** important, common commands - in parentheses or as added explanation.
> Example commands: `kill-region', `clipboard-kill-region', `yank',
> `clipboard-yank', `kill-ring-save', `clipboard-kill-ring-save'.
>
> This would also help with finding relevant commands using `command-apropos'.
> And it would help them learn the associated Emacs terminology that they will
> need in order to understand other concepts.
>
> Again, ignore this suggestion if the Emacs 21 doc strings for these commands
> already refer to "cut", "paste", and "copy" - I have only Emacs 20. The
> menubar command names "Cut", "Paste", and "Copy" are helpful to newbies, but
> the doc strings are not correspondingly clear (in Emacs 20, at least). It
> wouldn't take much to add a simple explanation that provides a bridge to
> familiar concepts (added text: <<>>):
>
> `kill-region' - "Kill between point and mark.
> <<Cuts the selected text to the clipboard for subsequent pasting.>>" (The
> complete doc string in Emacs 20 is 14 lines long, without once using the
> word "cut", the word "paste", or the word "selected".)
How about automatically highlighting and hyperlinking glossary terms in
doc strings to the corresponding entry in the Glossary info node?
--
Kevin Rodgers
- Re: Menu suggestion, (continued)
- Re: Menu suggestion, Eli Zaretskii, 2004/04/28
- Re: Menu suggestion, Robert J. Chassell, 2004/04/28
- Re: Menu suggestion, Miles Bader, 2004/04/28
- Re: Menu suggestion, Robert J. Chassell, 2004/04/28
- Re: Menu suggestion, Richard Stallman, 2004/04/29
- Re: Menu suggestion, Juri Linkov, 2004/04/29
- Re: Menu suggestion, Eli Zaretskii, 2004/04/26
- jargon translation up-front in doc (was: Menu suggestion), Drew Adams, 2004/04/26
- Re: jargon translation up-front in doc (was: Menu suggestion), Eli Zaretskii, 2004/04/27
- RE: jargon translation up-front in doc (was: Menu suggestion), Drew Adams, 2004/04/28
- Re: jargon translation up-front in doc (was: Menu suggestion),
Kevin Rodgers <=
- RE: jargon translation up-front in doc (was: Menu suggestion), Drew Adams, 2004/04/29
- Re: jargon translation up-front in doc (was: Menu suggestion), Kim F. Storm, 2004/04/29
- RE: jargon translation up-front in doc (was: Menu suggestion), Drew Adams, 2004/04/29
- Re: jargon translation up-front in doc (was: Menu suggestion), Richard Stallman, 2004/04/30
- Default Emacs keybindings (was: Re: Menu suggestion), Per Abrahamsen, 2004/04/26
- Re: Default Emacs keybindings (was: Re: Menu suggestion), Luc Teirlinck, 2004/04/26
- Re: Default Emacs keybindings, Per Abrahamsen, 2004/04/26
- Re: Default Emacs keybindings (was: Re: Menu suggestion), Alan Mackenzie, 2004/04/26
- Re: Default Emacs keybindings (was: Re: Menu suggestion), David Kastrup, 2004/04/26
- Re: Default Emacs keybindings (was: Re: Menu suggestion), Kim F. Storm, 2004/04/26