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: /srv/bzr/emacs/trunk r111840: Port documentation to Texinfo 5.0. Date: Fri, 22 Feb 2013 22:50:05 +0200 Message-ID: <83wqu0kr9e.fsf@gnu.org> References: <87txp6ytgg.fsf@bzg.ath.cx> <83621lo9zl.fsf@gnu.org> <51265ACA.9000706@cs.ucla.edu> <83y5ehms5a.fsf@gnu.org> <5ld2vtqyjz.fsf@fencepost.gnu.org> <5126932B.4060007@cs.ucla.edu> <8338woma6c.fsf@gnu.org> <87bobc3x5r.fsf@gmx.de> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1361566238 7775 80.91.229.3 (22 Feb 2013 20:50:38 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 22 Feb 2013 20:50:38 +0000 (UTC) Cc: eggert@cs.ucla.edu, emacs-devel@gnu.org, bzg@altern.org To: Michael Albinus Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Feb 22 21:50:58 2013 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 1U8za5-0002dj-6k for ged-emacs-devel@m.gmane.org; Fri, 22 Feb 2013 21:50:57 +0100 Original-Received: from localhost ([::1]:34669 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U8zZk-0007jC-Qs for ged-emacs-devel@m.gmane.org; Fri, 22 Feb 2013 15:50:36 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:49238) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U8zZe-0007gk-NH for emacs-devel@gnu.org; Fri, 22 Feb 2013 15:50:34 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1U8zZO-0008GU-In for emacs-devel@gnu.org; Fri, 22 Feb 2013 15:50:30 -0500 Original-Received: from mtaout20.012.net.il ([80.179.55.166]:57764) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U8zZO-0008Dd-Ah; Fri, 22 Feb 2013 15:50:14 -0500 Original-Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0MIN00G0034SYZ00@a-mtaout20.012.net.il>; Fri, 22 Feb 2013 22:50:10 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0MIN00GO937MP780@a-mtaout20.012.net.il>; Fri, 22 Feb 2013 22:50:10 +0200 (IST) In-reply-to: <87bobc3x5r.fsf@gmx.de> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 X-Received-From: 80.179.55.166 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:157271 Archived-At: > From: Michael Albinus > Cc: Paul Eggert , rgm@gnu.org, bzg@altern.org, emacs-devel@gnu.org > Date: Fri, 22 Feb 2013 21:34:40 +0100 > > > I think the best way to fix this would be to introduce several macros, > > one each for every number of non-empty arguments, and then use each > > one as needed. A bit less convenient, perhaps, but much more > > straightforward. > > > > The question is would Michael accept this solution. > > I haven't played with texinfo 5 yet, so I cannot say too much. But the > idea of @trampfn was to have just one unique macro with plays for > all. That part is clear from the macro definition and its use. > Before changing this, I would like to check with texinfo 5 whether > it is still possible. What do you mean by "possible"? That macro is the only reason of the error messages tramp.texi triggers from Texinfo 5.0. The new makeinfo clearly does NOT support @set/@clear in the middle of text, and it also doesn't support the @c trick of removing the newline from the expansion of a macro. While it is possible that Texinfo 5.0.1 or some such will be augmented to support these tricks, it is IMO better to avoid them in the first place: that way, the manual will build correctly with any Texinfo version. But it's your decision, eventually. > If I understand Glenn correctly, we have no rush for the emacs-24 > branch (please correct me if I'm wrong). Texinfo 5.0 is out, so if we release Emacs 24.3 with tramp.texi as it is now, people who have Texinfo 5.0 installed will be unable to rebuild the manual if they need to change it for some reason. Not a catastrophe, obviously, but IMO not nice, either: this is, after all, Free Software.