source@mandoc.bsd.lv
 help / color / mirror / Atom feed
From: schwarze@mandoc.bsd.lv
To: source@mandoc.bsd.lv
Subject: mandoc: update DESCRIPTION and COMPATIBILITY, mostly correcting
Date: Thu, 4 Oct 2018 10:32:39 -0500 (EST)	[thread overview]
Message-ID: <381bd20efc8178cb@fantadrom.bsd.lv> (raw)

Log Message:
-----------
update DESCRIPTION and COMPATIBILITY, mostly correcting statements
from the past that are no longer true

Modified Files:
--------------
    mandoc:
        roff.7

Revision Data
-------------
Index: roff.7
===================================================================
RCS file: /home/cvs/mandoc/mandoc/roff.7,v
retrieving revision 1.106
retrieving revision 1.107
diff -Lroff.7 -Lroff.7 -u -p -r1.106 -r1.107
--- roff.7
+++ roff.7
@@ -39,17 +39,14 @@ or
 code.
 To properly format such manuals, the
 .Xr mandoc 1
-utility supports a tiny subset of
+utility supports a subset of
 .Nm
 requests and escapes.
-Only these requests and escapes supported by
+Even though this manual page lists all
+.Nm
+requests, it only has partial information about requests not supported by
 .Xr mandoc 1
-are documented in the present manual,
-together with the basic language syntax shared by
-.Nm ,
-.Xr mdoc 7 ,
-and
-.Xr man 7 .
+and about language features that do not matter for manual pages.
 For complete
 .Nm
 manuals, consult the
@@ -193,7 +190,6 @@ Many requests and macros support scaled 
 The syntax for a scaled width is
 .Sq Li [+-]?[0-9]*.[0-9]*[:unit:] ,
 where a decimal must be preceded or followed by at least one digit.
-Negative numbers, while accepted, are truncated to zero.
 .Pp
 The following scaling units are accepted:
 .Pp
@@ -2123,8 +2119,8 @@ The
 .Xr mandoc 1
 implementation of the
 .Nm
-language is intentionally incomplete.
-Unimplemented features include:
+language is incomplete.
+Major unimplemented features include:
 .Pp
 .Bl -dash -compact
 .It
@@ -2135,10 +2131,9 @@ never reads or writes external files exc
 requests with safe relative paths.
 .It
 There is no automatic hyphenation, no adjustment to the right margin,
-and no centering; the output is always set flush-left.
+and very limited support for centering; the output is always set flush-left.
 .It
-Support for setting tabulator positions
-and tabulator and leader characters is missing,
+Support for setting tabulator and leader characters is missing,
 and support for manually changing indentation is limited.
 .It
 The
@@ -2149,14 +2144,14 @@ output media.
 .It
 Width measurements are implemented in a crude way
 and often yield wrong results.
-Explicit movement requests and escapes are ignored.
+Support for explicit movement requests and escapes is limited.
 .It
 There is no concept of output pages, no support for floats,
 graphics drawing, and picture inclusion;
 terminal output is always continuous.
 .It
-Requests regarding color, font families, and glyph manipulation
-are ignored.
+Requests regarding color, font families, font sizes,
+and glyph manipulation are ignored.
 Font support is very limited.
 Kerning is not implemented, and no ligatures are produced.
 .It
@@ -2164,8 +2159,12 @@ The
 .Qq \(aq
 macro control character does not suppress output line breaks.
 .It
-Diversions are not implemented,
+Diversions and environments are not implemented,
 and support for traps is very incomplete.
+.It
+Use of macros is not supported inside
+.Xr tbl 7
+code.
 .El
 .Pp
 The special semantics of the
--
 To unsubscribe send an email to source+unsubscribe@mandoc.bsd.lv

                 reply	other threads:[~2018-10-04 15:32 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=381bd20efc8178cb@fantadrom.bsd.lv \
    --to=schwarze@mandoc.bsd.lv \
    --cc=source@mandoc.bsd.lv \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).