diff --git a/scripts/dhcp-discover.nse b/scripts/dhcp-discover.nse
index 67a424d11..f64e09c4c 100644
--- a/scripts/dhcp-discover.nse
+++ b/scripts/dhcp-discover.nse
@@ -39,6 +39,8 @@ Some of the more useful fields:
 --                cause the router to reserve a new  IP address each time.
 -- @args requests Set to an integer to make up to  that many requests (and display the results).
 --
+-- @usage
+-- nmap -sU -p 67 --script=dhcp-discover <target>
 -- @output
 -- Interesting ports on 192.168.1.1:
 -- PORT   STATE SERVICE
diff --git a/scripts/dns-random-srcport.nse b/scripts/dns-random-srcport.nse
index 38d3e0577..8becca767 100644
--- a/scripts/dns-random-srcport.nse
+++ b/scripts/dns-random-srcport.nse
@@ -25,6 +25,8 @@ porttest.dns-oarc.net: Duane Wessels <wessels@dns-oarc.net>
 ]]
 
 ---
+-- @usage
+-- nmap -sU -p 53 --script=dns-random-srcport <target>
 -- @output
 -- PORT   STATE SERVICE REASON
 -- 53/udp open  domain  udp-response
diff --git a/scripts/dns-random-txid.nse b/scripts/dns-random-txid.nse
index 834b956a3..75455bb38 100644
--- a/scripts/dns-random-txid.nse
+++ b/scripts/dns-random-txid.nse
@@ -25,6 +25,8 @@ txidtest.dns-oarc.net: Duane Wessels <wessels@dns-oarc.net>
 ]]
 
 ---
+-- @usage
+-- nmap -sU -p 53 --script=dns-random-txid <target>
 -- @output
 -- PORT   STATE SERVICE REASON
 -- 53/udp open  domain  udp-response
diff --git a/scripts/dns-recursion.nse b/scripts/dns-recursion.nse
index b9b57204d..f16c8914b 100644
--- a/scripts/dns-recursion.nse
+++ b/scripts/dns-recursion.nse
@@ -11,6 +11,8 @@ nameservers.
 ]]
 
 ---
+-- @usage
+-- nmap -sU -p 53 --script=dns-recursion <target>
 -- @output
 -- PORT   STATE SERVICE REASON
 -- 53/udp open  domain  udp-response
diff --git a/scripts/dns-update.nse b/scripts/dns-update.nse
index 54505fe90..6995bdf35 100644
--- a/scripts/dns-update.nse
+++ b/scripts/dns-update.nse
@@ -13,6 +13,8 @@ license = "Same as Nmap--See http://nmap.org/book/man-legal.html"
 categories = {"discovery", "safe"}
 
 ---
+-- @usage
+-- nmap -sU -p 53 --script=dns-update <target>
 -- @output
 -- PORT   STATE SERVICE
 -- 53/udp open  domain
diff --git a/scripts/freelancer-info.nse b/scripts/freelancer-info.nse
index a6059c20a..07dcb1c51 100644
--- a/scripts/freelancer-info.nse
+++ b/scripts/freelancer-info.nse
@@ -20,6 +20,10 @@ See http://sourceforge.net/projects/gameq/
 (relevant files: games.ini, packets.ini, freelancer.php)
 ]]
 
+---
+-- @usage
+-- nmap -sU -sV -p 2302 <target>
+-- nmap -sU -p 2302 --script=freelancer-info <target>
 -- @output
 -- PORT     STATE SERVICE    REASON       VERSION
 -- 2302/udp open  freelancer udp-response Freelancer (name: Discovery Freelancer RP 24/7; players: 152/225; password: no)
diff --git a/scripts/iax2-version.nse b/scripts/iax2-version.nse
index 90ef8cf8f..ecc3328c4 100644
--- a/scripts/iax2-version.nse
+++ b/scripts/iax2-version.nse
@@ -10,6 +10,8 @@ The script sends an Inter-Asterisk eXchange (IAX) Revision 2 Control Frame POKE
 ]]
 
 ---
+-- @usage
+-- nmap -sU -sV -p 4569 <target>
 -- @output
 -- PORT     STATE  SERVICE VERSION
 -- 4569/udp closed iax2
diff --git a/scripts/ike-version.nse b/scripts/ike-version.nse
index b1fa06824..4949ff391 100644
--- a/scripts/ike-version.nse
+++ b/scripts/ike-version.nse
@@ -13,6 +13,10 @@ Obtains information (such as vendor and device type where available) from an IKE
 
 
 ---
+-- @usage
+-- nmap -sU -sV -p 500 <target>
+-- nmap -sU -p 500 --script ike-version <target>
+--
 -- @output
 -- PORT    STATE SERVICE REASON       VERSION
 -- 500/udp open  isakmp  udp-response Cisco VPN Concentrator 3000 4.0.7
diff --git a/scripts/lexmark-config.nse b/scripts/lexmark-config.nse
index 1ee573b07..f3e7c6b37 100644
--- a/scripts/lexmark-config.nse
+++ b/scripts/lexmark-config.nse
@@ -17,6 +17,8 @@ http://www.lexmark.com/vgn/images/portal/Security%20Features%20of%20Lexmark%20MF
 
 
 ---
