Commit graph

425 commits

Author SHA1 Message Date
Mathieu Arnold
e1a974cfd5 Fix some extra spacing in screen entries.
While there, replace some with programlisting when more suited.

Sponsored by:	Absolight
2017-09-07 11:56:16 +00:00
Sevan Janiyan
769a27e835 Site hosting "How do I write "Hello, world" in FreeBSD assembler" is no longer around.
Switch to archive.org mirror.

PR:             203346
Submitted by:   <luoh2 AT rpi DOT edu>
Approved by:    bcr (mentor)
Differential Revision:  https://reviews.freebsd.org/D11849
2017-08-11 15:49:09 +00:00
Glen Barber
7256802129 Bump the copyright year for the Developers' Handbook following r50127.
Sponsored by:	The FreeBSD Foundation
2017-05-25 16:22:12 +00:00
Sevan Janiyan
ed3b6bc268 We point to broken CGI script which redirects to Amazon if working.
Replace link with the target Amazon URL visitor would be redirected to normally.

PR:		218071
Submitted by:	Ian A Rios <riosi AT rpi edu>
Approved by:	bcr (mentor)
Differential Revision:	https://reviews.freebsd.org/D10259
2017-04-04 13:13:10 +00:00
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