Merge remote-tracking branch 'origin/develop' into HEAD

docs/using-the-compiler.rst

@@ -314,6 +314,7 @@ Input Description
         //   evm.bytecode.opcodes - Opcodes list
         //   evm.bytecode.sourceMap - Source mapping (useful for debugging)
         //   evm.bytecode.linkReferences - Link references (if unlinked object)
+        //   evm.bytecode.generatedSources - Sources generated by the compiler
         //   evm.deployedBytecode* - Deployed bytecode (has all the options that evm.bytecode has)
         //   evm.deployedBytecode.immutableReferences - Map from AST ids to bytecode ranges that reference immutables
         //   evm.methodIdentifiers - The list of function hashes
@@ -427,6 +428,18 @@ Output Description
                 "opcodes": "",
                 // The source mapping as a string. See the source mapping definition.
                 "sourceMap": "",
+                // Array of sources generated by the compiler. Currently only
+                // contains a single Yul file.
+                "generatedSources": [{
+                  // Yul AST
+                  "ast": { ... }
+                  // Source file in its text form (may contain comments)
+                  "contents":"{ function abi_decode(start, end) -> data { data := calldataload(start) } }",
+                  // Source file ID, used for source references, same "namespace" as the Solidity source files
+                  "id": 2,
+                  "language": "Yul",
+                  "name": "#utility.yul"
+                }]
                 // If given, this is an unlinked object.
                 "linkReferences": {
                   "libraryFile.sol": {
@@ -693,8 +706,8 @@ have to be updated manually.)
 
 .. code-block:: Solidity
 
-    pragma solidity >0.6.99 <0.9.0;
     // SPDX-License-Identifier: GPL-3.0
+    pragma solidity >=0.7.0 <0.9.0;
     abstract contract C {
         // FIXME: remove constructor visibility and make the contract abstract
         constructor() {}