+--@usage
+-- nmap -sU -p 9100 --script=lexmark-config <target>
 --@output
 -- Interesting ports on 192.168.1.111:
 -- PORT     STATE   SERVICE REASON
diff --git a/scripts/murmur-version.nse b/scripts/murmur-version.nse
index 719f19d57..bb4c968eb 100644
--- a/scripts/murmur-version.nse
+++ b/scripts/murmur-version.nse
@@ -31,6 +31,7 @@ the server.
 See http://mumble.sourceforge.net/Protocol.
 ]]
 
+---
 -- @output
 -- PORT      STATE SERVICE VERSION
 -- 64740/tcp open  murmur  Murmur 1.2.4 (control port; users: 35; max. users: 100; bandwidth: 72000 b/s)
diff --git a/scripts/nat-pmp-info.nse b/scripts/nat-pmp-info.nse
index 5bd08afa6..a12d6be76 100644
--- a/scripts/nat-pmp-info.nse
+++ b/scripts/nat-pmp-info.nse
@@ -17,6 +17,10 @@ The NAT-PMP protocol is supported by a broad range of routers including:
   - Peplink Balance
 ]]
 
+---
+--@usage
+-- nmap -sU -p 5351 --script=nat-pmp-info <target>
+
 author = "Patrik Karlsson"
 license = "Same as Nmap--See http://nmap.org/book/man-legal.html"
 categories = {"default", "discovery", "safe"}
diff --git a/scripts/nfs-ls.nse b/scripts/nfs-ls.nse
index feedff87e..e81f8e1a1 100644
--- a/scripts/nfs-ls.nse
+++ b/scripts/nfs-ls.nse
@@ -32,6 +32,9 @@ These access permissions are shown only with NFSv3:
 ]]
 
 ---
+-- @usage
+-- nmap -p 111 --script=nfs-ls <target>
+-- nmap -sV --script=nfs-ls <target>
 -- @output
 -- PORT    STATE SERVICE
 -- 111/tcp open  rpcbind
diff --git a/scripts/nfs-statfs.nse b/scripts/nfs-statfs.nse
index 53aa0c9c3..bfd497aeb 100644
--- a/scripts/nfs-statfs.nse
+++ b/scripts/nfs-statfs.nse
@@ -15,6 +15,9 @@ the version used is NFSv3.
 ]]
 
 ---
+-- @usage
+-- nmap -p 111 --script=nfs-statfs <target>
+-- nmap -sV --script=nfs-statfs <target>
 -- @output
 -- PORT    STATE SERVICE
 -- | nfs-statfs:
diff --git a/scripts/ntp-info.nse b/scripts/ntp-info.nse
index 8ae1d13f9..34cda234a 100644
--- a/scripts/ntp-info.nse
+++ b/scripts/ntp-info.nse
@@ -21,6 +21,8 @@ documentation of the protocol.
 ]]
 
 ---
+-- @usage
+-- nmap -sU -p 123 --script ntp-info <target>
 -- @output
 -- PORT    STATE SERVICE VERSION
 -- 123/udp open  ntp     NTP v4
diff --git a/scripts/quake3-master-getservers.nse b/scripts/quake3-master-getservers.nse
index 481fbed96..41bf4a537 100644
--- a/scripts/quake3-master-getservers.nse
+++ b/scripts/quake3-master-getservers.nse
@@ -11,6 +11,8 @@ Queries Quake3-style master servers for game servers (many games other than Quak
 ]]
 
 ---
+-- @usage
+-- nmap -sU -p 27950 --script=quake3-master-getservers <target>
 -- @output
 -- PORT      STATE SERVICE REASON
 -- 27950/udp open  quake3-master
diff --git a/scripts/servicetags.nse b/scripts/servicetags.nse
index 2739025a7..701c8bb7a 100644
--- a/scripts/servicetags.nse
+++ b/scripts/servicetags.nse
@@ -15,6 +15,8 @@ http://arc.opensolaris.org/caselog/PSARC/2006/638/ServiceTag_API_CLI_v07.pdf
 ]]
 
 ---
+-- @usage
+-- nmap -sU -p 6481 --script=servicetags <target>
 -- @output
 -- | servicetags:
 -- |   URN: urn:st:3bf76681-5e68-415b-f980-abcdef123456
diff --git a/scripts/snmp-interfaces.nse b/scripts/snmp-interfaces.nse
index 3606b7e32..2bb040baf 100644
--- a/scripts/snmp-interfaces.nse
+++ b/scripts/snmp-interfaces.nse
@@ -20,6 +20,8 @@ successfully added.
 ]]
 
 ---
+-- @usage
+-- nmap -sU -p 161 --script=snmp-interfaces <target>
 -- @args snmp-interfaces.host  Specifies the SNMP server to probe when
 --       running in the "pre-scanning phase".
 -- @args snmp-interfaces.port  The optional port number corresponding
