Commit graph

77 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
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
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
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
Eitan Adler
6b8a33ac94 Add missing </para> 2014-06-30 05:48:40 +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
Gabor Kovesdan
24d129e8d1 - Definitively upgrade to DocBook 5.0 2013-11-07 15:39:28 +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
Gabor Kovesdan
a06603e1e8 - MFH 2013-02-05 09:14:34 +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
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
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
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
Rene Ladan
614a27171c Remove lang/gpc as a Pascal compiler
PR:		docs/156309
Submitted by:	Chris Rees [utisoft gmail.com]
2011-04-12 18:21:40 +00:00
Peter Pentchev
d6ce8f3c55 Update the information about Perl and Tcl available in the ports tree.
PR:		140568, 140569
Submitted by:	Denny Lin <dennylin93@cnmc32.hs.ntnu.edu.tw>
2009-11-25 10:28:55 +00:00
Gabor Pali
002b4edbbe Change role="port" to role="package" so that package links are properly
generated

Approved by:	trhodes, gabor (mentor)
2008-08-06 20:44:12 +00:00
Gabor Pali
48c74ccc11 - Update to the tools section of the developers-handbook
PR:		docs/125346
Submitted by:	gavin
Reviewed by:	danger, trhodes, Ben Kaduk <minimarmot (at) gmail (dot) com>
Approved by:	trhodes
2008-07-23 20:39:55 +00:00
Christian Brueffer
bee89619f0 Don't claim that Perl and Fortran are in the base system, add a note
about the next section describing some of the options from the ports
collection.

PR:		120152
Submitted by:	Michael Voorhis <mvoorhis@cs.wpi.edu>
2008-02-03 18:26:28 +00:00
Marc Fonvieille
e13bdf2a4b Various typo and punctuation fixes. 2006-08-28 18:59:16 +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
Jesus R. Camou
191eead814 o Remove old <ulink> tags for packages. Use
<filename role="package"> instead.
o Add Ruby to the list of supported interpreters.

Recommended by:	trhodes
Approved by:	trhodes (mentor)
2005-11-09 02:43:26 +00:00
Murray Stokely
53b85eb152 Reference the development.7 man page.
PR:		docs/62914
2005-03-18 02:16:39 +00:00
Simon L. B. Nielsen
ed68a6151d - Remove a few contractions.
PR:		docs/77778
Submitted by:	Joel Dahl <joel@automatvapen.se>
2005-02-20 14:53:33 +00:00
Giorgos Keramidas
6c52523e6b Grammar nit.
Submitted by:	beowuff at gmail dot com
2004-12-09 11:45:37 +00:00
Hiroki Sato
c4cb2201ad Use lower-case characters for attribute name (s/URL=/url=/).
No content change.
2004-08-09 19:49:18 +00:00
Hiroki Sato
84f8ee0a15 Use relative URLs when URL_RELPREFIX is defined and URLS_ABSOLUTE
is not defined.

- URL_RELPREFIX must always point the top page's URL
  (http://www.FreeBSD.org) in relative form, defined in Makefile.

- &url.base; can be used in doc/<langcode>/*.  It will be
  replaced with the real URL which points the top page.

For translators: Please make sure to define URL_RELPREFIX to
point the top page.  The localized docs have different directory
hierarchy in its URL from the English version.

Tested by:	den
2004-07-06 15:09:55 +00:00
Josef El-Rayes
8142b0c275 Fix missing whitespace after 'Contributed by' and another minor
sgml issue i introduced with last commit.

Pointed out by:		simon
2004-05-16 21:44:47 +00:00
Josef El-Rayes
6d05c0410f Modify the author information into standard used through out the handbook.
Discussed on:	freebsd-doc@
2004-05-16 21:28:34 +00:00
Denis Peplin
bf2a771582 Use &url.main; for references to main FreeBSD website
Ihis entity auto-replaced with ../../../.. by default
and with http://www.FreeBSD.org/ when URLS_ABSOLUTE is set
(used for mirrors and for release building accordingly)
2004-05-11 13:29:48 +00:00
Ceri Davies
d385af32a6 Correct instances of "try and ...". 2004-02-25 20:07:18 +00:00
Simon L. B. Nielsen
0b473c33aa *.sgml:
- Use trademark entities.
 - Add trademark attributions.
 - Don't join trademarks with other words, e.g. using hyphens.

trademark.ent:
 - Add trademark entity for Sun.
2004-02-16 00:11:08 +00:00
Sean Chittenden
2c9abf4694 Whitespace changes in the sample .emacs file. 2003-10-17 21:09:05 +00:00
Marc Fonvieille
25eac97f02 Add a reference to the Free Pascal Compiler.
PR:		docs/56132
Submitted by:	Marco van de Voort marcov@stack.nl
2003-08-29 13:31:23 +00:00
Marc Fonvieille
34a5a8c393 Missing/malformed tags fixes.
Found by:	make lint
2003-08-27 07:16:27 +00:00
Bruce A. Mah
3e3f50555c Try to clarify some text regarding Emacs Lisp and Common Lisp.
PR:		55397
Reviewed by:	krion
2003-08-08 20:38:02 +00:00
Sean Chittenden
36cbe51ebd Small whitespace fix to improve readability of the lisp code in the .emacs
example.
2003-04-04 03:39:08 +00:00
Sean Chittenden
30dd31cfc8 Use own dogfood and remove whitespace pointed out through by displaying
trailing whitespace.

PR:		docs/48371
Approved by:	ceri
2003-02-17 20:09:57 +00:00