diff options
Diffstat (limited to 'help/C/preface.sgml')
| -rw-r--r-- | help/C/preface.sgml | 83 |
1 files changed, 83 insertions, 0 deletions
diff --git a/help/C/preface.sgml b/help/C/preface.sgml new file mode 100644 index 0000000000..9637beaf4c --- /dev/null +++ b/help/C/preface.sgml @@ -0,0 +1,83 @@ +<!-- +<!DOCTYPE preface PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"> +--> + <preface id="introduction"> + <title>About this Book</title> + <sect1 id="organization"> + <title>Organization</title> + <para> + This book is divided into two parts, with several + appendices. The first part is a <link linkend="usage">guided + tour</link>, which will explain how to use + <application>Evolution</application>. If you are new to + <application>Evolution</application> or to groupware in + general, this section is for you. The second section, covering + <link linkend="config">configuration</link>, is targeted at + more advanced users, but anyone who wants to change the way + <application>Evolution</application> looks or acts can benefit + from reading it. + </para> + </sect1> + + <sect1 id="typography"> + <title>Typographical conventions</title> + <para> + In this book, we'll mark some words with special typography: + <simplelist> + <member><application>Applications</application></member> + <member><command>Commands</command> you type at the command line</member> + <member><guilabel>Labels</guilabel> for buttons and other portions of the graphical interface</member> + + <member> Menu selections look like this: + <menuchoice> + <guimenu>Menu</guimenu> + <guisubmenu>Submenu</guisubmenu> + <guimenuitem>Menu Item</guimenuitem> + </menuchoice> + </member> + <member><guibutton>Buttons</guibutton> you can + click</member> <member><userinput>Anything you type + in</userinput></member> <member><computeroutput>Text + output from a computer</computeroutput></member> + <member><glossterm linkend="apx-gloss">Words</glossterm> + that are defined in the <xref linkend="apx-gloss">.</member> + </simplelist> +</para> +<para> +We'll provide assorted bits of additional information in tips set off from the rest of the book, as well. + + <tip id="example-tip"> + <title>Tip</title> + <para> + Tips and bits of extra information will look like + this. + </para> + </tip> +</para> + +<para> +Examples are also set off from the rest of the text. They look like this: + + <example> + <title>Example Example</title> + <para> + This is what an example looks like. We'll provide + examples for some of the more complicated tasks you + might be performing. + </para> + </example> +</para> +<para> +Lastly, we'll have warnings, in cases where you should be careful: + + <warning id="example-warning"> + <title>Example Warning</title> + <para> + This is what a warning looks like. If there's a chance + you'll run into trouble, we'll warn you beforehand. + </para> + </warning> + </para> + </sect1> +</preface> + |