From: Ian Jackson Date: Tue, 8 Jun 2021 11:21:58 +0000 (+0100) Subject: specs docs: Improvements X-Git-Tag: otter-0.7.0~33 X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=commitdiff_plain;h=e1f8d5b07a9191f12c3aad4e086ed4b0d52817ff;p=otter.git specs docs: Improvements Signed-off-by: Ian Jackson --- 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.