Commit graph

427 commits

Author SHA1 Message Date
Eitan Adler
7e1c3e6035 Prefer the use of service(1) to explicit invocation of /etc/rc.d
scripts: service(1) puts things in one place and abstracts them.  Also, it's less
typing and easier to autocomplete.

While here modernize script examples by removing the ".sh" suffix.

Discussed on:	-doc
Reviewed by:	bjk (prior version)
Approved by:	bcr (mentor)
2013-01-28 19:42:38 +00:00
Gabor Kovesdan
d95165dc16 - Make the English documentation valid XML 2013-01-21 17:37:33 +00:00
Warren Block
6aba0d141a Update the Using Tapes section to more closely reflect modern reality.
Modified version of patch from PR.

PR:		docs/175226
Submitted by:	Diane Bruce <db@db.net>
2013-01-18 01:17:04 +00:00
Warren Block
0e8f52f505 Whitespace-only fixes. Translators, please ignore. 2012-11-02 04:13:41 +00:00
Gabor Kovesdan
b4346b9b2d - Rename .sgml files to .xml
- Reflect the rename in referencing files

Approved by:	doceng (implicit)
2012-10-01 09:53:01 +00:00
Eitan Adler
f90d581ee9 The doc files are now XML, not SGML.
Approved by:	gjb
2012-09-23 18:47:00 +00:00
Gabor Kovesdan
9c243757ef - XML declarations should use IANA encoding names
Pointed out by:	hrs
2012-09-14 17:47:48 +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
Benjamin Kaduk
defbfa7e19 Make the dump-over-ssh example not depend on root's shell being a Bourne
derivative (particularly poignant given that root's default shell is csh!).

PR		docs/167020
Submitted by:	crees
Approved by:	hrs (mentor)
2012-05-30 05:26:11 +00:00
Glen Barber
0292a7ca80 - Fix URLs for the livefs ISO image.
- Add a note that the livefs ISOs are not available for 9.0-RELEASE and
  later, and that the standard install CDROM as well as the memstick
  image may be used to recover a system.

PR:		166580
Submitted by:	Vitaly Magerya (vmagerya%gmail!com)
2012-04-28 22:19:24 +00:00
Eitan Adler
8045345d30 The man pages documents 128 as the default, and a test verifies this.
PR:		docs/161057
Submitted by:	Robert Simmons <rsimmons0@gmail.com>
Reviewed by:	bz
Approved by:	bcr
2012-03-03 19:34:20 +00:00
Eitan Adler
e6a507fa1b Fix a variety of English style nits and other issues found with igor.
Reviewed by:	gabor
Approved by:	wblock
2012-02-13 18:28:50 +00:00
Daniel Gerzo
f15e40468d - update rc.conf configuration directive for enabling quotas for
recent FreeBSD systems

Reviewed by:	remko
PR:		docs/164735
2012-02-10 10:09:19 +00:00
Warren Block
9cdd7d95bf Correct <screen> and <programlisting> tags, replace spaces with real
tabs in a couple of <programlisting> elements, fix the link to the
"Torture-testing Backup" article.
2012-02-03 02:14:27 +00:00
Warren Block
c245e45479 Whitespace-only commit, translators may ignore. Rewrap paragraphs, fix
indentation.
2012-02-02 19:21:57 +00:00
Warren Block
d5795b93d1 Improve the HAST section of the Handbook.
Approved by:	bcr (mentor)
2011-12-05 23:46:43 +00:00
Benedict Reuschling
6b31d4c1b4 s/transfered/transferred
Found by:	codespell
2011-05-27 10:22:55 +00:00
Benedict Reuschling
3983825ca8 Mention the partitioning of large disks using gpart(8).
PR:		docs/157091
Submitted by:	Robert Simmons (rsimmons0 at gmail dot com)
Patch by:	Niclas Zeising (niclas dot zeising at gmail dot com)
2011-05-26 18:28:23 +00:00
Glen Barber
8de80a0170 s/acronym/literal for consistency.
Approved by:		jkois (mentor)
2011-03-21 14:04:13 +00:00
Benedict Reuschling
6e4fe8ed77 Remove a superfluous semicolon. 2011-03-10 18:03:32 +00:00
Daniel Gerzo
888424b7a0 - fix the failover example script in the HAST section
PR:		docs/155372
Submitted by:	johnpupu@gmail.com
2011-03-08 08:47:59 +00:00
Daniel Gerzo
56abf5b493 - the hast.conf configuration example had the IP addresses reversed.
Reported by:	lordboboss <lordboboss@free.fr>
2011-03-07 15:16:31 +00:00
Daniel Gerzo
b5257f7460 - add a new section about HAST
Reviewed by:	pjd, Mikolaj Golub <to.my.trociny@gmail.com>,
		Fabian Keil <freebsd-listen@fabiankeil.de>,
		bcr, brucec, Warren Block <wblock@wonkity.com>,
2011-03-04 16:40:26 +00:00
Ryusuke SUZUKI
0354aa6afc Fix two more broken links to vinum man page.
Noted by:	jkois@
2010-12-30 00:41:40 +00:00
Ryusuke SUZUKI
c3993e73d7 PR: docs/153269
&man.vinum.8 -> &man.vinum.4

Submitted by: Aldis Berjoza <aldis _at_ bsdroot dot lv>
2010-12-24 15:21:14 +00:00
Rene Ladan
f211e47377 Handbook fixups from 6.X removal:
- fix broken sentence in multimedia [1]
	- GNU tar is no longer in base [2]
Submitted by:	ryusuke [1], pluknet [2]
2010-12-03 09:38:53 +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
Benedict Reuschling
174584f1b7 The -v parameter of cdda2wav does not support numerical values in newer
releases and produces a warning when invoked like that. Change the example
to use the correct non-numeric form.

PR:             docs/152248
Submitted by:   Warren Block (wblock at wonkity dot com)
2010-11-15 18:04:58 +00:00
Marc Fonvieille
c7bf2534e7 Update Emergency Restore Procedure section to use the livefs CDROM
instead of a fixit floppy (the given fixit floppy build procedure does
not work).  I had this change on my todo list since 2003...

PR:
Submitted by:
Reviewed by:
Approved by:
Obtained from:
MFC after:
Security:
2010-08-21 20:49:54 +00:00
Johann Kois
b019a703d8 Change the link to "Torture-testing Backup and Archive Programs".
Requested by:   Bernhard Erdmann (be ett berdmann dott de)
2010-08-19 18:45:18 +00:00
Marc Fonvieille
5eee66d830 Add a note mentioning that cdda2wav can also be used on ATAPI drives and
that this choice can be a better one than the dd(1) method for question
of jitter correction, etc.

PR:		docs/129281
Submitted by:	Yuri <yuri@tsoft.com>
2010-08-10 08:51:37 +00:00
Simon L. B. Nielsen
9ced15d6cf Add a warning that usermount (vfs.usermount) is not generally safe.
Text by:	rwatson (mostly)
With hat:	so
2010-05-27 09:52:11 +00:00
Marc Fonvieille
f71c5a8b8f Add a note on how to burn files > 4.38GB on DVD medias.
Submitted by:	Tomek Cedro <tomek.cedro@gmail.com>
2010-01-18 19:32:23 +00:00
Daniel Gerzo
e164385633 - reword to avoid a grammar mistak and contraction
PR:	139101
2009-09-24 15:30:11 +00:00
Marc Fonvieille
f923fa9417 A little face lifting of the "USB Storage Devices" to avoid the split
between ehci(4) and o/uchi(4) which comes from a time when USB 2.X
support was "young".  Let's mention usbconfig(8).  This section is now
8.X, 7.X and 6.X compliant.
2009-07-26 11:49:01 +00:00
Hiroki Sato
51cb41ff65 Fix build. 2008-12-24 13:30:35 +00:00
Tom Rhodes
cff3b7069f Recommend setting TMPDIR to a larger file system in cases where /tmp
is small and restore eats the space.

PR:		75865
Submitted by:	"Ben Kaduk" <minimarmot@gmail.com>
2008-12-24 10:54:09 +00:00
Marc Fonvieille
c5e08b8d45 For devfs rulesets examples use [foo=5] scheme since
/etc/defaults/devfs.rules already defines 4 rulesets.
2008-10-07 17:57:41 +00:00
Manolis Kiagias
24b5978b1a Fix two examples in the 'ubs-disks' section
Reviewed by:	pgj, keramida, trhodes
2008-10-03 19:16:10 +00:00
Gabor Pali
edafad6a69 Eliminate erroneous role="directory" attributes from <filename> elements
and replace them with class="directory" [1][2]

[1] http://docbook.org/tdg/en/html/filename.html
[2] http://www.freebsd.org/doc/en/books/fdp-primer/sgml-markup-docbook.html#AEN1799
    (4.2.5.5)

Approved by:	trhodes, gabor (mentor)
2008-08-06 22:03:50 +00:00
Gabor Kovesdan
dfd24d9758 - Use replaceable correctly. Don't mark up the environment variable,
use the "username" word instead.

PR:		docs/123343
Submitted by:	pgj
2008-05-07 14:23:37 +00:00
Gabor Kovesdan
545f3afe56 - Use keycap instead of userinput
PR:		docs/123333
Submitted by:	pgj
2008-05-05 14:04:31 +00:00
Daniel Gerzo
47e1fc0543 - use the rc.d script to restart a system service instead of the old-fashioned
kill method

PR:		docs/123348
Submitted by:	pgj
2008-05-02 23:08:05 +00:00
Marc Fonvieille
a116ea3db1 Use the default extent-size for newfs(8) instead of a -d0 one which may
lead to errors.

PR:		docs/122066
Submitted by:	Takamichi Tateoka <tate@cs.uec.ac.jp>
2008-03-25 08:43:38 +00:00
Tom Rhodes
bfce2dfb29 Remove duplicated word introduced in previous revision.
Noticed by:	ceri
2008-01-22 16:45:19 +00:00
Tom Rhodes
7e383b86e6 Discuss the gbde lockfile
PR:		113695
Submitted by:	Marc Silver <marcs@draenor.org>
2008-01-21 21:08:05 +00:00
Remko Lodder
402dcb4530 If we are creating a mini-bsd floppy with new commands, why do
we insert /dev/MAKEDEV in the floppy then? I dont have it anymore
on a recent system, thus remove the information about it. Probably
the information in the mini-kernelconfiguration example could use
a little hand as well.
2007-12-25 21:02:37 +00:00
Gabor Kovesdan
df6644b54d - Since FreeBSD 6.2 the option to define the encryption algorithm to encrypt
the swap partition has changed from -a to -e. Reflect this in the
  documentation.

PR:		docs/113390
Submitted by:	"Beat Gaetzi" <beat@chruetertee.ch>
2007-12-21 21:01:24 +00:00
Marc Fonvieille
3c53514e13 - Remove obsolete -r flag for commands using bsdlabel(8)
- Add some missing tags
2007-08-23 08:48:34 +00:00
Gabor Kovesdan
0484d71768 - Use mount -t msdosfs instead of mount_msdosfs
PR:		docs/115571
Submitted by:	lme
Approved by:	keramida (mentor)
2007-08-22 15:50:32 +00:00
Marc Fonvieille
b25a3f90d9 - Various SGML fixes (use of correct tags);
- Avoid the capitalization of the geli command;
- In disk encryption section, reword a sentence mentioning old
  removed swap encryption stuff;
- Slight rewording of a title to match what we really talk about;
- Punctuation fix where needed.
2007-08-20 16:48:01 +00:00
Denis Peplin
9fb738716e Remove out-of-date statement about gbde:
"geom_bde_load" option can be added to loader.conf now.
2007-06-15 12:41:54 +00:00
Marc Fonvieille
f21eaf86d5 Remove an extra ; I added in my previous commit.
Found by:	Ganbold <ganbold@micom.mng.net>
2007-03-12 06:35:29 +00:00
Marc Fonvieille
c6000d645b In the USB disks part: the use of a devfs.rules(5) rule requires a
ruleset declaration.  This ruleset also needs to be enabled in
/etc/rc.conf
2007-03-11 11:47:42 +00:00
Giorgos Keramidas
65c844bb8e Move a misplaced parenthesis, to avoid leaving a verb hanging near the
end of a sentence without a subject.

Noticed by:	ganbold@micom.mng.net
2007-03-06 22:52:29 +00:00
Giorgos Keramidas
fcf316d0cc Minor syntax nit.
Submitted by:	ganbold.at.micom.mng.net
2007-01-22 14:46:55 +00:00
Joel Dahl
52f60fcf13 s/vfs.usermount="1"/vfs.usermount=1/
Submitted by:	Jacques Legare <jacques.legare@sympatico.ca>
2006-12-27 17:04:05 +00:00
Marc Fonvieille
dc1f80fd35 In the USB storage section:
Describe how to make USB devices mountable as a normal user.

PR:		docs/106148
Submitted by:	Roland Smith <rsmith@xs4all.nl>
With some help from:	ceri@
2006-12-07 11:47:36 +00:00
Tom Rhodes
6cca657e7f Fix up previous delta from patch mis-alignment.
Noticed by:	jkois
2006-11-05 00:49:34 +00:00
Tom Rhodes
8a2c586e32 Add a note (step) showing that you can load gdbe using kldload(8);
at this time there is no loader.conf variable in defaults/loader.conf in 6,
note that.
Remove some old cruft and reword near sentence to keep flow going smoothly.
Two spaces between the end of a sentence and the beginning of a new sentence.

PR:		86733
Submitted by:	Josh Paetzel (patch rewritten by me)
2006-11-04 11:02:41 +00:00
Marc Fonvieille
163edf7af0 Remove the part mentioning the need of sysutils/cd9660_unicode to
correctly display multibyte characters on some ISO 9660 CDs; inform the
user about the -C option of mount_cd9660 and the need of cd9660_iconv.ko

Problem found by:	Andrei Kolu <antik@bsd.ee>
2006-08-25 19:12:37 +00:00
Marc Fonvieille
e8d6e270a1 Add manual page entity for rsync(1) where needed. 2006-08-21 07:58:16 +00:00
Marc Fonvieille
303cf27887 It is now (since a while) possible to directly load atapicam support via
the /boot/loader.conf file w/o requiring a kernel rebuild.  Update the
atapicam section to reflect that possibility.
2006-08-01 09:37:28 +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
Remko Lodder
2261993c9f Fix typo.
Spotted by:	brueffer
2006-05-29 16:11:54 +00:00
Remko Lodder
845ca3cf73 I introduced a typo in the previous commit.
s/have/has/
2006-05-28 18:37:55 +00:00
Remko Lodder
d7fd936e49 Update the DVD-RAM section a bit. This avoids the usage of "you", "we"
and things like that, which is consistent with the rest of the documention.

Also remove a paragraph that mentioned that the upcoming commands should be
executed as root, since the prompt should imply that already (like the rest
of the handbook has as well).
2006-05-28 18:33:25 +00:00
Remko Lodder
c79c51b517 Add missing </sect3> 2006-05-28 14:38:01 +00:00
Ceri Davies
48cc251fea Remove link to freebsd.dk/ata since it isn't working for some time and
we now support most drives.  Reword a whole bunch of stuff as a result,
including getting rid of some 4.x/early 5.x specific text.

Partially PR:		docs/95601
Partially submitted by:	James <inspiredbymetal@hotmail.co.uk>
2006-04-18 22:04:19 +00:00
Marc Fonvieille
8bdb63e112 Add a DVD-RAM section.
This is based on a mail exchange on freebsd-doc with Michael K. Roost
<michi@mirox.ch>.
2006-03-31 10:47:03 +00:00
Dmitry Morozovsky
3ca01feccb One excessive 'kilo' in sector size. Fix this. 2006-03-28 08:26:37 +00:00
Simon L. B. Nielsen
605abcfbe4 Some rework of the memory, and file-backed file systems section:
- Remove 5.X from titles, since it applies to 5.X+.
- Refer only to bsdlabel in the 5.X+ section and remove note about the
  switch from disklabel to bsdlabel in FreeBSD 5.1.
- Do not suggest users place file systems on the "c" partition (which
  is meant for the "raw" device) and use the "a" partition instead.
  (Note that I'm not really sure if there is a good reason to label a
  memory disk before use when just using the entire disk for one file
  system, but I will leave this for now.)
- Update program output to show what resent FreeBSD version actually
  writes.
- For memory backed file system section, suggest that people use swap
  backed and not malloc(9) backed, since malloc based memory disks
  have a good disk of causing a panic since the kernel risks runing
  out of memory in the malloc pool.
2006-03-23 22:13:54 +00:00
Marc Fonvieille
10c618f72c Add a missing </para>, this fixes a weird page rendering. 2006-03-22 13:05:22 +00:00
Marc Fonvieille
201d8087d2 Characters entities should not be used inside programlisting tags since
these later are rendered as <pre></pre>.

Noticed by:	Denis SAGET <geodni@free.fr>
2006-03-22 12:53:23 +00:00
Christian Brueffer
e66f49338c Oops, "written by" should have been used here. 2006-03-12 19:06:36 +00:00
Christian Brueffer
972e6ca0bd o Add a section on swap encryption
o Remove the swap encryption stuff from the disk encryption section

Reviewed by:	Ken Tom, remko
2006-03-12 18:56:04 +00:00
Ceri Davies
33aea870ce Minor rewording. 2006-02-23 19:10:27 +00:00
Marc Fonvieille
5b220e58d2 s/rewriteable/rewritable 2006-02-16 13:13:50 +00:00
Doug Barton
42fbeac82a Swap out all references to rcNG in favor of rc.d. This is not
"next generation" technology anymore. :)

