Re: [gentoo-dev] [PATCH v1] eclass/savedconfig.eclass: rewrite the ROFF macros

[Michał Górny]

On Thu, 2019-11-07 at 18:56 -0500, Göktürk Yüksek wrote:
> man2html cannot cope with multi-character number-register names and
> also doesn't recognize the square brackets in the '\n' escape
> sequence. This breaks the autogenerated HTML output. Rename the
> number-register from "step" to "R" and get rid of the square brackets.
>
> Closes: https://bugs.gentoo.org/699476
>
> Signed-off-by: Göktürk Yüksek <gokturk@g.o>
> ---
>  eclass/savedconfig.eclass | 10 +++++-----
>  1 file changed, 5 insertions(+), 5 deletions(-)
>
> diff --git a/eclass/savedconfig.eclass b/eclass/savedconfig.eclass
> index dab2283fe0f..8f64c5b8edd 100644
> --- a/eclass/savedconfig.eclass
> +++ b/eclass/savedconfig.eclass
> @@ -14,20 +14,20 @@
>  # so users can modify these config files and the ebuild will take it
>  # into account as needed.
>  #
> -# @ROFF .nr step 1 1
> +# @ROFF .nr R 1 1
>  # Typically you can create your own configuration files quickly by
>  # doing:
> -# @ROFF .IP \n[step] 3
> +# @ROFF .IP \nR 3
>  # Build the package with FEATURES=noclean USE=savedconfig.
> -# @ROFF .IP \n+[step]
> +# @ROFF .IP \n+R
>  # Go into the build dir and edit the relevant configuration system
>  # (e.g. `make menuconfig` or `nano config-header.h`).  You can look
>  # at the files in /etc/portage/savedconfig/ to see what files get
>  # loaded/restored.
> -# @ROFF .IP \n+[step]
> +# @ROFF .IP \n+R
>  # Copy the modified configuration files out of the workdir and to
>  # the paths in /etc/portage/savedconfig/.
> -# @ROFF .IP \n+[step]
> +# @ROFF .IP \n+R
>  # Emerge the package with just USE=savedconfig to get the custom build.
>
>  inherit portability

Not a ROFF expert but looks reasonable.

-- 
Best regards,
Michał Górny