documentation support

docs/md/builtins.md

@@ -0,0 +1,15 @@
+@defgroup  builtins  YAP Core Built-ins                  
+
+@brief This chapter describes the core built-in predicates  that control the execution of
+Prolog programs, provide fundamental functionality such as termm manipulation or arithmetic, and support interaction with external
+resources,
+
+Many of the predicates described here have been standardised by the International Standard Organization.
+ The corresponding standartised subset of Prolog also known as ISO-Prolog.                                                                                             
+In the description of the arguments of predicates the following
+notation will be used:
+
++ a preceding plus sign will denote an argument as an "input
+argument" - the argument is read, not written, and it cannot be a free variable at the time of the call;
++ a preceding minus sign will denote an "output argument";
++ an argument with no preceding symbol can be used in both ways.

docs/md/extensions.md

@@ -0,0 +1,21 @@
+Extensions to core Prolog.			{#extensions}
+=========================
+
+YAP includes a number of extensions over the original Prolog
+language. Next, we discuss how to use the most important ones.
+
+  + @ref Rational_Trees
+
+  + @ref AttributedVariables
+
+  + @ref  DepthLimited
+
+  + @ref  Tabling
+
+  + @ref Threads
+
+  + @ref Profiling
+
+  + @ref YAPArrays
+
+  + @ref Parallelism

docs/md/load_files.md

@@ -1,15 +1,12 @@
-Loading and Organising YAP Programs           {#load_files}
-===================================
+@defgroup load_files Loading and Organising YAP Programs    
 
-  Next, we present the main predicates and directives available to load
-  files and to control the Prolog environment.
+  @brief Next, we present the main predicates and directives available to load
+  files and to control the Prolog environment. They include
+
+  + @subpage YAPConsulting
 
   + @subpage YAPModules
 
-  + @ref YAPConsulting
+  + @subpage YAPBigLoad
 
-  +  @ref QLY
-
-  + @ref YAPBigLoad
-
-  
+  

docs/md/packages.md

@@ -1,13 +1,13 @@
 YAP packages              {#packages}
 ============
 
-  + @subpage real
+  + @subpage realxplxc
 
   + @subpage BDDs
 
   + @subpage  gecode
 
-  + @subpage  myddas
+  + @subpage  myddas_dbms
 
   + @ref PFL
 

docs/md/programming.md

@@ -0,0 +1,10 @@
+Programming in YAP            {#YAPProgramming}
+====================
+
+  + @ref Syntax
+
+  + @ref YAPCompilerSettings
+
+  + @ref Indexing
+
+  + @ref Deb_Interaction

docs/md/yap.md

@@ -5,7 +5,7 @@
 ![The YAP Logo](docs/icons/yap_128x128x32.png)
 </center>
 
-NOTE: this version of YAP is still experimental, documentation may be out of date.
+NOTE: this version of YAP is still experimental, documentation may be missing or brout of date.
 
 ## Introduction
 
@@ -25,7 +25,7 @@ The manual is organised as follows:
 
 + @subpage builtins
 
-+ @subpage Extensions
++ @subpage extensions
 
 + @subpage library
 
@@ -59,21 +59,6 @@ from
 Jan Wielemaker. We would also like to gratefully
 acknowledge the contributions from Ashwin Srinivasian.
 
-@page builtins YAP Core Built-ins
-
-
-This chapter describes the core predicates  that control the execution of
-Prolog programs, provide fundamental functionality such as termm manipulation or arithmetic, and support interaction with external
-resources, Many of the predicates described here have been standardised by the ISO. The standartised subset of Prolog also known as ISO-Prolog.                                                                                                                                                                                              
-
-In the description of the arguments of predicates the following
-notation will be used:
-
-+ a preceding plus sign will denote an argument as an "input
-argument" - it cannot be a free variable at the time of the call;
-+ a preceding minus sign will denote an "output argument";
-+ an argument with no preceding symbol can be used in both ways.
-
 
 @page Library YAP Library
 
@@ -89,7 +74,26 @@ argument" - it cannot be a free variable at the time of the call;
 YAP includes a number of extensions over the original Prolog
 language.
 
-         @subpage atts
+  + @subpage atts
+
+  + @ref Rational_Trees
+  
+  + @ref CohYroutining
+
+  + @ref Attributed_Variables
+
+  + @ref  DepthLimited
+
+  + @ref  Tabling
+
+  + @ref Threads
+
+  + @ref Profiling
+
+  + @ref YAPArrays
+
+  + @ref Parallelism
+
 
 @page YAPProgramming Programming in YAP