From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#4402: apropos-documentation and platform-specific docs Date: Fri, 11 Sep 2009 12:02:37 +0300 Message-ID: <83pr9x26s2.fsf@gnu.org> References: Reply-To: Eli Zaretskii , 4402@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org X-Trace: ger.gmane.org 1252661266 2376 80.91.229.12 (11 Sep 2009 09:27:46 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 11 Sep 2009 09:27:46 +0000 (UTC) To: Glenn Morris , 4402@emacsbugs.donarmstrong.com Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Sep 11 11:27:39 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1Mm2Pq-0004jU-Ua for geb-bug-gnu-emacs@m.gmane.org; Fri, 11 Sep 2009 11:27:39 +0200 Original-Received: from localhost ([127.0.0.1]:40213 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Mm2Pq-00045s-Ap for geb-bug-gnu-emacs@m.gmane.org; Fri, 11 Sep 2009 05:27:38 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Mm2PN-0003WP-EX for bug-gnu-emacs@gnu.org; Fri, 11 Sep 2009 05:27:09 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Mm2PH-0003O1-Ni for bug-gnu-emacs@gnu.org; Fri, 11 Sep 2009 05:27:07 -0400 Original-Received: from [199.232.76.173] (port=59706 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Mm2PH-0003Ng-8x for bug-gnu-emacs@gnu.org; Fri, 11 Sep 2009 05:27:03 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:46343) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Mm2PG-0002To-PC for bug-gnu-emacs@gnu.org; Fri, 11 Sep 2009 05:27:03 -0400 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n8B9QxiR005539; Fri, 11 Sep 2009 02:26:59 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n8B9A74X002956; Fri, 11 Sep 2009 02:10:07 -0700 Resent-Date: Fri, 11 Sep 2009 02:10:07 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Eli Zaretskii Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Fri, 11 Sep 2009 09:10:06 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: followup 4402 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by 4402-submit@emacsbugs.donarmstrong.com id=B4402.12526598781308 (code B ref 4402); Fri, 11 Sep 2009 09:10:06 +0000 Original-Received: (at 4402) by emacsbugs.donarmstrong.com; 11 Sep 2009 09:04:38 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from mtaout7.012.net.il (mtaout7.012.net.il [84.95.2.19]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n8B94aV3001303 for <4402@emacsbugs.donarmstrong.com>; Fri, 11 Sep 2009 02:04:38 -0700 Original-Received: from conversion-daemon.i-mtaout7.012.net.il by i-mtaout7.012.net.il (HyperSendmail v2007.08) id <0KPS00K00U0TCY00@i-mtaout7.012.net.il> for 4402@emacsbugs.donarmstrong.com; Fri, 11 Sep 2009 12:04:29 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([84.228.50.163]) by i-mtaout7.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0KPS0024HUJHBL00@i-mtaout7.012.net.il>; Fri, 11 Sep 2009 12:04:29 +0300 (IDT) In-reply-to: X-012-Sender: halo1@inter.net.il X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Fri, 11 Sep 2009 05:27:07 -0400 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:30951 Archived-At: > From: Glenn Morris > Date: Fri, 11 Sep 2009 03:01:04 -0400 > Cc: > > The problem is caused by the DOC file containing three sets of > doc-strings for Fx-create-frame, extracted from w32fns.c, xfns.c, and > nsfns.m. > > This made me wonder, why does the DOC file in my GNU/Linux build > contain information extracted from Nextstep and Windows files that is > never going to be relevant? Perhaps it's so that one can in principle > share DOC files between different builds? This doesn't seem like a big > advantage to me. I doubt (m)any people have ever shared the DOC file > between any of these platforms. The size of DOC is a negligible part of > a current Emacs installation. DOC is an architecture-independent file, so it must include the doc strings of all symbols. > The standard solution to this kind of thing seems to be that where > functions/variables have multiple, platform-specific definitions, each > should have the same, unified doc-string. This is a bit of a pain. > > Only putting the relevant files into the DOC file would eliminate this > issue. There are other solutions, but they need some infrastructure. See past discussions of this issue a couple of months ago.