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

Diff for /mandoc/Attic/index.sgml between version 1.4 and 1.9

version 1.4, 2009/02/23 20:55:56 version 1.9, 2009/02/27 10:55:16
Line 24 
Line 24 
                                         </h1>                                          </h1>
   
                                         <p>                                          <p>
                                         <span class="nm">mdocml</span> is a suite of tools that compile &#8220;mdoc&#8221;, the roff macro                                          <span class="nm">mdocml</span> is a suite of tools compiling &#8220;mdoc&#8221;, the roff macro
                                         package of the 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.  groff amounts to over 60 000 lines of GPL C++ source, which is a                                          displaying BSD mdoc pages.
                                         considerable encumbrance to BSD operating system.  
                                         </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
                                           which is GPL.  It runs slowly, produces uncertain output, and varies in operation from system
                                           to system.  mdocml strives to fix this (respectively small, C, ISC-licensed, fast and regular).
                                           </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 buffers
                                         of mdoc input.  Its intermediate output, an abstract syntax tree, is fully documented in the <span                                          of mdoc input.  Its intermediate output, an abstract syntax tree, is fully documented in the <span
Line 44 
Line 49 
   
                                         <ul>                                          <ul>
                                         <li><span class="man">mdocterm(1)</span> &#8211; formats mdoc input for display on the terminal                                          <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 strict HTML (nascent)                                          <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">mdoclint(1)</span> &#8211; validates mdoc input
                                         <li><span class="man">mdoctree(1)</span> &#8211; prints input abstract syntax tree                                          <li><span class="man">mdoctree(1)</span> &#8211; prints input abstract syntax tree
                                         </ul>                                          </ul>
Line 73 
Line 78 
                                         i386, AMD64 and Alpha.                                          i386, AMD64 and Alpha.
                                         </p>                                          </p>
   
                                           <p>
                                           The most current version is <span class="attn">@VERSION@</span>, dated
                                           <span class="attn">@VDATE@</span>.
                                           </p>
   
                                         <h2>                                          <h2>
                                         snapshotted source                                          Snapshot source
                                         </h2>                                          </h2>
   
                                         <p>                                          <p>
                                         CVS sources are checkedout and snapshotted with big updates.  These may be found in the <a                                          CVS sources are checkedout and snapshotted with version updates.  These may be found in the <a
                                         href="/snapshots/">/snapshots/</a> directory.                                          href="/snapshots/">/snapshots/</a> directory.
                                         </p>                                          </p>
   
Line 86 
Line 96 
                                         % cd /tmp<br>                                          % cd /tmp<br>
                                         % ftp -V -o- http://mdocml.bsd.lv/snapshots/mdocml.tar.gz | tar -zvxf -<br>                                          % ftp -V -o- http://mdocml.bsd.lv/snapshots/mdocml.tar.gz | tar -zvxf -<br>
                                         % cd mdocml<br>                                          % cd mdocml<br>
                                         % make && make regress && make install                                          % make all<br>
                                           % make regress<br>
                                           # make install
                                         </p>                                          </p>
   
                                         <h2>                                          <h2>
                                         nightly port                                          Snapshot port
                                         </h2>                                          </h2>
   
                                         <p>                                          <p>
Line 100 
Line 112 
                                         </p>                                          </p>
   
                                         <p class="boxed">                                          <p class="boxed">
                                         % sudo pkg_delete mdocml<br>                                          # pkg_delete mdocml<br>
                                         % cd /usr/ports/devel/<br>                                          # cd /usr/ports/devel/<br>
                                         % sudo rm -rf mdocml<br>                                          # rm -rf mdocml<br>
                                         % ftp -V -o- http://mdocml.bsd.lv/ports-openbsd/mdocml.tar.gz | sudo tar -zvxf -<br>                                          # ftp -V -o- http://mdocml.bsd.lv/ports-openbsd/mdocml.tar.gz | tar -zvxf -<br>
                                         % cd mdocml<br>                                          # cd mdocml<br>
                                         % sudo make && sudo make regress && sudo make install                                          # make build<br>
                                           # make regress<br>
                                           # make install
                                         </p>                                          </p>
                                 </td>                                  </td>
                         </tr>                          </tr>
Legend:
Removed from v.1.4  
changed lines
  Added in v.1.9
CVSweb