Update text and examples to match current realities relative
to the local_startup import, and other advances.

Attempt to future-proof the text a little by referring to
dates and releases, rather than (e.g.) "recently."

Add some more man page references.

Reviewed, and helpful suggestions provied by:	pav
2006-01-17 09:55:05 +00:00
Pav Lucistnik
c1266282fc 16.6.5 Duplicating Audio CDs
- mention that 4.X don't prefix device nodes with zero
- show how to force system to retaste media
- flip note from "on 5.X and later" to "on 4.X"

Solving:	docs/79658
Reported by:	Alan Larson <larson@w6yx.stanford.edu>
2006-01-10 17:26:34 +00:00
Xin LI
e140896ec8 Escape <, >, &'s, plus some cleanups against the SGML. There should not
be any content changes involved in this commit, however, localization
teams are encouraged to catch up with this change.

Requested by:	intron at intron ac
Reviewed by:	Niclas Zeising <lothrandil at n00b apagnu se>
Glanced by:	simon
2006-01-05 20:03:39 +00:00
Ceri Davies
89b4d4aa69 Add details on how to use GELI.
Submitted by:	Daniel Gerzo <danger at rulez dot sk>
Reviewed by:	ceri, remko, pjd
2005-12-30 21:10:24 +00:00
Pav Lucistnik
088e1ecffb 16.4.3 Rebuilding ATA RAID1 Arrays:
- update atacontrol attach/detach syntax for 6.0, where it accepts ataN instead
  of just N
