[BACK]Return to index.sgml CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Diff for /mandoc/Attic/index.sgml between version 1.14 and 1.39

version 1.14, 2009/03/24 10:59:50 version 1.39, 2009/10/31 08:37:26
Line 3 
Line 3 
         <head>          <head>
                 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">                  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
                 <meta name="resource-type" content="document">                  <meta name="resource-type" content="document">
                 <link rel="stylesheet" href="style.css" type="text/css" media="all">                  <link rel="stylesheet" href="index.css" type="text/css" media="all">
                 <title>mdocml.bsd.lv</title>                  <title>mdocml.bsd.lv</title>
         </head>          </head>
         <body>          <body>
         <table width="600">          <table class="frame" summary="[frame]">
                 <col width="100%">                  <col width="100%">
                 <tbody>                  <tbody>
                         <tr>                          <tr>
Line 24 
Line 24 
                                         </h1>                                          </h1>
   
                                         <p>                                          <p>
                                         <span class="nm">mdocml</span> is a suite of tools compiling &#8220;-mdoc&#8221;, the roff macro                                          <span class="nm">mdocml</span> is a suite of tools compiling &#8220;-mdoc&#8221;, the roff macro package
                                         package of choice for BSD manual pages.  The mission of <span class="nm">mdocml</span> is to deprecate                                          of choice for BSD manual pages, and &#8220;-man&#8221;, the predominant historical package for UNIX
                                         <a href="http://www.gnu.org/software/groff/" class="external">groff</a>, the GNU roff implementation,                                          manuals.  The mission of <span class="nm">mdocml</span> is to deprecate <a
                                         for displaying -mdoc pages.                                          href="http://www.gnu.org/software/groff/" class="external">groff</a>, the GNU roff implementation, for
                                           displaying -mdoc pages whilst providing token support for -man.
                                         </p>                                          </p>
   
                                         <p>                                          <p>
