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: Sat, 12 Sep 2009 11:55:47 +0300 Message-ID: <83zl90zgmk.fsf@gnu.org> References: <83pr9x26s2.fsf@gnu.org> Reply-To: Eli Zaretskii , 4402@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org X-Trace: ger.gmane.org 1252746440 5780 80.91.229.12 (12 Sep 2009 09:07:20 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 12 Sep 2009 09:07:20 +0000 (UTC) Cc: 4402@emacsbugs.donarmstrong.com To: Glenn Morris Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Sep 12 11:07:13 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 1MmOZc-0001Ie-JD for geb-bug-gnu-emacs@m.gmane.org; Sat, 12 Sep 2009 11:07:12 +0200 Original-Received: from localhost ([127.0.0.1]:55467 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MmOZb-0008MF-6k for geb-bug-gnu-emacs@m.gmane.org; Sat, 12 Sep 2009 05:07:11 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1MmOZX-0008MA-FU for bug-gnu-emacs@gnu.org; Sat, 12 Sep 2009 05:07:07 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1MmOZS-0008Hi-If for bug-gnu-emacs@gnu.org; Sat, 12 Sep 2009 05:07:06 -0400 Original-Received: from [199.232.76.173] (port=47354 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1MmOZS-0008Ha-Gi for bug-gnu-emacs@gnu.org; Sat, 12 Sep 2009 05:07:02 -0400 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:35111) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1MmOZR-0002La-Dv for bug-gnu-emacs@gnu.org; Sat, 12 Sep 2009 05:07:01 -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 n8C96xdJ026633; Sat, 12 Sep 2009 02:06:59 -0700 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id n8C9548U025883; Sat, 12 Sep 2009 02:05:04 -0700 Resent-Date: Sat, 12 Sep 2009 02:05:04 -0700 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Eli Zaretskii Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Sat, 12 Sep 2009 09:05:04 +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.125274575524204 (code B ref 4402); Sat, 12 Sep 2009 09:05:04 +0000 Original-Received: (at 4402) by emacsbugs.donarmstrong.com; 12 Sep 2009 08:55:55 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from mtaout3.012.net.il (mtaout4.012.net.il [84.95.2.10]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id n8C8trCZ024201 for <4402@emacsbugs.donarmstrong.com>; Sat, 12 Sep 2009 01:55:54 -0700 Original-Received: from conversion-daemon.i_mtaout3.012.net.il by i_mtaout3.012.net.il (HyperSendmail v2004.12) id <0KPU00E00ORU2T00@i_mtaout3.012.net.il> for 4402@emacsbugs.donarmstrong.com; Sat, 12 Sep 2009 11:55:47 +0300 (IDT) Original-Received: from HOME-C4E4A596F7 ([84.228.50.163]) by i_mtaout3.012.net.il (HyperSendmail v2004.12) with ESMTPA id <0KPU00KV8OSZR7A0@i_mtaout3.012.net.il>; Sat, 12 Sep 2009 11:55:47 +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: Sat, 12 Sep 2009 05:07:06 -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:31005 Archived-At: > From: Glenn Morris > Cc: 4402@emacsbugs.donarmstrong.com > Date: Fri, 11 Sep 2009 14:05:32 -0400 > > Eli Zaretskii wrote: > > > DOC is an architecture-independent file, so it must include the doc > > strings of all symbols. > > My question is, why must DOC be architecture independent? > There are certianly drawbacks to this, so what's the benefit? The main benefit is that it can be installed only once for several different architectures, like all the Lisp files. Another benefit is that the doc strings are available on all platforms, no matter if the doc string is read from a Lisp file or from DOC. This is handy when, e.g., one writes an emulation for a platform-specific function on another platform. It also provides a common base for discussing interfaces and doc strings.