- fix instructions for FreeBSD 5.X/6.X, where addspare step is needed and
  rebuild command returns immediately

Fixes:

PR:		docs/58111
Submitted by:	Jack Twilley <jmt@twilley.org>

PR:		docs/83771
Submitted by:	edwin
2005-12-18 18:39:41 +00:00
Giorgos Keramidas
0c5fbe5924 Add a section that describes briefly various backup strategies available
with FreeBSD, their relative merits and what the final choise of a
backup strategy has to cover/support.

PR:		docs/89900
Submitted by:	Lowell Gilbert <freebsd-bugs-local@be-well.ilk.org>
2005-12-12 15:16:03 +00:00
Murray Stokely
aad8957506 1. Remove redundant use of the proper noun.
2. Note that bsdtar is the default since 5.3, and that it doesn't
   support tarring to remote tapes directly, only via a pipeline
   through ssh or similar.

PR:		docs/81738
Submitted by:	Rene Ladan <r.c.ladan@student.tue.nl>
2005-08-05 19:06:20 +00:00
Remko Lodder
65f73cf928 Nuke Quota support information for FreeBSD 3.2
Requested by:		Siebrand Mazeland <siebrand dot mazeland at xs4all dot nl>
Discussed with:		#bsddocs
2005-08-02 18:48:04 +00:00
Giorgos Keramidas
bcce52355e Add missing </para> 2005-06-18 21:10:58 +00:00
Hiten Pandya
1c58896a25 Snapshot files are set with the "snapshot" file flag during creation by
mksnap_ffs(8) or mount(8).  The previous statement was incorrect since
it mentions the immutable flag, i.e. "noschg" which is not the case when
one does "ls -lo" in a directory containing snapshot files.

