docs/Samba-Guide/conventions.xml

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   3                 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
   4
   5   <!-- Stuff for xincludes -->
   6   <!ENTITY % xinclude SYSTEM "../entities/xinclude.dtd">
   7   %xinclude;
   8
   9   <!-- entities files to use -->
  10   <!ENTITY % global_entities SYSTEM '../entities/global.entities'>
  11   %global_entities;
  12
  13 ]>
  14
  15   <sect1>
  16     <title>Conventions Used</title>
  17
  18     <para>
  19     The following notation conventions are used throughout this book:
  20     </para>
  21
  22     <itemizedlist>
  23       <listitem>
  24         <para>
  25         TOSHARG is used as an abbreviation for the book, <quote>The Official Samba-3
  26         HOWTO and Reference Guide,</quote> Editors: John H. Terpstra and Jelmer R. Vernooij,
  27         Publisher: Prentice Hall, ISBN: 0131453556.
  28         </para>
  29       </listitem>
  30
  31       <listitem>
  32         <para>
  33         Directories and filenames appear in mono-font. For example,
  34         <filename>/etc/pam.conf</filename>.
  35         </para>
  36       </listitem>
  37
  38       <listitem>
  39         <para>
  40         Executable names are bolded. For example, <command>smbd</command>.
  41         </para>
  42       </listitem>
  43
  44       <listitem>
  45         <para>
  46         Menu items and buttons appear in bold. For example, click <guibutton>Next</guibutton>.
  47         </para>
  48       </listitem>
  49
  50       <listitem>
  51         <para>
  52         Selecting a menu item is indicated as:
  53         <menuchoice>
  54                 <guimenu>Start</guimenu>
  55                 <guimenuitem>Control Panel</guimenuitem>
  56                 <guimenuitem>Administrative Tools</guimenuitem>
  57                 <guimenuitem>Active Directory Users and Computers</guimenuitem>
  58         </menuchoice>
  59        </para>
  60       </listitem>
  61     </itemizedlist>
  62
  63   </sect1>
  64