Skip to content

Comments

Add manpage and --version flag#10

Merged
actualben merged 4 commits intomainfrom
feat/manpage-and-version
Feb 17, 2026
Merged

Add manpage and --version flag#10
actualben merged 4 commits intomainfrom
feat/manpage-and-version

Conversation

@actualben
Copy link
Contributor

@actualben actualben commented Feb 17, 2026

This PR adds a manpage for the CLI and sets up automated generation from the argparse definition.

Changes:

  • Add --version flag to CLI using importlib.metadata
  • Extract get_parser() function from main() for argparse-manpage compatibility
  • Add man/extra-sections.man with documentation for expressions, examples, timezones, and localization
  • Add Makefile with wheel, manpages, test, and clean targets
  • Update wheel.yml workflow to use make wheel, ensuring manpage is generated before build
  • Add argparse-manpage as dev dependency
  • Exclude generated man/*.1 files from version control

The manpage is auto-generated from the argparse definition combined with the extra sections file, keeping CLI help and manpage documentation in sync.

- Add man/datetimecalc.1 with full documentation of CLI usage
- Add --version flag using importlib.metadata
- Add Makefile with build, manpage, test, clean targets
- Extract get_parser() function for argparse-manpage compatibility
- Add man/extra-sections.man with expressions, examples, and other docs
- Generate man/datetimecalc.1 using argparse-manpage
- Update wheel.yml workflow to use make build
- Add argparse-manpage as dev dependency
- Rename 'build' target to 'wheel' for clarity
- Add progress echo for each target
- Reorder dependencies so $< works for --include
- Place .PHONY declarations adjacent to targets
- Quote automatic variables
- Update workflow to use 'make wheel'
The manpage is generated from argparse via 'make manpages'.
@actualben
Copy link
Contributor Author

@copilot please update the description based on the commits in this pr

Copy link

Copilot AI commented Feb 17, 2026

@actualben I've opened a new pull request, #11, to work on those changes. Once the pull request is ready, I'll request review from you.

@actualben
Copy link
Contributor Author

@copilot I just wanted your help generating a better description for this PR based on the current set of commits, I didn't want a new PR.

Copy link

Copilot AI commented Feb 17, 2026

@actualben I've opened a new pull request, #12, to work on those changes. Once the pull request is ready, I'll request review from you.

@actualben actualben merged commit c1e90cd into main Feb 17, 2026
1 check passed
@actualben actualben deleted the feat/manpage-and-version branch February 17, 2026 12:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants