Commit Graph

269 Commits

Author SHA1 Message Date
Murray Stokely
6f9ac6fee0 Markup fix. Use .Va instead of .Ev. No content changes. 2002-03-15 23:34:17 +00:00
Murray Stokely
b3a43ea37a Add a description of the TARGET variable, and add more information
about the TARGET_ARCH variable. (1)

Add information about the DESTDIR variable.

Add more examples for cross-building.

(1) Submitted by:     ru
MFC after:	      3 days
2002-03-15 23:29:24 +00:00
Murray Stokely
1bcf2f1a12 Even more markup / whitespace fixes:
* Use .Va instead of .Ev
* Remove a trailing whitespace at EOL.
* Quote some arguments.

Submitted by:	ru
2002-03-15 09:23:21 +00:00
Robert Watson
b45deeb2a5 NAI DBA update. 2002-03-14 21:58:58 +00:00
Murray Stokely
b82e53e2bd Add an ENVIRONMENT section, and document TARGET_ARCH and NO_WERROR.
Add a cross-build example.
2002-03-14 09:38:24 +00:00
Murray Stokely
afb3369031 Various mdoc fixes.
Submitted by:	ru
2002-03-14 04:21:50 +00:00
Murray Stokely
994c71f0c8 * Simplify the synopsis.
* Remove trailing whitespace at EOL.
* Various grammar cleanups.
* Note that MAKE_ISOS is disabled by default.
* Use more descriptive mdoc markup.
* Use proper references for the online FDP documents.

Submitted by:	dd
2002-03-13 09:54:31 +00:00
Murray Stokely
a54bda91f5 Reference release(7) in SEE ALSO. 2002-03-13 06:59:39 +00:00
Murray Stokely
de26e0ad7a Add a makefile to document the release building process.
Specifically, this documents the available targets and relevant
environment variables for "make release".  LOCAL_PATCHES,
RELEASEDISTFILES, RELEASENOUPDATE, etc.. are covered.

A future commit should add more information about drivers.conf,
boot_crunch.conf, and other less well-known aspects of the release
build.

Reviewed and history section added by:	phk
2002-03-13 06:33:26 +00:00
Murray Stokely
5d3d0230e6 Point readers to the Porter's Handbook instead of the non-existant
"Porting Applications" section of the FreeBSD Handbook.

MFC After: 2 days
2002-03-12 09:45:29 +00:00
Giorgos Keramidas
6057ffa65a Fix typo.
PR:		docs/35422
Submitted by:	Mike DeGraw-Bertsch <mbertsch@radioactivedata.org>
2002-02-28 22:44:15 +00:00
Robert Watson
aa5ff764fa Two license updates. 2002-02-18 01:28:01 +00:00
Robert Watson
992e463887 Clarify word choice: s/those users/users/, since there is no previous
instance of 'users' to refer to.
2002-02-18 00:20:12 +00:00
Ruslan Ermilov
93dee74a5d Revert revision 1.57 -- ache@ axed /var/spool/uucp in BSD.var.dist,v 1.55. 2002-01-22 14:55:25 +00:00
Ruslan Ermilov
757c6a47b6 mdoc(7) police: tidy up.
Reviewed by:	chris
2002-01-18 16:46:43 +00:00
Chris Costello
43b95addad Change "From Id:" to the correct "$Id$" string, as there's no danger
of it being expanded.

