Skip to content

Update documentation in zonemaster-cli script#336

Merged
tgreenx merged 1 commit intozonemaster:developfrom
tgreenx:update-script-documentation
May 31, 2023
Merged

Update documentation in zonemaster-cli script#336
tgreenx merged 1 commit intozonemaster:developfrom
tgreenx:update-script-documentation

Conversation

@tgreenx
Copy link
Contributor

@tgreenx tgreenx commented May 30, 2023

Purpose

This PR proposes an update to the script/zonemaster-cli file, in particular to be more in line with options (and their documentation) in lib/Zonemaster/CLI.pm.

Note that the content in script/zonemaster-cli deliberately provides slightly more detailed documentation than the one in lib/Zonemaster/CLI.pm. This stems from issue #68 (not addressed in this PR), where documentation is done in two different places.

Context

Part of v2023.1 release testing

Also see #68

Changes

script/zonemaster-cli

  • Add missing options (and their documentation): nstimes, dump_profile, sourceaddr4, sourceaddr6, elapsed
  • Add defaults for each option, when applicable
  • Rephrasing, sanitizing

How to test this PR

Check that perldoc script/zonemaster-cli (or man zonemaster-cli) and zonemaster-cli -h provide similar, accurate information (although not an exact copy).

Add missing options
Add defaults for each option, when applicable
Rephrasing, sanitizing
@tgreenx tgreenx added A-Documentation Area: Documentation only. V-Patch Versioning: The change gives an update of patch in version. labels May 30, 2023
@tgreenx tgreenx added this to the v2023.1 milestone May 30, 2023
@tgreenx tgreenx requested review from a user, hannaeko, marc-vanderwal, matsduf and mattias-p May 30, 2023 17:17
Copy link
Contributor

@marc-vanderwal marc-vanderwal left a comment

Choose a reason for hiding this comment

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

Looks good to me.

@tgreenx tgreenx merged commit 2b14a85 into zonemaster:develop May 31, 2023
@tgreenx tgreenx deleted the update-script-documentation branch May 31, 2023 14:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-Documentation Area: Documentation only. V-Patch Versioning: The change gives an update of patch in version.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants