bug#12849: 24.2.50; Doc: `message': mention `message-log-max'

bug#12849: 24.2.50; Doc: `message': mention `message-log-max'

[Michael Heerdegen]

Hi,

I made the experience that many people don't know that logging messages
(printed with `message') in the *Messages* buffer can be prevented with
binding `message-log-max' to nil.

Indeed, it's not easy to find in the doc, and the name `message-log-max'
also doesn't sound as if this variable could have this effect.

I think we should mention this effect of binding `message-log-max' to
nil in the docstring of `message', e.g. by changing this sentence:

The message also goes into the `*Messages*' buffer.

to

The message also goes into the `*Messages*' buffer if `message-log-max'
is not nil.


Thanks,

Michael.


In GNU Emacs 24.2.50.1 (x86_64-pc-linux-gnu, GTK+ Version 3.4.2)
 of 2012-11-01 on dex, modified by Debian
 (emacs-snapshot package, version 2:20121101-1)
Windowing system distributor `The X.Org Foundation', version 11.0.10707000
System Description:	Debian GNU/Linux testing (wheezy)

bug#12849: 24.2.50; Doc: `message': mention `message-log-max'

[Leo]

On 2012-11-10 08:14 +0800, Michael Heerdegen wrote:
> I made the experience that many people don't know that logging messages
> (printed with `message') in the *Messages* buffer can be prevented with
> binding `message-log-max' to nil.

How about adding:

(defsubst message-nolog (format-string &rest args)
  "Same as `message' except not writing to *Messages* buffer."
  (let (message-log-max) (apply 'message format-string args)))

This could encourage elisp authors to choose what to log to *Messages*
buffer. For example, ff-quiet-mode defaults to nil and, boy, this
library can write thousands of useless lines to *Messages* buffer.

Leo

bug#12849: 24.2.50; Doc: `message': mention `message-log-max'

[Michael Heerdegen]

Leo <sdl.web@gmail.com> writes:

> How about adding:
>
> (defsubst message-nolog (format-string &rest args)
>   "Same as `message' except not writing to *Messages* buffer."
>   (let (message-log-max) (apply 'message format-string args)))
>
> This could encourage elisp authors to choose what to log to *Messages*
> buffer. For example, ff-quiet-mode defaults to nil and, boy, this
> library can write thousands of useless lines to *Messages* buffer.

I would appreciate something like that (besides improving the doc).

Maybe the same could be done for `with-temp-message'.


Regards,

Michael. 

bug#12849: 24.2.50; Doc: `message': mention `message-log-max'

[Glenn Morris]

Version: 24.3

Michael Heerdegen wrote:

> I think we should mention this effect of binding `message-log-max' to
> nil in the docstring of `message'

Thanks; done.