From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: [Emacs-diffs] emacs-24 r117559: Fix bug #18636 with documentation of multi-monitor displays. Date: Thu, 09 Oct 2014 20:57:51 +0300 Message-ID: <83iojtazxc.fsf@gnu.org> References: <83vbnuib0y.fsf@gnu.org> <83oatlitqk.fsf@gnu.org> <83mw95b1qy.fsf@gnu.org> <5bwq89f86w.fsf@fencepost.gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1412877487 18647 80.91.229.3 (9 Oct 2014 17:58:07 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 9 Oct 2014 17:58:07 +0000 (UTC) Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org To: Glenn Morris Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Oct 09 19:57:59 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1XcHyR-0001my-1W for ged-emacs-devel@m.gmane.org; Thu, 09 Oct 2014 19:57:59 +0200 Original-Received: from localhost ([::1]:44501 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XcHyQ-000836-JH for ged-emacs-devel@m.gmane.org; Thu, 09 Oct 2014 13:57:58 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:50751) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XcHyA-00082r-8U for emacs-devel@gnu.org; Thu, 09 Oct 2014 13:57:47 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XcHy5-0005On-4k for emacs-devel@gnu.org; Thu, 09 Oct 2014 13:57:42 -0400 Original-Received: from mtaout26.012.net.il ([80.179.55.182]:57923) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XcHy4-0005OF-TW; Thu, 09 Oct 2014 13:57:37 -0400 Original-Received: from conversion-daemon.mtaout26.012.net.il by mtaout26.012.net.il (HyperSendmail v2007.08) id <0ND600700UIPI200@mtaout26.012.net.il>; Thu, 09 Oct 2014 20:55:47 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout26.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0ND6009ELV4ZNS00@mtaout26.012.net.il>; Thu, 09 Oct 2014 20:55:47 +0300 (IDT) In-reply-to: <5bwq89f86w.fsf@fencepost.gnu.org> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 80.179.55.182 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:175196 Archived-At: > From: Glenn Morris > 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)