Autogenerate man page by keszybz · Pull Request #35 · systemd/package-notes · GitHub
Skip to content

Autogenerate man page#35

Merged
bluca merged 3 commits into
systemd:mainfrom
keszybz:autogenerate-man-page
May 21, 2024
Merged

Autogenerate man page#35
bluca merged 3 commits into
systemd:mainfrom
keszybz:autogenerate-man-page

Conversation

@keszybz

@keszybz keszybz commented May 21, 2024

Copy link
Copy Markdown
Member

No description provided.

keszybz added 3 commits May 21, 2024 18:57
Also, change help to use capitalized sentences. argparse
unfortunately doesn't make this easy, we need to readd the
--help option manually with the correct description.
Setting this up is a bit annoying, but then with luck we won't
have to edit raw roff when new options are added.
@bluca bluca merged commit 31ce2fc into systemd:main May 21, 2024
@bluca

bluca commented May 21, 2024

Copy link
Copy Markdown
Member

@bluca

bluca commented May 21, 2024

Copy link
Copy Markdown
Member

Dropping that parameter I get:

argparse-manpage(1)                           General Commands Manual                           argparse-manpage(1)

NAME
       argparse-manpage

SYNOPSIS
       argparse-manpage [-r] [-s] [-f [FEATURE1,FEATURE2]] [-h] filename [filename ...]

DESCRIPTION
       Read .note.dlopen notes from ELF files and report the contents.

OPTIONS
       filename
              Library file to extract notes from

       -r, --raw
              Show the original JSON extracted from input files

       -s, --sonames
              List all sonames and their priorities, one soname per line

       -f [FEATURE1,FEATURE2], --features [FEATURE1,FEATURE2]
              Describe features, can be specified multiple times

AUTHORS
       package-notes was written by <<UNSET --author OPTION>> <<<UNSET --author_email OPTION>>>.

DISTRIBUTION
       The latest version of package-notes may be downloaded from ⟨<<UNSET⟩

@keszybz keszybz deleted the autogenerate-man-page branch May 21, 2024 18:55
@keszybz

keszybz commented May 21, 2024

Copy link
Copy Markdown
Member Author

Hmm, maybe you have an old version of argparse-manpage? But the list at https://github.com/praiskup/argparse-manpage/ says Debian 12 has 4.5, same as here.

@bluca

bluca commented May 21, 2024

Copy link
Copy Markdown
Member

@bluca

bluca commented May 21, 2024

Copy link
Copy Markdown
Member

Just generate it once with that tool and check the result in? I can't imagine we are going to change this that often...

@keszybz

keszybz commented May 22, 2024

Copy link
Copy Markdown
Member Author

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants