fix docs

docs/doxygen.rc

@@ -38,7 +38,7 @@ PROJECT_NAME           = yap-6
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         =
+PROJECT_NUMBER         = 6.3.4
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer a
@@ -330,7 +330,7 @@ AUTOLINK_SUPPORT       = YES
 # diagrams that involve STL classes more complete and accurate.
 # The default value is: NO.
 
-BUILTIN_STL_SUPPORT    = NO
+BUILTIN_STL_SUPPORT    = YES
 
 # If you use Microsoft's C++/CLI language, you should set this option to YES to
 # enable parsing support.
@@ -670,7 +670,7 @@ SHOW_FILES             = YES
 # Folder Tree View (if specified).
 # The default value is: YES.
 
-SHOW_NAMESPACES        = YES
+SHOW_NAMESPACES        = NO
 
 # The FILE_VERSION_FILTER tag can be used to specify a program or script that
 # doxygen should invoke to get the current version for each file (typically from
@@ -783,7 +783,8 @@ INPUT                  = docs/yap.md \
                          os \
                          packages \
                          library \
-                         CXX
+                         CXX \
+                         OPTYap
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
@@ -862,7 +863,7 @@ RECURSIVE              = YES
 # Note that relative paths are relative to the directory from which doxygen is
 # run.
 
-EXCLUDE                =
+EXCLUDE                = *pltotex.pl
 
 # The EXCLUDE_SYMLINKS tag can be used to select whether or not files or
 # directories that are symbolic links (a Unix file system feature) are excluded
@@ -963,7 +964,7 @@ FILTER_SOURCE_PATTERNS =
 # (index.html). This can be useful if you have a project on for instance GitHub
 # and want to reuse the introduction page also for the doxygen output.
 
-USE_MDFILE_AS_MAINPAGE = NO
+USE_MDFILE_AS_MAINPAGE = docs/yap.md
 
 #---------------------------------------------------------------------------
 # Configuration options related to source browsing
@@ -989,19 +990,19 @@ INLINE_SOURCES         = YES
 # Fortran comments will always remain visible.
 # The default value is: YES.
 
-STRIP_CODE_COMMENTS    = YES
+STRIP_CODE_COMMENTS    = NO
 
 # If the REFERENCED_BY_RELATION tag is set to YES then for each documented
 # function all documented functions referencing it will be listed.
 # The default value is: NO.
 
-REFERENCED_BY_RELATION = NO
+REFERENCED_BY_RELATION = YES
 
 # If the REFERENCES_RELATION tag is set to YES then for each documented function
 # all documented entities called/used by that function will be listed.
 # The default value is: NO.
 
-REFERENCES_RELATION    = NO
+REFERENCES_RELATION    = YES
 
 # If the REFERENCES_LINK_SOURCE tag is set to YES and SOURCE_BROWSER tag is set
 # to YES, then the hyperlinks from functions in REFERENCES_RELATION and
@@ -2100,7 +2101,7 @@ PERL_PATH              = /usr/bin/perl
 # powerful graphs.
 # The default value is: YES.
 
-CLASS_DIAGRAMS         = NO
+CLASS_DIAGRAMS         = YES
 
 # You can define message sequence charts within doxygen comments using the \msc
 # command. Doxygen will then run the mscgen tool (see:

docs/yap.tex

@@ -9761,6 +9761,15 @@ this is possible, @var{Goal} will become invalid after executing
   YAP_RecoverSlots(1);
   if (out == 0) return FALSE;
 @end example
+
+@ifplaintext
+
+@copydoc real
+
+@end ifplaintext
+
+@texinfo
+
 Slots are safe houses in the stack, the garbage collector and the stack
 shifter know about them and make sure they have correct values. In this
 case, we use a slot to preserve @var{t} during the execution of
@@ -9807,6 +9816,8 @@ Set the first @var{HowMany} arguments to the @var{HowMany} slots
 starting at @var{slot}.
 @end table
 
+@end texinfo
+
 The following functions complement @var{YAP_RunGoal}:
 @table @code
 @item  @code{int} YAP_RestartGoal(@code{void})
@@ -9815,7 +9826,7 @@ Look for the next solution to the current query by forcing YAP to
 backtrack to the latest goal. Notice that slots allocated since the last
 @code{YAP_RunGoal} will become invalid.
 
-@item  @code{int} YAP_Reset(@code{void})
+@Item  @code{int} YAP_Reset(@code{void})
 @findex YAP_Reset (C-Interface function)
 Reset execution environment (similar to the @code{abort/0}
 built-in). This is useful when you want to start a new query before