Re: [PATCH] mmap.2: ffix

["Alejandro Colomar (man-pages)" <alx.manpages@gmail.com>]

Hi, Branden!

On 2/28/22 14:18, G. Branden Robinson wrote:
> Hi, Alex!
> 
>> Then, should I report a bug in groff?
>>
>> I could reproduce the incorrect formatted output with
>> GNU groff version 1.23.0.rc1.1931-35c9b
> 
> I didn't even see the run-on bold at first; I was looking for
> breaking/spacing problems.
> 
> No, groff is behaving correctly as I understand it (and consistently
> with Heirloom Doctools troff--I didn't fire up the PDP-11 simulator for
> this).
> 

Ahh, I thought I knew \c.  It seems I didn't.  I thought it was as
simple as "remove any spaces between this line and the next, but
consider them separate in terms of formatting".  But it continues
formatting too.

$ cat c.man
.TH \ec 7 $TODAY alx experiments
.SH NAME
\ec \- experiment
.SH TEST
foo\c
.B bar\c
baz
$ man ./c.man | cat
\c(7)                      experiments                     \c(7)

NAME
       \c - experiment

TEST
       foobarbaz

alx                          $TODAY                        \c(7)


"barbaz" is bold.  I thought only "bar" would be bold.


>> Okay, I'll fix that.
> 
> I'm looking forward to seeing a PDF-hyperlinked rendition of the next
> Linux man-pages release, as I've done with the 384-page
> "groff-man-pages.pdf".  :)

Might be :)
Maybe you release groff-1.23 before we (I?) release man-pages-next (if
it's me releasing, I may delay it until linux-6.0).  If that's the case,
and most distros ship it by that time, I may introduce .MR.

BTW, have you seen the changes I introduced this week?  I'd like to know
your opinion about them, if you have one, since there are quite a lot
of them:

$ git shortlog  --since 'last week' | wc -l
499


They reduce to 3 kinds of changes:

- Add LIBRARY section.  Similar in FreeBSD and NetBSD,
  but I used lowercase for everything but the first letter.

- Remove most of the license texts (all except those that don't have a
  SPDX license tag), and replace them by the license tag.  Add the
  licenses to <LICENSES/>.

- Move types out of system_data_types to separate pages, that are
  much more manageable.  system_data_types(7) was becoming something
  huge like queue(3) once was.  I also wonder if we should inaugurate
  a new subsection of man3 (maybe 3types?).


Regards,
Alex


-- 
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/