diff --git a/nselib/msrpc.lua b/nselib/msrpc.lua
index 0da4973a6..642af041b 100644
--- a/nselib/msrpc.lua
+++ b/nselib/msrpc.lua
@@ -1,5 +1,8 @@
---- By making heavy use of the 'smb' library, this library will call various MSRPC 
---  functions. The functions used here can be accessed over TCP ports 445 and 139, 
+--- Call various MSRPC functions.
+--
+-- This library gives support for calling various MSRPC functions, making heavy
+-- use of the <code>smb</code> library.
+-- The functions used here can be accessed over TCP ports 445 and 139, 
 --  with an established session. A NULL session (the default) will work for some 
 --  functions and operating systems (or configurations), but not for others. 
 --
diff --git a/nselib/smb.lua b/nselib/smb.lua
index ac1bd9d76..36330a2ff 100644
--- a/nselib/smb.lua
+++ b/nselib/smb.lua
@@ -1,6 +1,8 @@
---- A library for SMB (Server Message Block) (aka CIFS) traffic. This traffic is normally
+--- Server Message Block (SMB, also known as CIFS) traffic.
+--
+-- SMB traffic is normally
 --  sent to/from ports 139 or 445 of Windows systems, although it's also implemented by
---  others (the most notable one being Samba).
+--  other systems (the most notable one being Samba).
 --
 -- The intention of this library is to eventually handle all aspects of the SMB protocol,
 -- A programmer using this library must already have some knowledge of the SMB protocol,