Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: Use scdoc to write and generate man pages #299

Merged
merged 1 commit into from
Jan 20, 2025
Merged

Conversation

Antiz96
Copy link
Owner

@Antiz96 Antiz96 commented Jan 20, 2025

Description

scdoc is much more user friendly, simpler to read / write & more "digest" than groff.
See #296 for the rational about the scdoc choice.

Note that this introduces two new targets in the Makefile:

  • build (default target): Used to generate and archive the man pages (the generation of the .mo translation files has been moved here as well).
  • clean: Used to clean up the project directory of files man pages generated during build (the deletion of the generated .mo translation files has been moved here as well).

Addressed feature request

Closes #296

@Antiz96 Antiz96 force-pushed the man_pages_scdoc branch 9 times, most recently from a18842b to 1ef0692 Compare January 20, 2025 12:15
`scdoc` is much more user friendly, simpler to read / write & more "digest" than `groff`.
See #296 for the rational about the `scdoc` choice.

Note that this introduces two new targets in the `Makefile`:

- build (default target): Used to generate and archive the man pages (the generation of the `.mo` translation files has been moved here as well).
- clean: Used to clean up the project directory of files man pages generated during build (the deletion of the generated `.mo` translation files has been moved here as well).

Closes #296
Copy link
Owner Author

@Antiz96 Antiz96 left a comment

Choose a reason for hiding this comment

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

LGTM

@Antiz96 Antiz96 merged commit 6749a94 into main Jan 20, 2025
1 check passed
@Antiz96 Antiz96 deleted the man_pages_scdoc branch January 20, 2025 12:21
@Antiz96 Antiz96 added this to the v3.6.0 milestone Jan 20, 2025
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.

Use scdoc to write and generate man pages
1 participant