From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Glenn Morris Newsgroups: gmane.emacs.bugs Subject: bug#4402: apropos-documentation and platform-specific docs Date: Fri, 11 Sep 2009 03:01:04 -0400 Message-ID: Reply-To: Glenn Morris , 4402@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1252658842 27457 80.91.229.12 (11 Sep 2009 08:47:22 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 11 Sep 2009 08:47:22 +0000 (UTC) To: bug-gnu-emacs@gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Fri Sep 11 10:47:16 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 1Mm1ml-0007WR-L9 for geb-bug-gnu-emacs@m.gmane.org; Fri, 11 Sep 2009 10:47:15 +0200 Original-Received: from localhost ([127.0.0.1]:51098 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Mm1mk-0001T2-UT for geb-bug-gnu-emacs@m.gmane.org; Fri, 11 Sep 2009 04:47:14 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Mm1me-0001QD-4j for bug-gnu-emacs@gnu.org; Fri, 11 Sep 2009 04:47:08 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Mm1mZ-0001KC-0n for bug-gnu-emacs@gnu.org; Fri, 11 Sep 2009 04:47:07 -0400 Original-Received: from [199.232.76.173] (port=36144 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Mm1mY-0001K3-SM for bug-gnu-emacs@gnu.org; Fri, 11 Sep 2009 04:47:02 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:57512) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1Mm1mY-0002ln-8V for bug-gnu-emacs@gnu.org; Fri, 11 Sep 2009 04:47:02 -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 n8B8l0sR030547; Fri, 11 Sep 2009 01:47:00 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n8B8e51v029591; Fri, 11 Sep 2009 01:40:05 -0700 Resent-Date: Fri, 11 Sep 2009 01:40:05 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Glenn Morris Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Fri, 11 Sep 2009 08:40:05 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: report 4402 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by submit@emacsbugs.donarmstrong.com id=B.125265786928252 (code B ref -1); Fri, 11 Sep 2009 08:40:05 +0000 Original-Received: (at submit) by emacsbugs.donarmstrong.com; 11 Sep 2009 08:31:09 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from lists.gnu.org (lists.gnu.org [199.232.76.165]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n8B8V6Oh028249 for ; Fri, 11 Sep 2009 01:31:08 -0700 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Mm1X7-0000f3-An for bug-gnu-emacs@gnu.org; Fri, 11 Sep 2009 04:31:05 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Mm1Wz-0000Ya-Oz for bug-gnu-emacs@gnu.org; Fri, 11 Sep 2009 04:31:01 -0400 Original-Received: from [199.232.76.173] (port=45105 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Mm1Wz-0000YF-Et for bug-gnu-emacs@gnu.org; Fri, 11 Sep 2009 04:30:57 -0400 Original-Received: from fencepost.gnu.org ([140.186.70.10]:56429) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1Mm1Wy-0000Ib-LD for bug-gnu-emacs@gnu.org; Fri, 11 Sep 2009 04:30:57 -0400 Original-Received: from rgm by fencepost.gnu.org with local (Exim 4.67) (envelope-from ) id 1Mm080-0002jp-6G; Fri, 11 Sep 2009 03:01:04 -0400 X-Spook: Belknap munitions advisors passwd Montenegro MP5K-SD FBI X-Ran: jW>?9|=o$5v/ku$,\n{[bOlV?.%"9t$,eZ)unleL.=v$6MyyTAjJ^7YJ?y&FuULP%^*J?- X-Hue: red X-Attribution: GM User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Fri, 11 Sep 2009 04:47: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:30949 Archived-At: On GNU/Linux: emacs -Q M-x apropos-documentation nextstep returns various matches, including things like: x-create-frame Function: Make a new Nextstep window, called a "frame" in Emacs terms. [...] The one-line summary is incorrect, since it is the version specific to the NS build, not the build currently running. 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. 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.