Home | History | Annotate | Line # | Download | only in mantools
makemanidx revision 1.1.1.5
      1 #!/bin/sh
      2 
      3 cat <<EOF
      4 <!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
      5         "https://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
     21 Manual 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
     28 documents.  These introductions are hyperlinked to more advanced
     29 documents and to UNIX-style manual pages. The UNIX-style manual
     30 pages 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
     43 overview</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
     55 UNIX manual: examples are mailq(1) or access(5). Unfortunately,
     56 there is no single universal method to organize manual pages; each
     57 UNIX flavor appears to be different. Postfix documentation assumes
     58 the 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 
     80 EOF
     81 
     82 srctoman "$@" | sed 's/\\-/-/g' | awk '
     83 
     84 NR == 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 
     94 cat <<EOF
     95 </body>
     96 
     97 </html>
     98 EOF
     99