diff options
author | Ingo Schwarze <schwarze@openbsd.org> | 2019-04-23 18:46:06 +0000 |
---|---|---|
committer | Ingo Schwarze <schwarze@openbsd.org> | 2019-04-23 18:46:06 +0000 |
commit | dc84793b8b21e0dfd2d19fbacfe8349e161d9a17 (patch) | |
tree | f6a506b1787509d57a0d08e76a080579744506e3 | |
parent | 366ae9cca3a26355a9eded1f8f7afe1034edb071 (diff) | |
download | mandoc-dc84793b8b21e0dfd2d19fbacfe8349e161d9a17.tar.gz mandoc-dc84793b8b21e0dfd2d19fbacfe8349e161d9a17.tar.zst mandoc-dc84793b8b21e0dfd2d19fbacfe8349e161d9a17.zip |
clarify how .%P is conventionally used;
triggered by a question from Fabio Scotoni <fabio at esse dot ch>
-rw-r--r-- | mdoc.7 | 13 |
1 files changed, 10 insertions, 3 deletions
@@ -1,4 +1,4 @@ -.\" $Id: mdoc.7,v 1.276 2019/02/07 15:45:53 schwarze Exp $ +.\" $Id: mdoc.7,v 1.277 2019/04/23 18:46:06 schwarze Exp $ .\" .\" Copyright (c) 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv> .\" Copyright (c) 2010, 2011, 2013-2018 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: February 7 2019 $ +.Dd $Mdocdate: April 23 2019 $ .Dt MDOC 7 .Os .Sh NAME @@ -596,6 +596,13 @@ block. Book or journal page number of an .Ic \&Rs block. +Conventionally, the argument starts with +.Ql p.\& +for a single page or +.Ql pp.\& +for a range of pages, for example: +.Pp +.Dl .%P pp. 42\e(en47 .It Ic \&%Q Ar name Institutional author (school, government, etc.) of an .Ic \&Rs @@ -2969,7 +2976,7 @@ exclamation mark Note that even a period preceded by a backslash .Pq Sq \e.\& gets this special handling; use -.Sq \e&. +.Sq \e&.\& to prevent that. .Pp Many in-line macros interrupt their scope when they encounter |