Bug 234997

Summary: gmirror.8: geom_mirror_load="YES" is not documented
Product: Documentation Reporter: Mateusz Piotrowski <0mp>
Component: Manual PagesAssignee: Benedict Reuschling <bcr>
Status: In Progress ---    
Severity: Affects Only Me CC: bcr, crest, doc, ygy
Priority: ---    
Version: Latest   
Hardware: Any   
OS: Any   

Description Mateusz Piotrowski freebsd_committer freebsd_triage 2019-01-16 13:29:07 UTC 
In order to activate mirrors automatically on boot one has to add geom_mirror_load="YES" to loader.conf(5). It is not documented in gmirror.8, however.
Comment 1 Mateusz Piotrowski freebsd_committer freebsd_triage 2019-01-17 13:16:11 UTC 
Reported by: Michiel van Baak <michiel@vanbaak.eu>
Comment 2 Benedict Reuschling freebsd_committer freebsd_triage 2019-06-09 16:34:28 UTC 
The problem is actually bigger than anticipated. All the other files in the head/lib/geom/ subdirectories for the other GEOM modules also do not have this information in the SYNOPSIS section. I've opened a review for gmirror.8 here:

https://reviews.freebsd.org/D20577
Comment 3 commit-hook freebsd_committer freebsd_triage 2022-10-05 16:50:54 UTC 
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=d63104d253e284964a2e7994553594b5b04422a3

commit d63104d253e284964a2e7994553594b5b04422a3
Author:     Benedict Reuschling <bcr@FreeBSD.org>
AuthorDate: 2022-10-05 16:44:31 +0000
Commit:     Benedict Reuschling <bcr@FreeBSD.org>
CommitDate: 2022-10-05 16:44:31 +0000

    Add information on how to load gmirror on boot to auto activate mirrors

    PR:                     234997
    Reported by:            Michiel van Baak <michiel@vanbaak.eu>
    Event:                  Aberdeen Hackathon 2022
    Differential Revision:  https://reviews.freebsd.org/D20577

 lib/geom/mirror/gmirror.8 | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)
Comment 4 Benedict Reuschling freebsd_committer freebsd_triage 2022-10-05 16:53:05 UTC 
I've fixed it for gmirror, but as mentioned, the other geom man pages also need that. Not sure if that is necessary in the age of devmatch, but for consistencies sake, it would not hurt either. Opinions?
Comment 5 Mark Linimon freebsd_committer freebsd_triage 2024-01-10 04:58:42 UTC 
^Triage: assign to committer that resolved.

It still seems like there are similar issues to be discussed, however.