emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: tumme testing


From: Mathias Dahl
Subject: Re: tumme testing
Date: Sat, 11 Feb 2006 22:54:44 +0100
User-agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.50 (gnu/linux)

"Robert J. Chassell" <address@hidden> writes:

>    Would all "tag commands" need that info? Although there are quite few
>    of them now, more could be added, and I hate redundant documentation.
>
> Please remember, not every one will have read the manual.  Or if they
> have, they may not remember it.  
>
> Perhaps they last read the relevant node 20 years ago.  If you do as
> well as others, and you should, people for whom Chinese is a second
> language will read a translation of your words in 2026.
>
> The doc string and the Texinfo documentation are not redundant; the
> purposes of each are different.

I was referring to the docstrings only and sloppily mentioned
"documentation" as a general word. I know they are separate and have
separate purposes.

> Each tag command requires documentation that `describe-function'
> displays and, in different and when necessary more words, the Texinfo
> file requires documentation, too.

Yes. I am currently trying to update both.

> You simply want to say something like the following (in one filled
> paragraph; but at the moment, there is no command to view the image
> files as small thumbnails in dired, I am leaving the commands as
> ellipses and the paragraph unfilled):
>
>     The viewing commands are the same as before.
>     To view those image files as small thumbnails in dired, type ...
>     To view those image files as thumbnails in a different buffer,
>     type ...

I think I understand what you mean now. I'll look into it.





reply via email to

[Prev in Thread] Current Thread [Next in Thread]