While I am here, mention a way for finding snapshot files on a file
system.

PR: 	docs/80535 (inspired by)
2005-06-16 04:46:15 +00:00
Hiten Pandya
e3f9e93d33 Correct misleading statement about state of mounted snapshots.
PR:      	docs/80533
Submitted by:	Bernd Luevelsmeyer <bdluevel@heitec.net>
2005-06-16 03:19:58 +00:00
Ceri Davies
dd5144a783 Correct the QIC tape dimensions quoted (I didn't check this, but now the
metric matches the imperial at least).

PR:		docs/81225
Submitted by:	Rene Ladan < r dot c dot ladan at student dot tue dot nl >
2005-05-20 18:14:24 +00:00
Denis Peplin
3efd17c503 Move scbus, cd, and pass devices from "need to add" programmlisting to
"also need" programmlisting. These lines already present in recent GENERICs.
2005-05-04 13:07:11 +00:00
Remko Lodder
fa63510b7c Remove an extra visable space in the File System Quotas section.
PR:		docs/80261
Submitted by:	Brad Davis <so14k at so14k dot com>
2005-04-22 19:31:10 +00:00
Giorgos Keramidas
07d593dc61 Add a missing filesystem option to a dump(8) example.
Noticed by:	Andrew Davis <andrew@zeffa.net.au>
2005-04-14 16:42:36 +00:00
Peter Pentchev
f44c8792b5 Since the quota tools seem to have been working in kbytes, not blocks,
for some time now, reflect this in the documentation.

