Changeset View
Standalone View
share/man/man7/hier.7
Show All 22 Lines | |||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" @(#)hier.7 8.1 (Berkeley) 6/5/93 | .\" @(#)hier.7 8.1 (Berkeley) 6/5/93 | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd November 22, 2022 | .Dd November 23, 2022 | ||||
.Dt HIER 7 | .Dt HIER 7 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm hier | .Nm hier | ||||
.Nd layout of file systems | .Nd layout of file systems | ||||
.Sh DESCRIPTION | .Sh SYNOPSIS | ||||
A sketch of the file system hierarchy. | A sketch of the file system hierarchy. | ||||
.Sh DESCRIPTION | |||||
.Bl -tag -width "/libexec/" | .Bl -tag -width "/libexec/" | ||||
.It Pa / | .It Pa / | ||||
root directory of the file system | root directory of the file system | ||||
.It Pa /bin/ | .It Pa /bin/ | ||||
user utilities fundamental to both single-user and multi-user environments | user utilities fundamental to both single-user and multi-user environments | ||||
.It Pa /boot/ | .It Pa /boot/ | ||||
programs and configuration files used during operating system bootstrap | programs and configuration files used during operating system bootstrap | ||||
.Pp | .Pp | ||||
▲ Show 20 Lines • Show All 242 Lines • ▼ Show 20 Lines | |||||
.Xr sendmail 8 | .Xr sendmail 8 | ||||
mail filter API | mail filter API | ||||
.It Pa machine/ | .It Pa machine/ | ||||
machine-specific C include files | machine-specific C include files | ||||
.It Pa net/ | .It Pa net/ | ||||
miscellaneous network C include files | miscellaneous network C include files | ||||
.Bl -tag -width Fl -compact | .Bl -tag -width Fl -compact | ||||
.It Pa altq/ | .It Pa altq/ | ||||
C include files for alternate packet queueing; see | C include files for alternate packet queuing; see | ||||
.Xr altq 4 | .Xr altq 4 | ||||
.El | .El | ||||
.It Pa net80211/ | .It Pa net80211/ | ||||
C include files for 802.11 wireless networking; | C include files for 802.11 wireless networking; | ||||
see | see | ||||
.Xr net80211 4 | .Xr net80211 4 | ||||
.It Pa netinet/ | .It Pa netinet/ | ||||
C include files for Internet standard protocols; | C include files for Internet standard protocols; | ||||
Show All 19 Lines | |||||
remote procedure calls; | remote procedure calls; | ||||
see | see | ||||
.Xr rpc 3 | .Xr rpc 3 | ||||
.It Pa rpcsvc/ | .It Pa rpcsvc/ | ||||
definition of RPC service structures; see | definition of RPC service structures; see | ||||
.Xr rpc 3 | .Xr rpc 3 | ||||
.It Pa security/ | .It Pa security/ | ||||
PAM; see | PAM; see | ||||
.Xr pam 8 | .Xr pam 3 | ||||
.It Pa sys/ | .It Pa sys/ | ||||
system C include files (kernel data structures) | system C include files (kernel data structures) | ||||
.\" .It Pa tcl/ | .\" .It Pa tcl/ | ||||
.\" Tcl language; | .\" Tcl language; | ||||
.\" see | .\" see | ||||
.\" .Xr Tcl n | .\" .Xr Tcl n | ||||
.\" .Bl -tag -width "kerberos5/" -compact | .\" .Bl -tag -width "kerberos5/" -compact | ||||
.\" .It Pa generic/ | .\" .It Pa generic/ | ||||
Show All 31 Lines | |||||
OpenSSL (Cryptography/SSL toolkit) dynamically loadable engines | OpenSSL (Cryptography/SSL toolkit) dynamically loadable engines | ||||
.El | .El | ||||
.Pp | .Pp | ||||
.It Pa libdata/ | .It Pa libdata/ | ||||
miscellaneous utility data files | miscellaneous utility data files | ||||
.Pp | .Pp | ||||
.Bl -tag -width Fl -compact | .Bl -tag -width Fl -compact | ||||
.It Pa gcc/ | .It Pa gcc/ | ||||
.Xr gcc 1 | GCC configuration data | ||||
danfe: //GCC configuration data//, perhaps: before it was correct as it was referring to the command… | |||||
Done Inline ActionsI forgot that one. Unless there's another round of reviewing, I'll fix it before pushing. pauamma_gundo.com: I forgot that one. Unless there's another round of reviewing, I'll fix it before pushing. | |||||
configuration data | |||||
.It Pa ldscripts/ | .It Pa ldscripts/ | ||||
linker scripts; | linker scripts; | ||||
see | see | ||||
.Xr ld 1 | .Xr ld 1 | ||||
.It Pa pkgconfig/ | .It Pa pkgconfig/ | ||||
pc files | .Xr pc 5 Pq Pa ports/devel/pkgconf | ||||
files: collections of compiler flags, linker flags, and other | |||||
information relevant to library use | |||||
Done Inline ActionsI would have also expanded what those pc files are, currently it's unclear unless the reader already knows what they are. danfe: I would have also expanded what those //pc files// are, currently it's unclear unless the… | |||||
Done Inline ActionsCome to think of it, I'm not sure what they are for. Compiler and linker options for contributed base software? pauamma_gundo.com: Come to think of it, I'm not sure what they are for. Compiler and linker options for… | |||||
Done Inline Actions
man pc(5) -- actually, changing it to .Xr pc 5 would probably be sufficient and avoid the need for elaborate explanation. danfe: > I'm not sure what they are for.
//man pc(5)// -- actually, changing it to `.Xr pc 5` would… | |||||
Done Inline ActionsNot in base. But perhaps "compiler flags, linker flags, and other information relevant to library use"? (Summarized from first paragraph of https://www.freebsd.org/cgi/man.cgi?query=pc&apropos=0&sektion=0&manpath=FreeBSD+13.1-RELEASE+and+Ports&arch=default&format=html description, as I think it would apply to use in base.) pauamma_gundo.com: Not in base. But perhaps "compiler flags, linker flags, and other information relevant to… | |||||
Done Inline ActionsHow does it look now? pauamma_gundo.com: How does it look now? | |||||
Done Inline Actions
Description is okay, but why not annotate .Xr pc 5 explicitly? danfe: > How does it look now?
Description is okay, but why not annotate `.Xr pc 5` explicitly? | |||||
Done Inline ActionsBecause, as I mentioned earlier, that manual page isn't in base. I'm trying to bring mandoc -T lint complaints down here, not give it more things to complain about. pauamma_gundo.com: Because, as I mentioned earlier, that manual page isn't in base. I'm trying to bring mandoc -T… | |||||
Done Inline ActionsI doubt this will appease mandoc -T lint, but you could always add a reference that the manual is part of a third-party package, such as in security(7): security.7:.Xr xterm 1 Pq Pa ports/x11/xterm gjb: I doubt this will appease `mandoc -T lint`, but you could always add a reference that the… | |||||
Done Inline ActionsWFM. pauamma_gundo.com: WFM. | |||||
.El | .El | ||||
.Pp | .Pp | ||||
.It Pa libexec/ | .It Pa libexec/ | ||||
system daemons & system utilities (executed by other programs) | system daemons & system utilities (executed by other programs) | ||||
.Pp | .Pp | ||||
.Bl -tag -width Fl -compact | .Bl -tag -width Fl -compact | ||||
.It Pa aout/ | .It Pa aout/ | ||||
utilities to manipulate a.out executables | utilities to manipulate a.out executables | ||||
▲ Show 20 Lines • Show All 60 Lines • ▼ Show 20 Lines | |||||
word lists; | word lists; | ||||
see | see | ||||
.Xr look 1 | .Xr look 1 | ||||
.Bl -tag -width Fl -compact | .Bl -tag -width Fl -compact | ||||
.It Pa freebsd | .It Pa freebsd | ||||
.Fx Ns -specific | .Fx Ns -specific | ||||
terms, proper names, and jargon | terms, proper names, and jargon | ||||
.It Pa web2 | .It Pa web2 | ||||
words from Webster's 2nd International | words from Webster's Second International | ||||
.El | .El | ||||
.It Pa doc/ | .It Pa doc/ | ||||
miscellaneous documentation; | miscellaneous documentation; | ||||
source for most of the printed | source for most of the printed | ||||
.Bx | .Bx | ||||
manuals (available | manuals (available | ||||
from the | from the USENIX association) | ||||
.Tn USENIX | |||||
association) | |||||
.Bl -tag -width Fl -compact | .Bl -tag -width Fl -compact | ||||
.It Pa FAQ/ | .It Pa FAQ/ | ||||
Frequently Asked Questions | Frequently Asked Questions | ||||
.It Pa IPv6/ | .It Pa IPv6/ | ||||
implementation notes for IPv6 | implementation notes for IPv6 | ||||
.It Pa es/ | .It Pa es/ | ||||
Spanish translations of documents in /usr/share/doc | Spanish translations of documents in /usr/share/doc | ||||
.It Pa handbook/ | .It Pa handbook/ | ||||
▲ Show 20 Lines • Show All 348 Lines • Show Last 20 Lines |
GCC configuration data, perhaps: before it was correct as it was referring to the command and rendered as gcc(1), but now it means the product itself, which name is an abbreviation and thus should be capitalized.