Differential D40232 Diff 122367 documentation/content/en/books/developers-handbook/introduction/_index.adoc

Changeset View

Standalone View

documentation/content/en/books/developers-handbook/introduction/_index.adoc

	Show First 20 Lines • Show All 79 Lines • ▼ Show 20 Lines
	* If you can get 90 percent of the desired effect for 10 percent of the work, use the simpler solution.			* If you can get 90 percent of the desired effect for 10 percent of the work, use the simpler solution.
	* Isolate complexity as much as possible.			* Isolate complexity as much as possible.
	* Provide mechanism, rather than policy. In particular, place user interface policy in the client's hands.			* Provide mechanism, rather than policy. In particular, place user interface policy in the client's hands.

	From Scheifler & Gettys: "X Window System"			From Scheifler & Gettys: "X Window System"

	[[introduction-layout]]			[[introduction-layout]]
	== The Layout of /usr/src			== The Layout of /usr/src

	The complete source code to FreeBSD is available from our public repository.			The complete source code for FreeBSD is available from our link:https://cgit.freebsd.org/src/[public Git repository].
				mhorneAuthorUnsubmitted Done Inline Actions I thought about making 'public repository' a link as well. But I was unsure what the source of truth is in our docs. https://docs.freebsd.org/en/books/handbook/mirrors/ ? mhorne: I thought about making 'public repository' a link as well. But I was unsure what the source of…
				emasteUnsubmitted Not Done Inline Actions I think that would be ok, or https://cgit.freebsd.org/src/ emaste: I think that would be ok, or https://cgit.freebsd.org/src/
	The source code is normally installed in [.filename]#/usr/src# which contains the following subdirectories:			The source code is normally installed in [.filename]#/usr/src#.
				The layout of the source tree is described by the top-level link:https://cgit.freebsd.org/src/tree/README.md[README.md] file.
	[.informaltable]
	[cols="1,1", frame="none", options="header"]
	\|===
	\| Directory
	\| Description

	\|[.filename]#bin/#
	\|Source for files in [.filename]#/bin#

	\|[.filename]#cddl/#
	\|Utilities covered by the Common Development and Distribution License

	\|[.filename]#contrib/#
	\|Source for files from contributed software

	\|[.filename]#crypto/#
	\|Cryptographical sources

	\|[.filename]#etc/#
	\|Source for files in [.filename]#/etc#

	\|[.filename]#gnu/#
	\|Utilities covered by the GNU Public License

	\|[.filename]#include/#
	\|Source for files in [.filename]#/usr/include#

	\|[.filename]#kerberos5/#
	\|Source for Kerberos version 5

	\|[.filename]#lib/#
	\|Source for files in [.filename]#/usr/lib#

	\|[.filename]#libexec/#
	\|Source for files in [.filename]#/usr/libexec#

	\|[.filename]#release/#
	\|Files required to produce a FreeBSD release

	\|[.filename]#rescue/#
	\|Build system for the [.filename]#/rescue# utilities

	\|[.filename]#sbin/#
	\|Source for files in [.filename]#/sbin#

	\|[.filename]#secure/#
	\|Contributed cryptographic sources

	\|[.filename]#share/#
	\|Source for files in [.filename]#/usr/share#

	\|[.filename]#sys/#
	\|Kernel source files

	\|[.filename]#tests/#
	\|The FreeBSD test suite

	\|[.filename]#tools/#
	\|Tools used for maintenance and testing of FreeBSD

	\|[.filename]#usr.bin/#
	\|Source for files in [.filename]#/usr/bin#

	\|[.filename]#usr.sbin/#
	\|Source for files in [.filename]#/usr/sbin#
	\|===