PR:		64063
Submitted by:	Stacey Roberts <stacey@vickiandstacey.com>
2005-02-27 12:59:47 +00:00
Giorgos Keramidas
99452d30fb Wording fixes. 2005-01-25 13:58:06 +00:00
Giorgos Keramidas
78fba00a1f The matcd(4) driver is not gone in 5.0 and 5.1 only.
It has been removed from CURRENT too.
2005-01-25 12:58:56 +00:00
Giorgos Keramidas
288de68c35 Delete EOL whitespace, in preparation of more fixes.
Translators may safely ignore this commit.
2005-01-25 12:29:06 +00:00
Giorgos Keramidas
29fa37e8e8 rcmd(3) and ruserok(3) are not commands. Replace the <command>
elements that wrapped them with man page references for the
respective library functions.
2005-01-25 12:27:21 +00:00
Denis Peplin
5146e3285a Use sysinstall by default and /stand/sysinstall for systems older than 5.2
Same for /rescue (use it by defaut, and /stand for old systems)
2004-12-22 11:22:19 +00:00
Marc Fonvieille
eb3da5313b Punctuation fix. 2004-12-05 16:40:56 +00:00
Marc Fonvieille
5055021668 s/role="directory"/class="directory"/ since the last instance is the
correct one.  I'm guilty of most of these wrong attributes.
2004-11-19 19:57:22 +00:00
Peter Pentchev
e7cc0c839f Describe the -no-emul-boot mkisofs(8) option and use it in the example.
Also remove the -U option from the example, since it could create ISO
images that some systems could not boot from (besides, it is not used in
the FreeBSD src/release/i386/mkisoimages.sh script, and there probably
is a reason for that ;)

