From e1f8d5b07a9191f12c3aad4e086ed4b0d52817ff Mon Sep 17 00:00:00 2001 From: Ian Jackson Date: Tue, 8 Jun 2021 12:21:58 +0100 Subject: [PATCH] specs docs: Improvements Signed-off-by: Ian Jackson --- docs/gamespec.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/gamespec.rst b/docs/gamespec.rst index a8d11714..9e6303e5 100644 --- a/docs/gamespec.rst +++ b/docs/gamespec.rst @@ -54,9 +54,11 @@ macros are automatically imported and can be called with ``{[ m::MACRO...}}``. And enough blank lines are added to make the input line numbers match up with the lines in the notional ``spec`` file. +Note that line numbers reported during TOML parsing +refer to lines in the template-expanded output. To help diagnose your templates, ``otter -vv reset ...`` will expand the templates itself and print out the results of the file splitting, -and then of the expansion. +and then of the expansion, before sending the file to the server. For details of the template syntax, see `the Tera documentation`_. For examples, see the built-in game specs. -- 2.30.2