Follow-up Comment #6, bug #68261 (group groff):

[comment #5 comment #5:]
> Hi Branden. This is Karl. I made the previous anonymous comment; sorry, I
> didn't realize I wasn't logged in.

Ahh, thanks for clarifying.
 
>> You want to know [how] to edit the man page so you won't "have to" edit the
>> man page?
 
> There's a big difference between adding a directive to say "please don't give
> me a warning about \fC" and having to go through all the content fixing every
> case of \fC.

Yes indeed.

Here are a handful of solutions.

1.  Silence warnings in category "font" via the command-line.  
Pass `-W font` to _groff_ or _troff_, directly or via whatever tool is
wrapping them.

2.  Silence warnings in category "font" via the _man_(7) macro package's
configuration.  Edit "man.local"--on a Debian-based system this file is in
_/etc/groff_--to silence them in _nroff_ mode only as follows.


.if n .if \n[.warn]>=131072 .warn \n[.warn]-131072


(Yes, that interface is about as un-intuitive as it can be, thanks to the
*roff language lacking bitwise arithmetic operations.  We have a plan in bug
#68242.)

Illustration:


$ git diff tmac
diff --git a/tmac/man.local b/tmac/man.local
index d01988c09..95093a53a 100644
--- a/tmac/man.local
+++ b/tmac/man.local
@@ -21,6 +21,7 @@
 .\"   4: x-man-doc://1/groff   -- ManOpen (Mac OS X pre-2005)
 .\" Set this register to configure which the `MR` macro uses.
 .\" .nr an*MR-URL-format 1
+.if n .if \n[.warn]>=131072 .warn \n[.warn]-131072
 .\"
 .\" Local Variables:
 .\" mode: nroff
$ echo ".ft C" | ./build/test-groff -man -T utf8
$ echo ".ft C" | ./build/test-groff -man -T ps
troff:<standard input>:1: warning: font name 'C' is deprecated [-w font]


3.  Use a GNU _troff_ feature to remap the font to something that will work
better in context.  This too can be done in "man.local".  You could also do it
in the document itself, but that would override user preferences that might be
configured in "man.local" on a target system.


.if n if \n(.g .do .ftr C B \" bold on terminals
.if t if \n(.g .do .ftr C CR \" Courier roman on typesetters


> In my case, with makeindex.1, there were a lot.

Sorry.  :(  Before undertaking things that seem like a lot of tedious effort,
please ask the _groff_ mailing list for help.  There's a lot of expertise
among its subscribers, including a lot of salty old gray beards that like to
get things done with minimal effort using classic Unix tools.  :)

Finally, I [https://lists.gnu.org/archive/html/groff/2026-05/msg00022.html
started a thread about font warnings on the same list] since the issue came up
elsewhere recently.  Please weigh in if you're at all inclined.


    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?68261>

_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/

Attachment: signature.asc
Description: PGP signature

Reply via email to