mirror of
https://github.com/nmap/nmap.git
synced 2026-02-13 00:46:32 +00:00
Normalize NSEDoc documentation of scripts.
I made every script follow a standard form: it starts with the id, followed by the description. The description is contained in [[ ]] delimiters. The description is in the global description variable, not in a LuaDoc comment. Other LuaDoc information such as @args and @usage follows the description in a comment. The first paragraph of each description is a a short summary of what the script does. More detailed information, if any, is given in following paragraphs. I also improved some wording and formatting in a few cases.
This commit is contained in:
@@ -1,13 +1,19 @@
|
||||
id = "HTML title"
|
||||
description = [[
|
||||
Shows the title of the default page of a web server.
|
||||
\n\n
|
||||
The script will follow no more than one HTTP redirect, and only if the
|
||||
redirection leads to the same host. The script may send a DNS query to
|
||||
determine if the host the redirect leads to has the same IP address as the
|
||||
original target.
|
||||
]]
|
||||
|
||||
---
|
||||
--@output
|
||||
-- 80/tcp open http syn-ack\n
|
||||
-- |_ HTML title: Foo.\n
|
||||
--@copyright Same as Nmap--See http://nmap.org/book/man-legal.html
|
||||
|
||||
id = "HTML title"
|
||||
|
||||
description = "Connects to an HTTP server and extracts the title of the default page."
|
||||
|
||||
author = "Diman Todorov <diman.todorov@gmail.com>"
|
||||
|
||||
license = "Same as Nmap--See http://nmap.org/book/man-legal.html"
|
||||
|
||||
Reference in New Issue
Block a user