From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id 4C3HDEmFR2U0pAAA9RJhRA:P1 (envelope-from ) for ; Sun, 05 Nov 2023 13:06:33 +0100 Received: from aspmx1.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id 4C3HDEmFR2U0pAAA9RJhRA (envelope-from ) for ; Sun, 05 Nov 2023 13:06:33 +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 EECB3586B6 for ; Sun, 5 Nov 2023 13:06:32 +0100 (CET) Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=sGAuYBLO; dmarc=pass (policy=none) header.from=posteo.net; 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-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1699185993; 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=p+WkgvNCexU94SPTQq9OtGEUJxZJxt7WXFhxd/3+b+k=; b=oYwmq+BwyusaaVREeIx693/LV827gwJQWPyGy4vRrWcaqA0is3HXn9Yq/Nf3X1MxFTNzPy iHzUtsY9RBuYAc0i85wSNwMa1Jc+7/dyZT896JPAv4GuzHAK85/kxUJAAmRniFIpv0g9I9 8PCTDXmQsP8GXTfQi1fMsrLXvU2Mgj1FqwjBmApRNRuPAHEs6naSS7P5b+e3QpqVzEOpUw P1DdZr+85fR+/Jm+mIdnXqrPTG+BbIViKFqo6IuzBuaNrRroSu/arBsIn47OV2qbxqwoWs b1D82J85htyH801zV8Ng/XxgHvwNQ6Snk4v8ccz3Gc9IxAL7rPa+PhtcIUkwrQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=posteo.net header.s=2017 header.b=sGAuYBLO; dmarc=pass (policy=none) header.from=posteo.net; 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-Seal: i=1; s=key1; d=yhetil.org; t=1699185993; a=rsa-sha256; cv=none; b=gSxwH6oyWHxQdFDWrT2m4skt2/EpMPumOh+VZZ24GvNtyFDqlb+WGTXjZmMUryX+shMLJl kr4KNR9cwZCBSN5SnhwVjbJVfwGBtxRpA2YvU0ZQ32+L+VRLy2USrPZVHTHdK371gnbyMB o9WusJOJDC7XPNMlta1dukSQLsRBr23pKMpam5FBersABrIiGJZb4Jjtc5SRuFYedruiJz MIwyO0b+DK69WWrMrwsv5VUf8sxbnOxsJO/FTuEGiYa0k533q2CMZ0VkX5omJjFlE9Bspb rEM4XN4dIIjSjMzP/5FadKZTERjm7XCUerpzcXWaJqZEICRuMU1BFlq7NZLSbg== Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qzbtU-0005sJ-9A; Sun, 05 Nov 2023 07:06:20 -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 1qzbtS-0005rn-1l for emacs-orgmode@gnu.org; Sun, 05 Nov 2023 07:06:18 -0500 Received: from mout02.posteo.de ([185.67.36.66]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qzbtN-0005yp-VZ for emacs-orgmode@gnu.org; Sun, 05 Nov 2023 07:06:17 -0500 Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id 55A7C240101 for ; Sun, 5 Nov 2023 13:06:10 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017; t=1699185970; bh=p+WkgvNCexU94SPTQq9OtGEUJxZJxt7WXFhxd/3+b+k=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version: Content-Transfer-Encoding:From; b=sGAuYBLOMzcygIWCPn9k7RkHlGEyTUewWDg1yS+qxQ6ebD3rESPnu1LwcOqpLhskF w/ojMt2NAVEg6XpAtMBGM9F3mMS7kaOo/b5YamBUhT0XkzyArCtsr1dnmhyxVvkfaR NlZLScHuqwcjjq7Nji4DHUDJA58Mz9UP2iqqKa1LIsnoLGtm52gWcGyNnjJBJupES4 EwPab6KP2gk5Cj5xNHUoxBnvO/MhAFgmNZUw7A2YY1oNBNU3WR4d7He4nhVYoxZb3o 7j9uG3jSW2ryq6vQsStHhnuesvFMjQKxHG0l2a01NVv43GDD7ar15473si0yYeM8oW pxuVexudi+IuA== Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4SNY9F4TJ5z9rxK; Sun, 5 Nov 2023 13:06:09 +0100 (CET) From: Ihor Radchenko To: Max Nikulin Cc: emacs-orgmode@gnu.org Subject: Re: man pages references (Re: [PATCH] ox-ascii.el: Consistently add brackets around links) In-Reply-To: References: <874jijaukf.fsf@localhost> <8734y1aeae.fsf@localhost> <87lebt8rrm.fsf@localhost> <87edhk717a.fsf@localhost> <8734xzdm8g.fsf@localhost> Date: Sun, 05 Nov 2023 12:08:02 +0000 Message-ID: <87a5rs5rod.fsf@localhost> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=185.67.36.66; envelope-from=yantar92@posteo.net; helo=mout02.posteo.de 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_H5=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham 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-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Spam-Score: -8.78 X-Spam-Score: -8.78 X-Migadu-Queue-Id: EECB3586B6 X-Migadu-Scanner: mx10.migadu.com X-TUID: c7La1myZ2NDl Max Nikulin writes: >>> Side note: it should be either just "man(1)" or "man(8)" without any URL >>> for plain text export, but it is another story. >>=20 >> I would not say "should". May? Yes. URL also makes sense in some >> scenarios (when the intended reader is not on Linux). > > URL makes sense when it is particular version or a page generated=20 > without intermediate roff format, but this case it is https:, not man:=20 > link. Compare (sorry, man.he.net is terribly obsolete) > http://storaged.org/doc/udisks2-api/latest/udisks.8.html#id-1.2.4.7 > that has more links than the page generated from man page (debiman still= =20 > recognizes much more cross-references than emacs man buffers) > https://manpages.debian.org/bookworm/udisks2/udisks.8.en.html#DEVICE_INFO= RMATION I do not see why man.he.net is obsolete - it does not look like it is unmaintained. That said, feel free to submit a patch with online man pages website being customizeable. > "man(1)" references were used in paper documents when internet was not=20 > always available. In books references may be emphasized by italics or=20 > fixed width font. > > I like formatting similar to "systemd-resolved(8) =C2=A7=E2=80=AF/ETC/RES= OLV.CONF" > https://wiki.archlinux.org/title/Systemd-resolved > It makes clear that links point to man pages and precise enough since=20 > specific sections are provided. I have no objections about having this export style as a user option. Again, patches welcome. --=20 Ihor Radchenko // yantar92, Org mode contributor, Learn more about Org mode at . Support Org development at , or support my work at