external/ibm-public/postfix/dist/mantools/makemanidx

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