diff --git a/scripts/snmp-netstat.nse b/scripts/snmp-netstat.nse
index 18d46388d..b7a8fbee7 100644
--- a/scripts/snmp-netstat.nse
+++ b/scripts/snmp-netstat.nse
@@ -13,6 +13,8 @@ newtargets script argument.
 ]]
 
 ---
+-- @usage
+-- nmap -sU -p 161 --script=snmp-netstat <target>
 -- @output
 -- | snmp-netstat:
 -- |   TCP  0.0.0.0:21           0.0.0.0:2256
diff --git a/scripts/snmp-processes.nse b/scripts/snmp-processes.nse
index 95e320019..950f6a01b 100644
--- a/scripts/snmp-processes.nse
+++ b/scripts/snmp-processes.nse
@@ -9,6 +9,8 @@ Attempts to enumerate running processes through SNMP.
 ]]
 
 ---
+-- @usage
+-- nmap -sU -p 161 --script=snmp-processes <target>
 -- @output
 -- | snmp-processes:
 -- |   System Idle Process
diff --git a/scripts/snmp-win32-services.nse b/scripts/snmp-win32-services.nse
index d672ed1cb..5b162bec6 100644
--- a/scripts/snmp-win32-services.nse
+++ b/scripts/snmp-win32-services.nse
@@ -9,6 +9,8 @@ Attempts to enumerate Windows services through SNMP.
 ]]
 
 ---
+-- @usage
+-- nmap -sU -p 161 --script=snmp-win32-services <target>
 -- @output
 -- | snmp-win32-services:
 -- |   Apache Tomcat
diff --git a/scripts/snmp-win32-shares.nse b/scripts/snmp-win32-shares.nse
index 93784783f..b1a4b9ac4 100644
--- a/scripts/snmp-win32-shares.nse
+++ b/scripts/snmp-win32-shares.nse
@@ -9,6 +9,8 @@ Attempts to enumerate Windows Shares through SNMP.
 ]]
 
 ---
+-- @usage
+-- nmap -sU -p 161 --script=snmp-win32-shares <target>
 -- @output
 -- | snmp-win32-shares:
 -- |   SYSVOL
diff --git a/scripts/snmp-win32-software.nse b/scripts/snmp-win32-software.nse
index 3920bd9e4..5b1f3addf 100644
--- a/scripts/snmp-win32-software.nse
+++ b/scripts/snmp-win32-software.nse
@@ -10,6 +10,8 @@ Attempts to enumerate installed software through SNMP.
 ]]
 
 ---
+-- @usage
+-- nmap -sU -p 161 --script=snmp-win32-software <target>
 -- @output
 -- | snmp-win32-software:
 -- |   Apache Tomcat 5.5 (remove only); 2007-09-15 15:13:18
diff --git a/scripts/snmp-win32-users.nse b/scripts/snmp-win32-users.nse
index 57d4a0e4a..ebe9350f8 100644
--- a/scripts/snmp-win32-users.nse
+++ b/scripts/snmp-win32-users.nse
@@ -9,6 +9,8 @@ Attempts to enumerate Windows user accounts through SNMP
 ]]
 
 ---
+-- @usage
+-- nmap -sU -p 161 --script=snmp-win32-users <target>
 -- @output
 -- | snmp-win32-users:
 -- |   Administrator
diff --git a/scripts/stun-version.nse b/scripts/stun-version.nse
index e40b661d6..771c0f9bb 100644
--- a/scripts/stun-version.nse
+++ b/scripts/stun-version.nse
@@ -8,6 +8,8 @@ information from the response, if the server attribute is present.
 ]]
 
 ---
+-- @usage
+-- nmap -sU -sV -p 3478 <target>
 -- @output
 -- PORT     STATE SERVICE VERSION
 -- 3478/udp open  stun    Vovida.org 0.96
diff --git a/scripts/teamspeak2-version.nse b/scripts/teamspeak2-version.nse
index 1f8415363..8b43def06 100644
--- a/scripts/teamspeak2-version.nse
+++ b/scripts/teamspeak2-version.nse
@@ -12,6 +12,9 @@ A single UDP packet (a login request) is sent. If the server does not have a
 password set, the exact version, name, and OS type will also be reported on.
 ]]
 
+---
+-- @usage
+-- nmap -sU -sV -p 8767 <target>
 -- @output
 -- PORT     STATE SERVICE    REASON     VERSION
 -- 8767/udp open  teamspeak2 script-set TeamSpeak 2.0.23.19 (name: COWCLANS; no password)
diff --git a/scripts/upnp-info.nse b/scripts/upnp-info.nse
index d5e106901..49b7d721b 100644
--- a/scripts/upnp-info.nse
+++ b/scripts/upnp-info.nse
@@ -9,6 +9,8 @@ Attempts to extract system information from the UPnP service.
 ]]
 
 ---
+-- @usage
+-- nmap -sU -p 1900 --script=upnp-info <target>
 -- @output
 -- |  upnp-info:  System/1.0 UPnP/1.0 IGD/1.0
 -- |_ Location: http://192.168.1.1:80/UPnP/IGD.xml