Merge pull request #2168 from rouault/gie_strict_mode

gie: implement a strict mode with <gie-strict> </gie-strict> (fixes #2158)

1 files changed, 27 insertions, 0 deletions

diff --git a/docs/source/apps/gie.rst b/docs/source/apps/gie.rst
index af6f528e..a1c7cb56 100644
--- a/docs/source/apps/gie.rst
+++ b/docs/source/apps/gie.rst
@@ -324,6 +324,33 @@ gie command language
         expect  0   110579.9
         </gie>
 
+
+Strict mode
+***********
+
+.. versionadded:: 7.1
+
+A stricter variant of normal gie syntax can be used by wrapping gie commands
+between ``<gie-strict>`` and ``</gie-strict>``. In strict mode, comment lines
+must start with a sharp character. Unknown commands will be considered as an error.
+A command can still be split on several lines, but intermediate lines must
+end with the space character followed by backslash to mark the continuation.
+
+    .. code-block:: console
+
+        <gie-strict>
+        # This is a comment. The following line with multiple repeated characters too
+        -------------------------------------------------
+        # A command on several lines must use " \" continuation
+        operation proj=hgridshift +grids=nzgd2kgrid0005.gsb \
+                  ellps=GRS80
+        tolerance 1 mm
+        ignore    pjd_err_failed_to_load_grid
+        accept    172.999892181021551 -45.001620431954613
+        expect    173                 -45
+        </gie-strict>
+
+
 Background
 **********