Commit graph

511 commits

Author SHA1 Message Date
Warren Block
13b90ac2e3 Add a section documenting how to submit new translations. 2015-10-13 22:33:09 +00:00
Warren Block
0048f6916c Swap two words transposed. 2015-10-01 14:55:39 +00:00
Warren Block
991f29b7ab Remove mention of outdated optional packages. Pointed out by Hoyoung
Kim <trig4800@gmail.com> on -doc.
2015-09-09 14:03:22 +00:00
Warren Block
e7f74412e6 Add "Example" to example titles that only have element names. 2015-09-09 02:14:13 +00:00
Warren Block
98ecd8f450 Clean up Links section:
Remove section about <anchor>, xml:id makes those unnecessary.
Remove section about using <link> to link to the same document.
Change ulink reference to link.
Add an example showing using an XML empty tag for a link.
Add an example of using <uri>.
Add "Example" to example titles.
2015-09-08 03:59:02 +00:00
Warren Block
68d409151b Update an obsolete URL for the Subversion repository. 2015-09-05 14:07:28 +00:00
Warren Block
c0c5b7d158 Add titles to examples missing them. This prevents mysterious blank,
unclickable entries in the list of examples.
2015-09-02 22:56:34 +00:00
Warren Block
09be597cc5 Anti-and an and, accomplishing an an. 2015-09-02 22:01:42 +00:00
Warren Block
fdcac356bb Be more clear about rebuilding the docproj port. 2015-09-02 21:52:57 +00:00
Warren Block
9bc66bf912 Add a new chapter that documents how PO translations are created and
maintained.
2015-09-02 20:30:53 +00:00
Warren Block
3062276fef Add a skeletally brief overview of the FORMATS variable and actually show how
to build an output file.  Both of these are things might be of more than
academic value to someone working on the documentation.
2015-09-02 20:28:03 +00:00
Warren Block
444e5eec2f Clarify and simplify the chapter about building the web site.
Reviewed by:	gjb
2015-08-19 02:22:19 +00:00
Warren Block
5c9b75f2c7 Update the emacs configuration.
PR:		202303
Submitted by:	Hoyoung Kim <trig4800@gmail.com>
2015-08-14 23:07:33 +00:00
Warren Block
9e379ea8c1 Correct and clarify the use of environment variables when building the
web site.
2015-07-26 22:22:12 +00:00
Warren Block
4f85e40164 Update for the new simplified geolocated and swizzlified Subversion
repository.
2015-07-22 21:57:34 +00:00
Warren Block
6cb3b6ed01 Update emacs configuration.
Submitted by:	Noam Postavsky <npostavs@users.sourceforge.net>
2015-07-12 11:28:44 +00:00
Warren Block
b28f6ef5ee Fix directory name in the Quick Start of the FDP Primer.
PR:		200857
Submitted by:	camarda@amnz.org
2015-06-14 19:38:09 +00:00
Rene Ladan
4d07437c99 The send-pr(1) has been removed in FreeBSD 10, so remove it from most of the
documentation (books, articles, websites) unless there is an explicit or
"obvious" reason.

Do not touch old news articles, release notes, or the CGI scripts.

Differential Revision: 	https://reviews.freebsd.org/D2380
Reviewed by:	bjk
2015-05-01 21:32:39 +00:00
Eitan Adler
8026bd5fdc translator faq:
- remove FAQ about why we have a FAQ: this is obvious
	- add a mention of freebsd-translators@ which is a generic mailing list
2015-04-10 03:49:43 +00:00
Allan Jude
7f34616c6a Fix typos in the FreeBSD Documentation Project Primer
PR:		198654
Differential Revision:	https://reviews.freebsd.org/D2112
Submitted by:	Francis Gudin
Reviewed by:	wblock
Approved by:	bcr (mentor)
Sponsored by:	ScaleEngine Inc.
2015-03-22 20:39:42 +00:00
Jason Helfman
9ac4671ccd - remove class defining directory from ftp-primer and advise to use filename
Differential Revision:	https://reviews.freebsd.org/D1740
Approved by:	bcr (mentor)
2015-02-12 17:59:51 +00:00
Benedict Reuschling
94cbef681c Revert my previous change.
To quote form the standard:
"reaching the } that terminates the main function returns a value of 0."
- 5.1.2.2.3 Program termination in 2ISO/IEC 9899:2012

