From 47458427c9a8e1bded36d5eb803153adf6ace0d2 Mon Sep 17 00:00:00 2001
From: Even Rouault <even.rouault@spatialys.com>
Date: Sun, 19 Apr 2020 17:30:24 +0200
Subject: gie: implement a strict mode with <gie-strict> </gie-strict> (fixes
 #2158)

In that mode:
* All non-comment/decoration lines must start with a valid tag
* Commands split on several lines should be terminated with " \"
---
 docs/source/apps/gie.rst | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)

(limited to 'docs/source')

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
 **********
 
-- 
cgit v1.2.3