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

Diff for /mandoc/Attic/index.sgml between version 1.12 and 1.13

version 1.12, 2009/03/23 21:46:04 version 1.13, 2009/03/24 10:28:06
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 for BSD manual pages.  The mission of <span class="nm">mdocml</span> is to deprecate <a                                          package for BSD manual pages.  The mission of <span class="nm">mdocml</span> is to deprecate <a
                                         href="http://www.gnu.org/software/groff/" class="external">groff</a>, the GNU roff implementation, for                                          href="http://www.gnu.org/software/groff/" class="external">groff</a>, the GNU roff implementation, for
                                         displaying BSD mdoc pages.                                          displaying BSD mdoc pages.
                                         </p>                                          </p>
   
                                         <p>                                          <p>
                                         Why?  groff amounts to roughly 5,2 MB of source code (OpenBSD 4.2), some of which is C++ and all of                                          Why?  groff amounts to over 5 MB of source code, most of which is C++ and all of which is GPL.  It runs
                                         which is GPL.  It runs slowly, produces uncertain output, and varies in operation from system                                          slowly, produces uncertain output, and varies in operation from system to system.  mdocml strives to fix
                                         to system.  mdocml strives to fix this (respectively small, C, ISC-licensed, fast and regular).                                          this (respectively small, C, ISC-licensed, fast and regular).
                                         </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 the libmdoc library, a validating scanner-parser producing
                                         intermediate-form output from mdoc input.  libmdoc is a simple, fast library operating on memory buffers                                          intermediate-form output from -mdoc input.  libmdoc is a simple, fast library operating on memory
                                         of mdoc input.  Its intermediate output, an abstract syntax tree, is fully documented in the <span                                          buffers, so it can be used for a variety of front-ends (terminal-based, CGI and so on).  The primary
                                         class="man">mdoc(3)</span> reference manual.                                          front-end is <span class="man">mandoc(1)</span>, which formats -mdoc manuals for display on the
                                           terminal.
                                         </p>                                          </p>
   
                                         <p>                                          <p>
                                         There are three utilities implementing <span class="man">mdoc(3)</span>:                                          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>
   
                                         <ul>  
                                         <li><span class="man">mdocterm(1)</span> &#8211; formats mdoc input for display on the terminal  
                                         <li><span class="man">mdochtml(1)</span> &#8211; formats mdoc input as HTML/CSS (nascent)  
                                         <li><span class="man">mdoclint(1)</span> &#8211; validates mdoc input  
                                         <li><span class="man">mdoctree(1)</span> &#8211; prints input abstract syntax tree  
                                         </ul>  
   
                                         <p>                                          <p>
                                         The <span class="man">mdocterm(1)</span> utility is intended to deprecate usage of <a  
                                         href="http://www.gnu.org/software/groff/" class="external">groff</a> for displaying BSD manuals to the  
                                         terminal, either directly or cached as a &#8220;catman&#8221; page.  
                                         </p>  
   
                                         <p>  
                                         <span class="attn">Please submit patches!</span> Although a significant implementation exists, work                                          <span class="attn">Please submit patches!</span> Although a significant implementation exists, work
                                         remains for the backend library and especially the front-end utilities.  See the <a                                          remains for the backend library and especially the front-end utilities.  See the <a
                                         href="#contact">contact</a> information below to submit patches and bug reports.                                          href="#contact">contact</a> information below to submit patches and bug reports.
Line 74 
Line 64 
                                         </h1>                                          </h1>
   
                                         <p>                                          <p>
                                         Sources correctly build and install on OpenBSD, NetBSD and Linux operating systems, tested variously on                                          Sources correctly build and install on FreeBSD, OpenBSD, NetBSD and Linux operating systems, tested
                                         i386, AMD64 and Alpha.                                          variously on i386, AMD64, Alpha and others.
                                         </p>                                          </p>
   
                                         <p>                                          <p>
Line 180 
Line 170 
                         <tr>                          <tr>
                                 <td>                                  <td>
                                         <div class="foot">                                          <div class="foot">
                                                 Copyright &#169; 2009 Kristaps D&#382;onsons, $Date$                                                  Copyright &#169; 2008, 2009 Kristaps D&#382;onsons, $Date$
                                         </div>                                          </div>
                                 </td>                                  </td>
                         </tr>                          </tr>
Legend:
Removed from v.1.12  
changed lines
  Added in v.1.13
CVSweb