]> git.cameronkatri.com Git - mandoc.git/commitdiff
Get ready for a version.
authorKristaps Dzonsons <kristaps@bsd.lv>
Sat, 24 Mar 2012 01:54:43 +0000 (01:54 +0000)
committerKristaps Dzonsons <kristaps@bsd.lv>
Sat, 24 Mar 2012 01:54:43 +0000 (01:54 +0000)
Makefile
index.sgml
whatis.1

index 474b408d43c9d74c00b3d090395f273a32383bf9..304237b47827c3e55f3a6af9c4f06defff8341ea 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -12,8 +12,8 @@
 #
 # CFLAGS       += -DOSNAME="\"OpenBSD 4.5\""
 
-VERSION                 = 1.12.0
-VDATE           = 8 October 2011
+VERSION                 = 1.12.1
+VDATE           = 23 March 2012
 
 # IFF your system supports multi-byte functions (setlocale(), wcwidth(),
 # putwchar()) AND has __STDC_ISO_10646__ (that is, wchar_t is simply a
@@ -142,7 +142,6 @@ SRCS                 = Makefile \
                   preconv.c \
                   predefs.in \
                   read.c \
-                  regress \
                   roff.7 \
                   roff.c \
                   st.c \
index 1fbd2f0efbf896e7532f80604c49f5a31a56bf40..a0163e01b2f800669a8decbea698a096976809a7 100644 (file)
                        Sources: <A HREF="/snapshots/mdocml.tar.gz">current</A>,
                        <A HREF="/cgi-bin/cvsweb/?cvsroot=mdocml">cvsweb</A>
                        (<A HREF="/snapshots/">archives</A>)
-                       |
-                       Binaries: <A
-                       HREF="/binaries/mdocml-win32.zip">windows 32-bit</A>, <A
-                       HREF="/binaries/mdocml-win64.zip">windows 64-bit</A>, <A
-                       HREF="/binaries/mdocml-macosx.zip">mac os x</A>
-                       (<A HREF="/binaries/">archives</A>)
                </P>
                <H1>
                        <A NAME="description">Description</A>
                        <A NAME="news">News</A>
                </H1>
                <P CLASS="news">
-                       xx-xx-2011: version 1.12.1
+                       23-03-2011: version 1.12.1
                </P>
                <P>
                        Significant work on <A HREF="apropos.1.html">apropos</A> and <A HREF="mandocdb.8.html">mandocdb</A>.  These tools are
-                       now much more robust and in line with other manpage systems.  A <A HREF="whatis.1.html">whatis</A> implementation is now
-                       handled as an <A HREF="apropos.1.html">apropos</A> mode.  These tools are also able to minimally handle pre-formatted
-                       pages, that is, those already formatted by another utility such as GNU troff.
+                       now much more robust.  
+                       A <A HREF="whatis.1.html">whatis</A> implementation is now handled as an <A HREF="apropos.1.html">apropos</A> mode.
+                       These tools are also able to minimally handle pre-formatted pages, that is, those already formatted by another utility
+                       such as GNU troff.
                </P>
                <P>
                        The <A HREF="man.cgi.7.html">man.cgi</A> script is also now available for wider testing.  It interfaces with <A
                        on-the-fly by <A HREF="mandoc.3.html">libmandoc</A> or internal methods to convert pre-formatted pages.
                </P>
                <P>
-                       Lastly, the mailing list archive for the discuss and tech lists are being hosted by <A CLASS="external"
+                       The mailing list archive for the discuss and tech lists are being hosted by <A CLASS="external"
                        HREF="http://www.gmane.org">Gmane</A> at <A HREF="http://dir.gmane.org/gmane.comp.tools.mdocml.user"
                        CLASS="external">gmane.comp.tools.mdocml.user</A> and <A HREF="http://dir.gmane.org/gmane.comp.tools.mdocml.devel"
                        CLASS="external">gmane.comp.tools.mdocml.devel</A>, respectively.
                </P>
