]> git.droids-corp.org - protos/libecoli.git/commitdiff
update documentation
authorOlivier Matz <zer0@droids-corp.org>
Fri, 21 Feb 2020 20:47:48 +0000 (21:47 +0100)
committerOlivier Matz <zer0@droids-corp.org>
Fri, 21 Feb 2020 20:47:48 +0000 (21:47 +0100)
doc/architecture.rst
doc/meson.build

index 274873de4a67920b9dc678cb87fde57562fd6d3a..6c524f76563228881d7cc21f460dd5a3799d4109 100644 (file)
@@ -17,16 +17,17 @@ parts:
   *libecoli*.
 - utilities: logging, string, strings vector, hash table, ...
 
-The grammar tree
-----------------
+The grammar graph
+-----------------
 
-The *ecoli nodes* are organized in a tree. An *ecoli grammar tree*
+The *ecoli nodes* are organized in a graph. Actually, it is mostly a
+tree, but loops are allowed in some cases. An *ecoli grammar tree*
 describes how the input is parsed and completed. Let's take a simple
 example:
 
 .. figure:: simple-tree.svg
 
-   A simple *ecoli grammar tree*.
+   A simple *ecoli grammar graph*.
 
 We can also represent it as text like this::
 
@@ -85,7 +86,7 @@ Let's take another simple example.
 
 .. figure:: simple-tree2.svg
 
-   Another simple *ecoli grammar tree*.
+   Another simple *ecoli grammar graph*.
 
 In that case, there is no lexer (the *sh_lex* node), so the input must
 be a string vector that is already split. For instance, it matches:
@@ -101,7 +102,7 @@ But it does **not** match:
 - ``[]`` (empty vector)
 
 At the time the input is parsed, a *parse tree* is built. When it
-matches, it describes which part of the *ecoli grammar tree* that
+matches, it describes which part of the *ecoli grammar graph* that
 actually matched, and what input matched for each node.
 
 Passing ``["bar", "1"]`` to the previous tree would result in the
@@ -111,7 +112,7 @@ following *parse tree*:
 
    The *ecoli parse tree*, result of parsing.
 
-Each node of the *parse tree* references the node of the *grammar tree*
+Each node of the *parse tree* references the node of the *grammar graph*
 that matched. It also stores the string vector that matched.
 
 .. figure:: parse-tree2.svg
@@ -126,7 +127,7 @@ following example:
 
 .. figure:: simple-tree3.svg
 
-   A simple *ecoli grammar tree*, that matches ``[]``, ``[foo]``,
+   A simple *ecoli grammar graph*, that matches ``[]``, ``[foo]``,
    ``[foo, foo]``, ...
 
 Here is the resulting *parse tree* when the input vector is ``[foo, foo,
@@ -151,3 +152,4 @@ Todo
 - params are consumed
 - nodes
 - attributes
+- extending lib with external nodes (in dev guide?)
index a6c70283c1b0c36310334402d47e60effe2c3c2b..a58e4a522d2e75049d4275a7ed1df06152c4df09 100644 (file)
@@ -3,33 +3,32 @@
 
 doc_install_dir = join_paths('share', 'doc', 'libecoli')
 
-doxygen = find_program('doxygen', required : false)
-if not doxygen.found()
-  error('MESON_SKIP_TEST doxygen not found.')
-endif
-
 cdata = configuration_data()
 cdata.set('VERSION', meson.project_version())
 cdata.set('OUTPUT', join_paths(meson.build_root(), 'doc', 'api'))
 cdata.set('TOPDIR', meson.source_root())
 
-doxygen_conf = configure_file(
-  input: 'Doxyfile.in',
-  output: 'Doxyfile',
-  configuration: cdata,
-  install: false)
-
-doxygen_build = custom_target(
-  'doxygen',
-  input: doxygen_conf,
-  output: 'api',
-  command: [doxygen, '@INPUT@', '@OUTPUT@'],
-  build_by_default: true,
-  install_dir: doc_install_dir)
+doxygen = find_program('doxygen',
+       required : get_option('build_doc'))
 
 sphinx_build = find_program(
   'sphinx-build', required: get_option('build_doc'))
-if get_option('build_doc') and sphinx_build.found()
+
+if get_option('build_doc')
+       doxygen_conf = configure_file(
+         input: 'Doxyfile.in',
+         output: 'Doxyfile',
+         configuration: cdata,
+         install: false)
+
+       doxygen_build = custom_target(
+         'doxygen',
+         input: doxygen_conf,
+         output: 'api',
+         command: [doxygen, '@INPUT@', '@OUTPUT@'],
+         build_by_default: true,
+         install_dir: doc_install_dir)
+
        html_doc = custom_target('html_doc',
                input: meson.current_source_dir(),
                output: 'html_doc',