Bug 197003

Summary: devd(8) man page needs update for /etc/devd/ and /usr/local/etc/devd/
Product: Documentation Reporter: Harald Schmalzbauer <bugzilla.freebsd>
Component: Manual PagesAssignee: Guangyuan Yang <ygy>
Status: Closed FIXED    
Severity: Affects Many People CC: doc, felix.the.red, imp, ygy
Priority: --- Keywords: easy, patch
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
devd(8) patch felix.the.red: maintainer-approval? (imp)

Description Harald Schmalzbauer 2015-01-22 13:52:45 UTC
Accidentally, while running devd(8) in debug/foreground mode I noticed the following output:
Parsing /etc/devd.conf
…
Parsing files in /etc/devd
…
Parsing files in /usr/local/etc/devd

/etc/devd/ was obvious, although not documented, since there are conf files populated in base.
But /usr/local/etc/devd/ was new to me.
Both directories are not mentioned in DEVD(8), nor referenced in DEVD.CONF(5).

If someone has a reccomendation for a CLI-man-page editor besides vi(1)&co (I'm not familar with formatting tags), I'd do my best preparing a non-native-speaker's diff. Have alwas been curious how people write/edit man pages…

I checked against "FreeBSD 8.1-STABLE #0: Mon Sep  6 18:31:39 CEST 2010" and "FreeBSD 10.1-STABLE+FP1 #0 r277168M"
Comment 1 Felix Johnson freebsd_triage 2021-10-17 17:38:02 UTC
Created attachment 228783 [details]
devd(8) patch

Update devd(8) to note the default locations devd searches for config files.
Add a paragraph tag to separate the text from the previous paragraph.
Comment 2 commit-hook freebsd_committer 2021-10-19 04:41:17 UTC
A commit in branch main references this bug:

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

commit bad324ace4f817206baf86ae7379c35c8199048e
Author:     Felix Johnson <felix.the.red@gmail.com>
AuthorDate: 2021-10-19 04:37:40 +0000
Commit:     Guangyuan Yang <ygy@FreeBSD.org>
CommitDate: 2021-10-19 04:37:40 +0000

    devd(8): Note default config file search locations

    PR:             197003
    MFC after:      3 days
    Reported by:    Harald Schmalzbauer <bugzilla.freebsd@omnilan.de>

 sbin/devd/devd.8 | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)
Comment 3 commit-hook freebsd_committer 2021-10-22 04:00:13 UTC
A commit in branch stable/13 references this bug:

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

commit d8359af5b642c0d194aedce90ebd1415e0c483d6
Author:     Felix Johnson <felix.the.red@gmail.com>
AuthorDate: 2021-10-19 04:37:40 +0000
Commit:     Guangyuan Yang <ygy@FreeBSD.org>
CommitDate: 2021-10-22 03:59:17 +0000

    devd(8): Note default config file search locations

    PR:             197003
    Reported by:    Harald Schmalzbauer <bugzilla.freebsd@omnilan.de>

    (cherry picked from commit bad324ace4f817206baf86ae7379c35c8199048e)

 sbin/devd/devd.8 | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)