PR:		70952
Submitted by:	Jon Wallace <jon@whoweb.com>
Based on:	patch by Sebastian Schulze Struchtrup <seb@struchtrup.com>
2004-11-05 19:11:17 +00:00
Marc Fonvieille
a602367979 ad1 is not only for 4.X system, let's mention 5.X as well. 2004-11-01 18:56:50 +00:00
Hideyuki KURASHINA
f3027072d3 Fix a typo (syntax of cdrecord should be comma-separated values for
device reference).
2004-09-26 20:08:31 +00:00
Brooks Davis
d3b7df9511 Begin documenting the limitations of some popular disk partitioning
schemes.  In particular document the practical 2TB limit of bsdlabels.

Reviewed by:	simon
2004-09-14 00:20:32 +00:00
Murray Stokely
ee50c863c4 Correct misusage of <ulink> tag.
Found by:	loader@freebsdmall.com
2004-08-25 10:33:59 +00:00
Marc Fonvieille
9565589609 Devices name/node tagging is not consistent in the Handbook, it should
respect the following scheme:
- if the device name is /dev/foo --> <filename>/dev/foo</filename>
- if the device name is just foo --> <devicename>foo</devicename>
(See "4.2.5.7 Devices" from fdp-primer)
2004-08-11 16:24:26 +00:00
Marc Fonvieille
cf6a10e82d Grammar fix. 2004-08-05 18:25:32 +00:00
Marc Fonvieille
e521aefce9 In DVD section:
- Multisession is meaningful in data context only, so remove "DVD-Video
  players" from the text.