Pointed out by:	    kib
2014-12-06 19:39:54 +00:00
Benedict Reuschling
647bbf1d27 Change the "hello world" examples so that they return 0.
I realize that this is not a C programming primer, but
we can at least try to be correct here. :-)
2014-12-06 18:24:35 +00:00
Jason Helfman
41d9629e19 - fix svn command and mention svnweb interface
PR:		195295 (based on)
Differential Revision:	https://reviews.freebsd.org/D1222
Submitted by:	pt307@cam.ac.uk
Approved by:	wblock (mentor)
2014-12-01 19:56:49 +00:00
Jason Helfman
e5031bd37d - remove extraneous markup
Differential Revision:	https://reviews.freebsd.org/D1153
Approved by:	bcr (mentor)
2014-11-13 17:07:42 +00:00
Gavin Atkinson
90dc95bf1a The canonical form of links to Bugzilla should be http://bugs.FreeBSD.org .
Correct case and schema.
2014-07-30 22:55:12 +00:00
Warren Block
362aae352f Add an example showing the use of <example>. 2014-07-06 04:03:27 +00:00
Warren Block
8e43778a75 Add example of <stepalternative> to <procedure>. 2014-07-05 03:52:27 +00:00
Warren Block
7d9b32c439 Update the vim editor configuration.
Submitted by:	mat@
2014-07-02 20:09:36 +00:00
Warren Block
6277056204 Correct and expand DocBook examples, fix some that have embarrassing
errors and some that do exactly what the guidelines say to avoid.
2014-06-25 15:10:38 +00:00
Warren Block
7b8c9ea363 Whitespace-only fixes, translators please ignore. 2014-06-25 14:21:19 +00:00
Warren Block
e391092606 Remove obsolete example build instructions. Update book and article
examples for DocBook 5 and FreeBSD DTD.

Note to translators: there are content whitespace changes in the example
programlistings that should be included in translations.
2014-06-25 14:19:46 +00:00
Warren Block
76142d7105 Whitespace-only fixes, translators please ignore. 2014-06-25 13:47:40 +00:00
Warren Block
7f62180e7b Update the vim editor config section, adding gjb's .vimrc. Also add a
a post-processing step to avoid an embedded literal tab, and a short
note on usage.

PR:		191137
Submitted by:	venture37@geeklan.co.uk
2014-06-25 13:45:55 +00:00
Warren Block
38b0baffa3 Remove obsolete DocBook SGML setup instructions. 2014-06-24 15:50:48 +00:00
Warren Block
79077b5951 Point out that procedure steps are allowed to have title elements. 2014-06-24 15:45:24 +00:00
Glen Barber
4a4ba223dc Replace query-pr.cgi and send-pr.html with their Bugzilla
equivalents.

Sponsored by:	The FreeBSD Foundation
2014-06-18 13:41:03 +00:00
Christian Brueffer
74c900c9d5 Fix links to the SVN mirror list.
PR:		190962
Submitted by:	Sergey V. Dyatko
2014-06-13 10:26:42 +00:00
Warren Block
b0033df415 Whitespace fixes only, translators please ignore. 2014-06-01 02:04:19 +00:00
Warren Block
f0bf7f1886 Correct example. 2014-06-01 01:56:53 +00:00
Warren Block
7c74194d80 Add a variablelist example to the Lists and Procedures section, and
give it and the <procedure> entry separate examples.
2014-06-01 01:52:30 +00:00
Li-Wen Hsu
163ba6b752 Convert zh_TW from Big5 to UTF-8.
Approved by:	bcr
2014-05-29 16:48:07 +00:00
Warren Block
7992f26c4d Remove leftover sgml-markup and sgml-primer chapters. 2014-05-22 05:05:50 +00:00
Hiroki Sato
22b07b7150 - Add SCR and PIC as image format.
- Bump copyright year.
2014-05-21 09:23:53 +00:00
George V. Neville-Neil
fdff5a5c73 Remove location specific component of SVN repository from the example.
Approved by: gjb (mentor)
2014-05-18 14:59:06 +00:00
Warren Block
e48fc921b4 Mention groupnames. 2014-04-18 22:13:32 +00:00
Warren Block
b59cbd5364 Add non-trivial indentation examples and an example of moving an element
to the next line to improve readability.
2014-03-08 00:15:43 +00:00
Benjamin Kaduk
2fb105f2e7 Fix a few typos
PR:		docs/187241
Submitted by:	Alex Weber <alexwebr@gmail.com>
Approved by:	hrs (mentor)
2014-03-07 02:34:39 +00:00
Warren Block
ef48f1f02f Fix the example usage of an article link. 2014-03-04 12:57:52 +00:00
Warren Block
8f97d77882 Fix .nanorc config.
Submitted by:	jgh
2014-02-26 23:14:36 +00:00