From db5ba94e31ab0974ef0a12edfe212330a693bc13 Mon Sep 17 00:00:00 2001 From: Ingo Schwarze Date: Thu, 13 Feb 2020 18:32:56 +0000 Subject: Mention that the .Dd "date" argument is the date of the last change. Triggered by a question from Jason A. Donenfeld. While here, delete three COMPATIBILITY entries that i fixed some time ago. --- mdoc.7 | 21 ++++----------------- 1 file changed, 4 insertions(+), 17 deletions(-) (limited to 'mdoc.7') diff --git a/mdoc.7 b/mdoc.7 index d0dad480..c828399c 100644 --- a/mdoc.7 +++ b/mdoc.7 @@ -1,4 +1,4 @@ -.\" $Id: mdoc.7,v 1.280 2020/01/19 18:02:00 schwarze Exp $ +.\" $Id: mdoc.7,v 1.281 2020/02/13 18:32:56 schwarze Exp $ .\" .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons .\" Copyright (c) 2010, 2011, 2013-2020 Ingo Schwarze @@ -15,7 +15,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: January 19 2020 $ +.Dd $Mdocdate: February 13 2020 $ .Dt MDOC 7 .Os .Sh NAME @@ -1203,7 +1203,8 @@ Close a block. Does not have any tail arguments. .It Ic \&Dd Cm $\&Mdocdate$ | Ar month day , year -Document date for display in the page footer. +Document date for display in the page footer, +by convention the date of the last change. This is the mandatory first macro of any .Nm manual. @@ -3084,17 +3085,6 @@ The following problematic behaviour is found in groff: .Pp .Bl -dash -compact .It -.Ic \&Dd -with non-standard arguments behaves very strangely. -When there are three arguments, they are printed verbatim. -Any other number of arguments is replaced by the current date, -but without any arguments the string -.Dq Epoch -is printed. -.It -.Ic \&Lk -only accepts a single link-name argument; the remainder is misformatted. -.It .Ic \&Pa does not format its arguments when used in the FILES section under certain list types. @@ -3102,9 +3092,6 @@ certain list types. .Ic \&Ta can only be called by other macros, but not at the beginning of a line. .It -.Ic \&%C -is not implemented (up to and including groff-1.22.2). -.It .Sq \ef .Pq font face and -- cgit v1.2.3