xref: /netbsd-src/external/ibm-public/postfix/dist/mantools/makemanidx (revision 059c16a85b0b39d60ad6d18f53c09510815afa2b)
1#!/bin/sh
2
3cat <<EOF
4<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
5        "http://www.w3.org/TR/html4/loose.dtd">
6
7<html>
8
9<head>
10
11<title>Postfix Manual Pages </title>
12
13<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
14<link rel='stylesheet' type='text/css' href='postfix-doc.css'>
15
16</head>
17
18<body>
19
20<h1><img src="postfix-logo.jpg" width="203" height="98" ALT="">Postfix
21Manual Pages </h1>
22
23<hr>
24
25<h2> Information for new Postfix users </h2>
26
27<p> New Postfix users should first look at the following introductory
28documents.  These introductions are hyperlinked to more advanced
29documents and to UNIX-style manual pages. The UNIX-style manual
30pages are intended for people who are already familiar with Postfix.
31</p>
32
33<ul>
34
35<li> <a href="OVERVIEW.html"> Postfix architecture overview </a>
36
37<li> <a href="BASIC_CONFIGURATION_README.html"> Basic configuration
38</a>
39
40<li> <a href="DEBUG_README.html"> Trouble shooting </a>
41
42<li> <a href="CONTENT_INSPECTION_README.html"> Content inspection
43overview</a>
44
45<li> <a href="SMTPD_ACCESS_README.html">Relay/access control overview
46</a>
47
48<li> <a href="DATABASE_README.html"> Lookup table overview </a>
49
50</ul>
51
52<h2> Postfix manual page organization </h2>
53
54<p> Each Postfix manual page is numbered after a section of the
55UNIX manual: examples are mailq(1) or access(5). Unfortunately,
56there is no single universal method to organize manual pages; each
57UNIX flavor appears to be different. Postfix documentation assumes
58the following convention:  </p>
59
60<blockquote>
61
62<table cellpadding="0" cellspacing="0">
63
64<tr><th> Section </th> <th> Topic </th> </tr>
65
66<tr><td colspan="2"> <hr> </td> </tr>
67
68<tr><td align="center"> 1 </td> <td> Commands </td> </tr>
69
70<tr><td align="center"> 3 </td> <td> Library routines </td> </tr>
71
72<tr><td align="center"> 5 </td> <td> File formats </td> </tr>
73
74<tr><td align="center"> 8 </td> <td> Daemons </td> </tr>
75
76</table>
77
78</blockquote>
79
80EOF
81
82srctoman "$@" | sed 's/\\-/-/g' | awk '
83
84NR == 1,/SH "*SEE ALSO"*/ { next }
85
86/^Other:$/ { print ul; exit }
87
88/^[A-Z].*:$/ { print ul "<h2>", $0, "</h2>\n\n<ul>\n\n"; ul = "</ul>\n\n" }
89
90/^[a-z][-a-z0-9_]+\(/ { print "<li>", $0, "\n" }
91
92' | sed 's;: </h2>$; </h2>;'
93
94cat <<EOF
95</body>
96
97</html>
98EOF
99