Add Haddocks about exceptions thrown when compiling to wasm

Author: palas

network-mux/src/Network/Mux/Channel.hs

@@ -313,6 +313,8 @@ socketAsChannel socket =
 ---
 --- This is primarily for testing purposes since it does not allow actual IPC.
 ---
+-- __Exceptions:__
+-- May throw 'IOError' when compiling to @wasm@.
 createSocketConnectedChannels :: Socket.Family -- ^ Usually AF_UNIX or AF_INET
                               -> IO (ByteChannel IO,
                                      ByteChannel IO)

ouroboros-network/demo/connection-manager.hs

@@ -647,7 +647,8 @@ optionParser =
             <> showDefault
             )
 
-
+-- | __Exceptions:__
+-- May throw 'IOError' when compiling to @wasm@.
 run :: (Addr, Port)
     -> (Addr, Port)
     -> DiffTime -- ^ protocol idle timeout

ouroboros-network/framework/lib/Ouroboros/Network/Snocket.hs

@@ -346,6 +346,8 @@ type SocketSnocket = Snocket IO Socket SockAddr
 -- | Create a 'Snocket' for the given 'Socket.Family'. In the 'bind' method set
 -- 'Socket.ReuseAddr` and 'Socket.ReusePort'.
 --
+-- __Exceptions:__
+-- May throw 'IOError' when compiling to @wasm@.
 socketSnocket
   :: IOManager
   -- ^ 'IOManager' interface.  We use it when we create a new socket and when we
@@ -452,6 +454,8 @@ type LocalSnocket = Snocket IO LocalSocket LocalAddress
 -- around this, the address passed to 'open' via 'LocalFamily' will be
 -- referenced by 'LocalSocket'.
 --
+-- __Exceptions:__
+-- May throw 'IOError' when compiling to @wasm@.
 localSnocket :: IOManager -> LocalSnocket
 #if defined(mingw32_HOST_OS)
 localSnocket ioManager = Snocket {

ouroboros-network/tests/io/Test/Ouroboros/Network/Socket.hs

@@ -185,7 +185,8 @@ prop_socket_demo :: TestBlockChainAndUpdates -> Property
 prop_socket_demo (TestBlockChainAndUpdates chain updates) =
     ioProperty $ demo chain updates
 
-
+-- | __Exceptions:__
+-- May throw 'IOError' when compiling to @wasm@.
 demo :: forall block .
         ( Chain.HasHeader block
         , Serialise (Chain.HeaderHash block)