fixup! Update docs

Author: matheusaaguiar

docs/090-breaking-changes.rst

@@ -0,0 +1,29 @@
+********************************
+Solidity v0.5.0 Breaking Changes
+********************************
+
+This section highlights the main breaking changes introduced in Solidity
+version 0.9.0, along with the reasoning behind the changes and how to update
+affected code.
+For the full list check
+`the release changelog <https://github.com/argotorg/solidity/releases/tag/v0.9.0>`_.
+
+Changes to the Syntax
+=================
+
+* The ``send`` and ``transfer`` member functions of ``address`` are deprecated and will be removed.
+  They should be replaced by the :ref:`call function <address_related>` with an optionally provided maximum amount
+  of gas (default forwards all remaining gas) and an empty calldata parameter, e.g., ``call{value: amount}("")``.
+
+* The ABI coder v1 is deprecated and will be removed.
+  The old behavior will not be available anymore and using ``pragma abicoder v1;`` will result in a syntax error.
+
+* ``virtual`` modifiers are deprecated and no longer available starting with v.0.9.0.
+
+* The ``memory-safe-assembly`` special comment is deprecated and will be removed.
+  For new code targeting recent compilers, prefer specifying the dialect string.
+
+* Comparison of variables of contract type is deprecated and will not be allowed anymore starting with v.0.9.0.
+
+
+

docs/assembly.rst

@@ -384,7 +384,7 @@ of Solidity, you can use a special comment to annotate an assembly block as memo
 .. warning::
     The ``memory-safe-assembly`` special comment is deprecated and scheduled for
     removal in the next breaking version (0.9).
-    For new code targeting recent compilers, prefer specifying the dialect string.
+    For new code targeting recent compilers, prefer specifying the assembly block annotation.
 
 Advanced Safe Use of Memory
 ---------------------------

docs/contracts/functions.rst

@@ -310,6 +310,11 @@ will consume more gas than the 2300 gas stipend:
 - Calling an external function which consumes a large amount of gas
 - Sending Ether
 
+.. warning::
+    Note that ``send`` and ``transfer`` are deprecated and scheduled for removal in the next breaking version (0.9).
+    You are encouraged to use the :ref:`call function <address_related>` with an optionally provided maximum
+    amount of gas (default forwards all remaining gas) and an empty calldata parameter, e.g., ``call{value: amount}("")``.
+
 .. warning::
     When Ether is sent directly to a contract (without a function call, i.e. sender uses ``send`` or ``transfer``)
     but the receiving contract does not define a receive Ether function or a payable fallback function,
@@ -319,11 +324,6 @@ will consume more gas than the 2300 gas stipend:
     not recommended, since the fallback is invoked and would not fail for interface confusions
     on the part of the sender).
 
-.. warning::
-    Note that ``send`` and ``transfer`` are deprecated and scheduled for removal in the next breaking version (0.9).
-    You are encouraged to use the :ref:`call function <address_related>` with an optionally provided maximum
-    amount of gas (default forwards all remaining gas) and an empty calldata parameter, e.g., ``call{value: amount}("")``.
-
 .. warning::
     A contract without a receive Ether function can receive Ether as a
     recipient of a *coinbase transaction* (aka *miner block reward*)