From 50cdb5d614f1b70a17db1c5243e7970672fd3e47 Mon Sep 17 00:00:00 2001 From: Martin Atkins Date: Sun, 26 Aug 2018 10:28:03 -0700 Subject: [PATCH] guide: Stub out some more of the overall guide outline --- guide/go.rst | 3 +++ guide/go_decoding_gohcl.rst | 2 +- guide/go_decoding_hcldec.rst | 2 +- guide/go_decoding_lowlevel.rst | 5 +++++ guide/go_expression_eval.rst | 5 +++++ guide/go_patterns.rst | 2 ++ guide/index.rst | 1 + guide/language_design.rst | 3 +++ 8 files changed, 21 insertions(+), 2 deletions(-) create mode 100644 guide/go_decoding_lowlevel.rst create mode 100644 guide/go_expression_eval.rst create mode 100644 guide/go_patterns.rst create mode 100644 guide/language_design.rst diff --git a/guide/go.rst b/guide/go.rst index d0c6c7e..bd6cef1 100644 --- a/guide/go.rst +++ b/guide/go.rst @@ -24,5 +24,8 @@ a Go program. go_diagnostics go_decoding_gohcl go_decoding_hcldec + go_expression_eval + go_decoding_lowlevel + go_patterns .. _Go: https://golang.org/ diff --git a/guide/go_decoding_gohcl.rst b/guide/go_decoding_gohcl.rst index 02e87ce..1a0d6e7 100644 --- a/guide/go_decoding_gohcl.rst +++ b/guide/go_decoding_gohcl.rst @@ -67,7 +67,7 @@ The second argument to ``gohcl.DecodeBody``, shown as ``nil`` in the previous example, allows the calling application to additionally offer variables and functions for use in expressions. Its value is a pointer to an ``hcl.EvalContext``, which will be covered in more detail in the later section -:ref:`expression-eval`. For now, a simple example of making the id of the +:ref:`go-expression-eval`. For now, a simple example of making the id of the current process available as a single variable called ``pid``: .. code-block:: go diff --git a/guide/go_decoding_hcldec.rst b/guide/go_decoding_hcldec.rst index c0c4f64..dbc2bca 100644 --- a/guide/go_decoding_hcldec.rst +++ b/guide/go_decoding_hcldec.rst @@ -223,7 +223,7 @@ just as with ``gohcl.DecodeBlock``. This object can be constructed using :ref:`the gohcl helper function ` as before if desired, but you can also choose to work directly with :go:type:`hcl.EvalContext` as -discussed in :ref:`expression-eval`: +discussed in :ref:`go-expression-eval`: .. code-block:: go diff --git a/guide/go_decoding_lowlevel.rst b/guide/go_decoding_lowlevel.rst new file mode 100644 index 0000000..34dc2d1 --- /dev/null +++ b/guide/go_decoding_lowlevel.rst @@ -0,0 +1,5 @@ +.. _go-decoding-lowlevel: + +Advanced Decoding With The Low-level API +======================================== + diff --git a/guide/go_expression_eval.rst b/guide/go_expression_eval.rst new file mode 100644 index 0000000..02a7df7 --- /dev/null +++ b/guide/go_expression_eval.rst @@ -0,0 +1,5 @@ +.. _go-expression-eval: + +Expression Evaluation +===================== + diff --git a/guide/go_patterns.rst b/guide/go_patterns.rst new file mode 100644 index 0000000..ecddd6c --- /dev/null +++ b/guide/go_patterns.rst @@ -0,0 +1,2 @@ +Design Patterns for Complex Systems +=================================== diff --git a/guide/index.rst b/guide/index.rst index 763e011..67ab2ad 100644 --- a/guide/index.rst +++ b/guide/index.rst @@ -28,6 +28,7 @@ via its library API. intro go + language_design .. _libucl: https://github.com/vstakhov/libucl .. _`nginx configuration`: http://nginx.org/en/docs/beginners_guide.html#conf_structure diff --git a/guide/language_design.rst b/guide/language_design.rst new file mode 100644 index 0000000..dc01a75 --- /dev/null +++ b/guide/language_design.rst @@ -0,0 +1,3 @@ +Configuration Language Design +============================= +