aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorchriseth <chris@ethereum.org>2018-03-06 16:28:53 +0800
committerGitHub <noreply@github.com>2018-03-06 16:28:53 +0800
commit5f5af650ce5ad28179b037b0b7301b6ca7e87364 (patch)
tree7750a0f5c54916b44b5b4bb4dca9ef722095ab6c
parentf6c0daec14a047d753c2e501c500995bc7e6dc54 (diff)
parent154fd1d6cbfb7fc954b78e82831c8cdf50a51657 (diff)
downloaddexon-solidity-5f5af650ce5ad28179b037b0b7301b6ca7e87364.tar.gz
dexon-solidity-5f5af650ce5ad28179b037b0b7301b6ca7e87364.tar.zst
dexon-solidity-5f5af650ce5ad28179b037b0b7301b6ca7e87364.zip
Merge pull request #3653 from ethereum/docNegativeSourceIndex
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: