Improve messages related to the roff(7) .so request.

[mandoc.git] / demandoc.1

diff --git a/demandoc.1 b/demandoc.1
index dd8e677b78a1adae8004a92a90737c2879b20379..84571baf30aa7fbc0ac5e5f4f15a33c190f8584f 100644 (file)
--- a/demandoc.1
+++ b/demandoc.1
@@ -1,4 +1,4 @@
-.\"    $Id: demandoc.1,v 1.4 2011/09/01 22:25:53 kristaps Exp $
+.\"    $Id: demandoc.1,v 1.7 2013/07/13 19:41:16 schwarze Exp $

 .\"
 .\" Copyright (c) 2011 Kristaps Dzonsons <kristaps@bsd.lv>
 .\"
 .\"
 .\" 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.
 .\"
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"

-.Dd $Mdocdate: September 1 2011 $
+.Dd $Mdocdate: July 13 2013 $

 .Dt DEMANDOC 1
 .Os
 .Sh NAME
 .Dt DEMANDOC 1
 .Os
 .Sh NAME


@@ -33,6 +33,13 @@ and
 .Xr man 7
 .Ux
 manual files.
 .Xr man 7
 .Ux
 manual files.

+.Pp
+By default,
+.Nm
+parses standard input and outputs only text nodes, preserving line
+and column position.
+Escape sequences are omitted from the output.
+.Pp

 Its arguments are as follows:
 .Bl -tag -width Ds
 .It Fl w
 Its arguments are as follows:
 .Bl -tag -width Ds
 .It Fl w


@@ -42,26 +49,15 @@ A
 .Qq word ,
 in this case, refers to whitespace-delimited terms beginning with at
 least two letters and not consisting of any escape sequences.
 .Qq word ,
 in this case, refers to whitespace-delimited terms beginning with at
 least two letters and not consisting of any escape sequences.

-Terms have their leading and trailing punctuation
+Words have their leading and trailing punctuation

 .Pq double-quotes, sentence punctuation, etc.
 stripped.
 .It Ar
 The input files.
 .El
 .Pp
 .Pq double-quotes, sentence punctuation, etc.
 stripped.
 .It Ar
 The input files.
 .El
 .Pp

-If
-.Ar file
-is not provided,
-.Nm
-accepts standard input.

 If a document is not well-formed, it is skipped.
 .Pp
 If a document is not well-formed, it is skipped.
 .Pp

-By default,
-.Nm
-parses its input and outputs only text nodes, preserving line column
-position.
-Escape sequences are omitted from the output.
-.Pp

 The
 .Fl i ,
 .Fl k ,
 The
 .Fl i ,
 .Fl k ,


@@ -109,5 +105,4 @@ documents.
 The
 .Nm
 utility was written by
 The
 .Nm
 utility was written by

-.An Kristaps Dzonsons ,
-.Mt kristaps@bsd.lv .
+.An Kristaps Dzonsons Aq Mt kristaps@bsd.lv .