Commit Graph

1260 Commits

Author SHA1 Message Date
chriseth
3793aa405b
Merge pull request #3643 from ethereum/gasleft
Move msg.gas to global function gasleft(). Closes #2971.
2018-03-05 20:11:37 +01:00
Daniel Kirchner
b8589fbe0f Use msg.value and gasleft() as an example in the docs. 2018-03-05 16:59:33 +01:00
chriseth
6dc137317f
Merge pull request #3569 from ethereum/evmVersion
EVM version
2018-03-05 12:10:49 +01:00
Daniel Kirchner
c633c0eacb Move msg.gas to global function gasleft(). Closes #2971. 2018-03-05 11:18:04 +01:00
Furkan Ayhan
c2730a4893
Correct warning message in Pure Functions doc
wrong commit that caused this: (64eaff6420 (diff-754689a291c0a19b500c31eb6c1d30c7R506))
2018-03-04 13:23:07 +03:00
bernard peh
cde4e3172b change the language so that it doesn't sound like send and transfer is providing the stipend 2018-03-02 23:40:17 +11:00
chriseth
66ee9aa2f1 Use 0.4.21 pragma for documentation that uses "emit". 2018-03-02 12:29:48 +01:00
bernard peh
2c086cb90b clarify 2300 gas stipend in fallback function section 2018-03-02 16:25:52 +11:00
chriseth
1246917e32 Explain json-io setting. 2018-03-01 17:19:35 +01:00
Elena Dimitrova
c9840c98f4 Documentation updates for internal constructors and function signature (#3365)
* Add a note explaining return values not included in function signature

* Add section on Constructors in documentation

* Improve documented definition for abstract contract

* Add benefits of abstraction to documentation
2018-03-01 16:59:47 +01:00
Oleksii Matiiasevych
a0d006015e Update Tips and Tricks on structs initialization. (#3626)
* Update Tips and Tricks on structs initialization.
2018-03-01 16:54:04 +01:00
chriseth
cf6720eab5
Merge pull request #3587 from OTTTO/develop
Multiline output parameters and return statements
2018-03-01 12:07:09 +01:00
Jordi Baylina
4f34d092ca
Update miscellaneous.rst 2018-02-28 09:35:07 +01:00
chriseth
908b46e9a7
Merge pull request #3476 from ethereum/scoping
C99/C++ scoping rules
2018-02-27 17:06:10 +01:00
Alex Beregszaszi
317e017849 Shift operands were swapped in accepted EIP145 2018-02-27 13:43:02 +01:00
Alex Beregszaszi
afa4a48e37 Remove ROL/ROR as they are not part of EIP145 anymore 2018-02-27 13:42:41 +01:00
Alex Beregszaszi
9e0446a22c Document bitwise shift operators in assembly 2018-02-27 13:42:28 +01:00
chriseth
6391a36a6c Documentation about new scoping rules. 2018-02-27 12:41:32 +01:00
Alex Beregszaszi
aeb75172d5 Fix builtin function formatting in julia 2018-02-27 11:16:12 +01:00
Alex Beregszaszi
8cebfb168b Introduce VM version ('hard fork') column for assembly opcodes 2018-02-27 11:16:12 +01:00
Alex Beregszaszi
e424bd1007 Fix some keyword highlighting in docs 2018-02-27 11:12:10 +01:00
Dax Bondye
e34d367593 Multiline output parameters and return statements 2018-02-26 19:32:55 -08:00
Alex Beregszaszi
3594f02d51 Fix link to solcjs in the installation section 2018-02-27 00:38:52 +01:00
Alex Beregszaszi
241134a881 Mention that solcjs is not compatible with solc in the using-the-compiler section 2018-02-27 00:36:01 +01:00
chriseth
1f5eb4ba59
Merge pull request #3335 from nisdas/ballot-contract
Fixes the errors in the sample ballot contract
2018-02-27 00:17:46 +01:00
wbt
92fe9e621e Note deprecation of constant keyword on functions 2018-02-27 00:08:17 +01:00
chriseth
098033c94a Fix name shadowing in ballot example contract. 2018-02-27 00:02:39 +01:00
Alex Beregszaszi
64eaff6420 Random documentation updates (assembly, faq) 2018-02-26 20:19:26 +01:00
Aaron Colaço
ef7fbf8d0c Fix example; closes #3582 2018-02-24 00:09:49 +05:30
Hongbin Zuo
02307235c5 add in progress 2018-02-23 16:44:05 +08:00
Hongbin Zuo
fc3473b282 Why you made this change:
Talked with Chris and Matt, in order to develop stronger ethereum community in China, we decided to initiate the activity to translate Solidity documentation into Simplified Chinese version. We have invited over 10 experienced translators as a team to contribute on this effort.

What you did:
I finished translation of index.rst into Simplified Chinese and wanted it to be added into main doc index.
2018-02-23 15:06:14 +08:00
chriseth
2b62c201be
Merge pull request #3538 from ethereum/emitEvents
emit pseudo-keyword for events.
2018-02-22 22:42:04 +01:00
chriseth
97d1c70491
Merge pull request #3575 from OTTTO/develop
Recommend to explicitly label the visibility of functions.
2018-02-22 22:41:29 +01:00
Dax Bondye
2ac49b3c2d Reccomend to explicitly label the visibility of functions. 2018-02-22 10:23:20 -08:00
chriseth
71a34abd87
Merge pull request #3513 from OTTTO/develop
Add "Maximum Line Length" section
2018-02-22 16:12:49 +01:00
DYLAN BECKWITH
187e50b14c Recommend consistent style for wrapping long lines. 2018-02-22 07:01:07 -08:00
chriseth
7d87aed5d0
Merge pull request #3552 from ethereum/chriseth-patch-1
ABI: Clarify padding direction.
2018-02-22 15:32:18 +01:00
chriseth
2ada9683dd
Use the term "trailing zero-bytes". 2018-02-22 15:24:14 +01:00
chriseth
f58024b974 Documentation about emitting events. 2018-02-22 15:17:42 +01:00
chriseth
388718b59f Introduce emit statement. 2018-02-22 15:17:30 +01:00
mirgj
d01786f0aa
Update solidity-by-example.rst
highestBidder is the address.
it's highestBid that should be != 0 to be considered as pending return.

It's that right?
2018-02-22 01:42:57 +08:00
chriseth
20d8254029
Merge pull request #3427 from duaraghav8/patch-3
Abstract Contracts: Add note about function type
2018-02-21 18:04:35 +01:00
chriseth
29d40ad42a
Clarify padding direction. 2018-02-20 12:19:19 +01:00
chriseth
2a58b44b8b
Merge pull request #3543 from medvedev1088/feature/add-gas-details-to-documentation
Add gas forwarding details to address related functions in documentation
2018-02-19 23:16:36 +01:00
William Entriken
360009c376
Typo 2018-02-19 15:38:55 -05:00
Evgeny Medvedev
bce545c990 Add adjustable/no adjustable gas details to address related functions in units-and-global-variables.rst 2018-02-20 02:06:42 +07:00
chriseth
59f5a31376
Merge pull request #3357 from federicobond/improve-asm-grammar
docs: Improve assembly grammar definition
2018-02-19 19:30:54 +01:00
chriseth
09887de266
Fix link. 2018-02-19 19:02:49 +01:00
chriseth
39f09a90f0
Merge pull request #3448 from fulldecent/patch-8
Clarify name documentation for mixedCase
2018-02-19 18:59:50 +01:00
chriseth
a938e39a9d
Merge pull request #3182 from janat08/patch-2
Update introduction-to-smart-contracts.rst
2018-02-19 16:52:45 +01:00
chriseth
2b23d02c83
Update introduction-to-smart-contracts.rst 2018-02-19 16:52:37 +01:00
Evgeny Medvedev
bfcf4a86c3 Add gas forwarding details to address related functions in units-and-global-variables.rst 2018-02-18 23:43:09 +07:00
chriseth
2b5a5a8669 Make addmod and mulmod revert if the last argument is zero. 2018-02-15 13:52:17 +01:00
Alexandre Bezroutchko
3804f29a8d fix a typo 2018-02-14 09:49:06 +01:00
chriseth
fccede62ce Prepare 0.4.20 release. 2018-02-13 17:17:46 +01:00
chriseth
01ba8b7e1f
Remind authors of best practices. 2018-02-01 17:13:46 +01:00
William Entriken
5497a85158
Clarify name documentation for mixedCase 2018-01-29 14:45:36 -05:00
William Entriken
b517ebb8bc
Fix new Solidity warnings, for #3379 2018-01-29 10:26:07 -05:00
chriseth
bd3692f1e6
Merge pull request #3431 from fulldecent/patch-7
Add mutability declaration to example, for #3379
2018-01-29 13:44:43 +01:00
William Entriken
1cc31bacef
Remove useless self assignment 2018-01-28 17:41:09 -05:00
YuShuangqi
0ef43978fd
update types
correct the mistakes in writings
2018-01-27 07:36:25 +08:00
chriseth
9028610b45
Merge pull request #3424 from wbt/addDecompilerLink
Correct FAQ answer re: decompiler
2018-01-26 19:22:15 +01:00
wbt
efcc8efffa
Respond to chriseth's suggestions
https://github.com/ethereum/solidity/pull/3424#pullrequestreview-90873869
2018-01-26 13:15:22 -05:00
hyperfekt
b4fb7255dd
fixes ethereum/solidity#1209
This clears up a common and easy misunderstanding which seems to occur rather often.
(https://ethereum.stackexchange.com/questions/8263/trying-to-understand-libraries)
2018-01-26 15:32:11 +01:00
chriseth
e7afde9587
Merge pull request #3203 from ethereum/nocall
Prevent libraries from being called.
2018-01-25 16:45:54 +01:00
ZoOgY-DoOgY
4f753233f7
Inheritance, "super" and DDD
As explained in "Multiple Inheritance and Linearization" part, "a simple rule to remember is to specify the base classes in the order from “most base-like” to “most derived”". So "contract Final is Base1, Base2" means Final is derived from Base2, derived from Base1, so the final inheritance sequence should be, starting with the most derived contract : Final, Base2, Base1, mortal, owned.
2018-01-24 13:38:47 +01:00
William Entriken
053e634276
Add mutability declaration to example, for #3379 2018-01-23 21:52:58 -05:00
Raghav Dua
694fc6835f
correct terminology 2018-01-23 23:43:04 +05:30
Raghav Dua
18539e5353
Abstract Contracts: Add note about function type 2018-01-23 23:23:18 +05:30
Maurelian
31aaf4336a Add comment to clarify example (#3415)
* Add comment to clarify example

* Reverse bases.
2018-01-23 18:14:56 +01:00
chriseth
b24de1c29c
Some more clarifications. 2018-01-23 17:53:13 +01:00
wbt
a396572f57
Update FAQ answer re decompiler 2018-01-23 09:53:00 -05:00
Li Xuanji
d555c82db4
clarify address in function selector
I found that the canonical form for `address` in computing the function selector calldata tag is `uint160`. Update the abi specs to explicitly mention this.
2018-01-22 17:34:58 -05:00
Sawyer
530b47a01b
Update using-the-compiler.rst
in outputSelection section of Compiler Input and Output JSON Description:
"evm.sourceMap" should be "evm.bytecode.sourceMap"
"evm.opcodes"  should be "evm.bytecode.opcodes"
2018-01-21 16:35:59 +08:00
chriseth
f7315d19bd Document call protector. 2018-01-19 16:52:23 +01:00
Raghav Dua
95bafbc4e0
update solium description 2018-01-18 16:32:46 +05:30
wbt
1948b9687f
Case convention clarification
Constructors follow the contract naming convention, using CapWords, instead of mixedCase.
2018-01-16 13:08:20 -05:00
chriseth
14fcbd659f
Merge pull request #3393 from fulldecent/patch-5
Use CapWords style for example
2018-01-15 10:55:11 +01:00
William Entriken
b1d99587e0
Use CapWords style for example
Follows recommendation in https://github.com/ethereum/solidity/pull/3392
2018-01-14 13:56:02 -05:00
William Entriken
cb5758aa75
Prefer CapWords style struct names 2018-01-14 13:53:45 -05:00
William Entriken
deeee06bc2
Fix links and JS reference 2018-01-10 20:43:38 -05:00
William Entriken
c7632fc732
No nonsense explanation of compiler options 2018-01-05 10:13:33 -05:00
chriseth
6a9a4e2bb8
Explain the difference to inline assembly. 2018-01-04 17:19:45 +01:00
Federico Bond
be065a1243 grammar.txt: Add optional storage location to parameters 2018-01-04 01:47:07 -03:00
Federico Bond
088d0e5dc1 docs: Improve assembly grammar definition 2017-12-24 04:30:49 -03:00
Chuck LeDuc Díaz
efc198d515 Minor syntax and formatting changes (#3337)
* Copyediting, mostly syntax.

* Use consistent quote chars inside sample code comments

* Revert to put back matching parenthesis

* Use single backticks for comment code quotes

wherever a reserved word, function or variable name is used in a comment
2017-12-20 10:48:22 +01:00
chriseth
a4b886ad3c
Merge pull request #3345 from kevinwucodes/patch-1
add clarity to destructuring assignments with leading comma
2017-12-19 12:39:28 +01:00
Steve Waldman
75dd416c6e [Docs] Note that events can contain both indexed and unindexed arguments for values of dynamic-length types. 2017-12-19 03:09:13 -08:00
Steve Waldman
bae913368a [Docs] Include explanation of how indexed dynamic-length event args are encoded 2017-12-19 01:51:57 -08:00
Kevin Wu
ddad6a3f80
add clarity to destructuring assignments 2017-12-18 09:55:13 -08:00
Alex Beregszaszi
460c9f3943
Merge pull request #3343 from ethereum/structs-struct
Fix grammar: "structs type" into "struct type"
2017-12-18 14:18:06 +00:00
chriseth
2b19bcf609 Link to dev channel 2017-12-18 13:05:08 +00:00
Yoichi Hirai
d6e73b013f
Fix grammar: "structs type" into "struct type" 2017-12-18 13:31:40 +01:00
Jim McDonald
93cf4dee66 Fixes for failing tests 2017-12-13 07:55:46 +00:00
Jim McDonald
6e521d59b0 Fix Solidity warnings 2017-12-12 18:47:30 +00:00
elenadimitrova
c6a4aba9f0 Document function overloads and resolution 2017-12-12 10:26:58 +02:00
Alex Beregszaszi
40e8716926
Merge pull request #3197 from medvedev1088/fix-security-considerations-example
Add another example with call to demonstrate Re-Entrancy
2017-12-12 04:22:45 +00:00
Alex Beregszaszi
37b06884b2 Correct that ether transfers _can_ always include code execution in re-entrancy example 2017-12-12 03:31:30 +00:00
Evgeny Medvedev
2f6f81640b Add another contract with call to demonstrate re-entrancy vulnerability.
Add another contract with call to demonstrate re-entrancy vulnerability as send explicitly sets gas to 2300 by default according to this commit 9ca7472 which makes it impossible to "get multiple refunds" because a non-zero CALL costs at least 9700 gas. This issue is discussed on Ethereum StackExchange https://ethereum.stackexchange.com/questions/30371/send-ether-reentrancy-attack-in-reality-how-could-fallback-function-make-a-mes/30616#30616
2017-12-12 03:31:00 +00:00
Zhen Zhang
d50e8abefb Document JSON I/O error classes 2017-12-12 03:02:30 +00:00
chriseth
eebeb52aed
Merge pull request #3228 from ethereum/docs-tests-struct
Enable struct abi example with experimental pragma
2017-12-11 14:26:15 +01:00
chriseth
27f38fb5b3
Merge pull request #3281 from GNSPS/develop
Removed manual adjustment of stack of the docs
2017-12-11 12:00:47 +01:00
Kamuela Franco
ef57961711
Update style-guide.rst to include enum style 2017-12-09 14:53:40 +00:00
Gonçalo Sá
ca16099ad0 Removed manual adjustment of stack of the docs
Removed the section fo the docs regarding manual adjustment of the stack given the `unbalanced stack` check prevents its use
2017-12-05 03:20:35 +00:00
Ezra Epstein
29b30a95e9
link to wiki for additional info on napspec 2017-12-01 14:00:44 -05:00
Alex Beregszaszi
134cc73e8e Enable struct abi example with experimental pragma 2017-12-01 16:20:23 +00:00
chriseth
f7538daaf4 Preparation for 0.4.19 release. 2017-11-30 01:23:22 +01:00
Alex Beregszaszi
59bed63dbc Update standard json documentation 2017-11-29 20:10:18 +00:00
wbt
2ebc9953e4
Minor update in contracts
Fix typos and prevent example code from needing horizontal scroll bar
2017-11-29 14:21:21 -05:00
chriseth
a1f59cbb17
Merge pull request #3220 from ethereum/IuliaIf
If statement for Iulia / Inline Assembly
2017-11-27 09:02:46 -05:00
chriseth
1d91b65b72 Force condition to be bool in iulia mode. 2017-11-23 18:52:04 +01:00
chriseth
d0be67f6b0
Bugfix in blind auction 2017-11-23 18:43:19 +01:00
Alex Beregszaszi
dcd55c5005 Add exponential notation to numbers in SolidityLexer 2017-11-23 12:13:00 +00:00
Alex Beregszaszi
2c3c5ad7c9 Move reserved keywords from SolidityLexer 2017-11-23 12:12:34 +00:00
chriseth
e15918d8b6 Add if statement to Julia specification. 2017-11-22 16:25:24 +01:00
chriseth
6dbc34e16e If statement for Iulia / inline assembly. 2017-11-22 16:25:24 +01:00
Alex Beregszaszi
ff229ab05a
Merge pull request #3195 from ethereum/chriseth-patch-1
Tone down similarity to JavaScript.
2017-11-22 13:25:04 +00:00
chriseth
88e1b68aaf More explanation about the packed encoding. 2017-11-22 12:29:16 +00:00
Ezra Epstein
744dea60a4 had "names" when "parameters" was meant 2017-11-22 04:08:35 +00:00
Alex Beregszaszi
23379e1061 Ensure each code snippet in the docs can be extracted for tests 2017-11-22 04:08:35 +00:00
Sami Mäkelä
a4310fec55 avoid reassigning variables 2017-11-22 03:33:08 +00:00
Sami Mäkelä
16f8187166 added Switch specification 2017-11-22 03:33:07 +00:00
chriseth
d4452d8c1f Small fixes
suggested by @mrsmkl
2017-11-22 03:33:07 +00:00
chriseth
c2f2b25064 Some clarifications. 2017-11-22 03:33:07 +00:00
chriseth
5eaef9e87e Typos and clarifications. 2017-11-22 03:33:07 +00:00
chriseth
a67bd2fb6a Include JULIA section in the TOC. 2017-11-22 03:33:07 +00:00
Alex Beregszaszi
72f9e45b1a Add true/false literals 2017-11-22 03:33:07 +00:00
Alex Beregszaszi
980ba42faf Remove from examples 2017-11-22 03:33:06 +00:00
Alex Beregszaszi
0e0de7b7fd Switch cases do not require colon 2017-11-22 03:33:06 +00:00
chriseth
d9abe7b712 Require at least one case in switch 2017-11-22 03:33:06 +00:00
Alex Beregszaszi
e9b08e029e Restriction of switch 2017-11-22 03:33:06 +00:00
Alex Beregszaszi
15ca987048 Include section for Julia objects 2017-11-22 03:33:06 +00:00
Alex Beregszaszi
29502f9d44 Include type names in grammar 2017-11-22 03:33:06 +00:00
Alex Beregszaszi
b2f2b36b7c Remove subassembly 2017-11-22 03:33:05 +00:00
Alex Beregszaszi
be470f107e Support types in grammar 2017-11-22 03:33:05 +00:00
Alex Beregszaszi
0493828916 Clarify literals 2017-11-22 03:33:05 +00:00
Alex Beregszaszi
29da069bf0 Do not require parentheses on function return values 2017-11-22 03:33:05 +00:00
chriseth
ad5cd21571 More specification. 2017-11-22 03:33:05 +00:00
chriseth
f17bdaabda Improve semantics description. 2017-11-22 03:33:04 +00:00
Alex Beregszaszi
e33a9b43ad Include split/combine256 2017-11-22 03:33:04 +00:00
Alex Beregszaszi
aa6f33db2c Use signed/unsigned types in low-level functions 2017-11-22 03:33:04 +00:00
Alex Beregszaszi
0e4d236558 Include implicit type conversions 2017-11-22 03:07:54 +00:00
Alex Beregszaszi
183f70262a Document backends 2017-11-22 03:07:54 +00:00
Alex Beregszaszi
0339cc1bb1 Case is missing from switch statements 2017-11-22 03:07:54 +00:00
Alex Beregszaszi
3d99e82795 Add types to the examples 2017-11-22 03:07:54 +00:00
Alex Beregszaszi
173bdb0df6 Define types in Julia 2017-11-22 03:07:54 +00:00
Alex Beregszaszi
c3a6db7256 Describe built-in Julia functions 2017-11-22 03:07:54 +00:00
Alex Beregszaszi
2a91eb9538 Move Julia documentation to its own file 2017-11-22 03:07:49 +00:00
chriseth
f73660423a First take in formal specification. 2017-11-22 02:45:07 +00:00
chriseth
243002e5f3 Describe Julia. 2017-11-22 02:45:07 +00:00