Skip to content

docs: Add manpages - #346

Open
kienanstewart wants to merge 1 commit into
netromdk:masterfrom
kienanstewart:docs-man_pages
Open

docs: Add manpages#346
kienanstewart wants to merge 1 commit into
netromdk:masterfrom
kienanstewart:docs-man_pages

Conversation

@kienanstewart

Copy link
Copy Markdown

I based this heavily on the existing documentation. I chose to use rst2man because the README file is currently formatted with that markup already.

Fixes #345

Signed-off-by: Kienan Stewart <kienan.stewart@burntworld.ca>
@kienanstewart
kienanstewart requested a review from netromdk as a code owner July 27, 2026 18:09
@netromdk netromdk self-assigned this Aug 25, 2026
@netromdk netromdk added the enhancement New feature or request label Aug 25, 2026
@coveralls

Copy link
Copy Markdown

Coverage Status

coverage: 99.338%. remained the same — kienanstewart:docs-man_pages into netromdk:master

@netromdk netromdk left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you a lot! I only found a few discrepancies to fix.

Comment thread docs/man/vermin.1.rst
-h, --help
Show the help information and exits.

-v, --version

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
-v, --version
-V, --version

-v is already used for verbosity.

Comment thread docs/man/vermin.1.rst
--no-backport (default)
Use no backports. Clears any backports specified before this.

--feature==NAME

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
--feature==NAME
--feature=NAME

One = only.

Comment thread docs/man/vermin.ini.5.rst
verbose = ***0***
Verbosity level 1 to 4 showing increasingly more information. Turned off at level 0.

print_visit = ***no*** | yes

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
print_visit = ***no*** | yes
print_visits = ***no*** | yes

With an "s".

Comment thread docs/man/vermin.ini.5.rst

.. code-block:: ini

exclusion-regex =

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
exclusion-regex =
exclusion_regex =

With an "_".

Comment thread docs/man/vermin.1.rst
Exclude full names, like 'email.parser.FeedParser', from analysis. Useful to
ignore conditional logic that can trigger incompatible results. This option may
be specified multiple times.

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
--exclude-file=FILE
Exclude full names, like 'email.parser.FeedParser', from analysis but from a
specified file instead. Each line constitutes an exclusion with the same
format as with ``--exclude``.

Missing section.

@netromdk netromdk mentioned this pull request Aug 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add manual pages

3 participants