[Bug 261349] Modernise hier(7)
- In reply to: bugzilla-noreply_a_freebsd.org: "[Bug 261349] Consider adding /usr/src/sys/compat to hier(7)"
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Fri, 25 Aug 2023 13:45:30 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=261349 --- Comment #45 from Alexander Ziaee <concussious.bugzilla@runbox.com> --- Created attachment 244338 --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=244338&action=edit hier.7 rendered I can see that we've diverged slightly in some ways mdoc.7 and style.mdoc.5 are silent about, but hopefully you can overlook (or appreciate!) them and the additional content upstreamed in some form. If nothing else, this is what I'm doing, because "This manual page documents the default FreeBSD file system layout". To me that implies no intentional omission in the spirit of this document. There are some things I listed with no description because I didn't have a good description yet. Since the 14 alpha was released, I feel the need to share this in it's present state so that as much of it as everyone is willing to use can be available for new users in the release. Particularly: zapped synopsis because it isn't a synopsis describing the command line options. /var/log/messages absolutely must be listed guys, even you don't like my description and pick another, people new to unix-style systems do try freebsd all the time. If nobody tells you, it can take a very long time to realize there is a syslog everything is writing to. They are told to read man hier immediately upon logging in, so the inclusion of /var/log/messages in this document is quite serious. I used the term "BSD heritage" to describe the ancient artifacts in games and inetd, I think this is sets appropriate expectations for what they are if someone doesn't know. I know it's non-traditional to put the year in front of the release in history, but I'm 27 and that small addition makes young people realize something profound. Thank you for your time. -- You are receiving this mail because: You are the assignee for the bug.