From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.bugs Subject: bug#12686: PATCH: ambiguous help doc strings Date: Tue, 23 Oct 2012 11:04:07 +0300 Organization: JURTA Message-ID: <87wqyh7i20.fsf@mail.jurta.org> References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1350979764 10444 80.91.229.3 (23 Oct 2012 08:09:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 23 Oct 2012 08:09:24 +0000 (UTC) Cc: 12686@debbugs.gnu.org To: "Aaron S. Hawley" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Tue Oct 23 10:09:30 2012 Return-path: Envelope-to: geb-bug-gnu-emacs@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 1TQZYH-0000pa-5X for geb-bug-gnu-emacs@m.gmane.org; Tue, 23 Oct 2012 10:09:29 +0200 Original-Received: from localhost ([::1]:40451 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TQZY9-0000Vv-EF for geb-bug-gnu-emacs@m.gmane.org; Tue, 23 Oct 2012 04:09:21 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:44586) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TQZY6-0000V1-B9 for bug-gnu-emacs@gnu.org; Tue, 23 Oct 2012 04:09:19 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TQZXz-00064w-Lu for bug-gnu-emacs@gnu.org; Tue, 23 Oct 2012 04:09:18 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:46672) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TQZXz-00064s-IX for bug-gnu-emacs@gnu.org; Tue, 23 Oct 2012 04:09:11 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1TQZZm-0000YI-Bk for bug-gnu-emacs@gnu.org; Tue, 23 Oct 2012 04:11:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Juri Linkov Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 23 Oct 2012 08:11:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 12686 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 12686-submit@debbugs.gnu.org id=B12686.13509798212063 (code B ref 12686); Tue, 23 Oct 2012 08:11:02 +0000 Original-Received: (at 12686) by debbugs.gnu.org; 23 Oct 2012 08:10:21 +0000 Original-Received: from localhost ([127.0.0.1]:56922 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TQZZ6-0000XE-I4 for submit@debbugs.gnu.org; Tue, 23 Oct 2012 04:10:21 -0400 Original-Received: from ps18281.dreamhost.com ([69.163.218.105]:53913 helo=ps18281.dreamhostps.com) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TQZYz-0000Wl-AF for 12686@debbugs.gnu.org; Tue, 23 Oct 2012 04:10:17 -0400 Original-Received: from localhost (ps18281.dreamhostps.com [69.163.218.105]) by ps18281.dreamhostps.com (Postfix) with ESMTP id E8513451CCB1; Tue, 23 Oct 2012 01:08:19 -0700 (PDT) In-Reply-To: (Aaron S. Hawley's message of "Fri, 19 Oct 2012 16:58:06 -0400") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2.50 (x86_64-pc-linux-gnu) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:65908 Archived-At: > In order to check all the doc strings in Emacs, all the libraries in > Emacs need to be loaded. Unfortunately, Emacs crashes or becomes > unusable when doing this. Some libraries need to be skipped. This > could be because a library is loaded more than once since I use > `load-library' rather than `require'. To avoid crashes after loading all the libraries I suggest to try static analysis without loading the libraries. This is possible to do with a function like `emacs-lisp-grep' from http://lists.gnu.org/archive/html/emacs-devel/2005-05/msg01259.html When the first element of an expression read from the source file is `defun', its docstring is in the fourth element. A variable name is the second element of the expression whose first element is `defvar' or `defcustom', etc. Conditional defvars are more tricky to process but fortunately they are rare.