]> git.cameronkatri.com Git - mandoc.git/blobdiff - man.cgi.3
Now that our man.conf(5) format is mature and extremely simple,
[mandoc.git] / man.cgi.3
index a2b99ad04f159f254087b5e869e32a1a21282e97..e7c1d2fca0ca5f21b97fdde68fd6d8a75ef2cead 100644 (file)
--- a/man.cgi.3
+++ b/man.cgi.3
@@ -1,4 +1,4 @@
-.\"    $Id: man.cgi.3,v 1.1 2016/04/15 21:16:22 schwarze Exp $
+.\"    $Id: man.cgi.3,v 1.2 2016/07/07 19:19:01 schwarze Exp $
 .\"
 .\" Copyright (c) 2016 Ingo Schwarze <schwarze@openbsd.org>
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: April 15 2016 $
+.Dd $Mdocdate: July 7 2016 $
 .Dt MAN.CGI 3
 .Os
 .Sh NAME
@@ -55,14 +55,13 @@ the data directory containing all the manual trees;
 calls
 .Fn parse_manpath_conf ;
 .It
-calls
-.Fn parse_path_info ;
-.It
-calls
-.Fn parse_query_string
 if
 .Ev PATH_INFO
-is empty;
+is empty, calls
+.Fn parse_query_string ;
+otherwise,
+calls
+.Fn parse_path_info ;
 .It
 validates the manpath and the architecture;
 .It
@@ -227,9 +226,14 @@ to print the HTTP headers, then prints the HTML header up to the
 opening tag of the <body> element, then copies the file
 .Pa header.html
 to the output, if it exists and is readable.
-.It Ft void Fn resp_searchform "const struct req *req"
+.It Ft void Fn resp_searchform "const struct req *req" "enum focus focus"
 This generator prints a search form, filling it with data
 from the provided request object.
+If the
+.Fa focus
+argument is
+.Dv FOCUS_QUERY ,
+it sets the document's autofocus to the query input box.
 .It Ft void Fn resp_show "const struct req *req" "const char *file"
 This wrapper dispatches to either
 .Fn resp_catman
@@ -278,5 +282,6 @@ and does not ascend to parent directories.
 .Sh SEE ALSO
 .Xr mandoc 3 ,
 .Xr mansearch 3 ,
+.Xr mchars_alloc 3 ,
 .Xr mandoc.db 5 ,
 .Xr man.cgi 8