<?xml version="1.0"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % BOOK_ENTITIES SYSTEM "../index.ent">
%BOOK_ENTITIES;
]>
<section>
	<title>Document Conventions</title>

	<para>
		Certain words in this manual are represented in different fonts,
		styles, and weights. This highlighting indicates that the word is part
		of a specific category. The categories include the following:
	</para>

	<variablelist>
		<varlistentry>
			<term><literal>Courier font</literal></term>
			<listitem>
				<para>
					Courier font represents <command>commands</command>, <filename>file
					names and paths</filename>, and
					<prompt>prompts</prompt>
					.
				</para>
				<para>
					When shown as below, it indicates computer output:
<screen>
Desktop       about.html       logs      paulwesterberg.png
Mail          backupfiles      mail      reports
</screen>
				</para>
			</listitem>
		</varlistentry>

		<varlistentry>
			<term><userinput>bold Courier font</userinput></term>
			<listitem>
				<para>
					Bold Courier font represents text that you are to type, such as:
					<userinput>service jonas start</userinput>
				</para>
				<para>
					If you have to run a command as root, the root prompt
					(<literal>#</literal>) precedes the command:
				</para>
<screen>
# <userinput>gconftool-2
</userinput>
				</screen>
			</listitem>
		</varlistentry>

		<varlistentry>
			<term><replaceable>italic Courier font</replaceable></term>
			<listitem>
				<para>
					Italic Courier font represents a variable, such as an installation
					directory: <filename>
					<replaceable>install_dir</replaceable>/bin/</filename>
				</para>
			</listitem>
		</varlistentry>

		<varlistentry>
			<term><application>bold font</application></term>
			<listitem>
				<para>
					Bold font represents <application>application
					programs</application> and <guilabel>text found on a graphical
					interface</guilabel>.
				</para>
				<para>
					When shown like this: <guibutton> OK </guibutton>, it indicates a
					button on a graphical application interface.
				</para>
			</listitem>
		</varlistentry>
	</variablelist>

	<para>
		Additionally, the manual uses different strategies to draw your
		attention to pieces of information. In order of how critical the
		information is to you, these items are marked as follows:
	</para>

	<note>
		<title>Note</title>

		<para>
			A note is typically information that you need to understand the
			behavior of the system.
		</para>
	</note>
	<tip>
		<title>Tip</title>
		<para>
			A tip is typically an alternative way of performing a task.
		</para>
	</tip>
	<important>
		<title>Important</title>

		<para>
			Important information is necessary, but possibly unexpected, such as
			a configuration change that will not persist after a reboot.
		</para>
	</important>

	<caution>
		<title>Caution</title>

		<para>
			A caution indicates an act that would violate your support agreement,
			such as recompiling the kernel.
		</para>
	</caution>

	<warning>
		<title>Warning</title>

		<para>
			A warning indicates potential data loss, as may happen when tuning
			hardware for maximum performance.
		</para>
	</warning>
</section>
