aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/mdoc.7
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@openbsd.org>2019-04-23 18:46:06 +0000
committerIngo Schwarze <schwarze@openbsd.org>2019-04-23 18:46:06 +0000
commitdc84793b8b21e0dfd2d19fbacfe8349e161d9a17 (patch)
treef6a506b1787509d57a0d08e76a080579744506e3 /mdoc.7
parent366ae9cca3a26355a9eded1f8f7afe1034edb071 (diff)
downloadmandoc-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>
Diffstat (limited to 'mdoc.7')
-rw-r--r--mdoc.713
1 files changed, 10 insertions, 3 deletions
diff --git a/mdoc.7 b/mdoc.7
index 0624ce78..51498e19 100644
--- a/mdoc.7
+++ b/mdoc.7
@@ -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