Commit graph

130 commits

Author SHA1 Message Date
Gabor Kovesdan
a06603e1e8 - MFH 2013-02-05 09:14:34 +00:00
Gabor Kovesdan
3327cf64d4 - Remove HTML Tidy leftovers 2013-02-01 18:51:52 +00:00
Gabor Kovesdan
d891a25dc5 - Make sure all source files are ready before validation
- Make sure all source files are ready before building
- Clean up the workarounds from handbook Makefiles
2013-01-31 09:55:07 +00:00
Gabor Kovesdan
d95165dc16 - Make the English documentation valid XML 2013-01-21 17:37:33 +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
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
1365e9ed1f - Add a missing XML declaration so that Jade can process the PGP keys
properly
- While here, do not silent Jade since its output helps seeing what
  happens and would have been a big help when debugging this build error

Reviewed by:	gjb
2012-09-14 15:07:59 +00:00
Gabor Kovesdan
2e51ec7022 - Strip unnecessary trailing spaces
Approved by:	doceng (implicit)
2012-08-21 19:16:02 +00:00
Gabor Kovesdan
3cdf4e4922 - XMLify English books
Approved by:	doceng (implicit)
2012-06-21 16:04:40 +00:00
Craig Rodrigues
a98b78f5eb Enhance text which explains how to debug networking
problems when setting up PXE.

Reviewed by: gjb
2012-06-11 07:03:42 +00:00
Glen Barber
71484c537f bsdinstall chapter updates from -RC3:
- Add the 'Enabling Crash Dumps' screen [1]
- Add the 'Manual Configuration' screen
- Replace the 'Final Configuration' screen; the 'Shell' option was removed
  and replaced with the 'Manual Configuration' prompt

Reminded by:		ryusuke [1]
2011-12-11 18:21:55 +00:00
Glen Barber
36df0fc698 9.0-RC1 updates to the bsdinstall chapter:
- Document that bsdinstall will prompt a user if they would like
  to set a non-default keymap
- Add the image the displays the prompt for a user to select
  an non-default keymap
- Update the final configuration image, where 'Exit' is now the
  first option

Submitted/noticed by:	dru
2011-10-22 16:57:21 +00:00
Warren Block
3f66fb4e23 Add description of wireless config to bsdinstall chapter.
Approved by:	gjb
2011-10-12 04:00:20 +00:00
Warren Block
bfb5c2c098 Remove leftover image placeholders.
Approved by:	gjb
2011-10-08 16:44:25 +00:00
Glen Barber
2be024f6ea Add a few last-minute screenshots to Makefile. 2011-10-08 16:34:12 +00:00
Glen Barber
6ea67c3d87 Hook the bsdinstall chapter to the build. 2011-10-08 15:20:28 +00:00
Marc Fonvieille
48a3db76e8 - Change a section id to something closer to the real content of the
section (s/install-floppies/install-boot-media) to ease the read of
  the file;
- Some rewordings for i386 boot part to mention USB stick media.  I let
  floppies part since it's still correct for 7.X;
- Updates of some boot messages (still a work in progress);
- Add a screenshot for the keyboard selection at sysinstall(8) start
  which occurs if United States is not selected for the country.

PR:		docs/145023
Submitted by:   Aiza <aiza21@comclark.com>
2010-08-18 20:23:36 +00:00
Tom Rhodes
98a057adfe Decouple and remove the Updating chapter. 2008-12-23 18:59:03 +00:00
Manolis Kiagias
b75927fb7f Add a note on the files to update when adding a new chapter to the Handbook build
Suggested by:	murray
Discussed with:	murray, trhodes
2008-11-14 22:19:18 +00:00
Tom Rhodes
b9a67e9ab6 Add the DTrace, file systems, and Updating chapters to the build. They
need a bit more fleshing out, but there is no reason why they should
remain local patches anymore.

Reviewed by:	remko, pgj, manolis, keramida
2008-09-28 12:54:12 +00:00
Brad Davis
dfc911281c Add the images to the Makefile for the VMWare Virtualization section. 2008-03-03 11:07:37 +00:00
Chin-San Huang
21a93d5607 - Add Virtual PC on Windows(R) section.
Obtained from:	The FreeBSD Traditional Chinese Project
2007-10-13 12:01:20 +00:00
Marc Fonvieille
b638616131 - Update boot messages for both CDROM and floppies boot; [1]
- Add boot loader menu screenshot.

[1] This is for i386, this should be correct for amd64.  I cannot really
update the alpha part (no alpha hardware under the hand).
2007-07-29 11:19:09 +00:00
Chin-San Huang
afebebd09a - Update the deprecated section about "Visual kernel configuration".
- Attach the newly screenshot of country-config for FreeBSD 6.2 -R and later.
2007-06-30 18:12:31 +00:00
Chin-San Huang
84d02da05c - Remove two screenshot which is deprecated from sysinstall(8):
xf86setup, desktop.

Noticed by:	Ganbold <ganbold _at_ micom dot mng dot net>

Thanks. :)
2007-06-27 04:13:00 +00:00
Daniel Gerzo
dc1b399db4 Install missing callout images, which are required for example in Security
Advisories chapter.

