Skip to content

Rework facter man page#45

Merged
smortex merged 1 commit intomainfrom
man
Aug 25, 2025
Merged

Rework facter man page#45
smortex merged 1 commit intomainfrom
man

Conversation

@smortex
Copy link
Member

@smortex smortex commented Aug 22, 2025

This repository contain a facter(8) man page. This man page is generated by running facter --man which produce markdown and is passed to ronn, a ruby gem that was last updated in 2010 and bring a bunch of outdated dependencies that cause trouble with latest Ruby.

In order to get rid of this legacy gem, convert the "man" template so that it output a man page directly (with proper markup), that way no conversion is needed and the page is slightly improved (it is still not the quality of hand crafted man pages, but I do not consider this an issue given the point where we start). While here, change the man page section as facter is not a system manager command, but rather a general command. Get rid of the legacy man page and generate a new one.

This repository contain a facter(8) man page. This man page is generated by running `facter --man` which produce markdown and is passed to `ronn`, a ruby gem that was last updated in 2010 and bring a bunch of outdated dependencies that cause trouble with latest Ruby. In order to get rid of this legacy gem, convert the "man" template so that it output a man page directly (with proper markup), that way no conversion is needed and the page is slightly improved (it is still not the quality of hand crafted man pages, but I do not consider this an issue given the point where we start). While here, change the man page section as facter is not a system manager command, but rather a general command. Get rid of the legacy man page and generate a new one.
@smortex smortex added the documentation Improvements or additions to documentation label Aug 22, 2025
@smortex smortex marked this pull request as ready for review August 22, 2025 20:00
@smortex smortex merged commit e76ec65 into main Aug 25, 2025
23 of 26 checks passed
@smortex smortex deleted the man branch August 25, 2025 20:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

2 participants