In mdoc(7) and man(7), if a width is given as a bare number without

[mandoc.git] / preconv.1

diff --git a/preconv.1 b/preconv.1
index 12ea6f809fd32fe795f96de4a64537f907515d99..8daee30854d969c1882c524c1d49288f0db2e189 100644 (file)
--- a/preconv.1
+++ b/preconv.1
@@ -1,4 +1,4 @@
-.\"    $Id: preconv.1,v 1.3 2011/05/26 14:43:07 kristaps Exp $
+.\"    $Id: preconv.1,v 1.7 2013/07/13 19:41:16 schwarze Exp $
 .\"
 .\" Copyright (c) 2011 Kristaps Dzonsons <kristaps@bsd.lv>
 .\"
@@ -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: May 26 2011 $
+.Dd $Mdocdate: July 13 2013 $
 .Dt PRECONV 1
 .Os
 .Sh NAME
@@ -38,6 +38,11 @@ or other troff system supporting the
 escape sequence
 .Pc
 input.
+.Pp
+By default, it parses from standard output, determining encoding as
+described in
+.Sx Algorithm .
+.Pp
 Its arguments are as follows:
 .Bl -tag -width Ds
 .It Fl D Ar enc
@@ -48,15 +53,6 @@ The document's encoding.
 The input file.
 .El
 .Pp
-If
-.Ar file
-is not provided,
-.Nm
-accepts standard input.
-See
-.Sx Algorithm
-for encoding choice.
-.Pp
 The recoded input is written to standard output: Unicode characters in
 the ASCII range are printed as regular ASCII characters, while those
 above this range are printed using the
@@ -86,14 +82,14 @@ A file variable is an input line of the form
 .Pp
 .Dl \%.\e\(dq -*- key: val [; key: val ]* -*-
 .Pp
-where
+A coding tag variable is where
 .Cm key
 is
 .Qq coding
 and
 .Cm val
 is the name of the encoding.
-A typical usage may be
+A typical file variable with a coding tag is
 .Pp
 .Dl \%.\e\(dq -*- mode: troff; coding: utf-8 -*-
 .It
@@ -154,7 +150,7 @@ utility appeared in May 2011.
 The
 .Nm
 utility was written by
-.An Kristaps Dzonsons Aq kristaps@bsd.lv .
+.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv .
 .\" .Sh CAVEATS
 .\" .Sh BUGS
 .\" .Sh SECURITY CONSIDERATIONS