[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.23

version 1.14, 2009/03/24 10:59:50 version 1.23, 2009/06/25 10:52:56
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                                          DOWNLOADS
                                         </h1>                                          </h1>
   
                                         <p>                                          <p>
                                         Sources correctly build and install on FreeBSD, OpenBSD, NetBSD and Linux operating systems, tested                                          Sources correctly build and install on FreeBSD, OpenBSD, NetBSD and Linux operating systems, tested
                                         variously on i386, AMD64, alpha and others.                                          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="/snapshots/ChangeLog">ChangeLog</a> is written with each new version.
                                         </p>                                          </p>
   
                                         <p>  
                                         The most current version is <span class="attn">@VERSION@</span>, dated  
                                         <span class="attn">@VDATE@</span>.  
                                         </p>  
   
                                         <h2>                                          <h2>
                                         Snapshot source                                          Downstream
                                         </h2>                                          </h2>
   
                                         <p>                                          <table width="100%" style="padding-left: 10px;">
                                         CVS sources are checkedout and snapshotted with version updates.  These may be found in the <a                                          <col width="40%">
                                         href="/snapshots/">/snapshots/</a> directory.                                          <col width="60%">
                                         </p>                                          <tbody>
                                                   <tr>
                                                           <td>FreeBSD</td>
                                                           <td>
                                                           <a href="http://www.freebsd.org/cgi/cvsweb.cgi/ports/textproc/mdocml/"
                                                                   class="external">ports/textproc/mandoc</a>
                                                           </td>
                                                   </tr>
                                                   <tr>
                                                           <td>NetBSD</td>
                                                           <td>
                                                           <a href="http://cvsweb.netbsd.org/bsdweb.cgi/pkgsrc/textproc/mdocml/"
                                                                   class="external">pkgsrc/textproc/mandoc</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>
   
                                         <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                                          Current
                                         </h2>                                          </h2>
   
                                         <p>                                          <table width="100%" style="padding-left: 10px;">
                                         The source snapshot is automatically converted into OpenBSD, NetBSD and FreeBSD ports at <a                                          <col width="40%">
                                         href="/ports-openbsd/">/ports-openbsd/</a>, <a href="/ports-netbsd/">/ports-netbsd/</a> and <a                                          <col width="60%">
                                         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>Source archive</td>
                                         class="external"                                                          <td>
                                         href="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html">FreeBSD ports                                                          <a href="http://mdocml.bsd.lv/snapshots/mdocml.tar.gz">mdocml.tar.gz</a>
                                         guide</a>, first.                                                          (<a href="http://mdocml.bsd.lv/snapshots/mdocml.md5">md5</a>)
                                         </p>                                                          </td>
                                                   </tr>
                                                   <tr>
                                                           <td>FreeBSD port</td>
                                                           <td>
                                                           <a href="http://mdocml.bsd.lv/ports-freebsd/mdocml.tar.gz">mdocml.tar.gz</a>
                                                           (<a href="http://mdocml.bsd.lv/snapshots/mdocml.md5">md5</a>)
                                                           </td>
                                                   </tr>
                                                   <tr>
                                                           <td>NetBSD pkgsrc</td>
                                                           <td>
                                                           <a href="http://mdocml.bsd.lv/ports-netbsd/mdocml.tar.gz">/ports-netbsd/mdocml.tar.gz</a>
                                                           (<a href="http://mdocml.bsd.lv/snapshots/mdocml.md5">md5</a>)
                                                           </td>
                                                   </tr>
                                                   <tr>
                                                           <td>OpenBSD port</td>
                                                           <td>
                                                           <a href="http://mdocml.bsd.lv/ports-openbsd/mdocml.tar.gz">mdocml.tar.gz</a>
                                                           (<a href="http://mdocml.bsd.lv/ports-openbsd/mdocml.md5">md5</a>)
                                                           </td>
                                                   </tr>
                                           </tbody>
                                           </table>
   
                                         <h3>                                          <h2>
                                         OpenBSD port                                          Historical
                                         </h3>                                          </h2>
   
                                         <p class="boxed">                                          <table width="100%" style="padding-left: 10px;">
                                         # pkg_delete mdocml<br>                                          <col width="40%">
                                         # cd /usr/ports/textproc/<br>                                          <col width="60%">
                                         # 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="http://mdocml.bsd.lv/snapshots/">/snapshots/</a>
                                         </p>                                                          </td>
                                                   </tr>
                                                   <tr>
                                                           <td>FreeBSD port</td>
                                                           <td>
                                                           <a href="http://mdocml.bsd.lv/ports-freebsd/">/ports-freebsd/</a>
                                                           </td>
                                                   </tr>
                                                   <tr>
                                                           <td>NetBSD pkgsrc</td>
                                                           <td>
                                                           <a href="http://mdocml.bsd.lv/ports-netbsd/">/ports-netbsd/</a>
                                                           </td>
                                                   </tr>
                                                   <tr>
                                                           <td>OpenBSD port</td>
                                                           <td>
                                                           <a href="http://mdocml.bsd.lv/ports-openbsd/">/ports-openbsd/</a>
                                                           </td>
                                                   </tr>
                                           </tbody>
                                           </table>
                                   </td>
                           </tr>
                           <tr>
                                   <td>
                                           <h1>
                                           DOCUMENTATION
                                           </h1>
   
                                         <h3>                                          <table width="100%" style="padding-left: 10px;">
                                         NetBSD pkgsrc                                          <col width="40%">
                                         </h3>                                          <col width="60%">
                                           <tbody>
                                         <p class="boxed">                                                  <tr>
                                         # pkg_delete mdocml<br>                                                          <td><a href="mandoc.1.txt">mandoc(1)</a></td>
                                         # cd /usr/pkgsrc/textproc/<br>                                                          <td>format and display UNIX manuals</td>
                                         # rm -rf mdocml<br>                                                  </tr>
                                         # ftp -V -o- http://mdocml.bsd.lv/ports-netbsd/mdocml.tar.gz | tar -zvxf -<br>                                                  <tr>
                                         # cd mdocml<br>                                                          <td><a href="mandoc_char.7.txt">mandoc_char(7)</a></td>
                                         # make build<br>                                                          <td>mandoc special characters</td>
                                         # make install                                                  </tr>
                                         </p>                                                  <tr>
                                                           <td><a href="mdoc.7.txt">mdoc(7)</a></td>
                                         <h3>                                                          <td>mdoc language reference</td>
                                         FreeBSD port                                                  </tr>
                                         </h3>                                                  <tr>
                                                           <td><a href="man.7.txt">man(7)</a></td>
                                         <p class="boxed">                                                          <td>man language reference</td>
                                         # pkg_delete mdocml<br>                                                  </tr>
                                         # cd /usr/ports/textproc/<br>                                                  <tr>
                                         # rm -rf mdocml<br>                                                          <td><a href="manuals.7.txt">manuals(7)</a></td>
                                         # ftp -V -o- http://mdocml.bsd.lv/ports-freebsd/mdocml.tar.gz | tar -zvxf -<br>                                                          <td>a guide to writing UNIX manuals</td>
                                         # cd mdocml<br>                                                  </tr>
                                         # make build<br>                                                  <tr>
                                         # make install                                                          <td><a href="mdoc.3.txt">mdoc(3)</a></td>
                                         </p>                                                          <td>mdoc macro compiler library</td>
                                                   </tr>
                                                   <tr>
                                                           <td><a href="man.3.txt">man(3)</a></td>
                                                           <td>man macro compiler library</td>
                                                   </tr>
                                           </tbody>
                                           </table>
                                 </td>                                  </td>
                         </tr>                          </tr>
                         <tr>                          <tr>
Line 155 
Line 214 
                                         </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==',                                          onclick="window.open('http://mailhide.recaptcha.net/d?k=01jt88xIsFONwVjHZmGpc4AQ==&amp;c=sb5E6ulipc-eTnpTVqI-BQ==',
                                         '', 'toolbar=0,scrollbars=0,location=0,statusbar=0,menubar=0,resizable=0,width=500,height=300'); return                                          '', '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.                                          false;" title="Reveal this e-mail address">...</a>@kth.se.
                                         </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 versions, 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.23
CVSweb