Date: Fri, 25 Aug 2023 13:45:30 +0000 From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 261349] Modernise hier(7) Message-ID: <bug-261349-9-gsHRQWs9ff@https.bugs.freebsd.org/bugzilla/> In-Reply-To: <bug-261349-9@https.bugs.freebsd.org/bugzilla/> References: <bug-261349-9@https.bugs.freebsd.org/bugzilla/>
next in thread | previous in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D261349 --- Comment #45 from Alexander Ziaee <concussious.bugzilla@runbox.com> --- Created attachment 244338 --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=3D244338&action= =3Dedit 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 c= an 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 freeb= sd 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 a= nd 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 hist= ory, but I'm 27 and that small addition makes young people realize something profound. Thank you for your time. --=20 You are receiving this mail because: You are on the CC list for the bug.=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-261349-9-gsHRQWs9ff>