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: @dircategory entries sync'ed with info/dir Date: Fri, 18 Feb 2011 16:20:27 +0200 Message-ID: <83oc69v2z8.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: dough.gmane.org 1298038918 9146 80.91.229.12 (18 Feb 2011 14:21:58 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 18 Feb 2011 14:21:58 +0000 (UTC) Cc: Bill Wohler , Reiner Steib , Teodor Zlatanov , Michael Kifer , Jay Belanger , Katsumi Yamaoka , Michael Albinus , Carsten Dominik , Alan Mackenzie , Karl Berry To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Feb 18 15:21:52 2011 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.69) (envelope-from ) id 1PqRDS-00031W-NP for ged-emacs-devel@m.gmane.org; Fri, 18 Feb 2011 15:21:50 +0100 Original-Received: from localhost ([127.0.0.1]:44126 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PqRDM-0002XR-Ua for ged-emacs-devel@m.gmane.org; Fri, 18 Feb 2011 09:21:44 -0500 Original-Received: from [140.186.70.92] (port=44410 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PqRD1-0002M0-Nn for emacs-devel@gnu.org; Fri, 18 Feb 2011 09:21:25 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PqRD0-0007EW-U5 for emacs-devel@gnu.org; Fri, 18 Feb 2011 09:21:23 -0500 Original-Received: from mtaout20.012.net.il ([80.179.55.166]:45758) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PqRD0-0007EI-MF for emacs-devel@gnu.org; Fri, 18 Feb 2011 09:21:22 -0500 Original-Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0LGT00300H0RDL00@a-mtaout20.012.net.il> for emacs-devel@gnu.org; Fri, 18 Feb 2011 16:20:22 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([77.124.140.24]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LGT003B0H5VAI30@a-mtaout20.012.net.il>; Fri, 18 Feb 2011 16:20:22 +0200 (IST) X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 (beta) X-Received-From: 80.179.55.166 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:136181 Archived-At: I've committed to the emacs-23 branch changes in almost all of the manuals in doc/misc that synchronize their @dircategory directives with the corresponding entries in the info/dir top-level menu. This is so running install-info on the Emacs Info files does not cause duplicate entries in the menu created by the Info readers from all the `dir' files it finds on INFOPATH. Some of the manuals' master copies are maintained outside of the Emacs repository. I tried to CC all of them here. Please, when merging future versions into the Emacs repository, be extra careful so as not to lose these changes. Ideally, you should sync your master copies with these changes now. Thanks in advance. There's one problem left in this area that I'm unsure what to do about, if at all. The @dircategory directive of info.texi says "Texinfo documentation system", and I believe it is maintained as part of the Texinfo package. The info/dir file that comes with Emacs puts the corresponding menu entry at the very beginning (so that Info newbies could see it), with no category at all. OTOH, changing the @dircategory for info.texi would be frowned upon by the Texinfo maintainers. So I didn't change it for now. Karl, any suggestions? Personally, I tend to think we could leave it alone: if someone runs install-info on the Emacs Info manuals, she probably already has the Texinfo manuals installed anyway, so the entry for `info' will end up in that part, which is okay.