os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
49093 commits 1 branch 79 tags 298 MiB
Commit graph

421 commits

Author SHA1 Message Date
Benjamin Kaduk
3f6a7c180e Rewrap long line 
Whitespace-only; translators can ignore.
 2016-10-05 04:52:04 +00:00
Benjamin Kaduk
11f9b762cd Fix an incomplete sentence in the (rather unloved) developers handbook 
PR:		213200
Reported by:	georgc7@rpi.edu
 2016-10-05 04:51:09 +00:00
Enji Cooper
8b5d50071b Document tests/ per hier(7) in src in the Developer's Handbook Introduction 
chapter

Information about the tests/ directory was added to hier(7) in src@r250604.

This is a follow up commit which documents its existence in ^/stable/10 and
^/head

Approved by: hrs
Differential Revision: https://reviews.freebsd.org/D6821
Reviewed by: hrs
 2016-06-11 21:41:47 +00:00
Benedict Reuschling
a14d3c3c2e Rewrite my previous change to use a <variablelist>. That way, it is much 
clearer to understand and easier to read than having it all in one long
sentence.

Suggested by:	wblock@
Sponsored by:	Essen Hackathon 2016
 2016-04-24 21:23:28 +00:00
Benedict Reuschling
b3f817219a Replace some colons in a long sentence with 
semi-colons to make a list which contains
regular commas more readable.

PR:		203345
Submitted by:	munshs@rpi.edu
Sponsored by:	Essen Hackathon 2016
 2016-04-24 09:07:06 +00:00
Jason Helfman
124975c5fa - favor American English spelling of behavior 2016-03-27 19:17:51 +00:00
Jason Helfman
6d3642efd0 - fix index spelling of Von Neumann 
PR:		207354
Submitted by:	aleung013@gmail.com
Approved by:	wblock (mentor)
Differential Revision:	https://reviews.freebsd.org/D5377
 2016-02-22 23:37:45 +00:00
Jason Helfman
4011eead7b - address spelling issue 
PR:		207354
Submitted by:	aleung013@gmail.com
Approved by:	bcr (mentor)
Differential Revision:	https://reviews.freebsd.org/D5354
 2016-02-19 19:53:33 +00:00
Kevin Lo
cdedc9040f Replace gcc with clang to keep consistent with section 2.5.1 
Submitted by:	Ruey-Cherng Yu <raycherng at gmail.com>
Differential Revision:	https://reviews.freebsd.org/D4678
 2015-12-23 06:17:19 +00:00
Jason Helfman
307bc0bde4 - cleanup wording in developer's handbook 
PR:		203441 (based on)
Submitted by:	egreaves3@gmail.com
Approved by:	bcr@ (mentor)
Differential Revision:	https://reviews.freebsd.org/D3821
 2015-10-05 21:45:11 +00:00
Allan Jude
ee3969ebca Remove a broken link from the developers handbook 
PR:		202249
Submitted by:	pfg (original)
Approved by:	bcr (mentor)
Sponsored by:	EuroBSDCon DevSummit
 2015-09-28 22:10:41 +00:00
Brad Davis
0dda9d7b0e Clean up some of the formatting in the rendered version. 2015-04-13 13:57:34 +00:00
Eitan Adler
047a5c49a4 Don't encourage people to add '.' to path. This can lead to subtle 
issues in many common configurations.
 2015-04-01 06:25:57 +00:00
Glen Barber
fcb1ca095f Wrap lines, spacing nits, etc. following previous change. 
Translators please ignore.

Sponsored by:	The FreeBSD Foundation
 2015-03-12 01:25:02 +00:00
Glen Barber
03c9037828 Fix a few grammatical nits. 
Change wording referencing the previous section of the
kerneldebug book.
Reword the 'Add these options' sentence.
Consistify spacing in the KERNCONF addition list.
Fix a typo.

Sponsored by:	The FreeBSD Foundation
 2015-03-12 01:23:06 +00:00
Eitan Adler
6b8a33ac94 Add missing </para> 2014-06-30 05:48:40 +00:00
Eitan Adler
0f69367183 Bump copyright 2014-06-30 04:28:54 +00:00
Eitan Adler
4825e46e77 Don't make it seem like FreeSBD lacks these interfaces when first 
reading the sentence.
 2014-06-30 04:28:53 +00:00
Eitan Adler
0cd36ffb6b Eliminate some history from the documentation. 2014-06-30 04:28:51 +00:00
Warren Block
21115a05b8 Restore lost <replaceable> tags. 2014-04-28 20:13:07 +00:00
Glen Barber
211922b979 Add WITNESS_SKIPSPIN to the list of kernel debugging options 
that should be enabled.

Reviewed by:	sbruno (earlier version), kib
Sponsored by:	The FreeBSD Foundation
 2014-01-12 05:08:10 +00:00
Hiroki Sato
8def749c53 Normalize DTD URL. 2013-11-13 07:52:45 +00:00
Gabor Kovesdan
24d129e8d1 - Definitively upgrade to DocBook 5.0 2013-11-07 15:39:28 +00:00
Gabor Kovesdan
86a8d2d471 MFH 2013-11-05 15:52:37 +00:00
Warren Block
1a099a4c46 Update the copyright dates. Use $FreeBSD$ for the pubdate, as suggested 
by Taras Korenko <taras@synfin.me> on doc@.
 2013-10-30 01:03:30 +00:00
