Hi,

Reuben ua Brig wrote on Sun, Jun 27, 2021 at 09:47:01PM +1000:

>> Date: Sun, 27 Jun 2021 10:29:12 +0100
>> From: Stuart Henderson <s...@spacehopper.org>

Judiging from marc.info and from my own mailbox, i fail to find
the original copy of this posting by Stuart.  Reuben, did you
publicly quote a private mail, or am i missing something?

>> Seems I was (and the port Makefile) was wrong about it being tbl

No, Stuart, you were spot-on.

For example, consider

  gmdiff man0p/complex.h.0p
  gmdiff man1p/awk.1p

>> vut there aee some big problems with equations e.g. in float.h, math.h.

As far as i am aware, and according to the extract from my ports
notes file that i posted recently, the problems with eqn(7) are
mostly excessive spacing caused by weird syntax involving useless
quoted space characters in the eqn source code.  That's likely much
easier to fix than the very serious tbl parsing issues, but hardly
high priopity given that i don't recall ever having seen similar
input syntac anywhere else.

>> btw the source manpages *are* installed but (probably due to how
>> pkg_create handles manpages in USE_GROFF ports) they're tarred up.

Yes, they are installed, but only for licensing reasons in the past
(that may no longer exist).  The reason they are tarred up is that
we don't consider it useful to install two copies of the same text.
When cat pages are needed, we don't want the sources alongside.
So zhuk@ decided to waste as little space as the license allowed
when he set up the port in 2014.

> having only seen float.h, mandoc did slightly better in one place where
> it included a sum where the cat file only had <Sigma>.

Yes.  I improved handling of mathematical symbols and Greek letters
in both mandoc and groff terminal output not long ago, but eqn(7)
handling for the terminal is likely better with mandoc than with
groff: i spent significant work on that based on the excellent
foundations that Kristaps laid.

> personally i would like to patch man so that it calls make

Over my dead body.

> (with a
> special makefile), so it could be extended to e.g. cat pkg-readmes;

I dimly remember that moving pkg-readmes into a dedicated section of
the manual pages was proposed in the past and rejected; i don't
remember why exactly, it may have been because the existing format
is easier to handle for porters, and the texts are so short that it
usually matters relative little for users; not sure.

> but first i will see how posix-man-pages and v7man go.

I don't think i understaood all you said, some of your code snippets
seemed cryptic and of unclear purpose.  Try to write complete
sentences that are as clear as possible, please.

Regarding v7man, are you referring to

  https://man.bsd.lv/?query=.&apropos=1&manpath=UNIX-7

Anything wrong with that?

Yours,
  Ingo

Reply via email to