Initialize the local variable "act" in print_mdoc_node().

[mandoc.git] / man.cgi.3
diff --git a/man.cgi.3 b/man.cgi.3

index e7c1d2fca0ca5f21b97fdde68fd6d8a75ef2cead..e83248cc2f5b0fe0bbf2a9641487c98cdf5f9226 100644 (file)
--- a/man.cgi.3
+++ b/man.cgi.3
@@ -1,6 +1,6 @@
-.\"    $Id: man.cgi.3,v 1.2 2016/07/07 19:19:01 schwarze Exp $
+.\"    $Id: man.cgi.3,v 1.4 2017/03/15 13:18:53 schwarze Exp $
  .\"
  .\"
-.\" Copyright (c) 2016 Ingo Schwarze <schwarze@openbsd.org>
+.\" Copyright (c) 2016, 2017 Ingo Schwarze <schwarze@openbsd.org>
  .\"
  .\" Permission to use, copy, modify, and distribute this software for any
  .\" purpose with or without fee is hereby granted, provided that the above
  .\"
  .\" Permission to use, copy, modify, and distribute this software for any
  .\" purpose with or without fee is hereby granted, provided that the above
@@ -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.
  .\"
  .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  .\"
-.Dd $Mdocdate: July 7 2016 $
+.Dd $Mdocdate: March 15 2017 $
  .Dt MAN.CGI 3
  .Os
  .Sh NAME
  .Dt MAN.CGI 3
  .Os
  .Sh NAME
@@ -126,12 +126,30 @@ contains a search query in short format or when
  is empty and a
  .Ev QUERY_STRING
  is provided.
  is empty and a
  .Ev QUERY_STRING
  is provided.
-It changes into the manpath and calls
+If possible, requests using
+.Ev QUERY_STRING
+are redirected to URIs using
+.Ev PATH_INFO
+by calling
+.Fn pg_redirect .
+Otherwise, it changes into the manpath and calls
  .Xr mansearch 3 .
  Depending on the result, it calls either
  .Fn pg_noresult
  or
  .Fn pg_searchres .
  .Xr mansearch 3 .
  Depending on the result, it calls either
  .Fn pg_noresult
  or
  .Fn pg_searchres .
+.It Ft void Fn pg_redirect "const struct req *req" "const char *name"
+This function is special in so far as it does not print an HTML page,
+but only an HTTP 303 response with a Location: of the form:
+.Sm off
+.No http://
+.Ar host Ns /
+.Op Ar scriptname Ns /
+.Op Ar manpath Ns /
+.Op Ar arch Ns /
+.Fa name
+.Op Pf . Ar sec
+.Sm on
  .It Ft void Fn pg_noresult "const struct req *req" "const char *msg"
  This function calls
  .Fn resp_begin_html ,
  .It Ft void Fn pg_noresult "const struct req *req" "const char *msg"
  This function calls
  .Fn resp_begin_html ,
@@ -219,13 +237,18 @@ and
  are used.
  The highest level result generators are:
  .Bl -tag -width 1n
  are used.
  The highest level result generators are:
  .Bl -tag -width 1n
-.It Ft void Fn resp_begin_html "int code" "const char *msg"
+.It Ft void Fn resp_begin_html "int code" "const char *msg" "const char *file"
  This generator calls
  .Fn resp_begin_http
  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.
  This generator calls
  .Fn resp_begin_http
  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.
+If
+.Fa file
+is not
+.Dv NULL ,
+it is used for the <title> element.
  .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.
  .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.