Approved by: keramida (mentor), trhodes (mentor)
2007-05-06 09:52:34 +00:00
Marc Fonvieille
cf51f00a1f Add for real the images for the Virtualization chapter.
Forgotten by:		blackend@
2007-04-19 10:00:57 +00:00
Murray Stokely
cc77aae9cd Add virtualization chapter to the System Administrator <part> of the
Handbook.
2007-04-06 07:38:50 +00:00
Daniel Gerzo
f09602d335 Add a new Handbook chapter about FreeBSD jails. It has been originally written
by Matteo Riondato and further work has been done by me and my great mentors.
Despite it took months to get it in, we believe it's a right time to commit and
have a wider audience to look at it, and improve it even more. I hope you will
like it :-)

Approbed by: trhodes (mentor), keramida (mentor)
2007-03-22 20:30:18 +00:00
Giorgos Keramidas
10b9fc1cd5 Disconnect the "NanoBSD" Handbook chapter from the build. 2006-05-16 14:01:08 +00:00
Giorgos Keramidas
e48fa8dedb Add a chapter about "NanoBSD". This probably needs a bit more work,
and I may have missed some SGML-ification, but let's give more
visibility to the chapter, so others can help me improve it too.

PR:             docs/94419
Submitted by:   Daniel Gerzo <danger@rulez.sk>
2006-05-04 16:21:08 +00:00
Hiroki Sato
3f70c9595b Move build targets for book.{ps,pdf} of the handbook to the LI part. 2006-04-17 17:49:24 +00:00
Hiroki Sato
4c5050dc07 Add temporary files to CLEANFILES instead of removing them
during the build.
2005-09-19 20:01:58 +00:00
Hiroki Sato
40d1ff2285 Introduce doc.xml.mk and XMLDOCS variable to simplify build
of XML docs.  Note that XML catalog support is still incomplete.
2005-09-18 04:33:25 +00:00
Murray Stokely
15491b5420 Add disk striping diagram to the GEOM chapter.
Submitted by:	loader@freebsdmall.com
2005-08-12 12:00:23 +00:00
Tom Rhodes
9e1457cbcb Bring in two new chapters:
Audit - not hooked up to the build, but provided for when the audit framework
becomes available in the base system.

GEOM - Incomplete, only covers striping and mirroring since that is all I
have tested.  Incomplete is better than nothing in my opinion.  This one is
hooked up to the build.
2005-08-06 03:22:18 +00:00
Tom Rhodes
144fed7137 Grrr! I knew that was going to bite me eventually. Remove this chapter
from the book, the world is not ready for it yet.

Pointy hat:	trhodes
2005-07-21 09:18:59 +00:00
Tom Rhodes
72849eddb9 filesystem -> file system 2005-07-21 09:16:14 +00:00
Murray Stokely
fe21d08e83 Remove the bulging firewalls section from the security chapter into a
new chapter all its own, currently in the 'network communications'
part as chapter 24.

Add a small paragraph at the bottom of the security chapter synopsis
noting that additional security topics are covered in the MAC chapter
and the Firewall chapter.

While here add some missing punctuation, cleanup the whitespace, add
missing </para> tags, add a synopsis, and of course
s/<sectN/<sectN-1/.
2004-12-05 00:14:21 +00:00
Murray Stokely
1ffd2e8bc6 The advanced networking chapter had grown to almost 100 pages.
Split out the sections about network servers into a new chapter.

Reviewed by:	doc@
2004-07-13 03:48:29 +00:00
Simon L. B. Nielsen
bb5a806683 Actually include the glossary again... it is not included automatically
since since the generic make variable only add real chapters that are
called "chapter.sgml".

Pointy hat to:	simon
Noticed by:	ceri
2004-07-12 22:49:18 +00:00
Simon L. B. Nielsen
3cdb8b5b09 - Make decencies work for the Glossary, so the Handbook is rebuild
when the Glossary is updated.
- While I'm here; sort a SRCS entry missed in revision 1.86.

Prodded by:	ceri [1]
2004-07-12 21:58:13 +00:00
Simon L. B. Nielsen
8b2c84f627 Retire the WITH_GLOSSARY option and enable the Glossary by default.
No objections:	-doc
2004-07-12 20:24:41 +00:00
Murray Stokely
2d783cc50f Sort SRCS. 2004-07-12 09:26:16 +00:00
Marc Fonvieille
2db28883ee Add a graphic version for a remaining ASCII art, in static routes
section.
2004-07-11 13:34:27 +00:00
Hiroki Sato
a13b50e98b Unbreak the build.
Pointy hat to:	hrs
2004-07-07 11:23:16 +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
Tom Rhodes
dbf2be9b94 Add my recently written MAC chapter. At least 5-10% of this came from content
or ideas submitted to the trustedbsd-discuss mailing list by 'User Bugghy'
and from his mini-walkthrough.

Reviewed by:	-doc, TrustedBSD-discuss, rwatson
2004-06-21 19:34:56 +00:00
Denis Peplin
d25767864b Move
SRCS+= ${URLS_ENT}
from English Handbook Makefile to doc.common.mk

Reviewed by:	hrs
2004-05-11 05:52:39 +00:00