Sponsored by:	DARPA, NAI Labs
2002-01-17 23:08:43 +00:00
Bruce A. Mah
f1bf956810 newfs -U enables softupdates beginning with FreeBSD 4.5.
PR:		33391
Submitted by:	Ceri <setantae@submonkey.net>
2002-01-11 23:55:58 +00:00
Ruslan Ermilov
987af41675 mdoc(7) police: expand contractions, remove newly introduced
hard sentence break, revert to a proper markup for config(8)
file directives, fix broken xref.
2002-01-10 16:27:25 +00:00
Nik Clayton
e67796ea42 Fix typo, and add some additional description to the i8254 and TSC.
PR:		docs/20738
Submitted by:	Tan Koan-Sin <freedom@csie.nctu.edu.tw>
2002-01-09 13:10:18 +00:00
Mike Pritchard
7c86a74b2d ispell sweep of share/man/man7/*. 2002-01-09 12:34:01 +00:00
Chris Costello
e4407b54e8 Minor doc nit: Replace contractions with their expanded forms.
Obtained from:	NAI Labs CBOSS Project
Sponsored by:	DARPA, NAI Labs
2002-01-06 20:28:27 +00:00
Chris Costello
7f0def37ec As discussed with Bruce Evans and Kirk McKusick:
o Combine ufs.7 and ffs.7 into a single ffs.7 man page.
o Remove all references to `ufs' as a file system.
o Proper (lack of) capitalization for `ffs'.

Obtained from:	TrustedBSD Project
Sposnored by:	DARPA, NAI Labs
2002-01-05 20:18:35 +00:00
Chris Costello
ad25c55e52 Make WHERE TO START' and WHERE TO STOP' subsections within `DESCRIPTION'.
Suggested by:	sheldonh
Obtained from:	TrustedBSD Project
Sponsored by:	DARPA, NAI Labs
2002-01-01 19:20:02 +00:00
Chris Costello
3092f2e699 o Logically split up sentences, removing hard sentence breaks.
o Use .Sx where a section cross-reference is intended.

Obtained from:	TrustedBSD Project
Sponsored by:	DARPA, NAI Labs
2001-12-30 20:34:53 +00:00
Chris Costello
07bf51c9b5 Be sure to point out that, by "mount point", one in /etc/fstab
is meant.

Submitted by:	John Hanley <jh_@yahoo.com>
Obtained from:	TrustedBSD Project
Sponsored by:	DARPA, NAI Labs
2001-12-30 03:47:06 +00:00
Chris Costello
bd49a87618 Document how to enable ACLs using extattrctl.
Obtained from:	TrustedBSD Project
Sponsored by:	DARPA, NAI Labs
2001-12-30 03:44:40 +00:00
Chris Costello
1c393056e6 Move UFS and FFS docs to section 7.
Obtained from:	TrustedBSD Project
Sponsored by:	DARPA, NAI Labs
2001-12-28 17:10:13 +00:00
Chris Costello
1fc841e3ab Add in the new security documentation guidelines document.
Obtained from:	NAI Labs CBOSS Project
Sponsored by:	DARPA, NAI Labs
2001-12-22 22:07:02 +00:00
Robert Watson
7270230e88 o s/softupdates/it/ to reduce over-use of 'softupdates' in a single
paragraph.
2001-12-22 21:02:33 +00:00
Robert Watson
b2e2e310fd o Softupdates is now enabled by default on non-root file systems. Update
language about softupdates to reference this fact, as well as slightly
  moderate the "recommend Softupdates for use on all filesystems" to
  "most filesystems" so as to be consistent with what sysinstall selects.
2001-12-22 21:01:07 +00:00
Robert Watson
60114b8024 o Most users will use sysinstall(8) for partition layout, rather than
disklabel(8), so add a reference to sysinstall(8).
2001-12-22 20:54:45 +00:00
Robert Watson
bcb3e22d61 o Expand on the definition of a sysctl, and add cross-references to
rc.conf and sysctl.conf.

MFC after:	3 days
2001-12-22 14:25:31 +00:00
Robert Watson
07f4b9740e o Refer to hw.ata.wc as a 'loader tunable' rather than a 'kernel variable'
for consistency with the rest of the document.  Since we've already
  described the properties of loader tunables elsewhere, remove the
  duplicate description of it being a boot-time property.

MFC after:	3 days
2001-12-22 14:21:20 +00:00
Robert Watson
d888f91feb o Update tuning(7) to reflect auto-tuning of kern.maxusers in recent
versions of FreeBSD.  This should be merged before 4.5-RELEASE, as this
  functionality is present in 4.5-RELEASE.

MFC after:	3 days
2001-12-22 14:19:20 +00:00
Ruslan Ermilov
f74d799555 mdoc(7) police: kill the undead whitespace at EOL. 2001-12-14 09:09:21 +00:00
Robert Watson
3b4fff26f3 o Various language and style tweaks.
Submitted by:	ru
2001-12-12 15:58:04 +00:00
Ruslan Ermilov
108c9afc50 mdoc(7) police: remove the debugging stuff I use to prevent
hyphenation (so that the output could be spell-checked).
2001-12-12 15:15:46 +00:00
Sheldon Hearn
3626f83327 Update the default newfs block and fragment sizes from 8192/1024 to
16384/2048.

Following recent discussions on the -arch mailing list, involving dillon
and mckusick, this change parallels the one made over a decade ago when
the default was bumped up from 4096/512.

This should provide significant performance improvements for most
folks, less significant performance losses for a few folks and
wasted space lost to large fragments for many folks.

For discussion, please see the following thread in the -arch archive:

Subject: Using a larger block size on large filesystems

The discussion ceases to be relevant when the issue of partitioning
schemes is raised.
2001-12-11 16:21:40 +00:00
Sheldon Hearn
2bd2a050ac Remove the advice relating to the number of cylinders per cylinder
group.  The highest possible value is calculated automatically since
rev 1.41 of src/sbin/newfs.c .
2001-12-10 09:26:30 +00:00
Robert Watson
eb22d616a0 When rfc1323 is mentioned in the context of buffer sizes, not that it
is enabled by default in FreeBSD.
2001-12-07 18:17:37 +00:00
Robert Watson
a695793d88 o Add a mention of kern.openfiles to the description of kern.maxfiles,
and suggest using this value to get a sense of the needs of the system.
2001-12-07 18:02:16 +00:00
Robert Watson
0fbfd3c17d o Fix spelling of allocations as allocates.
Submitted by:	silby
2001-12-06 20:27:44 +00:00
Robert Watson
98181c4975 o Reflect changed default such that keepalives are always enabled by
default now.  Discuss why that's good.  Note that there are still
  some situations where turning it off may be advantageous, including
  situations where there are network outages and it's desirable to
  have TCP sessions last beyond the outage.

Reviewed by:	fenner
Suggested by:	silby
2001-12-06 20:24:38 +00:00
Robert Watson
9aa92d5586 Moderate the recommendation that TCP keepalives always be turned on;
in some environments, this may result in the early termination of
legitimate TCP sessions during temporary network outages.  However,
maintain a strong recommendation that this be used when many network
clients are dialup.

Requested by:	fenner
2001-12-06 19:57:34 +00:00
Robert Watson
25eecbb5a4 o Add an additional .Pp between the send/recvbuffer comments and
the ones on ipfw.  Note to self: why does ipfw/dummynet count as
  a sysctl in tuning(7)?
2001-12-06 19:50:35 +00:00
Robert Watson
fe3e42064f o When describing kern.ipc.nsfbufs, use the slightly less colloquial
"modify" rather than the slightly more colloquial "mess with".
2001-12-06 19:48:48 +00:00
Robert Watson
657c740ed6 The default values for net.inet.tcp.sendspace and net.inet.tcp.recvspace
have been changed to 32k and 64k respectively.
2001-12-06 19:44:31 +00:00
Robert Watson
48c1691ebf vmiodirenable is now on by default; reflect that change in default,
and talk more about the reasons to turn it off (restricted memory
environments), and less about why to turn it on.
2001-12-06 19:39:33 +00:00
Robert Watson
32a124764d Reword parts of tuning(7) regarding loader tunables, which are refered
to in the document as "boot-time sysctls".  Instead, refer to them as
loader tunables.
2001-12-06 19:36:21 +00:00
Dima Dorfman
b94231daca Spelling police: "more then" - "more than" where appropriate. 2001-11-24 19:47:12 +00:00