Add new helper AUTODOC_OutputTextFile
Revise how we hook into the package loading process

This uses namespaces (thus this will work only with GAP 4.5 or later),
but has the advantage that it will work even with packages that have
cyclic dependencies (such as e.g. between Alnuth and polycyclic).
Added a tutorials file in documentation.

This file is not included yet.
Added correct commands to tutorial file.
Added richt commands to file.

Does not work like it is at the moment,
since <Include> commands are evaluated by GAPDoc
in the verbatim enviroment.
Regenerate documentation
Included first tutorial.
Removed unnecessary doc files.
Merge branch 'master_save'

* master_save:
  Included first tutorial.
  Added richt commands to file.
  Added correct commands to tutorial file.
  Added a tutorials file in documentation.
doc: remove obsolete GAPDoc comments

Instead, add comments which point to the actual documentation.
doc: rewrap documentation strings, first step towards readability
doc: fix some typos in the manual
doc: Change mentions of CreateAutoDoc to CreateAutomaticDocumentation
doc: more cleanup
doc: major overhaul of the documentation

This removes most of the repetition in the manual, which makes maintenance
easier, and also helps user who now have a much easier time to spot the
differences between the various AutoDoc functions.

The readability of both the documentation source as well as of the
generated manual is also improved.
doc: move Declare* funcs into separate section
doc: regenerate documentation
doc: avoid emitting empty func labels
Merge branch 'docu-fixes' of https://github.com/fingolfin/AutoDoc

* 'docu-fixes' of https://github.com/fingolfin/AutoDoc:
  doc: avoid emitting empty func labels
  doc: regenerate documentation
  doc: move Declare* funcs into separate section
  doc: major overhaul of the documentation
  doc: more cleanup
  doc: Change mentions of CreateAutoDoc to CreateAutomaticDocumentation
  doc: fix some typos in the manual
  doc: rewrap documentation strings, first step towards readability
  doc: remove obsolete GAPDoc comments

Conflicts:
	gap/AutoDocEntries.g
	gap/AutoDocMainFunction.gd
	gap/CreateDocumentationEntries.gd
	gap/DeclareWithDocumentation.gd
Added a TODO file with some first remarks in it