Commit graph

264 commits

Author SHA1 Message Date
Gabor Kovesdan
7ba98a21ad MFH
Approved by:	doceng (implicit)
2012-08-19 23:05:52 +00:00
Gabor Kovesdan
74586f38c6 - Remove PSGML comments since they are not very useful after the XML
migration

Approved by:		doceng (implicit)
No objection from:	doc@, www@
2012-08-07 23:31:39 +00:00
Gabor Kovesdan
3cdf4e4922 - XMLify English books
Approved by:	doceng (implicit)
2012-06-21 16:04:40 +00:00
Warren Block
28b7376233 Make example swap partition names more realistic, and fix a typo. 2012-06-21 11:59:47 +00:00
Kevin Lo
0016b45b5e Fix typo 2012-06-20 02:28:11 +00:00
Benedict Reuschling
dc5ecb5cb1 Fix a comma splice by making two separate (shorter) sentences out of
a long one.

Submitted by:	bjk
2012-06-04 16:18:30 +00:00
Benedict Reuschling
aa095da897 Correct some errors where the tense changes in the middle of the
sentence and apply some other wording improvements to make the
text more readble.

Submitted by:	bjk
2012-06-03 19:44:39 +00:00
Benedict Reuschling
9feb409ca8 This change adds much more information about syslogd and newsyslog
than we had before in the configuration chapter. It describes how
the system logger can be configured, the rationale behind it and
the most important field that the user should edit.

PR:		docs/168305
Submitted by:	Niclas Zeising (zeising daemonic se)
Reviewed by:	wblock@, myself
2012-06-02 21:43:10 +00:00
Warren Block
12da7293c6 Fix a straggling <programlisting> tag. Translators, this makes a visible
change inside the programlisting, it's not just whitespace.
2012-04-18 05:54:17 +00:00
Warren Block
b64d04cb6f Whitespace-only cleanup. Wrap long lines, two spaces at sentence start,
correct indentation.
2012-04-18 05:48:05 +00:00
Warren Block
83ffb4ec19 Remove outdated note about ndis not supporting USB, add list of card
types supported to previous paragraph.

Edit redundant language.

Clarify explanation of 32-bit versus 64-bit drivers.
2012-04-18 03:33:14 +00:00
Eitan Adler
aeb1746e39 Place ending paragraph on the same line as the text.
Translators can ignore.

Requested and approved by:	bcr
2012-03-26 16:56:36 +00:00
Eitan Adler
5458fa1873 Make a few small changes found by igor (capitalize titles) and other style nits.
Translators can ignore.

Reviewed by:	gjb
Approved by:	bcr
2012-03-26 16:50:31 +00:00
Eitan Adler
bb233c6217 Rewrite the config chapter to be more clear and use professional language.
PR:		docs/164920
Submitted by:	Niclas Zeising <zeising@daemonic.se>
Reviewed by:	gjb (older version)
Approved by:	bcr
2012-03-26 16:42:26 +00:00
Eitan Adler
74fe68bfa8 Fix a variety of English style nits and other issues found with igor.
Reviewed by:	gabor
Approved by:	wblock
2012-02-13 04:28:35 +00:00
Glen Barber
0978762dc8 Replace references to www/apache13 with www/apache22.
A follow up to the network-servers chapter will be committed sometime
soon.

PR:		162494
Submitted by:	jgh (original version)
2012-01-31 14:14:59 +00:00
Doug Barton
58189f49fe Remove references to set_rcvar, which has been removed from 10-current.
While I'm here, bring some consistency to the various example rc.d scripts,
remove some bad examples, etc.
2012-01-14 23:16:00 +00:00
Manolis Kiagias
c4f7f08d30 Clear up the Handbook example on adding a swap file
PR:		docs/162597
Submitted by:	R. Clayton <rvclayton at acm dot org>
Reviewed by:	gjb
2011-11-16 06:55:28 +00:00
Daniel Gerzo
09d745a8bd - rework this section a little by including an info which applies to
the current state of how the things are done
- add a new paragraph covering the fact that rc.conf is read by sh(1)