-               <P CLASS="news">
-                       08-10-2011: version 1.12.0
-               </P>
-               <P>
-                       This version features a new, work-in-progress <A HREF="mandoc.1.html">mandoc</A> output mode: -<B>Tman</B>.  This mode
-                       allows a system maintainer to distribute <A HREF="man.7.html">man</A> media for older systems that may not natively
-                       support <A HREF="mdoc.7.html">mdoc</A>, such as old Solaris systems.
-                       The -<B>Ofragment</B> option was added to <A HREF="mandoc.1.html">mandoc</A>'s -<B>Thtml</B> and -<B>Txhtml</B> modes.
-               </P>
-               <P>
-                       While adding features, an <A HREF="apropos.1.html">apropos</A> utility has been merged from the mandoc-tools sandbox.
-                       This interfaces with <A HREF="mandocdb.8.html">mandocdb</A> for semantic search of manual content.  <A
-                       HREF="apropos.1.html">apropos</A> is different from the traditional <B>apropos</B> primarily in allowing keyword search
-                       (such as for functions, utilities, etc.) and regular expressions.
-                       Note that the calling syntax for <B>apropos</B> is likely to change as it settles down.
-               </P>
-               <P>
-                       In documentation news, the <A HREF="mdoc.7.html">mdoc</A> and <A HREF="man.7.html">man</A> manuals have been made
-                       considerably more readable by adding <I>MACRO OVERVIEW</I> sections, by moving the gory details of the <I>LANGUAGE
-                       SYNTAX</I> to the <A HREF="roff.7.html">roff</A> manual, and by moving the very technical <I>MACRO SYNTAX</I> sections
-                       down to the bottom of the page.
-               </P>
                <P>
-                       Furthermore, for <A HREF="tbl.7.html">tbl</A>, the -<B>Tascii</B> mode horizontal spacing of tables was rewritten
-                       completely.  It is now compatible with <A HREF="http://www.gnu.org/software/groff/" CLASS="external">groff</A>, both
-                       with and without frames and rulers.  Nesting of indented blocks is now supported in <A HREF="man.7.html">man</A>, and
-                       several bugs were fixed regarding indentation and alignment.  The page headers in <A HREF="mdoc.7.html">mdoc</A> are now
-                       nicer for very long titles.
+                       Lastly, I'm no longer providing binaries, as nobody has asked for them.
                </P>
                <P>
                        See <A HREF="http://mdocml.bsd.lv/cgi-bin/cvsweb/index.sgml?cvsroot=mdocml">cvsweb</A> for
                        <SMALL>
                                Copyright &#169; 2008&#8211;2011 
                                <A CLASS="external" HREF="http://kristaps.bsd.lv">Kristaps Dzonsons</A>, 
-                               $Date: 2011/12/14 23:17:12 $
+                               $Date: 2012/03/24 01:54:43 $
                        </SMALL>
                </P>
        </BODY>
index ed1196ef32084930942b32bb4b51c35c34c6da16..500b0b6c34d43ae498ddef1b27f222968b9f78c3 100644 (file)
--- a/whatis.1
+++ b/whatis.1
@@ -1,6 +1,6 @@
-.\"    $Id: whatis.1,v 1.7 2011/12/25 19:35:44 kristaps Exp $
+.\"    $Id: whatis.1,v 1.8 2012/03/24 01:54:43 kristaps Exp $
 .\"
-.\" Copyright (c) 2011 Kristaps Dzonsons <kristaps@bsd.lv>
+.\" Copyright (c) 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv>
 .\"
 .\" Permission to use, copy, modify, and distribute this software for any
 .\" purpose with or without fee is hereby granted, provided that the above
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: December 25 2011 $
+.Dd $Mdocdate: March 24 2012 $
 .Dt WHATIS 1
 .Os
 .Sh NAME
@@ -47,6 +47,8 @@ searches for
 .Xr mandocdb 8
 databases in the default paths stipulated by
 .Xr man 1 .
+If standard output is a TTY, a result may be selected from a list and
+its manual displayed with the pager.
 .Pp
 The options are as follows:
 .Bl -tag -width Ds
@@ -95,13 +97,21 @@ If an architecture is specified for the manual, it is displayed as
 .Pp
 .D1 title(cat/arch) \- description
 .Pp
-Resulting manuals may be accessed as
+If on a TTY, results are prefixed with a numeric identifier.
 .Pp
-.Dl $ man \-s sec title
+.D1 [index] title(cat) \- description
 .Pp
-If an architecture is specified in the output, use
-.Pp
-.Dl $ man \-s sec \-S arch title
+One may choose a manual be entering the index at the prompt.
+Valid choices are displayed using
+.Ev MANPAGER ,
+or failing that ,
+.Ev PAGER
+or just
+.Xr more 1 .
+Source pages are formatted with
+.Xr mandoc 1 ;
+preformatted pages with
+.Xr cat 1 .
 .Pp
 .Nm
 is identical to running
@@ -111,6 +121,14 @@ as follows:
 .Dl $ apropos -- -i 'Nm~[[:<:]]term[[:>:]]'
 .Sh ENVIRONMENT
 .Bl -tag -width Ds
+.It Ev MANPAGER
+Default pager for manuals.
+If this is unset, falls back to
+.Ev Pager .
+.It Ev PAGER
+The second choice for a manual pager.
+If this is unset, use
+.Xr more 1 .
 .It Ev MANPATH
 Colon-separated paths modifying the default list of paths searched for
 manual databases.