From 00ae8cb5d641e5a769cbbcb91d214d7bea8fb609 Mon Sep 17 00:00:00 2001 From: Kristaps Dzonsons Date: Sat, 24 Mar 2012 01:54:43 +0000 Subject: Get ready for a version. --- Makefile | 5 ++--- index.sgml | 45 +++++++-------------------------------------- whatis.1 | 30 ++++++++++++++++++++++++------ 3 files changed, 33 insertions(+), 47 deletions(-) diff --git a/Makefile b/Makefile index 474b408d..304237b4 100644 --- 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 \ diff --git a/index.sgml b/index.sgml index 51b094a6..22c7eeea 100644 --- a/index.sgml +++ b/index.sgml @@ -13,12 +13,6 @@ Sources: current, cvsweb (archives) - | - Binaries: windows 32-bit, windows 64-bit, mac os x - (archives)

Description @@ -330,13 +324,14 @@ News

- xx-xx-2011: version 1.12.1 + 23-03-2011: version 1.12.1

Significant work on apropos and mandocdb. These tools are - now much more robust and in line with other manpage systems. A whatis implementation is now - handled as an apropos 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 whatis implementation is now handled as an apropos mode. + These tools are also able to minimally handle pre-formatted pages, that is, those already formatted by another utility + such as GNU troff.

The man.cgi script is also now available for wider testing. It interfaces with libmandoc or internal methods to convert pre-formatted pages.

- Lastly, the mailing list archive for the discuss and tech lists are being hosted by Gmane at gmane.comp.tools.mdocml.user and gmane.comp.tools.mdocml.devel, respectively.

-

- 08-10-2011: version 1.12.0 -

-

- This version features a new, work-in-progress mandoc output mode: -Tman. This mode - allows a system maintainer to distribute man media for older systems that may not natively - support mdoc, such as old Solaris systems. - The -Ofragment option was added to mandoc's -Thtml and -Txhtml modes. -

-

- While adding features, an apropos utility has been merged from the mandoc-tools sandbox. - This interfaces with mandocdb for semantic search of manual content. apropos is different from the traditional apropos primarily in allowing keyword search - (such as for functions, utilities, etc.) and regular expressions. - Note that the calling syntax for apropos is likely to change as it settles down. -

-

- In documentation news, the mdoc and man manuals have been made - considerably more readable by adding MACRO OVERVIEW sections, by moving the gory details of the LANGUAGE - SYNTAX to the roff manual, and by moving the very technical MACRO SYNTAX sections - down to the bottom of the page. -

- Furthermore, for tbl, the -Tascii mode horizontal spacing of tables was rewritten - completely. It is now compatible with groff, both - with and without frames and rulers. Nesting of indented blocks is now supported in man, and - several bugs were fixed regarding indentation and alignment. The page headers in mdoc are now - nicer for very long titles. + Lastly, I'm no longer providing binaries, as nobody has asked for them.

See cvsweb for diff --git a/whatis.1 b/whatis.1 index da0c5792..910913dc 100644 --- a/whatis.1 +++ b/whatis.1 @@ -1,6 +1,6 @@ .\" $Id$ .\" -.\" Copyright (c) 2011 Kristaps Dzonsons +.\" Copyright (c) 2011, 2012 Kristaps Dzonsons .\" .\" Permission to use, copy, modify, and distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above @@ -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. -- cgit