cerc-io/solidity
10
0
Fork 0
mirror of https://github.com/ethereum/solidity synced 2023-10-03 13:03:40 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Change layout and include API, Input, Output sections

Browse Source
This commit is contained in:
Alex Beregszaszi 2017-02-02 20:52:59 +00:00
parent cbb668672f
commit d46ec20f88
1 changed files with 17 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
docs/using-the-compiler.rst
View File

@ -1,8 +1,11 @@
******************
Using the compiler
******************
.. index:: ! commandline compiler, compiler;commandline, ! solc, ! linker .. index:: ! commandline compiler, compiler;commandline, ! solc, ! linker
.. _commandline-compiler: .. _commandline-compiler:
******************************
Using the Commandline Compiler Using the Commandline Compiler
****************************** ******************************
@ -32,23 +35,26 @@ Either add ``--libraries "Math:0x12345678901234567890 Heap:0xabcdef0123456"`` to
If ``solc`` is called with the option ``--link``, all input files are interpreted to be unlinked binaries (hex-encoded) in the ``__LibraryName____``-format given above and are linked in-place (if the input is read from stdin, it is written to stdout). All options except ``--libraries`` are ignored (including ``-o``) in this case. If ``solc`` is called with the option ``--link``, all input files are interpreted to be unlinked binaries (hex-encoded) in the ``__LibraryName____``-format given above and are linked in-place (if the input is read from stdin, it is written to stdout). All options except ``--libraries`` are ignored (including ``-o``) in this case.
.. _compiler-api:
***************************************** Using the Compiler API
Standardized Input and Output Description **********************
*****************************************
The compiler API expects a JSON formatted input and outputs the compilations result in a JSON formatted output. The compiler API expects a JSON formatted input and outputs the compilations result in a JSON formatted output.
TBD
Compiler Input and Output JSON Description
******************************************
These JSON formats are used by the compiler API as well as are available through ``solc``. These are subject to change,
some fields are optional (as noted), but it is aimed at to only make backwards compatible changes.
Comments are of course not permitted and used here only for explanatory purposes. Comments are of course not permitted and used here only for explanatory purposes.
Input Description Input Description
----------------- -----------------
QUESTION: How to specific file-reading callback? - probably not as part of json input
The input description is language-specific and could change with each compiler version, but it
should be backwards compatible if possible.
.. code-block:: none .. code-block:: none
{ {
@ -150,8 +156,8 @@ should be backwards compatible if possible.
} }
Regular Output Output Description
-------------- ------------------
.. code-block:: none .. code-block:: none