FreeBSD src
Go to file
Jilles Tjoelker a62ab0274a sh: Add $'quoting' (C-style escape sequences).
A string between $' and ' may contain backslash escape sequences similar to
the ones in a C string constant (except that a single-quote must be escaped
and a double-quote need not be). Details are in the sh(1) man page.

This construct is useful to include unprintable characters, tabs and
newlines in strings; while this can be done with a command substitution
containing a printf command, that needs ugly workarounds if the result is to
end with a newline as command substitution removes all trailing newlines.

The construct may also be useful in future to describe unprintable
characters without needing to write those characters themselves in 'set -x',
'export -p' and the like.

The implementation attempts to comply to the proposal for the next issue of
the POSIX specification. Because this construct is not in POSIX.1-2008,
using it in scripts intended to be portable is unwise.

Matching the minimal locale support in the rest of sh, the \u and \U
sequences are currently not useful.

Exp-run done by: pav (with some other sh(1) changes)
2011-05-05 20:55:55 +00:00
bin sh: Add $'quoting' (C-style escape sequences). 2011-05-05 20:55:55 +00:00
cddl Don't pass empty mount options to nmount(2). 2011-05-03 16:00:26 +00:00
contrib Make cross-compiling using clang work better, by respecting the 2011-05-05 16:14:13 +00:00
crypto Merge two upstream patches from vendor branch. No functional changes. 2011-05-05 08:08:18 +00:00
etc 1. If PKG_DBDIR cannot be determined from make, set the default 2011-05-05 02:35:11 +00:00
games Improve the distributeworld target in Makefile.inc1 and update the release 2011-03-02 14:39:26 +00:00
gnu Remove GNU man implemenation now that the BSD version has cooked for a while. 2011-04-21 07:14:10 +00:00
include Vendor import of clang trunk r130700: 2011-05-02 19:39:53 +00:00
kerberos5 Fix a typo. 2010-01-09 18:53:03 +00:00
lib * Update copyright notice. 2011-05-05 19:49:27 +00:00
libexec rtld: eliminate double call to close(2) that may occur in load_object 2011-03-25 18:23:10 +00:00
release Simplify this script somewhat, following excellent suggestions from 2011-05-05 19:17:55 +00:00
rescue Finally... Import the latest open-source ZFS version - (SPA) 28. 2011-02-27 19:41:40 +00:00
sbin Implemented a mount option "nocto" that disables cache coherency 2011-05-04 13:27:45 +00:00
secure Upgrade to OpenSSH 5.8p2. 2011-05-04 07:34:44 +00:00
share Add a manpage for geom_map(4). 2011-05-05 14:43:35 +00:00
sys Detect and set Atom's Tj(max) to 90 if it's not the 45nm D400/D500/N400 2011-05-05 19:15:15 +00:00
tools sh: Add $'quoting' (C-style escape sequences). 2011-05-05 20:55:55 +00:00
usr.bin - Add a forgotten -o to usage(). 2011-05-05 10:17:49 +00:00
usr.sbin Fix boot on old machines (e.g. blue and white G3s) by synthesizing a 2011-05-05 00:52:19 +00:00
COPYRIGHT Happy New Year 2011. 2010-12-31 18:07:16 +00:00
LOCKS Update LOCKS syntax. 2008-06-05 19:47:58 +00:00
MAINTAINERS - Initial release of bxe(4) to support Broadcom NetXtreme II 10GbE. 2011-03-14 22:42:41 +00:00
Makefile Vendor import of clang trunk r130700: 2011-05-02 19:39:53 +00:00
Makefile.inc1 Correct the kernel config name printed out during install. 2011-05-05 00:43:55 +00:00
Makefile.mips Retire TARGET_ABI. 2011-01-07 20:26:33 +00:00
ObsoleteFiles.inc Upgrade our copy of llvm/clang to r130700, from upstream's trunk. 2011-05-02 21:04:37 +00:00
README Vendor import of OpenSSH 5.8p2 2011-05-03 11:22:37 +00:00
UPDATING Add UPDATING entry for the AR71xx config changes 2011-04-30 11:30:42 +00:00

This is the top level of the FreeBSD source directory.  This file
was last revised on:
$FreeBSD$

For copyright information, please see the file COPYRIGHT in this
directory (additional copyright information also exists for some
sources in this tree - please see the specific source directories for
more information).

The Makefile in this directory supports a number of targets for
building components (or all) of the FreeBSD source tree, the most
commonly used one being ``world'', which rebuilds and installs
everything in the FreeBSD system from the source tree except the
kernel, the kernel-modules and the contents of /etc.  The ``world''
target should only be used in cases where the source tree has not
changed from the currently running version.  See:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html
for more information, including setting make(1) variables.

The ``buildkernel'' and ``installkernel'' targets build and install
the kernel and the modules (see below).  Please see the top of
the Makefile in this directory for more information on the
standard build targets and compile-time flags.

Building a kernel is a somewhat more involved process, documentation
for which can be found at:
   http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig.html
And in the config(8) man page.
Note: If you want to build and install the kernel with the
``buildkernel'' and ``installkernel'' targets, you might need to build
world before.  More information is available in the handbook.

The sample kernel configuration files reside in the sys/<arch>/conf
sub-directory (assuming that you've installed the kernel sources), the
file named GENERIC being the one used to build your initial installation
kernel.  The file NOTES contains entries and documentation for all possible
devices, not just those commonly used.  It is the successor of the ancient
LINT file, but in contrast to LINT, it is not buildable as a kernel but a
pure reference and documentation file.


Source Roadmap:
---------------
bin		System/user commands.

cddl		Various commands and libraries under the Common Development
		and Distribution License.

contrib		Packages contributed by 3rd parties.

crypto		Cryptography stuff (see crypto/README).

etc		Template files for /etc.

games		Amusements.

gnu		Various commands and libraries under the GNU Public License.
		Please see gnu/COPYING* for more information.

include		System include files.

kerberos5	Kerberos5 (Heimdal) package.

lib		System libraries.

libexec		System daemons.

release		Release building Makefile & associated tools.

rescue		Build system for statically linked /rescue utilities.

sbin		System commands.

secure		Cryptographic libraries and commands.

share		Shared resources.

sys		Kernel sources.

tools		Utilities for regression testing and miscellaneous tasks.

usr.bin		User commands.

usr.sbin	System administration commands.


For information on synchronizing your source tree with one or more of
the FreeBSD Project's development branches, please see:

  http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/synching.html