Commit graph

42 commits

Author SHA1 Message Date
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
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
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
9c243757ef - XML declarations should use IANA encoding names
Pointed out by:	hrs
2012-09-14 17:47:48 +00:00
Gabor Kovesdan
2e51ec7022 - Strip unnecessary trailing spaces
Approved by:	doceng (implicit)
2012-08-21 19:16:02 +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
e6b69c3357 - XMLify English articles
Approved by:	doceng (implicit)
2012-06-21 16:01:00 +00:00
Benedict Reuschling
14ae773e34 Correct a typo in an <application> tag. 2012-03-25 14:05:01 +00:00
Eitan Adler
eaaf05c67c Adding missing </para> tag I missed in 1.26
Submitted by:	taras
Approved by:	dougb
2012-02-18 02:56:15 +00:00
Eitan Adler
48ade357c0 - XFree86 has not been in service for many years
- Remove the gratuitous linux comparison
- Expand a bit on window managers

Approved by:	dougb
2012-01-11 02:13:00 +00:00
Doug Barton
21117f8647 Correct the full name of DARPA
Submitted by:	Ryan Kavanagh <ryanakca@kubuntu.org>
2010-06-26 04:29:21 +00:00
Marc Fonvieille
ed46ec5264 Add some trademarks and quote tags. 2009-06-06 13:14:49 +00:00
Marc Fonvieille
b5cd4ccefe Add some application tags and one abbr. where needed. 2009-05-31 08:06:43 +00:00
Giorgos Keramidas
c4e9e2d3f2 Remove duplicated fullstop added during my last commit here.
Noticed by:	  ceri
2006-07-15 17:20:53 +00:00
Giorgos Keramidas
3c974c9d56 Note that the BSD projects have a reputation for quality & complete
documentation, in the section about the advantages of BSD.

PR:		docs/100312
Submitted by:	Aasmund Eikli <inter@o12a.com>
2006-07-15 00:24:16 +00:00
Simon L. B. Nielsen
eaece1fb89 Add id attributes to sect1 tags in articles that has generated stale
xXXX.html files on www.FreeBSD.org to avoid generating more of them.
2005-07-20 19:21:49 +00:00
Murray Stokely
898891d565 Update this excellent article to refer to BSD/OS in the past tense and
briefly note its demise.  While here, also correct a recent typo.
2005-05-09 00:36:04 +00:00
Marc Fonvieille
ef1026b895 Grammar fix. 2005-04-17 13:50:54 +00:00
Remko Lodder
d0a1f12465 Add some information about DragenFly.
PR:			docs/70310
Submitted by:		Joel Dahl <joel at automatvapen dot se>
Approved by:		maintainer timeout
2005-04-17 11:59:28 +00:00
Ceri Davies
db62e8f84f Update article for recent times:
o New platforms
o CVS webpage has moved
o Mention X.org
o Minor rewordings

PR:		docs/71712
Submitted by:	Gavin Atkinson <gavin.atkinson at ury.york.ac.uk>
2004-09-14 17:46:01 +00:00
Ceri Davies
f4a1b45804 Whitespace only changes (kill EOL whitespace, etc.).
PR:		docs/71712
Submitted by:	Gavin Atkinson <gavin.atkinson at ury.york.ac.uk>
2004-09-14 17:43:16 +00:00
Simon L. B. Nielsen
222b6c71c2 Fix link to FreeBSD consulting.
PR:		docs/71175
Submitted by:	Kevin Kinsey <kdk@daleco.biz>
2004-08-31 06:51:40 +00:00
Ceri Davies
5d58625415 Reword a contentious sentence.
Tossed around on:	doc
2004-08-11 21:04:09 +00:00
Hiroki Sato
5fa082b1f8 Simplify parameter entities in doctype declaration.
Currently we have articles.ent and books.ent, and
for example, articles.ent can be used by putting the
following lines in the doctype declaration:

 <!ENTITY % articles.ent PUBLIC
            "-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EN">
 %articles.ent;

This pulls all of the necessary entities via share/sgml/articles.ent.

The translation teams can customize these entities by redefining
the articles.ent file in <langcode>/share/sgml.  See
ja_JP.eucJP/share/sgml for example.
2004-08-08 13:44:01 +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
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
Alexey Zelkin
6d048e2320 Sync these Makefiles to have one style of declarations and comments. 2004-04-06 16:10:08 +00:00
Alexey Zelkin
2e0fdd35b2 Add WITH_ARTICLE_TOC to big articles to simplify navigation across
article.
2004-04-06 13:40:48 +00:00
Simon L. B. Nielsen
2993ccd69a *.sgml:
- Use trademark entities
 - Add trademark attributions.
 - Always use correct case for trademarks.
 - Don't join trademarks with other words, e.g. using hyphens.

trademark.ent:
 - Add entities for more trademarks / companies.
 - Sort the Sun trademark attribution entity.
2003-09-14 11:29:06 +00:00
Murray Stokely
69354d5448 Include the default FreeBSD entity set.
Use &unix; rather than <trademark>UNIX</trademark>, so that this is
rendered with (r) rather than ^TM.
2003-06-17 20:55:25 +00:00
Hiroki Sato
f6cd99b654 Back out WITH_DOCFORMAT_NAVI_LINK?=YES in Makefile. The navi-link
is generated when ${WITH_DOCFORMAT_NAVI_LINK} is defined or
${FORMATS} includes "html" and "html-split."
2003-04-22 18:35:44 +00:00
Hiroki Sato
4f8b26641c - Add WITH_DOCFORMAT_NAVI_LINK to mk/doc.docbook.mk and
enable it in en_US.ISO8859-1/ and ja_JP.eucJP/.

- Add PUBLIC "-//FreeBSD//ENTITIES DocBook Language Specific Entities//EN"
  and l10n.ent for entity localization.

- Use share/misc/docbook.css for indentiation of <programlisting>
  and <screen>.

- Add some missing $FreeBSD$.
2003-04-19 11:39:30 +00:00
Murray Stokely
82540f7710 Clarify that Darwin is not just an open source kernel, but in fact a
fully functional open source OS.

Inaccuracy noted by:	jared nied <jnied@southampton.liu.edu>
2003-03-10 06:16:12 +00:00
Murray Stokely
720d4d69c8 * s/freebsd.org/FreeBSD.org/
* Correct some broken links
* Use relative links for freebsd.org documents

PR:		docs/31447
Submitted by:	Cyrille Lefevre <clefevre@citeweb.net>
Found by:	linbot
2001-10-23 21:31:20 +00:00
Giorgos Keramidas
0b824da1aa Remove all contractions from most of the articles. This solves the
problems with the usage of "its" vs "it's" among other things

Approved by:	nik
2001-10-16 11:53:01 +00:00
Murray Stokely
d9c88c41c3 - Use <firstterm> instead of <emphasis> when introducing a new technical
term.
- Add missing words to form a complete sentence.
- Markup the first instance of STABLE the same as the first instance of
  CURRENT.

PR:		docs/30774, docs/30773
Submitted by:	Giorgos Keramidas <charon@labs.gr>
2001-09-24 02:17:48 +00:00
Chern Lee
3e8d98b70a Standardize:
TCL -> Tcl
ethernet -> Ethernet
ftp (noun) -> FTP

Approved by:	murray
2001-07-17 22:20:51 +00:00
Dima Dorfman
4a5d66a6bf Spelling police. 2001-07-10 14:00:17 +00:00
Nik Clayton
12450ef32d Add "Explaining BSD", an article by Greg Lehey. 2001-03-14 18:10:08 +00:00