aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDaniel Kirchner <daniel@ekpyron.org>2018-03-06 07:59:34 +0800
committerDaniel Kirchner <daniel@ekpyron.org>2018-03-06 09:05:35 +0800
commit154fd1d6cbfb7fc954b78e82831c8cdf50a51657 (patch)
tree66b59f606b70e677c5dc87e537657fd83b48d05a
parent41ea502f0e4c67339c4954ba0008a945ba110e87 (diff)
downloaddexon-solidity-154fd1d6cbfb7fc954b78e82831c8cdf50a51657.tar.gz
dexon-solidity-154fd1d6cbfb7fc954b78e82831c8cdf50a51657.tar.zst
dexon-solidity-154fd1d6cbfb7fc954b78e82831c8cdf50a51657.zip
Document the meaning of sourceIndex "-1" in source mappings.
-rw-r--r--docs/miscellaneous.rst5
1 files changed, 5 insertions, 0 deletions
diff --git a/docs/miscellaneous.rst b/docs/miscellaneous.rst
index 7d3d058b..075b6be0 100644
--- a/docs/miscellaneous.rst
+++ b/docs/miscellaneous.rst
@@ -192,6 +192,11 @@ These are regular array indices into a list of source files usually called
``"sourceList"``, which is part of the combined-json and the output of
the json / npm compiler.
+.. note ::
+ In the case of instructions that are not associated with any particular source file,
+ the source mapping assigns an integer identifier of ``-1``. This may happen for
+ bytecode sections stemming from compiler-generated inline assembly statements.
+
The source mappings inside the AST use the following
notation: