From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.devel Subject: RE: [External] : Re: Would you say this information window is well designed? Date: Mon, 22 Feb 2021 22:30:12 +0000 Message-ID: References: <83sg5oueex.fsf@gnu.org> <83o8gbvr4m.fsf@gnu.org> <84e3f5ab-436e-c0ea-39f1-2466f3227910@yandex.ru> <87im6jepft.fsf@gnus.org> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="5233"; mail-complaints-to="usenet@ciao.gmane.io" Cc: "laszlomail@protonmail.com" , Eli Zaretskii , "emacs-devel@gnu.org" To: Lars Ingebrigtsen , Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Feb 22 23:31:43 2021 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 1lEJjz-0001Ge-9o for ged-emacs-devel@m.gmane-mx.org; Mon, 22 Feb 2021 23:31:43 +0100 Original-Received: from localhost ([::1]:36702 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lEJjy-0005jB-C0 for ged-emacs-devel@m.gmane-mx.org; Mon, 22 Feb 2021 17:31:42 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:43500) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lEJij-00052j-1U for emacs-devel@gnu.org; Mon, 22 Feb 2021 17:30:25 -0500 Original-Received: from userp2120.oracle.com ([156.151.31.85]:40738) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lEJig-0001Ay-8l; Mon, 22 Feb 2021 17:30:24 -0500 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 11MMSdQg044392; Mon, 22 Feb 2021 22:30:15 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=corp-2020-01-29; bh=627f4X77zQ1nZ8GmuqFriwW5AJMUgjSjLNnZABPlCtY=; b=mOBI00oqmzFH1y2ekum+StlV5fJJpPaFQuytx3XCl++Zlx+d/N66WRTAK7gUUaHd9G39 4qLeDloVZxzjWtnOrDeoGQVRB3uoV5jegZEZ1fwmjjj0xBN2eA4fDLvyLkcBU9EEL2b/ u9qKmRi4AiFd1/e/L2Yv5KtRQ7FsgaKWkDLIs5zfymSJrOGZqsFsZSp+3CSFa15RXIgz njndGQ3ow0ICJ2/fI0qf1qZl3x1GSlT6VJbM91f0QvgOGPXc3yLpBPA2ToxXIg5CQLnO 2LmpZ570ID0JecNWj/fmOioPmrGaOdbfJocmeb/26XdlSiY8d0F5GWuUSNUue4GrLpJv rA== Original-Received: from aserp3020.oracle.com (aserp3020.oracle.com [141.146.126.70]) by userp2120.oracle.com with ESMTP id 36ugq3c7nv-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 22 Feb 2021 22:30:15 +0000 Original-Received: from pps.filterd (aserp3020.oracle.com [127.0.0.1]) by aserp3020.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 11MMKWao052580; Mon, 22 Feb 2021 22:30:14 GMT Original-Received: from nam12-mw2-obe.outbound.protection.outlook.com (mail-mw2nam12lp2043.outbound.protection.outlook.com [104.47.66.43]) by aserp3020.oracle.com with ESMTP id 36ucaxm2eb-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Mon, 22 Feb 2021 22:30:14 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=NcvH1UURja+c9t/gJY153t03ZKqGgca/d6n9EKnVgIhQ4obMcHp+DHyvCqeQk7VsdUVuKiqYb4KC/1Lua1Wq9ENXBfddQK6lDlKSIuFmR937BTG0mEpXzMRuzjM2SuVvHPCKpahgXMP4rB18btjBd9qUvZdT2r6C6BvUPN48tH+DejwwTF4qOZaqjO0pbvFCh/pWlAHF278+WeO/7aQ+lomoeCN0reuIGZMzTTYSZ0oCtleChv5qhzXav3weDvC74mnCIxHFWfo9kQ0SHV+rpsQiHpeQF/dJJF/PMe1dzuCZwh2Grg34MM6ExDW/ElOwGkn5Wov4b5naL/Np/4yzHg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=627f4X77zQ1nZ8GmuqFriwW5AJMUgjSjLNnZABPlCtY=; b=CxF+1wK2SorDfD8i8d+aHcb5R2jrOEf86nb80o+ZMz4DMDuBwz8gbFb5GgJStJ30MZpeASOBz76a6uoiDsm6Y1r0Lw8yDhMyB14EdM8goz9Ci3m0lFg+JD0Kstwcp1Au5gaD3Q2FTivgFCGUTA/c6xK8mPTgce9QR1kJc4ZMgVP2amTOGxF7+MBd9ALaHZsOniGG6nxT+3zt8IGo6byjVLVMTxRSoOQoEe55OJf/uXnuEA/4U7DxgiVL6oZmiaiDFFLhfVTituKks+l85wZE5YETZySrw+wZpphYIsqj0a8M8ak5ZseRiZOdK9rH/jSnsizDZiUYsUw2lByTD6z5Vg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=oracle.com; dmarc=pass action=none header.from=oracle.com; dkim=pass header.d=oracle.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.onmicrosoft.com; s=selector2-oracle-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=627f4X77zQ1nZ8GmuqFriwW5AJMUgjSjLNnZABPlCtY=; b=CeEK1QuKOr8zAfFtAbL/2zVpElecWD5QUTDJAQsqcat4+FX9QUvlgnFrjYa+7OlaGI4RdxOvsHN8psunpySl0UBaqLNDHYcokTS8GqBYAz1KfEksbx3viObIdgJ7eu/y3ZjWB9gNd3LBhRdyEmj7rs7dbrDxSOGuqOAlTGXVSxQ= Original-Received: from SA2PR10MB4474.namprd10.prod.outlook.com (2603:10b6:806:11b::15) by SA2PR10MB4411.namprd10.prod.outlook.com (2603:10b6:806:116::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3868.29; Mon, 22 Feb 2021 22:30:12 +0000 Original-Received: from SA2PR10MB4474.namprd10.prod.outlook.com ([fe80::b8d2:db6d:3e4b:d315]) by SA2PR10MB4474.namprd10.prod.outlook.com ([fe80::b8d2:db6d:3e4b:d315%5]) with mapi id 15.20.3868.032; Mon, 22 Feb 2021 22:30:12 +0000 Thread-Topic: [External] : Re: Would you say this information window is well designed? Thread-Index: AQHXCWXUCDdc/H/wZUKx06r9Zxq5Oapkv4Lw In-Reply-To: <87im6jepft.fsf@gnus.org> Accept-Language: en-US Content-Language: en-US authentication-results: gnus.org; dkim=none (message not signed) header.d=none;gnus.org; dmarc=none action=none header.from=oracle.com; x-originating-ip: [73.170.83.28] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 16280500-c912-4538-eca9-08d8d7816b6a x-ms-traffictypediagnostic: SA2PR10MB4411: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:9508; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: +BYzz+BnEzq4M31QqKcg8OK1qekX89WiuMAWeR7VWgUbSF7Aadm+O+26MFz74iIxVd/nSahZMGiwfuq8UTGoMMbYJEmKkiqphtgVlB+cd4nboKAYQXk4cWdD7usf85OnGXZpIzQh4e0BpdSfsOhRAyX95ozz8eR5aFbdgmeJLPrbf5VB6MGHltRkMkdR6jUyriu78jj64ExLH4cM/OiHovQl9brvguPNk0DDHTIZdVD9egTCMgfugYeD9uwKtLha7rD/Ase/ihOP+PcxGJFVrUVWnAM0IWHfnqn+mQKxyREnsDs6osVPg3hjZuTKAysVvaYqbQd0Fhrw64iGx9no1GyhRP7+doYu82ltYBkY8dczQEkf1tq4s1syjzSJaK7mcjifV86VfZiADkQJdcClk1cwDyJ+nl7pXFYT56yK7EYaIF4rCzCjkNnzLA7B70SJzBKej3vs1IRmx1t96/Xcz0IZ0jvUsXcOiHWP5zCFnVI5x8dkdEvf1H6SENRpJ6yBXjXGnOvoDlzTa5pqWqz2/Q== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SA2PR10MB4474.namprd10.prod.outlook.com; PTR:; CAT:NONE; SFS:(346002)(366004)(396003)(39860400002)(136003)(376002)(8936002)(478600001)(66946007)(9686003)(55016002)(86362001)(33656002)(7696005)(54906003)(110136005)(186003)(83380400001)(316002)(66446008)(4326008)(6506007)(5660300002)(8676002)(26005)(2906002)(71200400001)(44832011)(52536014)(64756008)(76116006)(66556008)(66476007); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: =?us-ascii?Q?qNAjdnWKi/ZxOBpezfEGJ/S9AWh7xO6bSrVGlhVE+mJfJKujriBzSiF1BiDy?= =?us-ascii?Q?YeFHwKeYICT2AO9FQgfSZWlnHZ4Q3urIsCtQgSywIQGSq4pIPPfVnGYbPN+J?= =?us-ascii?Q?JnH4uAnFszPHheYrVJhZmkrNRP6dupDYtGCzPDqLxS/8hcBGmlyLYA5cipkG?= =?us-ascii?Q?snsK3bRE5n9psAuf3QGZtTlR801C4LIzkhdxFNJKVCZU9L4xNx3rT7/9mnec?= =?us-ascii?Q?XP96gncZhdhVutzR8scMFD9IhiKaclfJYAy1Wu1fzCNYmXSE411ZiNVzUdel?= =?us-ascii?Q?1nNui0C+BPeOEKjNnmJ5sNHQPgxx4HVoATJZjP9jcPnxVwKnYnRMOOf+IRsF?= =?us-ascii?Q?cItXiDFm9M9D/eLsr0DcPvoeX+EwB9f6/5idDDd0A4MZkB+WVvu8didpoSdT?= =?us-ascii?Q?70snBHDl9+3YjKAXnH4OOyc26pzpy6AKNzHYqKWCu8jtsq0k6hI1gksJ9nCB?= =?us-ascii?Q?tIoqSOKWB+zYVHYUA04LgkEZ1PavPGnep9ExkX/r+QeWpwEva+L8FgWIxKv8?= =?us-ascii?Q?V5mBQUGKlSMR/iR8JHeIS9wZOwatDjEetPOQ4OUflFoNZhJrTazP2gYJ9fhm?= =?us-ascii?Q?zF66kzX2qsCnc0XC0AlLI9YGavenC0gAIp4X5SbQGpydNtzxXpjLWLU7ACre?= =?us-ascii?Q?eJts x-ms-exchange-transport-forked: True X-OriginatorOrg: oracle.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SA2PR10MB4474.namprd10.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 16280500-c912-4538-eca9-08d8d7816b6a X-MS-Exchange-CrossTenant-originalarrivaltime: 22 Feb 2021 22:30:12.5200 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 4e2c6054-71cb-48f1-bd6c-3a9705aca71b X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: PPaX5Ru5Oji+1hl4k6vQOfx7PiMpTtjQwsfK7XBuKzyJAbJp0J0zFbrOOcfI/pA/WU6JWZsl06BzYWijwJ7O0A== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA2PR10MB4411 X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=9903 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0 suspectscore=0 malwarescore=0 mlxlogscore=999 adultscore=0 bulkscore=0 mlxscore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2102220192 X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=9903 signatures=668683 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 phishscore=0 malwarescore=0 spamscore=0 mlxscore=0 suspectscore=0 priorityscore=1501 clxscore=1011 impostorscore=0 lowpriorityscore=0 mlxlogscore=999 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2102220193 Received-SPF: pass client-ip=156.151.31.85; envelope-from=drew.adams@oracle.com; helo=userp2120.oracle.com 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, 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 autolearn=ham autolearn_force=no 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:265512 Archived-At: > I think linking to the manual (as much as practically possible) from > *Help* is a good idea. However, `info-lookup-symbol' (the innards of > which we basically have to call) is a bit on the slow side. I don't find it slow. And it can be invoked only when a user clicks (or uses RET) on a link. I do that (in help-fns+.el) when the only manuals to be searched are Emacs and Elisp. This is the logic I use, FWIW: ,---- | Info-make-manuals-xref is a Lisp function in 'help-fns+.el'. |=20 | (Info-make-manuals-xref OBJECT &optional NO-NEWLINES-AFTER-P | MANUALS-SPEC NOMSG) |=20 | For more information see the manuals. |=20 | Create a cross-ref link for entries for OBJECT in manuals. | Non-`nil' optional arg NO-NEWLINES-AFTER-P means do not add two | newlines after the cross reference. |=20 | Optional arg MANUALS-SPEC controls which manuals to search. It has | the same form as option `help-cross-reference-manuals', and it | defaults to the value of that option. |=20 | Do nothing if the car of MANUALS-SPEC is nil (no manuals to search). |=20 | Otherwise, there are 3 cases: |=20 | 1. The cdr is `nil' and the car has the two manuals "emacs" and | "elisp", and only these (this is the default). |=20 | Create the link without first searching any manuals. Clicking the | link uses `help-lookup-symbol'. |=20 | 2. The cdr is `nil' and the car does not have just those two manuals. |=20 | Create the link without first searching any manuals. Clicking the | link then searches the manuals. |=20 | 3. The cdr is non-`nil'. |=20 | Create the link only if there are search hits in the manuals. | This takes time. |=20 | In cases #1 and #2, clicking the link might find that there are no | search hits in the manuals. In case #3, if there is a link then it is | sure to lead to hits. |=20 | In cases #2 and #3, clicking the link brings up an Info index buffer | for the manuals with hits. In case #1, clicking the link takes you | directly to a hit in one of the manuals, Emacs or Elisp. |=20 | Cases #1 and #2 create the `*Help'* buffer quickly. Case #3 takes | time to create it - possibly considerable time. `---- User option `help-cross-reference-manuals': ,---- | help-cross-reference-manuals is a variable defined in `help-fns+.el'. | Its value is (("emacs" "elisp")) |=20 | Documentation: | Manuals to search, for a `*Help*' buffer link to the manuals. | The default value is (("emacs" "elisp")). Clicking the | cross-reference link in `*Help*' uses `info-lookup-symbol' to take you | directly to the relevant doc in the Emacs or Elisp manual. This is | very quick. |=20 | Any other value means that clicking the link searches the indexes of | the specified manuals and then opens an Info Index buffer with links | to the relevant manuals. This can take a while, and if there are no | matches then the `*info*' buffer shown is empty. The advantage of | this approach is that you can get to a hit in more than one manual. |=20 | The option value is a cons: (MANUALS . SEARCH-FIRST). |=20 | MANUALS is the list of manuals to search, or the symbol `all', to | search all. If `nil' then do not create a cross-reference link. |=20 | SEARCH-FIRST is a Boolean value. If MANUALS specifies other than | just the Emacs and Elisp manuals (both) then: |=20 | * `nil' SEARCH-FIRST means create a cross-reference link | immediately, whether or not there are actually any matches. |=20 | * Non-`nil' SEARCH-FIRST means search the indexes, and create a link | only if there are matches. The indexes are thus searched before | populating buffer `*Help*', which takes time. You probably do not | want to use this possibility. |=20 | You can customize this variable. |=20 | For more information see the manuals. `----