- Add the number of sessions for DVD+R Dual Layer media

Submitted by:	Andy Polyakov <appro@fy.chalmers.se>
2004-07-26 09:52:07 +00:00
Marc Fonvieille
a65dec588c In DVD section:
- Give some directives for USB burners
- Mention K3b as possible GUI for growisofs(1)
2004-07-26 08:55:40 +00:00
Marc Fonvieille
0a2faae9a7 Mention DVD burners in USB section. 2004-07-23 08:33:32 +00:00
Giorgos Keramidas
4cfe73a045 Fix a couple of misplaced <acronym> tags.
PR:		docs/69220
Submitted by:	Warren Block <wblock@wonkity.com>
2004-07-18 01:56:40 +00:00
Giorgos Keramidas
59b1918b83 Refer to sysutils/cdrtools instead of sysutils/mkisofs now that the
mkisofs port was merged into cdrtools.  I've also replaced most of the
references to the <filename role="package">mkisofs</filename> program
with an entity which we already have.

PR:		docs/69087
Submitted by:	Janos Mohasci <janos.mohasci@bsd.hu>
2004-07-16 08:38:33 +00:00
Murray Stokely
cade92a188 Spellcheck: environment, appropriate, explanation, occasions
Found by:	make spellcheck
2004-07-14 05:33:13 +00:00
Marc Fonvieille
a1f77b1a3d s/md0c/md0 where needed. 2004-07-13 10:27:58 +00:00
Murray Stokely
6f04b3910f Add prerequisites to the chapter synopsis. Users should know how to
build and install a custom kernel before reading these chapters.
2004-07-13 05:19:27 +00:00
Murray Stokely
e3caf28e18 Add missing frame='none' to two tables. 2004-07-12 07:40:51 +00:00
Murray Stokely
d1ec2ee4a0 Remove stub for Mini-cartridge section that has been here for at least
4 years.  No one is going to write this section anytime soon, it's not
really needed anyway, so remove the 'XXX' empty subsection and one
link to this empty section.
2004-07-12 07:15:49 +00:00
Murray Stokely
e55989777d Wrap long lines in <programlisting> and <screen> sections. These flow
over the page in print output, and make the user scroll in HTML
output.
2004-07-12 07:04:56 +00:00
Marc Fonvieille
4db7640a47 Some grammar fixes.
Submitted by:	Ken Tom <sub@mui.net>
2004-07-06 17:55:30 +00:00
Marc Fonvieille
0533ca92d1 s/ssh1/ssh in a dump(8) command line. 2004-07-06 09:37:08 +00:00
Marc Fonvieille
bd70e1d6aa In CD burning section mention some GUI CD burning apps: X-CD-Roast
and K3b.  I know there are some other GUI burning softwares but
these latter seem to be the more important ones.
2004-07-05 13:35:47 +00:00
Marc Fonvieille
63c991a9ff Mention USB devices in the synopsis. 2004-07-05 12:36:40 +00:00
Marc Fonvieille
6a1d7bf4ad Add a new section: "USB Storage Devices" which covers the
configuration of FreeBSD to use USB thumbdrives, hard drives, etc.
Some parts of that section come from an article I wrote for
www.bsdnews.org, many persons found that article useful and asked me to
add the same informations in the Handbook.
2004-07-05 12:22:33 +00:00
Hiten Pandya
c3925a309d The 'dvdauthor' port resides under the 'multimedia' category, not 'sysutils'.
Noticed by:	Eirik Nygaard <eirikn at kerneled.com>
2004-06-07 13:36:45 +00:00
Ceri Davies
4b9577b446 Minor language/grammatical fixups. 2004-06-06 00:37:34 +00:00
Marc Fonvieille
e0d4ac1f87 s/command/command line/ where needed. 2004-05-13 15:31:22 +00:00
Marc Fonvieille
828dc5de75 In DVD burning section:
- Add a line on how to enable DMA access needed for the ATAPI burner
- Various rewordings and additions to improve the text
- Enhance the multisessions part
- Add credits to Andy Polyakov (growisofs author) who helped me a lot,
  thanks to you Andy!
2004-05-06 18:48:04 +00:00
Marc Fonvieille
f6b271d799 The line device atapicd is not needed by ATAPI/CAM.
Submitted by:	thomas@
2004-04-29 07:04:19 +00:00
Marc Fonvieille
de77c40644 In the Creating and Using Optical Media (CDs) section:
- s/acd0c/acd0/ and mention in various places 4.X needs the
  trailing c [1]
