Re: [Emacs-diffs] emacs-24 r117559: Fix bug #18636 with documentation of multi-monitor displays.

[Eli Zaretskii <eliz@gnu.org>]

> From: Glenn Morris <rgm@gnu.org>
> Cc: monnier@iro.umontreal.ca,  emacs-devel@gnu.org
> Date: Thu, 09 Oct 2014 13:45:43 -0400
> 
> Eli Zaretskii wrote:
> 
> >> BTW, in emacs+lispref, @example wins over @lisp in the ratio 50:1.
> >
> > Evidently, many people don't even know that @lisp exists.
> 
> It seems pointless to me. Quoth the texinfo manual:
> 
>     This is useful, for example, if you write a function that evaluates
>     only and all the Lisp code in a Texinfo file. Then you can use the
>     Texinfo file as a Lisp library.
> 
> This example cannot be evaluated as lisp.

Selective citation alert!  Here's the full one, with key parts
highlighted:

  The '@lisp' command is used for Lisp code.  It is synonymous with the
  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  '@example' command.

       This is an example of text written between an
       @lisp command and an @end lisp command.

    Use '@lisp' instead of '@example' to preserve information regarding
  the nature of the example.          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  ^^^^^^^^^^^^^^^^^^^^^^^^^
                              This is useful, for example, if you write a
                                              ^^^^^^^^^^^
  function that evaluates only and all the Lisp code in a Texinfo file.
  Then you can use the Texinfo file as a Lisp library.(1)