Line 37 
Line 38 
                                         </p>                                          </p>
   
                                         <p>                                          <p>
                                         The core of <span class="nm">mdocml</span> is the libmdoc library, a validating scanner-parser producing                                          The core of <span class="nm">mdocml</span> is composed of the <i>libmdoc</i> and <i>libman</i>
                                         intermediate-form output from -mdoc input.  libmdoc is a simple, fast library operating on memory                                          validating compiler libraries.  Both are simple, fast libraries operating on memory buffers, so they may
                                         buffers, so it can be used for a variety of front-ends (terminal-based, CGI and so on).                                          be used for a variety of front-ends (terminal-based, CGI and so on).  The primary front-end is <i>
                                           mandoc</i>, which formats manuals for display on the terminal.
                                         </p>                                          </p>
   
                                         <p>  
                                         The primary front-end is <span class="man">mandoc(1)</span>, which formats -mdoc manuals for display on  
                                         the terminal.  The <span class="man">mandoc(1)</span> utility is intended to deprecate usage of <a  
                                         href="http://www.gnu.org/software/groff/" class="external">groff</a> for displaying mdoc manuals on the  
                                         terminal.  
                                         </p>  
   
                                         <p>  
                                         <span class="attn">Please submit patches, bug reports and suggestions!</span> Although a significant  
                                         implementation exists, work remains for the backend library and especially the front-end utilities.  See  
                                         the <a href="#contact">contact</a> information below for submissions.  
                                         </p>  
                                 </td>                                  </td>
                         </tr>                          </tr>
                         <tr>                          <tr>
                                 <td>                                  <td>
                                         <h1>                                          <h1>
                                         INSTALLING SOURCES                                          SOURCES
                                         </h1>                                          </h1>
   
                                         <p>                                          <p>
                                         Sources correctly build and install on FreeBSD, OpenBSD, NetBSD and Linux operating systems, tested                                          Sources correctly build and install on DragonFly BSD, FreeBSD, OpenBSD, NetBSD, and GNU/Linux operating
                                         variously on i386, AMD64, alpha and others.                                          systems, tested variously on i386, AMD64, alpha, and others.  The most current version is <span
                                           class="attn">@VERSION@</span>, dated <span class="attn">@VDATE@</span>.  A full <a
                                           href="ChangeLog.html">ChangeLog</a> (<a href="ChangeLog.txt">txt</a>) is written with each release.
                                         </p>                                          </p>
   
                                         <p>  
                                         The most current version is <span class="attn">@VERSION@</span>, dated  
                                         <span class="attn">@VDATE@</span>.  
                                         </p>  
   
                                         <h2>                                          <h2>
                                         Snapshot source                                          Current
                                         </h2>                                          </h2>
   
                                         <p>                                          <table width="100%" summary="Current Sources">
                                         CVS sources are checkedout and snapshotted with version updates.  These may be found in the <a                                          <col width="200">
                                         href="/snapshots/">/snapshots/</a> directory.                                          <col>
                                         </p>                                          <tbody>
                                                   <tr>
                                                           <td>Source archive</td>
                                                           <td>
                                                           <a href="/snapshots/mdocml.tar.gz">/snapshots/mdocml.tar.gz</a>
                                                           (<a href="/snapshots/mdocml.md5">md5</a>)
                                                           </td>
                                                   </tr>
                                                   <tr>
                                                           <td>Online source</td>
                                                           <td>
                                                           <a class="external" href="http://bsd.lv/cgi-bin/cvsweb.cgi/?cvsroot=mdocml">cvsweb</a>
                                                           </td>
                                                   </tr>
                                           </tbody>
                                           </table>
   
                                         <p class="boxed">  
                                         % cd /tmp<br>  
                                         % ftp -V -o- http://mdocml.bsd.lv/snapshots/mdocml.tar.gz | tar -zvxf -<br>  
                                         % cd mdocml<br>  
                                         % make all<br>  
                                         % make regress<br>  
                                         # make install  
                                         </p>  
   
                                         <h2>                                          <h2>
                                         Snapshot port/pkgsrc                                          Downstream
                                         </h2>                                          </h2>
   
                                         <p>                                          <table width="100%" summary="Downstream Sources">
                                         The source snapshot is automatically converted into OpenBSD, NetBSD and FreeBSD ports at <a                                          <col width="200">
                                         href="/ports-openbsd/">/ports-openbsd/</a>, <a href="/ports-netbsd/">/ports-netbsd/</a> and <a                                          <col>
                                         href="/ports-freebsd/">/ports-freebsd/</a>, respectively.  Please read the <a class="external"                                          <tbody>
                                         href="http://www.openbsd.org/faq/faq15.html">OpenBSD Ports FAQ</a>, the <a class="external"                                                  <tr>
                                         href="http://www.netbsd.org/docs/software/packages.html">NetBSD pkgsrc guide</a> or the <a                                                          <td>DragonFly BSD</td>
                                         class="external"                                                          <td>
                                         href="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html">FreeBSD ports                                                          <a href="http://gitweb.dragonflybsd.org/dragonfly.git/tree/HEAD:/usr.bin/mandoc"
                                         guide</a>, first.                                                                  class="external">usr.bin/mandoc</a>
                                         </p>                                                          </td>
                                                   </tr>
                                                   <tr>
                                                           <td>FreeBSD</td>
                                                           <td>
                                                           <a href="http://www.freebsd.org/cgi/cvsweb.cgi/ports/textproc/mdocml/"
                                                                   class="external">ports/textproc/mdocml</a>
                                                           </td>
                                                   </tr>
                                                   <tr>
                                                           <td>NetBSD</td>
                                                           <td>
                                                           <a href="http://cvsweb.netbsd.org/bsdweb.cgi/src/external/bsd/mdocml/"
                                                                   class="external">src/external/bsd/mdocml</a>
                                                           </td>
                                                   </tr>
                                                   <tr>
                                                           <td>OpenBSD</td>
                                                           <td>
                                                           <a href="http://www.openbsd.org/cgi-bin/cvsweb/src/usr.bin/mandoc/"
                                                                   class="external">src/usr.bin/mandoc</a>
                                                           </td>
                                                   </tr>
                                           </tbody>
                                           </table>
   
                                         <h3>                                          <h2>
                                         OpenBSD port                                          Historical
                                         </h3>                                          </h2>
   
                                         <p class="boxed">                                          <table width="100%" summary="Archived Sources">
                                         # pkg_delete mdocml<br>                                          <col width="200">
                                         # cd /usr/ports/textproc/<br>                                          <col>
                                         # rm -rf mdocml<br>                                          <tbody>
                                         # ftp -V -o- http://mdocml.bsd.lv/ports-openbsd/mdocml.tar.gz | tar -zvxf -<br>                                                  <tr>
                                         # cd mdocml<br>                                                          <td>Source archive</td>
                                         # make build<br>                                                          <td>
                                         # make install                                                          <a href="/snapshots/">/snapshots/</a>
                                         </p>                                                          </td>
                                                   </tr>
                                           </tbody>
                                           </table>
                                   </td>
                           </tr>
                           <tr>
                                   <td>
                                           <h1>
                                           DOCUMENTATION
                                           </h1>
   
                                         <h3>                                          <p>
                                         NetBSD pkgsrc                                          These manuals are generated automatically and refer to the current snapshot.
                                         </h3>  
   
                                         <p class="boxed">  
                                         # pkg_delete mdocml<br>  
                                         # cd /usr/pkgsrc/textproc/<br>  
                                         # rm -rf mdocml<br>  
                                         # ftp -V -o- http://mdocml.bsd.lv/ports-netbsd/mdocml.tar.gz | tar -zvxf -<br>  
                                         # cd mdocml<br>  
                                         # make build<br>  
                                         # make install  
                                         </p>                                          </p>
   
                                         <h3>                                          <table width="100%" summary="Documentation">
                                         FreeBSD port                                          <col width="200">
                                         </h3>                                          <col>
                                           <tbody>
                                         <p class="boxed">                                                  <tr>
                                         # pkg_delete mdocml<br>                                                          <td><a href="mandoc.1.html">mandoc(1)</a> (<a href="mandoc.1.txt">text</a>)</td>
                                         # cd /usr/ports/textproc/<br>                                                          <td>format and display UNIX manuals</td>
                                         # rm -rf mdocml<br>                                                  </tr>
                                         # ftp -V -o- http://mdocml.bsd.lv/ports-freebsd/mdocml.tar.gz | tar -zvxf -<br>                                                  <tr>
                                         # cd mdocml<br>                                                          <td><a href="mandoc_char.7.html">mandoc_char(7)</a> (<a href="mandoc_char.7.txt">text</a>)</td>
                                         # make build<br>                                                          <td>mandoc special characters</td>
                                         # make install                                                  </tr>
                                         </p>                                                  <tr>
                                                           <td><a href="mdoc.7.html">mdoc(7)</a> (<a href="mdoc.7.txt">text</a>)</td>
                                                           <td>mdoc language reference</td>
                                                   </tr>
                                                   <tr>
                                                           <td><a href="man.7.html">man(7)</a> (<a href="man.7.txt">text</a>)</td>
                                                           <td>man language reference</td>
                                                   </tr>
                                                   <tr>
                                                           <td><a href="manuals.7.html">manuals(7)</a> (<a href="manuals.7.txt">text</a>)</td>
                                                           <td>a guide to writing UNIX manuals</td>
                                                   </tr>
                                                   <tr>
                                                           <td><a href="mdoc.3.html">mdoc(3)</a> (<a href="mdoc.3.txt">text</a>)</td>
                                                           <td>mdoc macro compiler library</td>
                                                   </tr>
                                                   <tr>
                                                           <td><a href="man.3.html">man(3)</a> (<a href="man.3.txt">text</a>)</td>
                                                           <td>man macro compiler library</td>
                                                   </tr>
                                           </tbody>
                                           </table>
                                 </td>                                  </td>
                         </tr>                          </tr>
                         <tr>                          <tr>
