doc changes

modified:   contrib/packages/guix/gnunet-doc.scm

adapt to the changes in this mixed commit

modified:   doc/.gitignore

add new files

modified:   doc/Makefile.am

make use of canonical, included, rules
generate html output with docstyle.css from taler exchange.

modified:   doc/chapters/installation.texi
new file:   doc/chapters/vocabulary.texi
modified:   doc/gnunet-c-tutorial.texi
modified:   doc/gnunet.texi
new file:   doc/docstyle.css

not really in use yet, but collected for later:
doc/gendocs.sh , doc/hacks.el

1 files changed, 47 insertions, 0 deletions

diff --git a/doc/chapters/vocabulary.texi b/doc/chapters/vocabulary.texi
new file mode 100644
index 000000000..8b6cbe35a
--- /dev/null
+++ b/doc/chapters/vocabulary.texi
@@ -0,0 +1,47 @@
+@node Vocabulary
+@chapter Vocabulary
+
+@menu
+* Words and characters::
+* Technical Assumptions::
+@end menu
+
+@node Words and characters
+@section Words and characters
+
+Throughout this document we use certain words and characters.
+
+@enumerate
+@item
+``@command{#}'' in example code blocks describes commands, ie comments.
+
+@example
+# Do the foobar thing:
+$ make foobar
+@end example
+
+@item
+Dollarsign ``@command{$}'' in example code blocks describes commands you
+execute as unprivileged users.
+
+@example
+$ cd foo; ./configure --example-switch
+@end example
+
+@item
+Backslash ``@command{\}'' describes linebreaks.
+
+@example
+./configure --foo --bar --baz \
+ --short-loop
+@end example
+
+...expands to @code{./configure --foo --bar --baz --short-loop}
+
+@end enumerate
+
+@node Technical Assumptions
+@section Technical Assumptions
+
+@c Is it really assuming Bash (ie Bash extensions of POSIX being used)?
+The shell on GNU systems is assumed to be Bash.