- The ATAPI/CAM section is just a cut&paste from an article I wrote for
  bsdnews.org, so let's mention the author.

PR:		docs/62097 [1]
Submitted by:	Marc Blanchet <marc.blanchet@viagenie.qc.ca>
2004-04-14 13:11:14 +00:00
Martin Heinen
6f9b32a646 Replace consecutive screen elements with one screen element.
The screens shown belong to the same session.
2004-04-11 17:36:17 +00:00
Marc Fonvieille
32edfa9144 Fix a bogus growisofs(1) example. 2004-03-08 20:45:56 +00:00
Marc Fonvieille
bd0f6365da Typo
Submitted by:	pav@
2004-02-29 12:18:40 +00:00
Marc Fonvieille
29101dcb74 Capitalize a title, I forgot it in my previous commit. 2004-02-26 20:33:06 +00:00
Marc Fonvieille
fd37f33107 Add a DVD burning section. This section covers DVD+R, DVD+RW, DVD-R and
DVD-RW (data, DVD-Video, multisession and how to grow an existing ISO
file system).
2004-02-23 10:48:00 +00:00
Josef El-Rayes
ebcb93faac Fix bogus doubled line and add example tags for consistency.
Approved by:    simon(mentor)
Submitted by:   Marian Cerny <jojo@matfyz.cz>
PR:             docs/61630
2004-01-20 23:56:32 +00:00
Josef El-Rayes
f1840d3466 Add text describing the mksnap_ffs command as an
alternative for creating snapshots.

  Approved by:  trhodes(maintainer)
  Approved by:  simon(mentor)
  Submitted by: Lukas Ertl <lertl@univie.ac.at>
  PR:           docs/53501
2004-01-16 21:48:15 +00:00
Alexander Langer
5fff2f6237 Add another example on how to use dump over ssh, setting RSH=ssh. 2004-01-15 12:06:19 +00:00
Ceri Davies
f589c4e5a5 Grammar police: "setup" is not a verb. 2003-11-05 10:36:56 +00:00
Marc Fonvieille
819a08a54a Add missing items in Synopsis and remove some other one.
PR:		docs/56929 & docs/56930
Submitted by:	Marco Trentini <mark@remotelab.org>
2003-09-17 07:40:06 +00:00
Marc Fonvieille
fe4878a69d Add missing closing tags not found by nsgmls, and fix the case of some
tags.

PR:		docs/56231
Submitted by:	Denis Peplin <den@freebsd-doc.org.ru>
2003-08-31 16:41:36 +00:00
Simon L. B. Nielsen
4cfd05d16f *.sgml:
- Use trademark entities.
 - Add trademark attributions.
 - Always use correct case for trademarks.
 - Don't join trademarks with other words, e.g. using hyphens.
 - Use 'UNIX like systems' instead of 'UNIX systems'.

trademark.ent:
 - Add entities for more trademarks / companies.
2003-08-23 23:26:44 +00:00
Simon L. B. Nielsen
aed2b1d2da Note that gbde(4) and vinum(4) does not work together at this point.
Submitted by:	Stefan Walter <sw@gegenunendlich.de>
PR:		docs/55122
Discussed on:	-doc
Approved by:	ceri (mentor)
2003-08-15 21:50:10 +00:00
Marc Fonvieille
ac3dece5ba More bsdlabel(8) updates. 2003-07-17 17:03:24 +00:00
Marc Fonvieille
5ed14dfcde Update the note about matcd(4) driver, this later is back in 5.X branch
since June 16th, 2003.
2003-07-17 08:06:48 +00:00
Marc Fonvieille
3c2bbd6ddc Start to update the chapter about bsdlabel(8). 2003-07-16 21:23:53 +00:00
Ceri Davies
22a4a9b4ec Capitalise titles as per the Chicago Manual of Style. 2003-07-13 18:18:34 +00:00
Tom Rhodes
139fc5e004 Sentence fragment.
Pointed out by:	Craig Reyenga <craig@craig.afraid.org> via -doc
2003-06-30 15:18:42 +00:00
Murray Stokely
b2408c9597 Use lower-case indexterms and remove an inordinate entry. 2003-06-15 09:53:45 +00:00