From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id CNasM1bMmGMuDgEAbAwnHQ (envelope-from ) for ; Tue, 13 Dec 2022 20:02:46 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id oIzIMlbMmGMSjgAAG6o9tA (envelope-from ) for ; Tue, 13 Dec 2022 20:02:46 +0100 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 591FB1085C for ; Tue, 13 Dec 2022 20:02:46 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p5AXD-0004ks-0D; Tue, 13 Dec 2022 14:01:47 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p5AXB-0004ka-Dk for emacs-orgmode@gnu.org; Tue, 13 Dec 2022 14:01:45 -0500 Received: from mail-mw2nam12olkn2020.outbound.protection.outlook.com ([40.92.23.20] helo=NAM12-MW2-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p5AX8-00045q-Ou for emacs-orgmode@gnu.org; Tue, 13 Dec 2022 14:01:45 -0500 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=A5NIB8l09DiZvc+8RpFcyUYoUH+0Ojp/9WccuZ+ZOkN3czDbBNXJqwDDMhXrSRVVXeSYg72pF+VNN1B2jYYD7Am+sYLxGCnNDiIRHtxihbtg9q0q3jx1pzGlO6wtd08GcGZmgtUC9MsULJPzzI7LGy3cDFzpvL00E/xv7D1D+ljCz9m20cqlDqppkHs3MDn3ALlv3qP7Vj8UUDsXukSF5uChNk9B/blvKjOLvbVOqansffOqWaWMawrrFgZ3s3drjDc43814Q3PJhO6LJsynDhZKnnn97LksTvKQ53dCIJPkvR7AwqpNHnBjdb6w8EK6AmTqqS+QN8yow9SSsWaUQA== 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-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=hcrDTco0hIPx8i0o9IYXGGGh76x3a3fUAdFfJaUKhyo=; b=SZRiEKECcOmAVxYpOXYW1QGrj1cOzLE+lWCzXI9SZ609mINUZ9pX9KyUVQ/SmOk4fgtbyQ+7LonFlyFVCh3qkdKoz8FW0GeloH+iniumKMWXNHqa75DjVZkciK7mDRWSrNyRbm/DQdSEqfQUFQNdBYmNJpxeEEAnggfANeEKxYOroD6v0WDZmLGSrvyGrJGeJIjubXiwx7Uc31/M3Ms46GK6Y5rpetm8VOIWKed5n7kPD9FHYo0eozQBMvUJai66WeVGYNYXD+0hashL8gHksFB905IGZ585zyYg+XTYey9acD+HaHLzElf1l+C5jMQ5Veb0IhiK8Xfjai+moOYkjg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=none; dmarc=none; dkim=none; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=outlook.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=hcrDTco0hIPx8i0o9IYXGGGh76x3a3fUAdFfJaUKhyo=; b=F9hnxUta/YVZpNKrhaCAYWNsn4YB25mLbWnD9u6RNJc3nw3HxAteo/zfx6oN1QpdQ5AEtEPwLT8xBFXdNrHPG9RUUsBFjplbCBlPmq7N0NNUnneMmW2uaeMr01OFwoheZxuKxN2P7xVHKTl22px670CMGN1hNpkG+6PXspFyvCSpEAfzTNsWAfVjBxjglHEaD6Cg69baN5kFer64nC/TEI+a+h7ZqYA16uBtoFxrRfrAIgOGuxncAzc7vUmyCBnXkybA9dX+KLFw5ckL31opKFH1QGpjjSSrQe39HNHo5QyolLc7j/VBp9UFMcpdV+ZQaE7p/dBlrJznXgfijaWQsQ== Received: from SJ0PR03MB5455.namprd03.prod.outlook.com (2603:10b6:a03:27b::11) by CO1PR03MB5809.namprd03.prod.outlook.com (2603:10b6:303:6e::9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5880.19; Tue, 13 Dec 2022 19:01:37 +0000 Received: from SJ0PR03MB5455.namprd03.prod.outlook.com ([fe80::e016:84f7:daad:916e]) by SJ0PR03MB5455.namprd03.prod.outlook.com ([fe80::e016:84f7:daad:916e%3]) with mapi id 15.20.5880.019; Tue, 13 Dec 2022 19:01:36 +0000 From: David Masterson To: Ihor Radchenko Cc: emacs-orgmode@gnu.org Subject: Re: [BUG] Documentation fix needed in "4.4 External Links" [9.6 ( @ /home/dsmasterson/.emacs.d/elpa/org-9.6/)] References: <87lenbd001.fsf@localhost> <87edt38c1d.fsf@localhost> Date: Tue, 13 Dec 2022 11:01:34 -0800 In-Reply-To: <87edt38c1d.fsf@localhost> (Ihor Radchenko's message of "Tue, 13 Dec 2022 17:10:38 +0000") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-TMN: [1Wep0EMNLeQcnpdgCHflVqbw0bBeGRQJOQrMJEo06xyeKSG0k+OMhaf3BVfVuBqV] X-ClientProxiedBy: SJ0PR13CA0130.namprd13.prod.outlook.com (2603:10b6:a03:2c6::15) To SJ0PR03MB5455.namprd03.prod.outlook.com (2603:10b6:a03:27b::11) X-Microsoft-Original-Message-ID: <87pmcn1629.fsf@penguin> MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 2 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: SJ0PR03MB5455:EE_|CO1PR03MB5809:EE_ X-MS-Office365-Filtering-Correlation-Id: 46ea8242-4629-41d7-f1a4-08dadd3c7573 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: w3fc520cmZArLHhuYRy6ySaSWO3oHUfaC+o6m24jFUodv6JLFFGXwYkZAJyHIJR29rqAlFC7OaWJ2mV2kMydBTnqU2D/GasfST1qaEvt1M6V2MAtcYhEHWSGRSKuv2Fzsz2yj4+uyZzZmjGXHcSMm7nXehPv/DYGwISYWO4OYCUo4dIhozzVoqERRQp9bFTm7qmoXlEKZCI8nsueL0XUMFKEr2TVdZkU/Zkm32Hgs3hF7Cr+q+8243wzoN7P1duIfrjlZsbwbn0WeMYxT8vF7dNVKUo5Hi+M4UQVyCogDn2QElWty6KWyI1+fx9GKvEuYVsAe412JsS1sdRsIgiOylR4fGhrNPqsWFmsSasOMMy6LD3qP4IH1okpronlHHsDgV5iyQWU6Gc7b5MBd2WjufUdC+mMAzvD1/C2WvLxvuJrl1IRF+ISxwNDbCVtIqn8dFd7O4iaCkyc4m3KTSEH6adX0ESYg0xcb+E9mNxQNl5bHkjjxCUbdkrXErLPyH6cMkYG4xA+VV42+1u/NgfM43jN5WaMzwql/GMSmVSVmLnCM6a4JPF+QP5qAd6BXLMRwqZGc+lqJOJoRPb4egmb38g7Qf118w97SkvkU23PzzgWTXKADzi8Gov5H/ujltJbBIhCd4wyNUtTPstBZt5XtG/z/Bpt+mgS2KFUvCwFB4k= X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?OFpwVzFheTg5RjBrV2lHaWVRT2RwcnZsd3RLYlkvVE4ySnFlbmJheWNMSjNS?= =?utf-8?B?cDNIUm9zb3N3MlphR1dYOHdXOGtXdmw0L1drUmJ5cXlwRG9DK3BzdmdGeVda?= =?utf-8?B?WUpOVDNGQzFSS0xFcm9oREp6SC8xOWVLRTdRM3ZweUR5L3BhSy9wM0U4Szg5?= =?utf-8?B?TVpsb2h4YnRONUIzQ04vYlM2bFRVblZ2ckE2UTRERGx2dzliVm1Seks5NHBS?= =?utf-8?B?YkJLWVh3M1RzM3JCemJTdlR4VXEzLzNEemxpWXNINytTdUJKRFMyUURzcG1H?= =?utf-8?B?ZHNjMkpCalFOUm1uY3NFUmtPRGM2L1BRZzg0TE9qZy9tVGxuZzYxSXJFaG9i?= =?utf-8?B?Mi9HTmpZZUkwY2hVaVZXTk9DR3MxdVVGQm91L3NBRi9ZamtiTVdWSHB5bFNE?= =?utf-8?B?TnVLY1UzNHVVb2ZFbjJyQlQ5elFPc051dklBNzdmRlVBMXo5V3NnVFMrQndZ?= =?utf-8?B?T05BajhRWWVKMi8rZHhqOGNyZDNpY212OUNzUWREeXh0dGg3WnZScmxUaWpE?= =?utf-8?B?d1BxUHZKbjViU0J5MHgrRWE0dW5UbE9lWnpzTG95b1JFUzdNbmFJQzJIS2E4?= =?utf-8?B?ZDUxSlJmTzk1eU02RzAzcE9zeUZKZE5HVEhzL0cydThlSCthV0pnNXJpQ2ZR?= =?utf-8?B?YTlGL0RBTlpRbnNEUk1JVFAyMWhNY0Y3bU9mcUcyVGM3dVBJTGdmbk5XQXVE?= =?utf-8?B?UGFudmR2UVNqdlpVVmprcjNiTEFyd2VNZkR2RGxTeXdpZ28rZFZ1T2t4dVpM?= =?utf-8?B?WjNNVjNaM1R3cVR2MkM3b1RzOXE5aEFDekhJOGo1VERwZ1JaNk95bmNpdHRN?= =?utf-8?B?OWVDM1lieUVaS1dEdkRGTFFpbmJLRmd6UzdjcEpqMFUwaG0vK1AzNkRTM1lL?= =?utf-8?B?RGtuOXQ2SXZYTUxwOXEvWmpEVzVDekFWMlB4VXVTcVdlWUxrV0hZQTdSOEM4?= =?utf-8?B?YmRKS2xsUUVySjdvTk9tWUVZVjZvY3pqa0E5Ukt2dTBXa1FrZDhxUndpSWdS?= =?utf-8?B?cTVCcjYraXMyaDBhaU5zdVlvRGZESmlQeTNQTjZteitYT3JJbEFkQkdpL2Z5?= =?utf-8?B?aGNyMkVtR1hmUTFhZHVtbUlWbVdYWWFVeEwxZVZ3ZlRRbVlDbFMrMVVYTThK?= =?utf-8?B?ZTlIMlhScmtPT20yRHRyS09VQWQxczZiZFVYVkJ1R3dHY1hQZm51dnhRSWtv?= =?utf-8?B?Wlo5cklBQ2lLR3JvczFDYUFRalBsZU10MWs2TXErdnVVbDZVQ3E5Y1RQUTVP?= =?utf-8?B?N1lnbDRjQlVkMXY5Ukd4elJtMTVQUXJvcnpUMFBVVlkxMTJVTnNIYkZaUnlV?= =?utf-8?B?eGtoNFMzRUZEQmxEcDNQdGlQRUFhSGN0eDhYeHVIaTNHR2FOVXBOWmFJWGgv?= =?utf-8?B?WlovNElXWWt3Z2JYWUlrbXNXZnltK29UcGxUUzJER3lSOG4rNGVVajNBRFhY?= =?utf-8?B?ZE55S1Vsd0hlM0trZlFsRndMNTJjTGpVZlJIZE80TE8vdEVWL2JFcEdEdDlV?= =?utf-8?B?d25tK1NiSCtvdEIyUzhUQTZqNURnZXB6L3E4UXNzdHo3M0d5THcwYm8rZHA4?= =?utf-8?B?M1kwcEc4c3lXaWtIaW1zZUJ3Qk9HT1dQU21VR3VpQmFHUndCSGk2dG1mNDR2?= =?utf-8?B?R1VweTllVGhVTHJOU3pTZ0ZTNzZYV3lHNkNURkU1TklRNHNHMEJCYmwwVHdC?= =?utf-8?B?OHZIbm1NQkh3SXJEY1hNS2dJYzRDVjBLbE1RZlBxTE5XMUVtcHY1ZlJNRmUx?= =?utf-8?B?ZFh3OWNNLzFLV0gxZ3doRmxvczFKbkQ2c0cydWVFdUY4Q1BpeXJlZlpCOVpa?= =?utf-8?B?Q1BhNEVLVlBvWWVSV0N3Uk80YWVQdmJ0c2c2b0t0OUh3VlUrR1huaXAyd1VP?= =?utf-8?Q?s9z6rtjEXjwQ0?= X-OriginatorOrg: outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 46ea8242-4629-41d7-f1a4-08dadd3c7573 X-MS-Exchange-CrossTenant-AuthSource: SJ0PR03MB5455.namprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Dec 2022 19:01:36.7779 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 84df9e7f-e9f6-40af-b435-aaaaaaaaaaaa X-MS-Exchange-CrossTenant-RMS-PersistedConsumerOrg: 00000000-0000-0000-0000-000000000000 X-MS-Exchange-Transport-CrossTenantHeadersStamped: CO1PR03MB5809 Received-SPF: pass client-ip=40.92.23.20; envelope-from=outlook_98C99531806B1C22@outlook.com; helo=NAM12-MW2-obe.outbound.protection.outlook.com X-Spam_score_int: 4 X-Spam_score: 0.4 X-Spam_bar: / X-Spam_report: (0.4 / 5.0 requ) BAYES_00=-1.9, DKIM_ADSP_CUSTOM_MED=0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_EF=-0.1, FORGED_GMAIL_RCVD=1, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FORGED_FROMDOMAIN=0.001, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.25, NML_ADSP_CUSTOM_MED=0.9, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: emacs-orgmode-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1670958166; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=hcrDTco0hIPx8i0o9IYXGGGh76x3a3fUAdFfJaUKhyo=; b=LzkSrszUj3aoRiOET1QF5QDJ3W81nB7GvZYdpbSqrpHYnyEhAwp9M3xXWCDOpriFh8Gzz6 snbeSIWIjE5/Kkk9EzR+MS3w9s1YglijB+eUBzPf+sYP7kc/55MzzyJIbydN16M1U4wOG1 6fFGoijTD5hMkNPbv53sqpMGB324LVdIM04lH3tUSFzbyw/MPNr6sexVJPzOyXUtEgn1Ir PtEqtYsIkbLB1pZfhQxAFLcw2hyOvg5K6xfFq7opavHBldaCI/gMGu3nUD3qyheWgKY0XP irFK0yYCQ1YMT6TUXxxAJSWC8NkJHKU91jVbrAQO0W8QoHFgqAO9sQ1jmRL2QA== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=pass header.d=outlook.com header.s=selector1 header.b=F9hnxUta; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org"; arc=pass ("microsoft.com:s=arcselector9901:i=1"); dmarc=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=gmail.com (policy=none) ARC-Seal: i=2; s=key1; d=yhetil.org; t=1670958166; a=rsa-sha256; cv=pass; b=BmM9bO7kXe1zuM+Po1ZrES7ohl502iB77yAMvsX/l9DhPxlN08k0PjUgOoJ3or54BS1uhW OMskWbehjCD7H+qV9IQqMqY/Edu5pakcNJnwtLYTfJndDnw/0TBICNIV104nm66WILD06r PzKW6gBNvZNzuzS23eVjVdwDgKbotP9nm99ZT4UiRxYorUP/pSWSB3E2jJ0d+8LfT5qY9D AhrDeD6E7ifDHgpB4csjrORPFSkg69osyS7eOWCjrdZOiuf4Y5pGx47k8CyP+z/TTfdugN fdZsZt6Hg+A2ySmIZCauDsq9kRTGetNc1t9BPAUptAepsb6kbmYD7569g+0AYw== X-Migadu-Spam-Score: -1.30 X-Spam-Score: -1.30 X-Migadu-Queue-Id: 591FB1085C X-Migadu-Scanner: scn0.migadu.com Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=outlook.com header.s=selector1 header.b=F9hnxUta; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org"; arc=pass ("microsoft.com:s=arcselector9901:i=1"); dmarc=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=gmail.com (policy=none) X-TUID: 75Gh81zbdBpN Ihor Radchenko writes: > David Masterson writes: > >>>> 2. If #1 depends on some org variable settings, can you mention what >>>> variables control the answer to #1? >>> >>> If you mean "can open", then see the next section. >> >> Ahh, maybe I am in the wrong section. I think, what I want is >> org-open-at-point (which could be mentioned in 4.4), but it's >> documentation string just says the linked file will be opened by "an >> appropriate application". I assume that that means some Elisp function >> is called that cross-references the file type with appropriate >> application. And that I could add to or adjust the cross-reference list >> for new/modified file types. It would be nice to mention that list >> variable so that I could trace the process further and determine what to >> do (like install the appropriate application). >> >> Does this help for what I'm looking for? > > 4.5 Handling Links > ... > =E2=80=98C-c C-o=E2=80=99 (=E2=80=98org-open-at-point=E2=80=99) > ... > ... Furthermore, it visits text and > remote files in =E2=80=98file=E2=80=99 links with Emacs and select a= suitable > application for local non-text files. Classification of files is > based on file extension only. See option =E2=80=98org-file-apps=E2= =80=99. If you > want to override the default application and visit the file with > Emacs, use a =E2=80=98C-u=E2=80=99 prefix. If you want to avoid ope= ning in Emacs, > use a =E2=80=98C-u C-u=E2=80=99 prefix. D***, I'm getting old! These things used to pop out at me in the old days. Apologies for the dumb question... :( Do you think (some part of) this (semi-)paragraph should be mentioned in the docstring for 'org-open-at-point' (and 'org-open-at-mouse')? I'm of the opinion that, if you walk-thru the docstring links, you would get all the info you'd get in the manual (and more), but not necessarily explained in a user-friendly form, --=20 David Masterson