From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id 4OUMLcCc72WcCgAAe85BDQ:P1 (envelope-from ) for ; Tue, 12 Mar 2024 01:07:28 +0100 Received: from aspmx1.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id 4OUMLcCc72WcCgAAe85BDQ (envelope-from ) for ; Tue, 12 Mar 2024 01:07:28 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=S6UnbxX0; 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"; dmarc=pass (policy=none) header.from=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1710202048; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=1CWA+8mK+dj1YQOoxWHP2Y8oDBS63yMpND7DN6BAUlo=; b=Hkmyw4QG9WB4T6I6QulRXTn33G67rDw41KNL+v6GAwvxvkcyk+XLuHyVqnaRVpcDgb3//9 jIbhqizpkJ2O1s1OtAPq7hKGjlfrW24d2VKIRc/5uY7N1yLQrrXF+U3aTImwUeBYNLWp3B ruuHJgNDq8+zn/fZCl7fjkhT56YIuxu4Q/ewmfzAB68tKirq8nGbsCOwrKYkuGFhWnHXE3 QXBb++68MQ59SPo4P9Oti8tnqWSMlenG8zIzffqpLoiizmZ26zXeP2hl/h6NMZvIZCXeRR SxOa86LLl/ePDC6C/W4Et5tv5ZZbviwaa3hXqy8miyTdPFVeC2fBb2KJJXb3gg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1710202048; a=rsa-sha256; cv=none; b=URM/LSCsR5QdwKWy1IMdVF83ZjgAmC4sBp5tDfXf4wTOKTao995ZnBRzqTl+ug/bmC1yae eZGGPEN5Y7GAeTpYlzdLiA9qAGuAlS6V8LHGXxtc2lFSApX5bzeGe6qe0/MckP8K+HiO8X 3XvzPidQUsQ+Uo3kaC6JTENvgxR3c0JY9ViVrszEFJS4udVISRXzFJSj+ih6bIaJRhjC0z gbaGQHnmqhocie42u3WenGeNnj6psl+fEJ9PgwcBypmYU7RmieOZFD3dOxuQ8LS7LQfFyp 44xOFfHwKM2OyoZFAzp6xPOQkKqCe1bPNMec1/6+svqrQeeaod96bnmwXasHbA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=S6UnbxX0; 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"; dmarc=pass (policy=none) header.from=gmail.com 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 66F986FE42 for ; Tue, 12 Mar 2024 01:07:28 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rjpez-00053t-7L; Mon, 11 Mar 2024 20:06:25 -0400 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 1rjpew-00053N-PB for emacs-orgmode@gnu.org; Mon, 11 Mar 2024 20:06:22 -0400 Received: from mail-pf1-x434.google.com ([2607:f8b0:4864:20::434]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rjpeu-0008Si-Qj for emacs-orgmode@gnu.org; Mon, 11 Mar 2024 20:06:22 -0400 Received: by mail-pf1-x434.google.com with SMTP id d2e1a72fcca58-6e63e9abf6aso2828051b3a.2 for ; Mon, 11 Mar 2024 17:06:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1710201979; x=1710806779; darn=gnu.org; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to; bh=1CWA+8mK+dj1YQOoxWHP2Y8oDBS63yMpND7DN6BAUlo=; b=S6UnbxX0o2LgKd287Gj6zjJk9MTB923xmMDg52ALJNUQA6ioeSJHUwzztd+15nZl16 n/LmDGipuMSyCuvNu//D4tqdTVyAWW18Ww1pN4/qWcVjc6HmCKjuI3TezGwMOeYlsqSs kvng4Vf50zYib1QHv0Rxb9e407wUrLcmmmQQM9KTjsrYgX+UQM0WTgfNPZTY+FBN1n0R XmaF67vxg9xpcT95BmwUQB625SCj8oMtV05h3ooCnEUFTWW6zPykY+AjcjRkK8HDMaTa H8vjnhHqFrUuMB1C5/Brv4JO0CgoNQjkVy1nWSbgXhRCnUzeZzbSr2a3D6bs1fxVFXXc fgIg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1710201979; x=1710806779; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=1CWA+8mK+dj1YQOoxWHP2Y8oDBS63yMpND7DN6BAUlo=; b=D+SJDtRJ4IjOMBhdaJQQUkp3DssvSUpifVrbWK/7IG/wJMDMq9dNmMgKAJqgMvHCTw qFH0q7fx+BPfVnqi4d+2BLzbHKwlh0ALbbR17+Y4461iJ/JM7z3hr9eieN98Ta2Z1QZe pPTjRLqWQcqJg5F15muthv7AOHBM62K7vzOqvnJ3gLJSa2njtrbytNfGBmNmIN4M+LdB w6yAGfGdj/Hdbi+FeovtJsFf5XE6evFKXPQCppxbDdUDApDspXCFY4NKJwUytfgW0aS+ R7jWMIujL+k1YKlchRXjkdib2n26ILqetiP73ssZe9xFs7VbY5Wt32YYGCrWlF74G6oE ukyg== X-Gm-Message-State: AOJu0Yy2+drdsVmrFUXbWyF5QUN/I1MZ6+vHBYszOlnmcM3hDB/9TzSi Vk3oNp2Y4BUEjaJMsR+wVxp2ROMonOMSZe+tr0Ph7nwSMcXwuQyQ X-Google-Smtp-Source: AGHT+IFJOvs4FRlMtsZYTFXmrzQDQFO0le9kUPNHGMIZxXivj7X5bHXUEXA+13RessuJg7uV7odk4g== X-Received: by 2002:a05:6a00:2d20:b0:6e5:5a24:818c with SMTP id fa32-20020a056a002d2000b006e55a24818cmr8788918pfb.7.1710201978849; Mon, 11 Mar 2024 17:06:18 -0700 (PDT) Received: from debian-hx90 (2603-8000-a400-0cdc-8eab-4f1f-27c0-53ad.res6.spectrum.com. [2603:8000:a400:cdc:8eab:4f1f:27c0:53ad]) by smtp.gmail.com with ESMTPSA id a28-20020a62d41c000000b006e537e90f91sm5125259pfh.131.2024.03.11.17.06.17 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 11 Mar 2024 17:06:18 -0700 (PDT) From: Xiyue Deng To: Ihor Radchenko Cc: emacs-orgmode@gnu.org, Jeremy Sowden Subject: Re: [BUG] "\fC" macro in ox-man.el [9.6.15 (release_9.6.15 @ /usr/share/emacs/29.2/lisp/org/)] In-Reply-To: <87frx7moh8.fsf@localhost> (Ihor Radchenko's message of "Sun, 03 Mar 2024 13:30:59 +0000") References: <87v866jsou.fsf@debian-hx90.lan> <87frx7moh8.fsf@localhost> Date: Mon, 11 Mar 2024 17:06:17 -0700 Message-ID: <87h6hcia9y.fsf@debian-hx90.lan> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain Received-SPF: pass client-ip=2607:f8b0:4864:20::434; envelope-from=manphiz@gmail.com; helo=mail-pf1-x434.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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: -9.53 X-Spam-Score: -9.53 X-Migadu-Queue-Id: 66F986FE42 X-Migadu-Scanner: mx11.migadu.com X-TUID: Yg6XlrBYlDWn Hi Ihor, Ihor Radchenko writes: > Xiyue Deng writes: > >> (This was first reported to Emacs at >> https://debbugs.gnu.org/cgi/bugreport.cgi?bug=69483) >> >> "mu4e"[1] (a popular Emacs mail client) uses Org to generate its >> manpages. However, the generated output contains macros that are not >> understood by groff. After some debugging, Jeremy traced this back to >> the macro "\fC" used in ox-man.el[2]. Git history shows that this may >> have been there since the beginning. We tried to find a documentation >> for the "\fC" macro but has not been able to find one. Jeremy suggests >> that "C" may be an old alias for Courier, and if that's the case it >> should be changed to "\f[CR]". Would be great if Org people can >> confirm. > > This is not an unknown problem. AFAIU, the \fC macro is widely used for > troff, although it is not supported by groff. Check out the ongoing > discussion at https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1049968#15 > > They suggest the following instead of \fC: > > The best solution known to me is to use an extension to the man(7) > language. It first appeared in Ninth Edition Unix (1986) and was > adopted by a groff release in 2009. That is the `EX`/`EE` macro pair, > which sets a monospaced display. (In other words, filling is disabled > and a monospaced font selected if necessary.) I'm not very familiar with roff so my understanding may be off. According to the `Safe subset' section in man(7), they mentioned the following: ,---- | Font changes (ft and the \f escape sequence) should only have the | values 1, 2, 3, 4, R, I, B, P, or CW (the ft command may also have no | parameters). `---- Does it mean `\fC' should be replaced by `\f[CW]'? Also CCing Jeremy who may have a better idea on how this should be handled. -- Xiyue Deng