Commit graph

406 commits

Author SHA1 Message Date
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
Isabell Long
2498002187 Add a new section to the developer's handbook about kernel debugging with
Dcons.

Converted from the wiki page [1] by myself as part of Google Code-In 2011.

[1] http://wiki.freebsd.org/DebugWithDcons

Reviewed by:	gavin
Approved by:	gabor (mentor)
2012-10-04 11:04:11 +00:00
Gabor Kovesdan
77d737ee88 - Rename the share/sgml directories to share/xml
- Fix build errors from the next change

Approved by:	doceng (implicit)
2012-10-01 11:56:00 +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
Gabor Kovesdan
efe7023c1f - Encoding names should be IANA names and in lower case 2012-09-22 20:09:08 +00:00
Gabor Kovesdan
9c243757ef - XML declarations should use IANA encoding names
Pointed out by:	hrs
2012-09-14 17:47:48 +00:00
Isabell Long
2e9319a593 Remove an extra word and place a full stop (period) inside parentheses in
the Emacs section of the Developer's Handbook.

Approved by:	gjb (mentor)
2012-09-14 17:09:52 +00:00
Gabor Kovesdan
2e51ec7022 - Strip unnecessary trailing spaces
Approved by:	doceng (implicit)
2012-08-21 19:16:02 +00:00
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
Isabell Long
e5c7e3910a Describe remote GDB configuration in greater depth in the developer's handbook.
PR:		docs/170013
Submitted by:	Carl Delsey (carl.r.delsey (at) intel.com)
Reviewed by:	gavin
Approved by:	gjb (mentor)
2012-07-20 14:46:08 +00:00
Isabell Long
564efa1a3f Remove outdated information from the Emacs section of the developer's
handbook.

PR:		docs/160447
Submitted by:	radiomlodychbandytow [at] o2 [dot] pl (on the mailing list;
		PRed by gjb)
Reviewed by:	gjb
Approved by:	gabor (mentor)
2012-06-28 09:10:37 +00:00
Gabor Kovesdan
3cdf4e4922 - XMLify English books
Approved by:	doceng (implicit)
2012-06-21 16:04:40 +00:00
Warren Block
1c3a3f8502 Whitespace-only changes. Fix indentation, trailing whitespace,
blank lines, rewrap paragraphs.
2012-04-02 15:42:38 +00:00
Glen Barber
d45961b7f6 Rewrap a few paragraphs
Found with:	textproc/igor
2012-02-21 04:01:43 +00:00
Glen Barber
ee0fa2683e Add commas after 'e.g.'
Fix a grammar nit: s/test/testing/

Found with:	textproc/igor
2012-02-21 03:59:33 +00:00