Gabor Kovesdan
23e4e6e242 - Add namespace declaration to index elements 2013-07-24 20:07:18 +00:00
Gabor Kovesdan
4a47cdca9b - Enable indexes by default; now they are not so difficult to generate 2013-07-24 19:38:10 +00:00
Warren Block
f99f3e141e Whitespace-only fixes. Translators, please ignore. 2013-07-24 03:00:29 +00:00
Gabor Kovesdan
adbdb3187f - Whitespac changes; translators may ignore 2013-07-23 19:21:07 +00:00
Gabor Kovesdan
736c0caff1 - Fix misplaced indexterms. 2013-07-23 18:55:22 +00:00
Rene Ladan
1d9bea10ed Merge the projects/entities branch into head/ 
The primary purposes are to clean up duplicated author definitions in
both share/xml/authors.ent and share/xml/developers.ent, and as a added
bonus simplify writing up author names/email addresses in web pages.

Apart from merging developers.ent into authors.ent, removing the former,
and updating the Committers Guide there should be little user-visible changes:
- a.portmgr renamed to a.portmgr.members
- a.doceng renamed to a.doceng.members
- team.re renamed to a.re.members.email and moved from
share/xml/freebsd.ent to share/xml/authors.ent
- a.core updated and moved from share/xml/mailing-lists.ent to
share/xml/teams.ent
- share/pgpkeys/{addkey.sh|README} updated

Translations are untouched except for build fixes.

Approved by:	doceng (gjb)
Approved by:	gjb (mentor)
 2013-07-09 21:15:47 +00:00
Gabor Kovesdan
7292289d38 - MFH 2013-05-07 10:20:20 +00:00
Gabor Kovesdan
821f9bab5d - MFH 2013-04-11 10:34:45 +00:00
Gabor Kovesdan
e8e2dfdbab - Do not specify image file extensions in documents; the proper extension 
is appended during rendering
- For the same reason, do not specify format either
- Add constraints to enforce this
 2013-04-02 09:50:10 +00:00
David E. O'Brien
210c653946 Update for uart(4) (FreeBSD 8.0+). 2013-03-23 00:01:14 +00:00
Gabor Kovesdan
b1f6349527 - MFH 2013-03-20 21:05:33 +00:00
Gabor Kovesdan
eb47c46865 - Fix erroneous fileref's that result in missing images 
- Also fix fdp-primer examples
 2013-03-14 09:19:23 +00:00
John-Mark Gurney
fee37ba27e add missing x... S_ISDIR doesn't set errno, and err uses it, errx 
doesn't...
 2013-02-28 07:28:22 +00:00
Gabor Kovesdan
3ab2d87bc1 - MFH 2013-02-18 15:29:06 +00:00
Eitan Adler
bdacdd4441 Remove sentences disparaging compiled languages. There's no reason to 
scare people off from compiled languages.

Discussed with:	db
Discussed with:	swills
Approved by:	bcr (mentor)
 2013-02-17 19:30:25 +00:00
Eitan Adler
1edb130790 Bump perl version reference. The present one is mildly out of date. 
Approved by:	bcr (mentor)
 2013-02-17 19:30:15 +00:00
Eitan Adler
8adfc6742d Remove outdated comments. 
Discussed with:	des
Approved by:	bcr (mentor)
 2013-02-16 16:36:19 +00:00
Gabor Kovesdan
a06603e1e8 - MFH 2013-02-05 09:14:34 +00:00
Gabor Kovesdan
5df509eaa2 - Remove standalone="no" statements from XML declarations since it did not 
always work and is no use anyway
 2013-01-30 19:12:36 +00:00
Gabor Kovesdan
36cdb51546 - Migrate the documentation set to DocBook 4.5 2013-01-30 14:00:53 +00:00
Gabor Kovesdan
d95165dc16 - Make the English documentation valid XML 2013-01-21 17:37:33 +00:00
Eitan Adler
44d90126ab Recommit portions of r40117 which are still valid. Remove a ton of obsolete comments from the "developer's handbook". 
Approved by:	bcr (original commit)
 2012-11-26 03:00:20 +00:00
Eitan Adler
0f21e94e49 Revert r40117 which removed the last mention of the "old" way to build the kernel. This needs some reworking to explain why one would want to do this. 2012-11-26 02:58:34 +00:00
Eitan Adler
50c1259b80 Remove a ton of obsolete comments from the "developer's handbook". 
Approved by:	bcr (mentor)
 2012-11-21 13:57:13 +00:00
Isabell Long
2be1e25fc2 Replace 'SGML' with 'XML' in Makefile code and comments. A consequence of 
this was that 'SGMLFLAGS' had to be changed to 'XMLFLAGS' in
share/mk/doc.docbook.mk so that everything continued to build OK.

Approved by:	gabor (mentor)
 2012-10-06 17:52:37 +00:00