Line 155 
Line 192 
                                         </h1>                                          </h1>
   
                                         <p>                                          <p>
                                         Please contact Kristaps, kris<a class="external"                                          For all issues related to <span class="nm">mdocml</span>, contact Kristaps D&#382;onsons, kris<a
                                           class="external"
                                         href="http://mailhide.recaptcha.net/d?k=01jt88xIsFONwVjHZmGpc4AQ==&amp;c=sb5E6ulipc-eTnpTVqI-BQ=="                                          href="http://mailhide.recaptcha.net/d?k=01jt88xIsFONwVjHZmGpc4AQ==&amp;c=sb5E6ulipc-eTnpTVqI-BQ=="
                                         onclick="window.open('http://mailhide.recaptcha.net/d?k=01jt88xIsFONwVjHZmGpc4AQ==&amp;c=sb5E6ulipc-eTnpTVqI-BQ==',                                          title="Reveal this e-mail address">...</a>@kth.se.
                                         '', 'toolbar=0,scrollbars=0,location=0,statusbar=0,menubar=0,resizable=0,width=500,height=300'); return  
                                         false;" title="Reveal this e-mail address">...</a>@kth.se, with questions, bug reports, patches, and so on.  
                                         </p>                                          </p>
   
                                         <p>                                          <p>
                                         If you'd like to submit patches, please contact us beforehand in case larger changes are pending but not                                          If you want to receive a semi-automated mail-out of new releases, then please write with a message
                                         checked in.  If making a bug report, please make sure it's repeatable on the most current snapshot.                                          subject of <i>subscribe mdocml</i> (or <i>unsubscribe mdocml</i>).
                                         </p>                                          </p>
                                 </td>                                  </td>
                         </tr>                          </tr>
Legend:
Removed from v.1.14  
changed lines
  Added in v.1.39
CVSweb