Re: Milestone reached: hyperlinked mdoc(7) documents in PDF

[G. Branden Robinson]

At 2024-03-18T13:00:19-0500, G. Branden Robinson wrote:
> At 2024-03-18T12:56:45-0500, G. Branden Robinson wrote:
> > It is not a goal of groff to behave identically to mandoc(1) in the
> > face of unspecified input.  Is your input specified somewhere?  (I
> > don't have the command of mdoc(7) that I do of man(7), and as we've
> > seen, my grasp of the latter is not flawless.)  Can you come up with
> > input that _is_ specified and yet still manifests this behavior?
> > 
> > And, yeah, I noticed the oblique face getting stuck on, too, when I
> > scrolled to the end of the document.
> 
> ...at the same time, this bad rendering doesn't happen with groff
> 1.22.4 or groff 1.23.0, so I might have inadvertently made groff
> mdoc(7) less robust here.  I'll bisect and see what I can see.

I was afraid of this.

df1fc139af57e947f038c52b3753dda411c3fc2e is the first bad commit
commit df1fc139af57e947f038c52b3753dda411c3fc2e
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Sun Sep 3 20:58:42 2023 -0500

    tmac/doc.tmac: Don't set `Ar` ellipsis in italics.

    * tmac/doc.tmac (doc-str-Ar-default, Ar): Stop setting ellipsis in
      italics.

    * tmac/groff_mdoc.7.man (Arguments): De-document apology for former
      behavior.

 ChangeLog             |  7 +++++++
 tmac/doc.tmac         |  4 ++--
 tmac/groff_mdoc.7.man | 11 -----------
 3 files changed, 9 insertions(+), 13 deletions(-)

The wonderful thing about mdoc having its own macro processing system is
that it's so fragile.

diff --git a/tmac/doc.tmac b/tmac/doc.tmac
index 52ed73714..8bbcca8a7 100644
--- a/tmac/doc.tmac
+++ b/tmac/doc.tmac
@@ -789,7 +789,7 @@
 .\" NS
 .\" NS width register 'Ar' set in doc-common
 .
-.ds doc-str-Ar-default "file\ .\|.\|.
+.ds doc-str-Ar-default file \f[].\|.\|.\"
 .
 .eo
 .de Ar
@@ -802,7 +802,7 @@
 .
 .    \" no argument
 .    if !\n[.$] \
-.      nop \)\*[doc-str-Ar-default]\&\f[]
+.      nop \)\*[doc-str-Ar-default]\&
 .  \}
 .
 .  if !\n[doc-arg-count] \

Back to the drawing board.

Regards,
Branden

signature.asc
Description: PGP signature