YS .

[Alejandro Colomar]

Hi Branden,

Was the trailing dummy string for YS to allow alignment finally merged?

I built groff(1) from git HEAD and lost that functionality.

Below is the head of a manual page for libs, a string library that I'm
writing:


        $ cat stpeprintf.3 
        .\" Copyright 2024 Alejandro Colomar <a...@kernel.org>
        .\" SPDX-License-Identifier: Linux-man-pages-copyleft
        .
        .
        .TH stpeprintf 3 (date) libs-(unreleased)
        .
        .
        .SH Name
        .
        stpeprintf
        \-
        format a string with truncation
        .
        .
        .SH Library
        .
        String library
        .RI ( libs ,\~ \-ls )
        .
        .
        .SH Synopsis
        .
        .nf
        .B #include <s/s/s/print/stpeprintf.h>
        .fi
        .P
        .B char *\c
        .SY stpeprintf (
        .BI char\~*_Nullable\~ dst ,
        .BI const\~char\~* end ,
        .BI const\~char\~*restrict\~ fmt ,
        .B ...);
        .YS .
        .B char *\c
        .SY vstpeprintf (
        .BI char\~*_Nullable\~ dst ,
        .BI const\~char\~* end ,
        .BI const\~char\~*restrict\~ fmt ,
        .BI va_list\~ ap );
        .YS
        .
        .

It renders as

        $ MANWIDTH=64 man ./stpeprintf.3 | cat
        stpeprintf(3)       Library Functions Manual      stpeprintf(3)

        Name
             stpeprintf - format a string with truncation

        Library
             String library (libs, -ls)

        Synopsis
             #include <s/s/print/stpeprintf.h>

             char *stpeprintf(char *_Nullable dst, const char *end,
                              const char *restrict fmt, ...);
             char *vstpeprintf(char *_Nullable dst, const char *end,
                               const char *restrict fmt, va_list ap);

        libs‐(unreleased)            (date)               stpeprintf(3)

While I'd expect the continuation lines of the prototypes to be aligned.
Was this extension never merged?

Have a lovely day!
Alex


-- 
<https://www.alejandro-colomar.es/>

signature.asc
Description: PGP signature