From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Michael Albinus Newsgroups: gmane.emacs.devel Subject: Re: /srv/bzr/emacs/trunk r111840: Port documentation to Texinfo 5.0. Date: Sun, 24 Feb 2013 19:21:41 +0100 Message-ID: <87sj4l374a.fsf@gmx.de> 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> <83wqu0kr9e.fsf@gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1361730232 14326 80.91.229.3 (24 Feb 2013 18:23:52 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 24 Feb 2013 18:23:52 +0000 (UTC) Cc: eggert@cs.ucla.edu, emacs-devel@gnu.org, bzg@altern.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Feb 24 19:24:14 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 1U9gF9-0006TH-Tg for ged-emacs-devel@m.gmane.org; Sun, 24 Feb 2013 19:24:12 +0100 Original-Received: from localhost ([::1]:56075 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U9gEp-0006bo-9K for ged-emacs-devel@m.gmane.org; Sun, 24 Feb 2013 13:23:51 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:55590) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U9gEh-0006ah-Te for emacs-devel@gnu.org; Sun, 24 Feb 2013 13:23:49 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1U9gEg-0001UA-QO for emacs-devel@gnu.org; Sun, 24 Feb 2013 13:23:43 -0500 Original-Received: from mout.gmx.net ([212.227.17.20]:63645) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U9gEg-0001Tx-Gi for emacs-devel@gnu.org; Sun, 24 Feb 2013 13:23:42 -0500 Original-Received: from mailout-de.gmx.net ([10.1.76.27]) by mrigmx.server.lan (mrigmx001) with ESMTP (Nemesis) id 0M6yIl-1V6JBH1Jy9-00wkpk for ; Sun, 24 Feb 2013 19:22:42 +0100 Original-Received: (qmail invoked by alias); 24 Feb 2013 18:21:45 -0000 Original-Received: from p57BB8BC4.dip0.t-ipconnect.de (EHLO detlef.gmx.de) [87.187.139.196] by mail.gmx.net (mp027) with SMTP; 24 Feb 2013 19:21:45 +0100 X-Authenticated: #3708877 X-Provags-ID: V01U2FsdGVkX18MTrp5LM4MsnGj73y5Dw7S9dNNs+v3pD+Kf/qNBk aXz5AdS2Jq3WJB In-Reply-To: <83wqu0kr9e.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 22 Feb 2013 22:50:05 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3.50 (gnu/linux) X-Y-GMX-Trusted: 0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-Received-From: 212.227.17.20 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:157290 Archived-At: Eli Zaretskii writes: >> > 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. > >> 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. I have modified the macro and some of its calls(*) to be compatible with Texinfo 5 (and also with Texinfo 4). There are still some warnings when compiling with Texinfo 5, but the result looks fine. Likely, I will go to the Texinfo ML and ask about the special problems with the Tramp manual. > 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. I've installed it in the emacs-24 branch. I have compiled tramp.texi with both Texinfo 4 and 5, and I have checked carefully the results. I believe, the created info files are acceptable for both versions. (*): The macro does not play well with @multitable and @item. Best regards, Michael.