Re: texinfo-all-menus-update

Re: texinfo-all-menus-update

[Robert J. Chassell]

   Is there any reason why texinfo-all-menus-update produces trailing
   whitespace after the menu entries?

No reason.  It is a bug.  I never noticed it doing that, and am glad
you found it.  I dislike trailing whitespace.  (Unfortunately, I am
too busy traveling at the moment to propose a fix.  If you can make
one, perhaps Karl can install it.)

-- 
    Robert J. Chassell                  bob@rattlesnake.com
    Rattlesnake Enterprises             http://www.rattlesnake.com

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://mail.gnu.org/mailman/listinfo/emacs-devel

calendar: trailing whitespace (Re: texinfo-all-menus-update)

[Karl Eichwalder]

"Robert J. Chassell" <bob@rattlesnake.com> writes:

>    Is there any reason why texinfo-all-menus-update produces trailing
>    whitespace after the menu entries?
>
> No reason.  It is a bug.  I never noticed it doing that, and am glad
> you found it.  I dislike trailing whitespace.

Also the 'calendar' buffer is affected.

-- 
ke@suse.de (work) / keichwa@gmx.net (home):              |
http://www.suse.de/~ke/                                  |      ,__o
Free Translation Project:                                |    _-\_<,
http://www.iro.umontreal.ca/contrib/po/HTML/             |   (*)/'(*)

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://mail.gnu.org/mailman/listinfo/emacs-devel

Re: calendar: trailing whitespace (Re: texinfo-all-menus-update)

[Karl Eichwalder]

Karl Eichwalder <ke@gnu.franken.de> writes:

> "Robert J. Chassell" <bob@rattlesnake.com> writes:
>
>>    Is there any reason why texinfo-all-menus-update produces trailing
>>    whitespace after the menu entries?
>>
>> No reason.  It is a bug.  I never noticed it doing that, and am glad
>> you found it.  I dislike trailing whitespace.
>
> Also the 'calendar' buffer is affected.

The solution or work around is obvious. IMO: make whitespace.el ignore
read-only buffers by default.

-- 
ke@suse.de (work) / keichwa@gmx.net (home):              |
http://www.suse.de/~ke/                                  |      ,__o
Free Translation Project:                                |    _-\_<,
http://www.iro.umontreal.ca/contrib/po/HTML/             |   (*)/'(*)

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://mail.gnu.org/mailman/listinfo/emacs-devel

Re: texinfo-all-menus-update

[Robert J. Chassell]

    >>    Is there any reason why texinfo-all-menus-update produces
    >>    trailing whitespace after the menu entries?
    >>
    >> No reason.  It is a bug.  I never noticed it doing that, and am
    >> glad you found it.  I dislike trailing whitespace.

On looking at it again, I found the reason for the trailing whitespace
after the menu entries (or at least one of the reasons).
The whitespace is intended as a feature.

The whitespace is designed to make it easier to write a descriptive
phrase or sentence that explains what the node is about, either
directly or with the help of the `texinfo-start-menu-description'
command.  You start the description after the whitespace, which
provides an indent to a specificed column, so all your descriptions
are lined up.

(See the Texinfo Info File,
    Node: Menu Parts, and Node: Inserting; 
or the printed Texinfo Manual Section: 
    `The Parts of a Menu' and `Inserting Frequently Used Commands'.)

In general, menus should contain descriptions, even though technically
they are optional.  This is because node names and section titles are
often too short to explain the node well.

The whitespace comes from the `texinfo-insert-menu' command which, as
its documentation says,

    Indents the first line of the description, if any, to the value of
    texinfo-column-for-description.

The `texinfo-all-menus-update', `texinfo-master-menu', and
`texinfo-make-menu' commands all call the `texinfo-insert-menu'
command.  Also, they automatically incorporate the descriptions from
pre-existing menus, if they exist.

The design question is whether `texinfo-all-menus-update' should make
it easier to add descriptions to menu entries that lack them; or
whether the command should make it easier to avoid adding such
descriptions.

I favor menu entries with descriptions.  Consequently, I have changed
my mind and suggest treating the current functionality as a feature
rather than as a bug.

As you work on a Texinfo document, you can remove all trailing
whitespace with the `delete-trailing-whitespace' command.  (For
convenience I have bound a function key to that command; I use it 
frequently.)

-- 
    Robert J. Chassell                  bob@rattlesnake.com
    Rattlesnake Enterprises             http://www.rattlesnake.com

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://mail.gnu.org/mailman/listinfo/emacs-devel

Re: texinfo-all-menus-update

[Richard Stallman]

    I favor menu entries with descriptions.  Consequently, I have changed
    my mind and suggest treating the current functionality as a feature
    rather than as a bug.

The argument seems reasonable--could you document this in
thefunction's doc string?


_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://mail.gnu.org/mailman/listinfo/emacs-devel