diff options
author | Ingo Schwarze <schwarze@openbsd.org> | 2012-08-29 23:38:50 +0000 |
---|---|---|
committer | Ingo Schwarze <schwarze@openbsd.org> | 2012-08-29 23:38:50 +0000 |
commit | 04962b24a061ec089915e89b57adf1720bb86670 (patch) | |
tree | b7a65d4d2d8db5b87309b2254738fbd4134ab14a /mdoc.7 | |
parent | a1b6c48416a5a555c81985c1ceba7b0c00cae260 (diff) | |
download | mandoc-04962b24a061ec089915e89b57adf1720bb86670.tar.gz mandoc-04962b24a061ec089915e89b57adf1720bb86670.tar.zst mandoc-04962b24a061ec089915e89b57adf1720bb86670.zip |
1) Remove documentation of the groff-1.15 compatibility quirk
of suppressing spacing before a third .Xr argument
because that quirk was removed in mdoc_macro.c rev. 1.113.
2) Mark the "section" argument to .Xr as (syntactically) optional,
but still do not encourage omitting it.
The missing .Op was reported by espie@.
Wording tweaked by and ok jmc@, ok millert@.
Diffstat (limited to 'mdoc.7')
-rw-r--r-- | mdoc.7 | 18 |
1 files changed, 6 insertions, 12 deletions
@@ -1,4 +1,4 @@ -.\" $Id: mdoc.7,v 1.215 2012/06/20 22:06:30 schwarze Exp $ +.\" $Id: mdoc.7,v 1.216 2012/08/29 23:38:50 schwarze Exp $ .\" .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv> .\" Copyright (c) 2010, 2011 Ingo Schwarze <schwarze@openbsd.org> @@ -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: June 20 2012 $ +.Dd $Mdocdate: August 29 2012 $ .Dt MDOC 7 .Os .Sh NAME @@ -2532,20 +2532,14 @@ Link to another manual .Pq Qq cross-reference . Its syntax is as follows: .Pp -.D1 Pf \. Sx \&Xr Ar name section +.D1 Pf \. Sx \&Xr Ar name Op section .Pp -The +Cross reference the .Ar name and .Ar section -are the name and section of the linked manual. -If -.Ar section -is followed by non-punctuation, an -.Sx \&Ns -is inserted into the token stream. -This behaviour is for compatibility with -GNU troff. +number of another man page; +omitting the section number is rarely useful. .Pp Examples: .Dl \&.Xr mandoc 1 |