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: Interactive hat. (Patch V2) Date: Mon, 27 Apr 2009 21:39:48 +0300 Message-ID: <83skjudjpn.fsf@gnu.org> References: <20090326152738.GF3358@muc.de> <20090326190603.GH3358@muc.de> <20090326233257.GA1008@muc.de> <20090413193255.GA2332@muc.de> <83bpr0nuwo.fsf@gnu.org> <20090423205030.GA2723@muc.de> <83y6tqf9xv.fsf@gnu.org> <20090427114620.GA2605@muc.de> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: ger.gmane.org 1240857652 7511 80.91.229.12 (27 Apr 2009 18:40:52 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 27 Apr 2009 18:40:52 +0000 (UTC) Cc: lekktu@gmail.com, karl@freefriends.org, monnier@iro.umontreal.ca, emacs-devel@gnu.org To: Alan Mackenzie Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Apr 27 20:40:43 2009 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1LyVkv-0008Et-Se for ged-emacs-devel@m.gmane.org; Mon, 27 Apr 2009 20:40:42 +0200 Original-Received: from localhost ([127.0.0.1]:45815 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LyVkv-0006bs-BW for ged-emacs-devel@m.gmane.org; Mon, 27 Apr 2009 14:40:41 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LyVk5-0006LG-28 for emacs-devel@gnu.org; Mon, 27 Apr 2009 14:39:49 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LyVk3-0006L2-Ud for emacs-devel@gnu.org; Mon, 27 Apr 2009 14:39:48 -0400 Original-Received: from [199.232.76.173] (port=48031 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LyVk3-0006Ko-LS for emacs-devel@gnu.org; Mon, 27 Apr 2009 14:39:47 -0400 Original-Received: from mtaout2.012.net.il ([84.95.2.4]:42385) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1LyVk3-0007n9-7W for emacs-devel@gnu.org; Mon, 27 Apr 2009 14:39:47 -0400 Original-Received: from conversion-daemon.i_mtaout2.012.net.il by i_mtaout2.012.net.il (HyperSendmail v2004.12) id <0KIR00J00VS4ON00@i_mtaout2.012.net.il> for emacs-devel@gnu.org; Mon, 27 Apr 2009 21:39:45 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([77.127.175.232]) by i_mtaout2.012.net.il (HyperSendmail v2004.12) with ESMTPA id <0KIR007K9VU6L751@i_mtaout2.012.net.il>; Mon, 27 Apr 2009 21:39:44 +0300 (IDT) In-reply-to: <20090427114620.GA2605@muc.de> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by monty-python.gnu.org: Solaris 9.1 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:110493 Archived-At: > Date: Mon, 27 Apr 2009 11:46:20 +0000 > Cc: lekktu@gmail.com, monnier@iro.umontreal.ca, emacs-devel@gnu.org, > Karl Berry > From: Alan Mackenzie > > > That's an unusual use of @itemx. Beware: it could do something you > > didn't intend in some future version of Texinfo. > > I don't think so; at least, not if makeinfo does what its manual says. > @itemx is defined to be identical to @item, except for not inserting a > blank line. (See page "itemx" in the manual). That's not what I meant. I meant that you in effect have here @item's without the text after them. A @table is not supposed to be like that, so who knows what will the output be? In particular, HTML and XML outputs may assume there always be some text, and if not, fail to properly close the markup. > > This @verbatim is not enough, I think: the typeface used by this > > example will be different from every other example in the manual, > > right? You need to force the same typeface as in @example, somehow. > > > Btw, why didn't @example fit the bill? > > Because @example inserts silly whitespace, of which there is already too > much. It indents to the current indent (e.g., if you are in a @table), and then a couple more columns. I never found that annoying, let alone silly. > I've now joined that body of hackers who hold Texinfo to be > unsuitable for writing manuals in, though it's still much better > than most of the competition. It's like democracy: the worst possible regime, except for all the others. Seriously, though: I have been writing Texinfo manuals and documents for at least 15 years now, and I find it very convenient and the results very nice. Quite a few people asked me how I manage to produce such nice-looking documents in Word ;-) > Don't worry, I'll get over it. Yes, please do.