From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: dieter@duenenhof-wilhelm.de (H. Dieter Wilhelm) Newsgroups: gmane.emacs.devel Subject: Re: [ELPA] New package: inform Date: Fri, 08 May 2020 20:53:42 +0200 Message-ID: <86imh6i7gp.fsf@duenenhof-wilhelm.de> References: <86lfm3k05m.fsf@duenenhof-wilhelm.de> <868si2kfg8.fsf@duenenhof-wilhelm.de> <2f8bf7aa-7160-44b0-9c7b-1ba97adb4496@default> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="20561"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.3 (gnu/linux) Cc: Stefan Monnier , emacs-devel@gnu.org To: Drew Adams Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri May 08 20:54:39 2020 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jX88s-0005GB-RZ for ged-emacs-devel@m.gmane-mx.org; Fri, 08 May 2020 20:54:38 +0200 Original-Received: from localhost ([::1]:46266 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jX88r-0004oX-Tu for ged-emacs-devel@m.gmane-mx.org; Fri, 08 May 2020 14:54:37 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:40488) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jX88E-0003wI-5r for emacs-devel@gnu.org; Fri, 08 May 2020 14:53:58 -0400 Original-Received: from mout.kundenserver.de ([217.72.192.73]:46197) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jX88C-0005kP-BE for emacs-devel@gnu.org; Fri, 08 May 2020 14:53:57 -0400 Original-Received: from ping ([92.116.132.95]) by mrelayeu.kundenserver.de (mreue109 [212.227.15.183]) with ESMTPSA (Nemesis) id 1N6bsG-1j3tBe0BWI-01836z; Fri, 08 May 2020 20:53:44 +0200 In-Reply-To: <2f8bf7aa-7160-44b0-9c7b-1ba97adb4496@default> (Drew Adams's message of "Fri, 8 May 2020 09:23:59 -0700 (PDT)") X-Provags-ID: V03:K1:gB4FxCPk9HIFOp0O4iknGBDr/eJL/tJYGqODl9IiPWf773Q8rGz Xeay4niwtqa1X+sUdllAkyxDcRUKkf1w4WzJS1ew4ymN3qF+L03yjHFSKFdqfxHziCK94ed XP3rFH6BAB8MJKlrw9nVQglXQe/+PrayX6CacY/mCRxb/dARxIhOaOZeuLvf6LnOEI+YVWJ WvhMGWEgr6s40bcBaWcZg== X-UI-Out-Filterresults: notjunk:1;V03:K0:o8qCpkeorag=:RM11M8YF7h8PyWxDmM/nh7 RmlWWchgpZGDEVn0Xi+pzMzaGOX7/tb3b6Hmp9DjoMfQRWtYbO82tVglNezN3f/efCdb2v9yh dfe+ZJ4BZRNWun6AfdvKrsAYbtUnye4e3y12wZKY6Z/FzCRKsYT2c6oI1v70UM8hFk2bmS8v7 J99e/YR1dDxXsnv7wWgCclm+a6tyKM7do2tXazXaO6y+8emg8lmVT1HWdrvjt/FBEAKbEPAVx 7SzxDkIMGNKT510xvnL9hc68s+RtgR+zcy8/7Dejafcgd3vXmzc9OdpajrFualJL0GAb92yTu ML+D5HtsidO8pBtEgHFIYNZ7zdkub65n/97tmX6mFddFcUeTKk5RSUb1SR9FGdTIUXvW0v7EF GTbbfn7gdE5myF+2FL5uKwmoVkSbEAriT16ctG5+Ft2Cwo2KgNwg9++GfdelPGGkhEoJOeqvY cmTu3W8XBK7OR195Xxj8/G622W77jb3UPAgzwU9WnHXh1Di5oCQbuXT2Lro9SulopCAWSVHZh kJBPULJshWlZwA0LhU5XlmLLyOfdTta0oCUGGbzKPX9ly9Kz2x8EGN15xFE04COsYrkC/Q4Xj phsdvu290y5KLr6SzaszRHyXRuXkIDFvYMi25BEHuKuAxO8fXxqlHP4IVg+9Z49yeTDm+cVeN gtwQelMa1X1Md3/knBfdX0OvWDL2S3qHbquV7wzb7BXnqqKSznJuIHBynUmzuOXxJlGc4+R9y SQM2IjZpwXuCoI6RyJZAmyzfJ4RAxIqSDCghrDk34lBvhpDDNRbxpwJHhL2AT+zbVEC8erav Received-SPF: none client-ip=217.72.192.73; envelope-from=dieter@duenenhof-wilhelm.de; helo=mout.kundenserver.de X-detected-operating-system: by eggs.gnu.org: First seen = 2020/05/08 14:53:54 X-ACL-Warn: Detected OS = Linux 3.11 and newer X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, URIBL_BLOCKED=0.001 autolearn=_AUTOLEARN X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:249317 Archived-At: Drew Adams writes: >> I assume it would be easier to create a collection of all >> (important?) Elisp related documents than the opposite. Is it >> possible to ask Emacs package archives programmatically which texinfo >> docs are included? > > In `help-fns+.el' I do something similar: providing links to manual > sections in `*Help*' output. I handle the question of which manuals > to treat with this user option: I downloaded help-fns+.el and it provides, among other things, the inverse functionality of inform: It is putting Info links in *Help* buffers. :-) Which is a georgeous idea because herewith the documentation loop between Help and Info documentation seems to be closed, at least for many, many symbols! :-) > ___ > > help-cross-reference-manuals is a variable defined in `help-fns+.el'. > Its value is (("emacs" "elisp")) Oh, that means (("emacs" "elisp") nil), OK further > Documentation: Manuals to search, for a `*Help*' buffer link to the > manuals. A cons. > > The car is a list of manuals to search, or the symbol `all', to > search all. If nil, then do not create a cross-reference link. > > The cdr is a boolean: > > Non-`nil' means search the manuals, then create a cross-ref link: > create it only if some search hits are found. > > `nil' means create a cross-ref link without searching manuals > first (but only if there are some manuals to search). :set #'(lambda (sym defs) (custom-set-default sym defs) (setq Info-indexed-nodes ())) Hmm, a setter function, why, that's over my horizon... :type '(cons (choice :tag "Which Manuals" (repeat :tag "Specific Manuals (files)" string) (const :tag "All Manuals" all)) (boolean :tag "Search Before Creating Button?")) Aha, I learned how to influence `customize' in a non trivial way, thank you Drew. > IOW, the car of the value is a whitelist of manuals to handle in this > regard. > > The default value corresponds to what Stefan suggested for inform.el's > links in Info: the manuals known to always be appropriate for such > handling: Emacs, Elisp. > > Different users have different sets of Info manuals. It's quite > possible that some will have manuals that are similar to the Emacs and > Elisp manuals in this regard. They can just add them to the list of > manuals to handle. (And they can remove manuals from the list, of > course.) I agree that white- or blacklists should be customisable. > You might want to have a user option for what you're considering wrt > Info links: a whitelist of the manuals to treat. Are you telling me that I can use, in these situtations, one variable for two purposes? 1) For specifying and changing the list and 2) switching a linking for lists off and on? '((list members) t) ; only these '((other members) nil) ; none of these '('all nil) ; no links '('all t) ; link everything? Thanks Dieter -- Best wishes H. Dieter Wilhelm Zwingenberg, Germany