From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: [ELPA] New package: inform Date: Fri, 8 May 2020 09:23:59 -0700 (PDT) Message-ID: <2f8bf7aa-7160-44b0-9c7b-1ba97adb4496@default> References: <86lfm3k05m.fsf@duenenhof-wilhelm.de> <868si2kfg8.fsf@duenenhof-wilhelm.de> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="34206"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: dieter@duenenhof-wilhelm.de, Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri May 08 18:28:14 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 1jX5rB-0008oW-Th for ged-emacs-devel@m.gmane-mx.org; Fri, 08 May 2020 18:28:13 +0200 Original-Received: from localhost ([::1]:57284 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jX5rA-00012f-Vl for ged-emacs-devel@m.gmane-mx.org; Fri, 08 May 2020 12:28:13 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:58712) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jX5qf-0000Nf-JP for emacs-devel@gnu.org; Fri, 08 May 2020 12:27:41 -0400 Original-Received: from aserp2120.oracle.com ([141.146.126.78]:39020) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jX5qe-0001Jh-4g for emacs-devel@gnu.org; Fri, 08 May 2020 12:27:40 -0400 Original-Received: from pps.filterd (aserp2120.oracle.com [127.0.0.1]) by aserp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 048GRS7S053770; Fri, 8 May 2020 16:27:33 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=f2RAhAx8d8GxJYm2qjP3Ko2FgSudOjdNUNzuPvXlifM=; b=XtDzTqYUeMtOM1lA+CZzN24qhEFfG68ob0axtO75GwThrAadRwqieCMqqKhIibHUsdJd tX7nlVCIhCSsCmI+k1IHu0sgaGwBMk8pdJzT9G1wumFxoQMofBtGG9wUOrV11ILZ+A00 ZPDcUWnk2hGozRTDd1+OzGj04C08ZJBp6jgx87epqtg5UZ0hMv5g47OkJxWYKbxwHEiC ijtYTDDgP68l5Wr+iWVu8DjJCbJwuD9XrwFAUEbidhjVmLhDPYJl0Z543b7bUvYRZ5dy CfBZOVqHPcJiGBX+e7JzpP9crXPPXCNv3yYALia9sgwpbxlnJmkmSVyn34QfiYOIH1jy /w== Original-Received: from userp3020.oracle.com (userp3020.oracle.com [156.151.31.79]) by aserp2120.oracle.com with ESMTP id 30vtepkwef-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 08 May 2020 16:27:30 +0000 Original-Received: from pps.filterd (userp3020.oracle.com [127.0.0.1]) by userp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 048GMjSB090723; Fri, 8 May 2020 16:24:02 GMT Original-Received: from userv0122.oracle.com (userv0122.oracle.com [156.151.31.75]) by userp3020.oracle.com with ESMTP id 30vteh3mwh-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Fri, 08 May 2020 16:24:02 +0000 Original-Received: from abhmp0007.oracle.com (abhmp0007.oracle.com [141.146.116.13]) by userv0122.oracle.com (8.14.4/8.14.4) with ESMTP id 048GO0Zr029292; Fri, 8 May 2020 16:24:00 GMT In-Reply-To: <868si2kfg8.fsf@duenenhof-wilhelm.de> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4993.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9614 signatures=668687 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 adultscore=0 phishscore=0 mlxlogscore=999 bulkscore=0 malwarescore=0 spamscore=0 mlxscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2003020000 definitions=main-2005080140 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9614 signatures=668687 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 spamscore=0 impostorscore=0 phishscore=0 clxscore=1015 priorityscore=1501 lowpriorityscore=0 malwarescore=0 suspectscore=0 mlxscore=0 mlxlogscore=999 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2003020000 definitions=main-2005080140 Received-SPF: pass client-ip=141.146.126.78; envelope-from=drew.adams@oracle.com; helo=aserp2120.oracle.com X-detected-operating-system: by eggs.gnu.org: First seen = 2020/05/08 12:27:36 X-ACL-Warn: Detected OS = Linux 3.x [generic] [fuzzy] X-Spam_score_int: -43 X-Spam_score: -4.4 X-Spam_bar: ---- X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIMWL_WL_HIGH=0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-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:249293 Archived-At: > > It looks fine to me, except that the extra links should only be added > > to those manuals we know are related to Emacs/Elisp (e.g. it doesn't > > make sense to add them to the Coreutils or Ada manuals). >=20 > I agree, there's a danger of "false positives" and suggest looping over > something in the line of > when (string=3D (file-name-nondirectory Info-current-file) "emacs"). >=20 > 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: ___ help-cross-reference-manuals is a variable defined in `help-fns+.el'. Its value is (("emacs" "elisp")) 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). ___ 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.) You might want to have a user option for what you're considering wrt Info links: a whitelist of the manuals to treat.