Skip site navigation (1)Skip section navigation (2)
Date:      Fri, 25 Aug 2023 13:45:30 +0000
From:      bugzilla-noreply@freebsd.org
To:        bugs@FreeBSD.org
Subject:   [Bug 261349] Modernise hier(7)
Message-ID:  <bug-261349-227-9uGdYvRFQI@https.bugs.freebsd.org/bugzilla/>
In-Reply-To: <bug-261349-227@https.bugs.freebsd.org/bugzilla/>
References:  <bug-261349-227@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 the assignee for the bug.=



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-261349-227-9uGdYvRFQI>