From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail
From: Noam Postavsky <npostavs@gmail.com>
Newsgroups: gmane.emacs.bugs
Subject: bug#28607: 27.0.50; help-fns unsolicited elisp loading
Date: Mon, 20 May 2019 13:49:34 -0400
Message-ID: <875zq5audt.fsf@gmail.com>
References: <87efqtoc9u.fsf@udel.edu> <3cvak51n96.fsf@fencepost.gnu.org>
	<20170926155126.kujypxt33oxbzxsq@logos.localdomain>
	<83in5xjzak.fsf@gnu.org>
	<CAKyxw10XCzp1fY96vcm_Ep_hZsF3a-YQeUnSkUc1p5WvPtDYhw@mail.gmail.com>
	<bjk1qdds39.fsf@fencepost.gnu.org>
	<CAKyxw13--qefNuxLQNjvsH7WRQHs0ucGmT9bXeZ3eVvtE-rdXA@mail.gmail.com>
	<874l5vf8q5.fsf@gmail.com> <83sgtecyen.fsf@gnu.org>
	<87tvdrda6j.fsf@gmail.com> <83woin91sj.fsf@gnu.org>
Mime-Version: 1.0
Content-Type: text/plain
Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226";
	logging-data="30733"; mail-complaints-to="usenet@blaine.gmane.org"
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.2 (gnu/linux)
Cc: mvoteiza@udel.edu, 28607@debbugs.gnu.org, monnier@iro.umontreal.ca
To: Eli Zaretskii <eliz@gnu.org>
Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon May 20 19:50:22 2019
Return-path: <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>
Envelope-to: geb-bug-gnu-emacs@m.gmane.org
Original-Received: from lists.gnu.org ([209.51.188.17])
	by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256)
	(Exim 4.89)
	(envelope-from <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	id 1hSmQV-0007qM-HX
	for geb-bug-gnu-emacs@m.gmane.org; Mon, 20 May 2019 19:50:19 +0200
Original-Received: from localhost ([127.0.0.1]:39571 helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>)
	id 1hSmQT-0005se-UT
	for geb-bug-gnu-emacs@m.gmane.org; Mon, 20 May 2019 13:50:18 -0400
Original-Received: from eggs.gnu.org ([209.51.188.92]:38114)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1hSmQF-0005qr-Ae
	for bug-gnu-emacs@gnu.org; Mon, 20 May 2019 13:50:04 -0400
Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1hSmQE-0001zl-6H
	for bug-gnu-emacs@gnu.org; Mon, 20 May 2019 13:50:03 -0400
Original-Received: from debbugs.gnu.org ([209.51.188.43]:52389)
	by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
	(Exim 4.71) (envelope-from <Debian-debbugs@debbugs.gnu.org>)
	id 1hSmQE-0001zf-2V
	for bug-gnu-emacs@gnu.org; Mon, 20 May 2019 13:50:02 -0400
Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
	(envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1hSmQD-00072x-Ss
	for bug-gnu-emacs@gnu.org; Mon, 20 May 2019 13:50:01 -0400
X-Loop: help-debbugs@gnu.org
Resent-From: Noam Postavsky <npostavs@gmail.com>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces@debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@gnu.org
Resent-Date: Mon, 20 May 2019 17:50:01 +0000
Resent-Message-ID: <handler.28607.B28607.155837458427060@debbugs.gnu.org>
Resent-Sender: help-debbugs@gnu.org
X-GNU-PR-Message: followup 28607
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: patch
Original-Received: via spool by 28607-submit@debbugs.gnu.org id=B28607.155837458427060
	(code B ref 28607); Mon, 20 May 2019 17:50:01 +0000
Original-Received: (at 28607) by debbugs.gnu.org; 20 May 2019 17:49:44 +0000
Original-Received: from localhost ([127.0.0.1]:37700 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces@debbugs.gnu.org>)
	id 1hSmPw-00072N-Hr
	for submit@debbugs.gnu.org; Mon, 20 May 2019 13:49:44 -0400
Original-Received: from mail-it1-f179.google.com ([209.85.166.179]:32963)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <npostavs@gmail.com>) id 1hSmPu-00072B-LF
	for 28607@debbugs.gnu.org; Mon, 20 May 2019 13:49:43 -0400
Original-Received: by mail-it1-f179.google.com with SMTP id j17so528655itk.0
	for <28607@debbugs.gnu.org>; Mon, 20 May 2019 10:49:42 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; 
	h=from:to:cc:subject:references:date:in-reply-to:message-id
	:user-agent:mime-version;
	bh=nBxiOj9TsrIZpuM84s7P8bNv1W/YBirTNug5rF+lKYs=;
	b=j+qH+RBzOyQYVThoQcezQcNiz1CnFHiTh+6eR6sQjo2Q51DKdHpxXt6Sa4AmkhkpKA
	1JyMdu93SOE9NOgrWq/9ou3XlX3YoiYqDxKrlaBgFppRDVfjrdEQVpkDXISTzMjGSHMH
	QWDXbjj2k+F8ufL1SLTST9UNHxggugmR+H9C3rAiSMQe2i38i/iey0Ak2AQPuwRrxvWf
	xP7sOZQgzQu9j0td5NjB6TJmy2oV1MEqMMAvqJi/RSgu70KFVBqDolhN+yykZjJO0rPp
	pypf9nxiZxZ/AXoq6txRwiO5y3wjRRI00m4iS8DJ9C5BEnWboM2brlXiTAsCOy5vSTy7
	8Xiw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
	d=1e100.net; s=20161025;
	h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to
	:message-id:user-agent:mime-version;
	bh=nBxiOj9TsrIZpuM84s7P8bNv1W/YBirTNug5rF+lKYs=;
	b=MhJOK3/JupHLnuwOhei6uz+u5Oui6J3IAhw1loYVZzUeL1n5lBVf7A9Vg1vGonUNri
	NMCjVsb/6eogh5Hi8V4UrsL8afOr2P6IxLRw0gdiyQSFLI16oGNiyiAYBGaxBVrKWHHR
	GrkjiY4BXDkFlaL9uIUjTIvzxyskyv/L171VsuEefRlPzNJp8DOOVMCRMeyFVIUJcNkY
	5tjYZ/xoDS9IQXLoGhvFw36w/bXmWiHUE3Y2gpoguI5a3Y16c52ExzvnzBVbrJI2HsTT
	wYMyCTF9Zq2HsUv5I+Y6cxkV15mg+pfbyq9PBwIG1rymKNB+HKi6XgyR2SM0m6eJj71t
	++Xw==
X-Gm-Message-State: APjAAAVTJA2agC+A5as5jRK81SEnszuB+5+P2/JgQ2I2gGarrqgrqDyc
	QEGFKGooaV4INaJckRS4WX8=
X-Google-Smtp-Source: APXvYqyXXT4N7+vbOjI+zPxpQUmQI/MIT6Bg+oJ5QcdpjzxiRMK5impaww/yXUJ3NJ64bX/RoLgADA==
X-Received: by 2002:a24:6583:: with SMTP id u125mr239299itb.168.1558374576721; 
	Mon, 20 May 2019 10:49:36 -0700 (PDT)
Original-Received: from minid (cbl-45-2-119-34.yyz.frontiernetworks.ca. [45.2.119.34])
	by smtp.gmail.com with ESMTPSA id
	d22sm5755309ioc.51.2019.05.20.10.49.35
	(version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
	Mon, 20 May 2019 10:49:35 -0700 (PDT)
In-Reply-To: <83woin91sj.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 18 May
	2019 19:15:40 +0300")
X-BeenThere: debbugs-submit@debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 209.51.188.43
X-BeenThere: bug-gnu-emacs@gnu.org
List-Id: "Bug reports for GNU Emacs,
	the Swiss army knife of text editors" <bug-gnu-emacs.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/bug-gnu-emacs/>
List-Post: <mailto:bug-gnu-emacs@gnu.org>
List-Help: <mailto:bug-gnu-emacs-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-gnu-emacs>,
	<mailto:bug-gnu-emacs-request@gnu.org?subject=subscribe>
Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org
Original-Sender: "bug-gnu-emacs"
	<bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org>
Xref: news.gmane.org gmane.emacs.bugs:159582
Archived-At: <http://permalink.gmane.org/gmane.emacs.bugs/159582>

Eli Zaretskii <eliz@gnu.org> writes:

>> +@node Autoload by Prefix
>> +@subsection Autoload by Prefix
>
> I think a "@cindex autoload by prefix" would be good here.

Sure.

>> +During completion for the commands @code{describe-variable} and
>> +@code{describe-function}, Emacs will try to load files which may
>> +contain definitions matching the prefix being completed.  The variable
>> +@code{definition-prefixes} holds a hashtable which maps a prefix to
>> +the corresponding list of files to load for it.  Entries to this
>> +mapping are added by calls to @code{register-definition-prefixes}
>> +which are generated by @code{update-file-autoloads}.  Files which
>> +don't contain any definitions worth loading (test files, for
>> +examples), should set @code{autoload-compute-prefixes} to @code{nil}
>> +as a file-local variable.
>
> I would add a cross-reference to where update-file-autoloads is
> described after it's mentioned.

Um, how should I do this?  I tried (I've also added
@anchor{update-file-autoloads} below @findex update-file-autoloads):

    the corresponding list of files to load for it.  Entries to this
    mapping are added by calls to @code{register-definition-prefixes}
    which are generated automatically (@pxref{update-file-autoloads,
    @code{update-file-autoloads}}).  Files which don't contain any

But it looks rather strange, it adds an extra period.

    corresponding list of files to load for it.  Entries to this mapping
    are added by calls to `register-definition-prefixes' which are
    generated automatically (*note `update-file-autoloads'
    .).  Files which don't contain any definitions