From 33fdc394c7a120ca24b18d6365d6a6800a04547c Mon Sep 17 00:00:00 2001
From: Jean-Yves Migeon <jeanyves.migeon@free.fr>
Date: Tue, 3 Sep 2013 11:45:32 +0200
Subject: [PATCH] Document the "device" keyword and its value.

---
 libarchive/mtree.5 | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/libarchive/mtree.5 b/libarchive/mtree.5
index b55326123..51ec2f962 100644
--- a/libarchive/mtree.5
+++ b/libarchive/mtree.5
@@ -134,6 +134,39 @@ The checksum of the file using the default algorithm specified by
 the
 .Xr cksum 1
 utility.
+.It Cm device
+The device number for
+.Sy block
+or
+.Sy char
+file types.
+The value must be one of the following forms:
+.Pp
+.Bl -tag -width 4n
+.It Ar format , Ns Ar major , Ns Ar minor Ns Bo , Ns Ar subunit Bc
+A device with
+.Ar major , minor
+and optional
+.Ar subunit
+fields.
+Their meaning is specified by the operating's system
+.Ar format .
+See below for valid formats.
+.It Ar number
+Opaque number (as stored on the file system).
+.El
+.Pp
+The following values for
+.Ar format
+are recognized:
+.Bl -tag -width xxxxxx -offset xx
+.It Sy native
+Native format as used by the operating system.
+.El
+.Pp
+See
+.Xr mknod 8
+for more details.
 .It Cm contents
 The full pathname of a file that holds the contents of this file.
 .It Cm flags
-- 
2.47.2