Home | History | Annotate | Line # | Download | only in mantools
makemanidx revision 1.1 
      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
     98