Skip to content

docs: add reproducible example for generating man page#20703

Closed
benslimanh wants to merge 2 commits into
curl:masterfrom
benslimanh:docs-manpage-example
Closed

docs: add reproducible example for generating man page#20703
benslimanh wants to merge 2 commits into
curl:masterfrom
benslimanh:docs-manpage-example

Conversation

@benslimanh
Copy link
Copy Markdown
Contributor

Fixes #20699

This PR addresses the documentation gap in manpage.md by providing a clear, reproducible step-by-step example for generating the curl.1 man page.

Changes included:

  • Added the exact manual invocation commands using the managen script for both nroff and plain-text outputs.
  • Clarified the usage of the -d and -I flags.
  • Added a clear explanation of how the script expands the %options keyword, as well as the %VERSION, %DATE, and %GLOBALS variables.

This should significantly lower the barrier for new contributors trying to build the man pages locally.

@bagder
Copy link
Copy Markdown
Member

bagder commented Feb 24, 2026

@sammydono I take it this satisfies your curiosity?

Comment thread docs/cmdline-opts/MANPAGE.md Outdated
Co-authored-by: Viktor Szakats <vszakats@users.noreply.github.com>
@bagder bagder closed this in a4ce687 Feb 24, 2026
@bagder
Copy link
Copy Markdown
Member

bagder commented Feb 24, 2026

Thanks!

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

Development

Successfully merging this pull request may close these issues.

Documentation gap: manpage.md lacks reproducible example for generating curl man page

3 participants