docs

Signed-off-by: Nils Gillmann <ng0@n0.is>

diff --git a/doc/documentation/Makefile.am b/doc/documentation/Makefile.am
index 305e25b2a1c5432a68fe3f33baf2f4ce09be70b0..991b1926ba4be5aad5b52edd637acf6db69a6852 100644 (file)
--- a/doc/documentation/Makefile.am
+++ b/doc/documentation/Makefile.am
@@ -112,6 +112,7 @@ info_TEXINFOS =                                             \
 
 gnunet_TEXINFOS =                                              \
        chapters/developer.texi                                 \
+       chapters/terminology.texi                               \
        chapters/installation.texi                              \
        chapters/philosophy.texi                                \
        chapters/user.texi                                      \
@@ -140,6 +141,7 @@ DISTCLEANFILES =                                            \
        chapter/philosophy.cps                                  \
        chapters/user.cps                                       \
        chapters/configuration.cps                              \
+       chapters/terminology.cps                                \
        chapters/vocabulary.cps                                 \
        fdl-1.3.cps                                             \
        gpl-3.0.cps

diff --git a/doc/documentation/chapters/terminology.texi b/doc/documentation/chapters/terminology.texi
new file mode 100644 (file)
index 0000000..fa9b084
--- /dev/null
+++ b/doc/documentation/chapters/terminology.texi
@@ -0,0 +1,21 @@
+@node Terminology
+@chapter Terminology
+
+@menu
+* Terminology::
+* Typography::
+@end menu
+
+@node Terminology
+@section Terminology
+
+In the following Manual we may use words that can not be found in the Appendix. Since we
+want to keep the Manual selfcontained, we will explain words here.
+
+@node Typography
+@section Typography
+
+When giving examples for commands, shell prompts are used to show if the command should/can
+be issued as root, or if "normal" user privileges are sufficient. We use a @code{#}
+for root's shell prompt, a @code{%} for users' shell prompt, assuming they use the C-shell
+or tcsh and a @code{$} for bourne shell and derivatives.

diff --git a/doc/documentation/gnunet.texi b/doc/documentation/gnunet.texi
index 5dbee8a544eec370586b78b04e131c5ee9f6f3ca..b977a9a148a1780da5da6ff2869e929a5dbb9564 100644 (file)
--- a/doc/documentation/gnunet.texi
+++ b/doc/documentation/gnunet.texi
@@ -87,6 +87,11 @@ This document is the Reference Manual for GNUnet version @value{VERSION}.
 @detailmenu
  --- The Detailed Node Listing ---
 
+Terminology and Typography
+
+* Terminology
+* Typography
+
 Philosophy
 
 * Design Goals::
@@ -189,6 +194,10 @@ GNUnet Developer Handbook
 @end detailmenu
 @end menu
 
+@c *********************************************************************
+@include chapters/terminology.texi
+@c *********************************************************************
+
 @c *********************************************************************
 @include chapters/philosophy.texi
 @c *********************************************************************