fixup! Update docs

Author: matheusaaguiar

docs/cheatsheet.rst

@@ -57,9 +57,15 @@ Members of ``address``
 - ``<address payable>.transfer(uint256 amount)``: send given amount of Wei to :ref:`address`, throws on failure
 
 .. warning::
-    ``send`` and ``transfer`` are deprecated and scheduled for removal.
-    Use the :ref:`call function <address_call_functions>` with an optionally provided maximum amount of
-    gas (by default forwards 63/64 of the remaining gas) and an empty calldata parameter, e.g., ``call{value: amount}("")``.
+    `send()` and `transfer()` are deprecated and scheduled for removal.
+    Simple ether transfers can still be performed using the [`call()`](...) function with empty payload, i.e., `call{value: <amount>}("")`.
+    By default this forwards all the remaining gas, subject to additional limits imposed by some EVM versions
+    (such as the [63/64th rule](https://eips.ethereum.org/EIPS/eip-150) introduced by `tangerineWhistle`).
+    As with any external call, the `gas` call option can be used to set a lower limit.
+
+    While it is possible to recreate the functionality by explicitly setting the limit to the value of the stipend (2300 gas),
+    this value no longer holds its original meaning due to changing opcode costs.
+    It is recommended to use different means to protect against reentrancy.
 
 .. index:: blockhash, blobhash, block, block;basefee, block;blobbasefee, block;chainid, block;coinbase, block;difficulty, block;gaslimit, block;number, block;prevrandao, block;timestamp
 .. index:: gasleft, msg;data, msg;sender, msg;sig, msg;value, tx;gasprice, tx;origin

docs/contracts/functions.rst

@@ -311,9 +311,15 @@ will consume more gas than the 2300 gas stipend:
 - Sending Ether
 
 .. warning::
-    ``send`` and ``transfer`` are deprecated and scheduled.
-    Use the :ref:`call function <address_call_functions>` with an optionally provided maximum amount of
-    gas (default forwards all remaining gas) and an empty calldata parameter, e.g., ``call{value: amount}("")``.
+    `send()` and `transfer()` are deprecated and scheduled for removal.
+    Simple ether transfers can still be performed using the [`call()`](...) function with empty payload, i.e., `call{value: <amount>}("")`.
+    By default this forwards all the remaining gas, subject to additional limits imposed by some EVM versions
+    (such as the [63/64th rule](https://eips.ethereum.org/EIPS/eip-150) introduced by `tangerineWhistle`).
+    As with any external call, the `gas` call option can be used to set a lower limit.
+
+    While it is possible to recreate the functionality by explicitly setting the limit to the value of the stipend (2300 gas),
+    this value no longer holds its original meaning due to changing opcode costs.
+    It is recommended to use different means to protect against reentrancy.
 
 .. warning::
     When Ether is sent directly to a contract (without a function call, i.e. sender uses ``send`` or ``transfer``)

docs/security-considerations.rst

@@ -160,8 +160,9 @@ Sending and Receiving Ether
   (for example in the "details" section in Remix).
 
 - There is a way to forward more gas to the receiving contract using ``addr.call{value: x}("")``.
-  This is essentially the same as ``addr.transfer(x)``, only that it forwards all remaining gas
-  and opens up the ability for the recipient to perform more expensive actions
+  This is essentially the same as ``addr.transfer(x)``, only that it forwards all remaining gas,
+  subject to additional limits imposed by some EVM versions (such as the [63/64th rule](https://eips.ethereum.org/EIPS/eip-150)
+  introduced by `tangerineWhistle`), and opens up the ability for the recipient to perform more expensive actions
   (and it returns a failure code instead of automatically propagating the error).
   This might include calling back into the sending contract or other state changes you might not have thought of.
   So it allows for great flexibility for honest users but also for malicious actors.

docs/types/value-types.rst

@@ -264,7 +264,9 @@ For a quick reference of all members of address, see :ref:`address_related`.
     .. warning::
         ``transfer`` is deprecated and scheduled for removal.
         Use the :ref:`call function <address_call_functions>` with an optionally provided maximum amount of
-        gas (default forwards all remaining gas) and an empty calldata parameter, e.g., ``call{value: amount}("")``.
+        gas and an empty calldata parameter, e.g., ``call{value: amount}("")``.
+        By default forwards all remaining gas, subject to additional limits imposed by some EVM versions (such as the [63/64th rule](https://eips.ethereum.org/EIPS/eip-150) introduced by `tangerineWhistle`).
+        As with any external call, the `gas` call option can be used to set a lower limit.
 
 * ``send``
 
@@ -279,7 +281,9 @@ For a quick reference of all members of address, see :ref:`address_related`.
     .. warning::
         ``send`` is deprecated and scheduled for removal.
         Use the :ref:`call function <address_call_functions>` with an optionally provided maximum amount of
-        gas (default forwards all remaining gas) and an empty calldata parameter, e.g., ``call{value: amount}("")``.
+        gas and an empty calldata parameter, e.g., ``call{value: amount}("")``.
+        By default forwards all remaining gas, subject to additional limits imposed by some EVM versions (such as the [63/64th rule](https://eips.ethereum.org/EIPS/eip-150) introduced by `tangerineWhistle`).
+        As with any external call, the `gas` call option can be used to set a lower limit.
 
 .. _address_call_functions:
 

docs/units-and-global-variables.rst

@@ -269,19 +269,27 @@ Members of Address Types
     send given amount of Wei to :ref:`address`, returns ``false`` on failure, forwards 2300 gas stipend, not adjustable
 
 .. warning::
-    ``send`` and ``transfer`` are deprecated and scheduled for removal.
-    Use the :ref:`call function <address_call_functions>` with an optionally provided maximum amount of
-    gas (default forwards all remaining gas) and an empty calldata parameter, e.g., ``call{value: amount}("")``.
+    `send()` and `transfer()` are deprecated and scheduled for removal.
+    Simple ether transfers can still be performed using the [`call()`](...) function with empty payload, i.e., `call{value: <amount>}("")`.
+    By default this forwards all the remaining gas, subject to additional limits imposed by some EVM versions (such as the [63/64th rule](https://eips.ethereum.org/EIPS/eip-150) introduced by `tangerineWhistle`).
+    As with any external call, the `gas` call option can be used to set a lower limit.
+
+    While it is possible to recreate the functionality by explicitly setting the limit to the value of the stipend (2300 gas), this value no longer holds its original meaning due to changing opcode costs.
+    It is recommended to use different means to protect against reentrancy.
 
 ``<address>.call(bytes memory) returns (bool, bytes memory)``
-    issue low-level ``CALL`` with the given payload, returns success condition and return data, forwards all available gas, adjustable
+    issue low-level ``CALL`` with the given payload, returns success condition and return data, forwards all available gas,  adjustable
 
 ``<address>.delegatecall(bytes memory) returns (bool, bytes memory)``
     issue low-level ``DELEGATECALL`` with the given payload, returns success condition and return data, forwards all available gas, adjustable
 
 ``<address>.staticcall(bytes memory) returns (bool, bytes memory)``
     issue low-level ``STATICCALL`` with the given payload, returns success condition and return data, forwards all available gas, adjustable
 
+Note that functions ``send``, ``transfer``, ``delegatecall`` and ``staticcall`` gas forwarding is subject to limits
+imposed by some EVM versions such as the [63/64th rule](https://eips.ethereum.org/EIPS/eip-150) introduced by `tangerineWhistle`))
+As with any external call, the `gas` call option can be used to set a lower limit.
+
 For more information, see the section on :ref:`address`.
 
 .. warning::