natspec improvements

Spearbit #2

Author: hoytech

src/EulerSwapManagement.sol

@@ -11,6 +11,9 @@ import {FundsLib} from "./libraries/FundsLib.sol";
 import {CurveLib} from "./libraries/CurveLib.sol";
 import {SwapLib} from "./libraries/SwapLib.sol";
 
+/// @title EulerSwapManagement contract
+/// @custom:security-contact security@euler.xyz
+/// @author Euler Labs (https://www.eulerlabs.com/)
 contract EulerSwapManagement is EulerSwapBase {
     error Unauthorized();
     error AlreadyActivated();

src/interfaces/IEulerSwapCallee.sol

@@ -6,5 +6,9 @@ interface IEulerSwapCallee {
     /// is invoked on the `to` address, allowing flash-swaps (withdrawing output before
     /// sending input.
     /// @dev This callback mechanism is designed to be as similar as possible to Uniswap2.
+    /// @param sender The address that originated the swap
+    /// @param amount0 The requested output amount of token0
+    /// @param amount1 The requested output amount of token1
+    /// @param data Opaque callback data passed by swapper
     function eulerSwapCall(address sender, uint256 amount0, uint256 amount1, bytes calldata data) external;
 }

src/libraries/FundsLib.sol

@@ -72,7 +72,7 @@ library FundsLib {
     /// @param amount The total amount to deposit
     /// @return The amount of assets successfully deposited (may be less than requested)
     /// @dev This function attempts to deposit assets into the specified vault.
-    /// @dev If the deposit fails with E_ZeroShares error, it safely returns 0 (this happens with very small amounts).
+    /// @dev If the deposit fails with E_ZeroShares or ZeroShares error, it safely returns 0 (this happens with very small amounts).
     /// @dev After successful deposit, if the user has any outstanding controller-enabled debt, it attempts to repay it.
     /// @dev If all debt is repaid, the controller is automatically disabled to reduce gas costs in future operations.
     function depositAssets(address evc, address eulerAccount, address supplyVault, address borrowVault, uint256 amount)