PR:		docs/157894
Reviewed by:	gavin, simon, Niclas Zeising
2011-06-15 13:44:49 +00:00
Chin-San Huang
eaa28ea784 - add LibreOffice to FAQ, Handbook
PR:		docs/155552
Submitted by:	Jason Helfman <jhelfman _@\ experts-exchange dot com>
2011-03-21 17:42:38 +00:00
Rene Ladan
fffad858e3 Remove support for FreeBSD prior to 7.0 from the Handbook.
More specifically:
- mentions of old versions of FreeBSD in historical context are left in tact
- remove section about KerberosIV
- remove section about SAP R/3
- remove mentions of XFree86
- only support gvinum
- update examples to 7.X or 8.X
- remove Alpha support
- add COMPAT_FREEBSD[67] kernel options
- csup(1) now only in the base system
- update (tty) device names, add warnings for 7.X
- remove MD5 from the port checksum algorithms
- update port versions (probably not all)
- add definitions for ctm-src[5-8] to mailing-lists.ent

Reviewed by:	bcr, joel, remko, simon
2010-12-01 20:37:05 +00:00
Remko Lodder
295fbd8980 Improve wording.
Found while translating this for the DOC-NL team.
2010-09-06 07:37:59 +00:00
Marc Fonvieille
8f9aabc4c1 Update a bit the "Setting Up Network Interface Cards" section to match
current FreeBSD versions (commands output, use of rc.d facilities,
config for Internet access, etc.).  I may add some inputs about DHCP
soon.
2010-08-28 20:59:31 +00:00
Marc Fonvieille
a6a7f5dfa4 ndisgen(8) produces from W32DRIVER.SYS a module called W32DRIVER_SYS.ko
and not W32DRIVER.ko
2010-08-22 13:10:26 +00:00
Gabor Pali
b48c1ff9ef - Improve wording in the recent addition by removing redundant parts
Spotted by:	danfe
2010-07-29 14:44:44 +00:00
Gabor Pali
c2b3288917 - Add some ACPI debugging advice
Submitted by:	danfe
Refined by:	bf
2010-07-29 10:50:08 +00:00
Giorgos Keramidas
c85e7d839b Add the class="directory" attribute to a sub-directory of src/. 2009-10-25 21:21:54 +00:00
Doug Barton
7abbc5958a Remove the section on old-style startup scripts from the "Starting Services"
section. We don't want any new examples of these kinds of scripts.

While I'm here, tune up the example rc.d script a bit, and tweak the text
in that section a bit for readability.
2009-05-30 18:42:38 +00:00
Giorgos Keramidas
923fda1d51 Add class="directory" to <filename> elements that need it.
Reviewed by:	manolis, rene, trhodes
2009-05-06 13:34:56 +00:00
Giorgos Keramidas
34bd84809b Reword a bit parts of #configtuning-initial, add a short note to
explain why `/var' or `/var/tmp' may needs a lot of disk space, and
tune the description of `/usr' to remove an instance of ``Both of
which'' that seemed to be dangling from nowhere in particular.
2008-11-13 05:03:14 +00:00
Christian Brueffer
44ce836674 Fix typo. 2008-11-01 11:13:46 +00:00
Marc Fonvieille
758c853438 s/man page/manual page/ 2008-09-17 19:27:10 +00:00
Tom Rhodes
588a5826a0 Update the /etc/hosts example in the handbook to match reality.
PR:		124949
Discussed with:	brueffer
2008-08-03 16:30:38 +00:00
Remko Lodder
52425992c2 Borrow Poul-Henning's Axe and chop out old information for 4.x, 5.x
and unsupported 6.x releases. Tom started this process a while ago
and I'll follow up on that for the latest EoL round.

The old versions can still be found in the doc archives:
http://docs.freebsd.org/doc/
2008-06-01 09:42:12 +00:00
Remko Lodder
09556065ef Remove reference to .sh extenions and adjust filepermissions from
755 to 555.

PR:		docs/124167
Submitted by:	Sahil Tandon <sahil at tandon dot net>
2008-05-31 19:10:24 +00:00
Remko Lodder
beb92e3a57 Nowadays the rc.d scripts are without .sh extension.
PR:		docs/123799
Submitted by:	Sahil Tandon <sahil at tandon dot net>
2008-05-19 18:32:41 +00:00
Giorgos Keramidas
59cdab6e08 Tweak a bit the description of `PROVIDE' rc.d keyword, to make it a bit
more clear that it is *required* for startup scripts.  An rc.d script
without a PROVIDE keyword is not run by our rc.subr (it is skipped by
the find_local_scripts_new() shell function of rc.subr).

