===================================================================
RCS file: /cvs/texi2mdoc/texi2mdoc.1,v
retrieving revision 1.4
retrieving revision 1.7
diff -u -p -r1.4 -r1.7
--- texi2mdoc/texi2mdoc.1	2015/02/20 12:25:25	1.4
+++ texi2mdoc/texi2mdoc.1	2015/02/23 12:39:59	1.7
@@ -1,4 +1,4 @@
-.\"	$Id: texi2mdoc.1,v 1.4 2015/02/20 12:25:25 kristaps Exp $
+.\"	$Id: texi2mdoc.1,v 1.7 2015/02/23 12:39:59 kristaps Exp $
 .\"
 .\" Copyright (c) 2015 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: February 20 2015 $
+.Dd $Mdocdate: February 23 2015 $
 .Dt TEXI2MDOC 1
 .Os
 .Sh NAME
@@ -84,13 +84,17 @@ The
 utility was written by
 .An Kristaps Dzonsons Aq Mt kristaps@bsd.lv .
 .Sh CAVEATS
-Amongst others, the
-.Li @macro
-and macro-related commands,
-.Li @defcodeindex ,
-and
-.Li @footnote
-are not supported.
+The output of
+.Nm
+doesn't play entirely nicely with
+.Xr mdoc 7 .
+It doesn't detect whether a line trailing slash is properly escaped, nor
+does it properly account for how it mingles
+.Sq \&Pp
+with the text.
+Moreover, many commands that might contain useful information (such as
+.Li @footnote )
+are thrown away.
 .\" .Sh BUGS
 .Sh SECURITY CONSIDERATIONS
 As a security precaution,
@@ -98,7 +102,7 @@ As a security precaution,
 does not allow the inclusion (via
 .Li @include
 or
-.Li @verbatiminclude
+.Li @verbatiminclude )
 of absolute paths or paths with
 .Li \&..
 as directory components.