From 154fd1d6cbfb7fc954b78e82831c8cdf50a51657 Mon Sep 17 00:00:00 2001 From: Daniel Kirchner Date: Tue, 6 Mar 2018 00:59:34 +0100 Subject: Document the meaning of sourceIndex "-1" in source mappings. --- docs/miscellaneous.rst | 5 +++++ 1 file changed, 5 insertions(+) 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: -- cgit