Inspired by:	A post by Helmut Schneider, jumper99 at gmx.de,
		on news:comp.unix.bsd.freebsd.misc
Message-Id:	63aggbF26iusnU1@mid.individual.net
2008-03-06 16:29:21 +00:00
Remko Lodder
c336eb6890 rc.d is no longer a new method, it's the method. 2007-12-23 18:48:21 +00:00
Marc Fonvieille
92cacb0de0 Use right tags for some command-line activities. 2007-08-17 12:54:31 +00:00
Nate Lawson
ce50266cf6 Clean up the acpi section a bit, removing references to disable acpi with
the acpiconf utility.  If I messed up the sgml, feel free to fix.
2007-04-07 20:21:09 +00:00
Giorgos Keramidas
2f18540604 Remove a reference to the `compat.linux.osrelease' sysctl.
As Alexander Leidinger has pointed out:

"glibc behaves differently based upon the value of it. It may refuse to
do anything if it doesn't understand the value.  Changing the value of
osrelease is only advised in experimental situations (like in
http://wiki.freebsd.org/linux-kernel) and may result even in kernel
panics."

I've replaced a reference to `compat.linux.osrelease' with a safer
example, for setting `security.bsd.see_other_uids=0', which we already
use as a sample /etc/sysctl.conf entry anyway.
2006-11-29 21:22:35 +00:00
Giorgos Keramidas
b93e6b5358 Various fixes to the "config and tuning" section of the Handbook.
* Reword the paragraph before a set of tunables for Linux, as
    it wasa bit confusing.

  * Correct the name of 'kern.maxfiles' (it was 'kern.maxfile')
    before, and reword the text around it to remove the need for
    a possessive "'s", which would look funny after 'maxfiles'.

  * Finish properly a sentence which was missing a fullstop.

Submitted by:	ganbold &at; micom &dot; mng &dot; net
2006-11-22 16:17:01 +00:00
Yaroslav Tykhiy
d5b45016fd Stop suggesting the use of the dangerous prefix "force"
with rc.d scripts.  The prefix "one" is the safe way to
override rc.conf once.  OTOH "force" will disable sanity
checks as well.
2006-10-26 15:29:09 +00:00
Yaroslav Tykhiy
7c6f9fab80 Link to the rc-scripting article from the appropriate section.
Suggested by:	dougb
2006-10-26 15:24:35 +00:00
Marc Fonvieille
0793255df0 In the Network Interface Cards page:
- Mention /boot/loader.conf when we talk about modules;

- The NDIS driver part does not belong to wireless devices section since
  it can be used for other Ethernet device, so move that part to its own
  section in the network device configuration page.  I also updated the
  previous text to match 5.5, 6.X and 7.X

  Based on docs/84961 (submitted by Fredrik Lindberg
  <fli+freebsd@shapeshifter.se>), docs/97229 (submitted by Gavin
  Atkinson <gavin@mod3.co.uk>) and many other requests/remarks.
2006-07-21 09:53:30 +00:00
Tom Rhodes
18577c121a Kill an extra space.
Noticed by:	simon
2006-07-16 18:42:49 +00:00
Tom Rhodes
aa9b8179ce Axe "under &os; 5.X and newer" in the rc title. 2006-07-14 03:03:34 +00:00
Giorgos Keramidas
e7ec7e7093 Document kern.maxfile' and kern.maxusers' auto-tuning.
PR:		docs/99804
Submitted by:	Kevin Kinsey <kdk@daleco.biz>
2006-07-12 11:18:26 +00:00
Tom Rhodes
3f0d1b56f0 Do what I swore would be done:
o Remove 4.X information, this includes notes and sections.

o Update documentation to reflect 5.X and 6.X.

o In some areas, try to make the new content version agnostic.

o Skip areas stating "5.[0-5] and later" as it's relevant - we
need a better way to handle these.

For several items, I checked the NOTES files, manual pages,
CVS history, etc.

Discussed on:		-doc
A few ideas from:	remko
2006-05-30 23:08:25 +00:00
Christian Brueffer
6c02bad18a Add a pointer to the "Encrypting Swap Space" section to the
"Adding Swap Space" section.
2006-03-13 16:52:10 +00:00