linux-btrfs.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH 0/5] Documentation updates
@ 2014-05-19 16:19 David Sterba
  2014-05-19 16:19 ` [PATCH 1/5] btrfs-progs: doc: fix argument notation and typos David Sterba
                   ` (4 more replies)
  0 siblings, 5 replies; 6+ messages in thread
From: David Sterba @ 2014-05-19 16:19 UTC (permalink / raw)
  To: linux-btrfs; +Cc: David Sterba

Formatting changes inspired by Hugo's mail and some fixes that I found along
the way. The update in Availability section removes the "heavy development &
not usable" text.

David Sterba (5):
  btrfs-progs: doc: fix argument notation and typos
  btrfs-progs: doc: remove text for unmerged features
  btrfs-progs: doc: autoformat user-supplied arguments by sed
  btrfs-progs: doc: make all commands and subcommands bold
  btrfs-progs: doc: update the Availability section

 Documentation/Makefile                   |  9 ++--
 Documentation/btrfs-balance.txt          | 30 +++++++-------
 Documentation/btrfs-check.txt            | 18 ++++----
 Documentation/btrfs-convert.txt          |  6 +--
 Documentation/btrfs-debug-tree.txt       |  6 +--
 Documentation/btrfs-device.txt           | 27 +++++-------
 Documentation/btrfs-filesystem.txt       | 70 ++++++--------------------------
 Documentation/btrfs-find-root.txt        |  6 +--
 Documentation/btrfs-image.txt            | 10 ++---
 Documentation/btrfs-inspect-internal.txt | 18 ++++----
 Documentation/btrfs-map-logical.txt      |  6 +--
 Documentation/btrfs-property.txt         | 22 +++++-----
 Documentation/btrfs-qgroup.txt           | 36 ++++++++--------
 Documentation/btrfs-quota.txt            | 16 ++++----
 Documentation/btrfs-receive.txt          | 12 +++---
 Documentation/btrfs-replace.txt          | 16 ++++----
 Documentation/btrfs-rescue.txt           | 16 ++++----
 Documentation/btrfs-restore.txt          | 12 +++---
 Documentation/btrfs-scrub.txt            | 26 ++++++------
 Documentation/btrfs-send.txt             | 10 ++---
 Documentation/btrfs-show-super.txt       |  6 +--
 Documentation/btrfs-subvolume.txt        | 34 ++++++++--------
 Documentation/btrfs-zero-log.txt         | 12 +++---
 Documentation/btrfs.txt                  | 48 +++++++++++-----------
 Documentation/btrfstune.txt              |  6 +--
 Documentation/fsck.btrfs.txt             |  6 +--
 Documentation/mkfs.btrfs.txt             | 12 +++---
 27 files changed, 207 insertions(+), 289 deletions(-)

-- 
1.9.0


^ permalink raw reply	[flat|nested] 6+ messages in thread
* [PATCH 1/5] btrfs-progs: doc: fix argument notation and typos
  2014-05-19 16:19 [PATCH 0/5] Documentation updates David Sterba
@ 2014-05-19 16:19 ` David Sterba
  2014-05-19 16:20 ` [PATCH 2/5] btrfs-progs: doc: remove text for unmerged features David Sterba
                   ` (3 subsequent siblings)
  4 siblings, 0 replies; 6+ messages in thread
From: David Sterba @ 2014-05-19 16:19 UTC (permalink / raw)
  To: linux-btrfs; +Cc: David Sterba

All user-supplied values should be enclosed in <...> to distinguish
them from verbatim strings.

Signed-off-by: David Sterba <dsterba@suse.cz>
---
 Documentation/btrfs-balance.txt          |  6 +++---
 Documentation/btrfs-check.txt            |  2 +-
 Documentation/btrfs-filesystem.txt       | 10 +++++-----
 Documentation/btrfs-image.txt            |  4 ++--
 Documentation/btrfs-inspect-internal.txt |  2 +-
 Documentation/btrfs-qgroup.txt           | 10 +++++-----
 Documentation/btrfs-scrub.txt            |  8 ++++----
 Documentation/btrfs-subvolume.txt        |  6 +++---
 Documentation/fsck.btrfs.txt             |  2 +-
 Documentation/mkfs.btrfs.txt             |  2 +-
 10 files changed, 26 insertions(+), 26 deletions(-)

diff --git a/Documentation/btrfs-balance.txt b/Documentation/btrfs-balance.txt
index 1b1861cfd31f..7edc44b150dd 100644
--- a/Documentation/btrfs-balance.txt
+++ b/Documentation/btrfs-balance.txt
@@ -36,11 +36,11 @@ given balance all chunks in a filesystem.
 +
 `Options`
 +
--d[filters]::::
+-d[<filters>]::::
 act on data chunks
--m[filters]::::
+-m[<filters>]::::
 act on metadata chunks
--s[filters]::::
+-s[<filters>]::::
 act on system chunks (only under -f)
 -v::::
 be verbose
diff --git a/Documentation/btrfs-check.txt b/Documentation/btrfs-check.txt
index 485a49cbc3ec..ce491734a981 100644
--- a/Documentation/btrfs-check.txt
+++ b/Documentation/btrfs-check.txt
@@ -22,7 +22,7 @@ https://btrfs.wiki.kernel.org/index.php/Btrfsck
 
 OPTIONS
 -------
--s|--support <superblock>::
+-s|--super <superblock>::
 use <superblock>th superblock copy.
 --repair::
 try to repair the filesystem.
diff --git a/Documentation/btrfs-filesystem.txt b/Documentation/btrfs-filesystem.txt
index de9b3f3c39c4..4ac8711f62c0 100644
--- a/Documentation/btrfs-filesystem.txt
+++ b/Documentation/btrfs-filesystem.txt
@@ -17,7 +17,7 @@ resizing, defragment.
 
 SUBCOMMAND
 ----------
-'df' [-b] path [<path>...]::
+'df' [-b] <path> [<path>...]::
 Show space usage information for a mount point.
 +
 If '-b' is given, then byte is used as unit. Default unit will be
@@ -59,10 +59,10 @@ lower than 100% because the metadata is duplicated for security reasons.
 If all the data and metadata are duplicated (or have a profile like RAID1)
 the Data to disk ratio could be 50%.
 
-'show' [--mounted|--all-devices|<path>|<uuid>|<device>|<lable>]::
+'show' [--mounted|--all-devices|<path>|<uuid>|<device>|<label>]::
 Show the btrfs filesystem with some additional info.
 +
-If no option nor <path>|<uuid>|<device>|<lable> is passed, btrfs shows
+If no option nor <path>|<uuid>|<device>|<label> is passed, btrfs shows
 information of all the btrfs filesystem both mounted and unmounted.
 If '--mounted' is passed, it would probe btrfs kernel to list mounted btrfs
 filesystem(s);
@@ -109,7 +109,7 @@ don't use it if you use snapshots, have de-duplicated your data or made
 copies with `cp --reflink`.
 
 // Some wording are extracted by the resize2fs man page
-'resize' [devid:][+/-]<size>[gkm]|[devid:]max <path>::
+'resize' [<devid>:][+/-]<size>[gkm]|[<devid>:]max <path>::
 Resize a filesystem identified by <path> for the underlying device
 devid *online*. +
 The devid can be found with 'btrfs filesystem show' and
@@ -133,7 +133,7 @@ partition after reducing the size of the filesystem.  This can done using
 it with the new desired size.  When recreating the partition make sure to use
 the same starting disk cylinder as before.
 
-'label' [<dev>|<mount_point>] [newlabel]::
+'label' [<dev>|<mountpoint>] [<newlabel>]::
 Show or update the label of a filesystem.
 +
 [<device>|<mountpoint>] is used to identify the filesystem. 
diff --git a/Documentation/btrfs-image.txt b/Documentation/btrfs-image.txt
index bd74a86cff44..c41e36d6c59a 100644
--- a/Documentation/btrfs-image.txt
+++ b/Documentation/btrfs-image.txt
@@ -24,10 +24,10 @@ using 1 stripe pointing to primary device, so that file system can be
 restored by running tree log reply if possible. To restore without
 changing number of stripes in chunk tree check -o option.
 
--c value::
+-c <value>::
 Compression level (0 ~ 9).
 
--t value::
+-t <value>::
 Number of threads (1 ~ 32) to be used to process the image dump or restore.
 
 -o::
diff --git a/Documentation/btrfs-inspect-internal.txt b/Documentation/btrfs-inspect-internal.txt
index 4555c70670df..c5f751dc4f71 100644
--- a/Documentation/btrfs-inspect-internal.txt
+++ b/Documentation/btrfs-inspect-internal.txt
@@ -23,7 +23,7 @@ Resolves an <inode> in subvolume <path> to all filesystem paths.
 -v::::
 verbose mode. print count of returned paths and ioctl() return value
 
-'logical-resolve' [-Pv] [-s bufsize] <logical> <path>::
+'logical-resolve' [-Pv] [-s <bufsize>] <logical> <path>::
 Resolves a <logical> address in the filesystem mounted at <path> to all inodes.
 +
 By default, each inode is then resolved to a file system path (similar to the
diff --git a/Documentation/btrfs-qgroup.txt b/Documentation/btrfs-qgroup.txt
index d0544232f353..531febb3a086 100644
--- a/Documentation/btrfs-qgroup.txt
+++ b/Documentation/btrfs-qgroup.txt
@@ -73,15 +73,15 @@ print max exclusive size of qgroup.
 list all qgroups which impact the given path(include ancestral qgroups)
 -f::::
 list all qgroups which impact the given path(exclude ancestral qgroups)
---sort=[\+/-]ATTR[,[+/-]ATTR]...::::
-list qgroups in order of ATTR.
+--sort=[\+/-]<attr>[,[+/-]<attr>]...::::
+list qgroups in order of <attr>.
 +
-ATTR can be one or more of qgroupid,rfer,excl,max_rfer,max_excl.
+<attr> can be one or more of qgroupid,rfer,excl,max_rfer,max_excl.
 +
-Prefix \'+' means ascending order and \'-' means descending order of ATTR.
+Prefix \'+' means ascending order and \'-' means descending order of <attr>.
 If no prefix is given, use ascending order by default.
 +
-If multiple ATTRs is given, use comma to separate.
+If multiple <attr>s is given, use comma to separate.
 
 'limit' [options] <size>|none [<qgroupid>] <path>::
 Limit the size of a qgroup to <size> or no limit in the btrfs filesystem
diff --git a/Documentation/btrfs-scrub.txt b/Documentation/btrfs-scrub.txt
index 3973f3174c72..c87658739620 100644
--- a/Documentation/btrfs-scrub.txt
+++ b/Documentation/btrfs-scrub.txt
@@ -16,7 +16,7 @@ from all disks and verifying checksums.
 
 SUBCOMMAND
 ----------
-'start' [-BdqrRf] [-c ioprio_class -n ioprio_classdata] <path>|<device>::
+'start' [-BdqrRf] [-c <ioprio_class> -n <ioprio_classdata>] <path>|<device>::
 Start a scrub on all devices of the filesystem identified by <path> or on
 a single <device>.
 +
@@ -40,11 +40,11 @@ Quiet. Omit error messages and statistics.
 Read only mode. Do not attempt to correct anything.
 -R::::
 Raw print mode. Print full data instead of summary.
--c ioprio_class::::
+-c <ioprio_class>::::
 Set IO priority class (see
  ionice (1)
 manpage).
--n ioprio_classdata::::
+-n <ioprio_classdata>::::
 Set IO priority classdata (see `ionice`(1) manpage).
 -f::::
 force to check whether scrub has started or resumed in userspace.
@@ -58,7 +58,7 @@ using the scrub resume command.
 If a <device> is given, the corresponding filesystem is found and
 scrub cancel behaves as if it was called on that filesystem.
 
-'resume' [-BdqrR] [-c ioprio_class -n ioprio_classdata] <path>|<device>::
+'resume' [-BdqrR] [-c <ioprio_class> -n <ioprio_classdata>] <path>|<device>::
 Resume a canceled or interrupted scrub cycle on the filesystem identified by
 <path> or on a given <device>.
 +
diff --git a/Documentation/btrfs-subvolume.txt b/Documentation/btrfs-subvolume.txt
index 7f32dbdfe538..6cc72803b34a 100644
--- a/Documentation/btrfs-subvolume.txt
+++ b/Documentation/btrfs-subvolume.txt
@@ -75,7 +75,7 @@ wait for transaction commit at the end of the operation
 -C|--commit-each::::
 wait for transaction commit after delet each subvolume
 
-'list' [options] [-G [\+|-] values] [-C [+|-]value] [--sort=rootid,gen,ogen,path] <path>::
+'list' [options] [-G [\+|-]<value>] [-C [+|-]<value>] [--sort=rootid,gen,ogen,path] <path>::
 List the subvolumes present in the filesystem <path>.
 +
 For every subvolume the following information is shown by default. +
@@ -110,11 +110,11 @@ print the result as a table.
 only snapshot subvolumes in the filesystem will be listed.
 -r::::
 only readonly subvolumes in the filesystem will be listed.
--G [+|-]value::::
+-G [+|-]<value>::::
 list subvolumes in the filesystem that its generation is
 >=, \<= or = value. \'\+' means >= value, \'-' means \<= value, If there is
 neither \'+' nor \'-', it means = value.
--C [+|-]value::::
+-C [+|-]<value>::::
 list subvolumes in the filesystem that its ogeneration is
 >=, \<= or = value. The usage is the same to '-g' option.
 --sort=rootid,gen,ogen,path::::
diff --git a/Documentation/fsck.btrfs.txt b/Documentation/fsck.btrfs.txt
index 52e8e4d0375f..cc4544a58b1b 100644
--- a/Documentation/fsck.btrfs.txt
+++ b/Documentation/fsck.btrfs.txt
@@ -7,7 +7,7 @@ fsck.btrfs - do nothing, successfully
 
 SYNOPSIS
 --------
-'fsck.btrfs' [-aApy] [device...]
+'fsck.btrfs' [-aApy] [<device>...]
 
 DESCRIPTION
 -----------
diff --git a/Documentation/mkfs.btrfs.txt b/Documentation/mkfs.btrfs.txt
index 7ce009611d93..95098328bb68 100644
--- a/Documentation/mkfs.btrfs.txt
+++ b/Documentation/mkfs.btrfs.txt
@@ -20,7 +20,7 @@ $$[-M|--mixed]$$
 $$[-s|--sectorsize <sectorsize>]$$
 $$[-r|--rootdir <rootdir>]$$
 $$[-K|--nodiscard]$$
-$$[-O|--features <feature1>[<,feature2...>]]$$
+$$[-O|--features <feature1>[,<feature2>...]]$$
 $$[-h]$$
 $$[-V|--version]$$
 $$<device> [<device>...]$$
-- 
1.9.0


^ permalink raw reply related	[flat|nested] 6+ messages in thread
* [PATCH 2/5] btrfs-progs: doc: remove text for unmerged features
  2014-05-19 16:19 [PATCH 0/5] Documentation updates David Sterba
  2014-05-19 16:19 ` [PATCH 1/5] btrfs-progs: doc: fix argument notation and typos David Sterba
@ 2014-05-19 16:20 ` David Sterba
  2014-05-19 16:20 ` [PATCH 3/5] btrfs-progs: doc: autoformat user-supplied arguments by sed David Sterba
                   ` (2 subsequent siblings)
  4 siblings, 0 replies; 6+ messages in thread
From: David Sterba @ 2014-05-19 16:20 UTC (permalink / raw)
  To: linux-btrfs; +Cc: David Sterba

The asciidoc conversion was done on a development branch and there are
portions of text that do not reflect the code.

Signed-off-by: David Sterba <dsterba@suse.cz>
---
 Documentation/btrfs-device.txt     |  5 -----
 Documentation/btrfs-filesystem.txt | 46 +-------------------------------------
 2 files changed, 1 insertion(+), 50 deletions(-)

diff --git a/Documentation/btrfs-device.txt b/Documentation/btrfs-device.txt
index 7a6bce5c650a..9cd8ad081a5a 100644
--- a/Documentation/btrfs-device.txt
+++ b/Documentation/btrfs-device.txt
@@ -86,11 +86,6 @@ filesystem as listed by blkid.
 Finally, if '--all-devices' or '-d' is passed, all the devices under /dev are 
 scanned.
 
-'disk-usage' [-b] <path> [<path>..]::
-Show which chunks are in a device.
-+
-If '-b' is given, byte will be set as unit.
-
 'ready' <device>::
 Check device to see if it has all of it's devices in cache for mounting.
 
diff --git a/Documentation/btrfs-filesystem.txt b/Documentation/btrfs-filesystem.txt
index 4ac8711f62c0..63e3ef676cd3 100644
--- a/Documentation/btrfs-filesystem.txt
+++ b/Documentation/btrfs-filesystem.txt
@@ -17,47 +17,8 @@ resizing, defragment.
 
 SUBCOMMAND
 ----------
-'df' [-b] <path> [<path>...]::
+'df' <path> [<path>...]::
 Show space usage information for a mount point.
-+
-If '-b' is given, then byte is used as unit. Default unit will be
-human-readable unit such as KiB/MiB/GiB.
-+
-The command 'btrfs filesystem df' is used to query how many space on the 
-disk(s) are used and an estimation of the free
-space of the filesystem.
-The output of the command 'btrfs filesystem df' shows:
-
-`Disk size`::::
-the total size of the disks which compose the filesystem.
-
-`Disk allocated`::::
-the size of the area of the disks used by the chunks.
-
-`Disk unallocated`::::
-the size of the area of the disks which is free (i.e.
-the differences of the values above).
-
-`Used`::::
-the portion of the logical space used by the file and metadata.
-
-`Free (estimated)`::::
-the estimated free space available: i.e. how many space can be used
-by the user. The evaluation cannot be rigorous because it depends by the
-allocation policy (DUP, Single, RAID1...) of the metadata and data chunks. +
-If every chunk is stored as "Single" the sum of the free (estimated) space
-and the used space  is equal to the disk size.
-Otherwise if all the chunk are mirrored (raid1 or raid10) or duplicated
-the sum of the free (estimated) space and the used space is
-half of the disk size. Normally the free (estimated) is between
-these two limits.
-
-`Data to disk ratio`::::
-the ratio betwen the logical size (i.e. the space available by
-the chunks) and the disk allocated (by the chunks). Normally it is 
-lower than 100% because the metadata is duplicated for security reasons.
-If all the data and metadata are duplicated (or have a profile like RAID1)
-the Data to disk ratio could be 50%.
 
 'show' [--mounted|--all-devices|<path>|<uuid>|<device>|<label>]::
 Show the btrfs filesystem with some additional info.
@@ -140,11 +101,6 @@ Show or update the label of a filesystem.
 If a newlabel optional argument is passed, the label is changed.
 NOTE: the maximum allowable length shall be less than 256 chars
 
-'disk-usage' [-tb] path [path...]::
-Show in which disk the chunks are allocated. +
-If '-b' is given,  set byte as unit;
-If '-t' is given, show data in tabular format.
-
 EXIT STATUS
 -----------
 'btrfs filesystem' returns a zero exist status if it succeeds. Non zero is
-- 
1.9.0


^ permalink raw reply related	[flat|nested] 6+ messages in thread
* [PATCH 3/5] btrfs-progs: doc: autoformat user-supplied arguments by sed
  2014-05-19 16:19 [PATCH 0/5] Documentation updates David Sterba
  2014-05-19 16:19 ` [PATCH 1/5] btrfs-progs: doc: fix argument notation and typos David Sterba
  2014-05-19 16:20 ` [PATCH 2/5] btrfs-progs: doc: remove text for unmerged features David Sterba
@ 2014-05-19 16:20 ` David Sterba
  2014-05-19 16:20 ` [PATCH 4/5] btrfs-progs: doc: make all commands and subcommands bold David Sterba
  2014-05-19 16:20 ` [PATCH 5/5] btrfs-progs: doc: update the Availability section David Sterba
  4 siblings, 0 replies; 6+ messages in thread
From: David Sterba @ 2014-05-19 16:20 UTC (permalink / raw)
  To: linux-btrfs; +Cc: David Sterba

Convert all values enclosed between <...> to italic before it goes to
asciidoc processor.

Signed-off-by: David Sterba <dsterba@suse.cz>
---
 Documentation/Makefile | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/Documentation/Makefile b/Documentation/Makefile
index e22f5bca0ff2..45299bb29f9b 100644
--- a/Documentation/Makefile
+++ b/Documentation/Makefile
@@ -85,10 +85,11 @@ clean:
 %.8 : %.xml 
 	$(QUIET_XMLTO)$(RM) $@ && \
 	$(XMLTO) -m $(MANPAGE_XSL) $(XMLTO_EXTRA) man $<
-
 %.xml : %.txt asciidoc.conf
-	$(QUIET_ASCIIDOC)$(RM) $@+ $@ && \
+	$(QUIET_ASCIIDOC)$(RM) $@.tmp[12] $@ && \
+	sed -e "s/\(<[^>]\+>\)/'\1'/g" < $< > $@.tmp1 && \
 	$(ASCIIDOC) -b docbook -d manpage -f asciidoc.conf \
 		$(ASCIIDOC_EXTRA) -abtrfs_version=$(BTRFS_VERSION) \
-		-o $@+ $< && \
-	mv $@+ $@
+		-o $@.tmp2 $@.tmp1 && \
+	mv $@.tmp2 $@ && \
+	rm -f -- $@.tmp1
-- 
1.9.0


^ permalink raw reply related	[flat|nested] 6+ messages in thread
* [PATCH 4/5] btrfs-progs: doc: make all commands and subcommands bold
  2014-05-19 16:19 [PATCH 0/5] Documentation updates David Sterba
                   ` (2 preceding siblings ...)
  2014-05-19 16:20 ` [PATCH 3/5] btrfs-progs: doc: autoformat user-supplied arguments by sed David Sterba
@ 2014-05-19 16:20 ` David Sterba
  2014-05-19 16:20 ` [PATCH 5/5] btrfs-progs: doc: update the Availability section David Sterba
  4 siblings, 0 replies; 6+ messages in thread
From: David Sterba @ 2014-05-19 16:20 UTC (permalink / raw)
  To: linux-btrfs; +Cc: David Sterba

Italic format is used for parameters and values, bold makes the text visually
separated.

Signed-off-by: David Sterba <dsterba@suse.cz>
---
 Documentation/btrfs-balance.txt          | 22 +++++++--------
 Documentation/btrfs-check.txt            | 14 +++++-----
 Documentation/btrfs-convert.txt          |  6 ++---
 Documentation/btrfs-debug-tree.txt       |  6 ++---
 Documentation/btrfs-device.txt           | 20 +++++++-------
 Documentation/btrfs-filesystem.txt       | 22 +++++++--------
 Documentation/btrfs-find-root.txt        |  6 ++---
 Documentation/btrfs-image.txt            |  6 ++---
 Documentation/btrfs-inspect-internal.txt | 16 +++++------
 Documentation/btrfs-map-logical.txt      |  6 ++---
 Documentation/btrfs-property.txt         | 20 +++++++-------
 Documentation/btrfs-qgroup.txt           | 24 ++++++++---------
 Documentation/btrfs-quota.txt            | 14 +++++-----
 Documentation/btrfs-receive.txt          | 10 +++----
 Documentation/btrfs-replace.txt          | 14 +++++-----
 Documentation/btrfs-rescue.txt           | 14 +++++-----
 Documentation/btrfs-restore.txt          | 10 +++----
 Documentation/btrfs-scrub.txt            | 20 +++++++-------
 Documentation/btrfs-send.txt             |  8 +++---
 Documentation/btrfs-show-super.txt       |  6 ++---
 Documentation/btrfs-subvolume.txt        | 28 +++++++++----------
 Documentation/btrfs-zero-log.txt         | 12 ++++-----
 Documentation/btrfs.txt                  | 46 ++++++++++++++++----------------
 Documentation/btrfstune.txt              |  6 ++---
 Documentation/fsck.btrfs.txt             |  6 ++---
 Documentation/mkfs.btrfs.txt             |  8 +++---
 26 files changed, 185 insertions(+), 185 deletions(-)

diff --git a/Documentation/btrfs-balance.txt b/Documentation/btrfs-balance.txt
index 7edc44b150dd..d34833d6f380 100644
--- a/Documentation/btrfs-balance.txt
+++ b/Documentation/btrfs-balance.txt
@@ -7,11 +7,11 @@ btrfs-balance - balance btrfs filesystem
 
 SYNOPSIS
 --------
-'btrfs [filesystem] balance' <subcommand>|<args>
+*btrfs [filesystem] balance* <subcommand>|<args>
 
 DESCRIPTION
 -----------
-'btrfs balance' is used to balance chunks in a btrfs filesystem across
+*btrfs balance* is used to balance chunks in a btrfs filesystem across
 multiple or even single device.
 
 See `btrfs-device`(8) for more details about the effect on device management.
@@ -21,10 +21,10 @@ SUBCOMMAND
 <path>::
 Balance chunks across the devices *online*.
 +
-'btrfs balance <path>' is deprecated,
-please use 'btrfs balance start' command instead.
+*btrfs balance <path>* is deprecated,
+please use *btrfs balance start* command instead.
 
-'start' [options] <path>::
+*start* [options] <path>::
 Balance chunks across the devices *online*.
 +
 Balance and/or convert (change allocation profile of) chunks that
@@ -47,28 +47,28 @@ be verbose
 -f::::
 force reducing of metadata integrity
 
-'pause' <path>::
+*pause* <path>::
 Pause running balance.
 
-'cancel' <path>::
+*cancel* <path>::
 Cancel running or paused balance.
 
-'resume' <path>::
+*resume* <path>::
 Resume interrupted balance.
 
-'status' [-v] <path>::
+*status* [-v] <path>::
 Show status of running or paused balance.
 +
 If '-v' option is given, output will be verbose.
 
 EXIT STATUS
 -----------
-'btrfs balance' returns a zero exist status if it succeeds. Non zero is
+*btrfs balance* returns a zero exist status if it succeeds. Non zero is
 returned in case of failure.
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
diff --git a/Documentation/btrfs-check.txt b/Documentation/btrfs-check.txt
index ce491734a981..073667265c13 100644
--- a/Documentation/btrfs-check.txt
+++ b/Documentation/btrfs-check.txt
@@ -7,18 +7,18 @@ btrfs-check - check or repair a btrfs filesystem offline
 
 SYNOPSIS
 --------
-'btrfs check' [options] <device>
+*btrfs check* [options] <device>
 
 DESCRIPTION
 -----------
-'btrfs check' is used to check or repair a btrfs filesystem offline.
+*btrfs check* is used to check or repair a btrfs filesystem offline.
 
-NOTE: Since btrfs is under heavy development especially the 'btrfs check'
+NOTE: Since btrfs is under heavy development especially the *btrfs check*
 command, it is *highly* recommended to read the following btrfs wiki before
-executing 'btrfs check' with '--repair' option: +
+executing *btrfs check* with '--repair' option: +
 https://btrfs.wiki.kernel.org/index.php/Btrfsck
 
-'btrfsck' is an alias of 'btrfs check' command and is now deprecated.
+*btrfsck* is an alias of *btrfs check* command and is now deprecated.
 
 OPTIONS
 -------
@@ -33,12 +33,12 @@ create a new extent tree.
 
 EXIT STATUS
 -----------
-'btrfs check' returns a zero exist status if it succeeds. Non zero is
+*btrfs check* returns a zero exist status if it succeeds. Non zero is
 returned in case of failure.
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
diff --git a/Documentation/btrfs-convert.txt b/Documentation/btrfs-convert.txt
index 780ca9ef052a..ed61d143d59f 100644
--- a/Documentation/btrfs-convert.txt
+++ b/Documentation/btrfs-convert.txt
@@ -7,11 +7,11 @@ btrfs-convert - convert from ext2/3/4 filesystem to btrfs or rollback
 
 SYNOPSIS
 --------
-'btrfs-convert' [options] <device>
+*btrfs-convert* [options] <device>
 
 DESCRIPTION
 -----------
-'btrfs-convert' is used to convert existed ext2/3/4 to btrfs filesystem,
+*btrfs-convert* is used to convert existed ext2/3/4 to btrfs filesystem,
 and the original filesystem image is accessible as from separate subvolume
 named 'ext2_subvol' as file image.
 
@@ -28,7 +28,7 @@ Roll back to ext2fs.
 
 EXIT STATUS
 -----------
-'btrfs-convert' will return 0 if no error happened.
+*btrfs-convert* will return 0 if no error happened.
 If any problems happened, 1 will be returned.
 
 AUTHOR
diff --git a/Documentation/btrfs-debug-tree.txt b/Documentation/btrfs-debug-tree.txt
index 80a85d44cdbb..bfc8aa401abb 100644
--- a/Documentation/btrfs-debug-tree.txt
+++ b/Documentation/btrfs-debug-tree.txt
@@ -7,11 +7,11 @@ btrfs-debug-tree - dump btrfs filesystem metadata into stdout
 
 SYNOPSIS
 --------
-'btrfs-debug-tree' [options] <device>
+*btrfs-debug-tree* [options] <device>
 
 DESCRIPTION
 -----------
-'btrfs-debug-tree' is used to dump the whole tree of the given device.
+*btrfs-debug-tree* is used to dump the whole tree of the given device.
 
 This is maybe useful for analyzing filesystem state or inconsistence and has
 a positive educational effect on understanding the internal structure.
@@ -30,7 +30,7 @@ Print info of the specified block only.
 
 EXIT STATUS
 -----------
-'btrfs-debug-tree' will return 0 if no error happened.
+*btrfs-debug-tree* will return 0 if no error happened.
 If any problems happened, 1 will be returned.
 
 AUTHOR
diff --git a/Documentation/btrfs-device.txt b/Documentation/btrfs-device.txt
index 9cd8ad081a5a..4f847763bb66 100644
--- a/Documentation/btrfs-device.txt
+++ b/Documentation/btrfs-device.txt
@@ -7,12 +7,12 @@ btrfs-device - control btrfs devices
 
 SYNOPSIS
 --------
-'btrfs device' <subcommand> <args>
+*btrfs device* <subcommand> <args>
 
 DESCRIPTION
 -----------
-'btrfs device' is used to control the btrfs devices, since btrfs can be used
-across several devices, 'btrfs device' is used for multiple device management.
+*btrfs device* is used to control the btrfs devices, since btrfs can be used
+across several devices, *btrfs device* is used for multiple device management.
 
 DEVICE MANAGEMENT
 -----------------
@@ -62,7 +62,7 @@ See `btrfs-replace`(8) and this man page for more details.
 
 SUBCOMMAND
 ----------
-'add' [-Kf] <dev> [<dev>...] <path>::
+*add* [-Kf] <dev> [<dev>...] <path>::
 Add device(s) to the filesystem identified by <path>.
 +
 If applicable, a whole device discard (TRIM) operation is performed.
@@ -74,10 +74,10 @@ do not perform discard by default
 -f|--force::::
 force overwrite of existing filesystem on the given disk(s)
 
-'delete' <dev> [<dev>...] <path>::
+*delete* <dev> [<dev>...] <path>::
 Remove device(s) from a filesystem identified by <path>.
 
-'scan' [(--all-devices|-d)|<device> [<device>...]]::
+*scan* [(--all-devices|-d)|<device> [<device>...]]::
 Scan devices for a btrfs filesystem.
 +
 If one or more devices are passed, these are scanned for a btrfs filesystem. 
@@ -86,10 +86,10 @@ filesystem as listed by blkid.
 Finally, if '--all-devices' or '-d' is passed, all the devices under /dev are 
 scanned.
 
-'ready' <device>::
+*ready* <device>::
 Check device to see if it has all of it's devices in cache for mounting.
 
-'stats' [-z] <path>|<device>::
+*stats* [-z] <path>|<device>::
 Read and print the device IO stats for all devices of the filesystem
 identified by <path> or for a single <device>.
 +
@@ -100,12 +100,12 @@ Reset stats to zero after reading them.
 
 EXIT STATUS
 -----------
-'btrfs device' returns a zero exist status if it succeeds. Non zero is
+*btrfs device* returns a zero exist status if it succeeds. Non zero is
 returned in case of failure.
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
diff --git a/Documentation/btrfs-filesystem.txt b/Documentation/btrfs-filesystem.txt
index 63e3ef676cd3..e3e270ff0957 100644
--- a/Documentation/btrfs-filesystem.txt
+++ b/Documentation/btrfs-filesystem.txt
@@ -7,20 +7,20 @@ btrfs-filesystem - control btrfs filesystem
 
 SYNOPSIS
 --------
-'btrfs filesystem' <subcommand> <args>
+*btrfs filesystem* <subcommand> <args>
 
 DESCRIPTION
 -----------
-'btrfs filesystem' is used to do the filesystem level control jobs, including
+*btrfs filesystem* is used to do the filesystem level control jobs, including
 all the regular filesystem operations like setting/getting label,
 resizing, defragment.
 
 SUBCOMMAND
 ----------
-'df' <path> [<path>...]::
+*df* <path> [<path>...]::
 Show space usage information for a mount point.
 
-'show' [--mounted|--all-devices|<path>|<uuid>|<device>|<label>]::
+*show* [--mounted|--all-devices|<path>|<uuid>|<device>|<label>]::
 Show the btrfs filesystem with some additional info.
 +
 If no option nor <path>|<uuid>|<device>|<label> is passed, btrfs shows
@@ -30,10 +30,10 @@ filesystem(s);
 If '--all-devices' is passed, all the devices under /dev are scanned;
 otherwise the devices list is extracted from the /proc/partitions file.
 
-'sync' <path>::
+*sync* <path>::
 Force a sync for the filesystem identified by <path>.
 
-'defragment' [options] <file>|<dir> [<file>|<dir>...]::
+*defragment* [options] <file>|<dir> [<file>|<dir>...]::
 Defragment file data and/or directory metadata *online*.
 +
 If '-r' is passed, files in dir will be defragmented recursively.
@@ -70,10 +70,10 @@ don't use it if you use snapshots, have de-duplicated your data or made
 copies with `cp --reflink`.
 
 // Some wording are extracted by the resize2fs man page
-'resize' [<devid>:][+/-]<size>[gkm]|[<devid>:]max <path>::
+*resize* [<devid>:][+/-]<size>[gkm]|[<devid>:]max <path>::
 Resize a filesystem identified by <path> for the underlying device
 devid *online*. +
-The devid can be found with 'btrfs filesystem show' and
+The devid can be found with *btrfs filesystem show* and
 defaults to 1 if not specified.
 The <size> parameter specifies the new size of the filesystem.
 If the prefix + or - is present the size is increased or decreased
@@ -94,7 +94,7 @@ partition after reducing the size of the filesystem.  This can done using
 it with the new desired size.  When recreating the partition make sure to use
 the same starting disk cylinder as before.
 
-'label' [<dev>|<mountpoint>] [<newlabel>]::
+*label* [<dev>|<mountpoint>] [<newlabel>]::
 Show or update the label of a filesystem.
 +
 [<device>|<mountpoint>] is used to identify the filesystem. 
@@ -103,12 +103,12 @@ NOTE: the maximum allowable length shall be less than 256 chars
 
 EXIT STATUS
 -----------
-'btrfs filesystem' returns a zero exist status if it succeeds. Non zero is
+*btrfs filesystem* returns a zero exist status if it succeeds. Non zero is
 returned in case of failure.
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
diff --git a/Documentation/btrfs-find-root.txt b/Documentation/btrfs-find-root.txt
index 18b1e845b143..a360f8f6e9f2 100644
--- a/Documentation/btrfs-find-root.txt
+++ b/Documentation/btrfs-find-root.txt
@@ -7,11 +7,11 @@ btrfs-find-root - filter to find btrfs root
 
 SYNOPSIS
 --------
-'btrfs-find-root' [options] <dev>
+*btrfs-find-root* [options] <dev>
 
 DESCRIPTION
 -----------
-'btrfs-find-root' is used to find the satisfied root, you can filter by
+*btrfs-find-root* is used to find the satisfied root, you can filter by
 root tree's objectid, generation, level.
 
 OPTIONS
@@ -25,7 +25,7 @@ Filter root tree by B-+ tree's level, level 0 in default.
 
 EXIT STATUS
 -----------
-'btrfs-find-root' will return 0 if no error happened.
+*btrfs-find-root* will return 0 if no error happened.
 If any problems happened, 1 will be returned.
 
 AUTHOR
diff --git a/Documentation/btrfs-image.txt b/Documentation/btrfs-image.txt
index c41e36d6c59a..7ee820c22721 100644
--- a/Documentation/btrfs-image.txt
+++ b/Documentation/btrfs-image.txt
@@ -7,11 +7,11 @@ btrfs-image - create/restore an image of the filesystem
 
 SYNOPSIS
 --------
-'btrfs-image' [options] <source> <target>
+*btrfs-image* [options] <source> <target>
 
 DESCRIPTION
 -----------
-'btrfs-image' is used to create an image of a btrfs filesystem.
+*btrfs-image* is used to create an image of a btrfs filesystem.
 All data will be zeroed, but metadata and the like is preserved.
 
 Mainly used for debug purpose.
@@ -50,7 +50,7 @@ captured.
 
 EXIT STATUS
 -----------
-'btrfs-image' will return 0 if no error happened.
+*btrfs-image* will return 0 if no error happened.
 If any problems happened, 1 will be returned.
 
 AUTHOR
diff --git a/Documentation/btrfs-inspect-internal.txt b/Documentation/btrfs-inspect-internal.txt
index c5f751dc4f71..fe76217365b0 100644
--- a/Documentation/btrfs-inspect-internal.txt
+++ b/Documentation/btrfs-inspect-internal.txt
@@ -7,15 +7,15 @@ btrfs-inspect-internal - resolve different btrfs items for debug purpose
 
 SYNOPSIS
 --------
-'btrfs inspect-internal' <subcommand> <args>
+*btrfs inspect-internal* <subcommand> <args>
 
 DESCRIPTION
 -----------
-'btrfs inspect-internal' is used to resolve different items for debug purpose.
+*btrfs inspect-internal* is used to resolve different items for debug purpose.
 
 SUBCOMMAND
 ----------
-'inode-resolve' [-v] <inode> <path>::
+*inode-resolve* [-v] <inode> <path>::
 Resolves an <inode> in subvolume <path> to all filesystem paths.
 +
 `Options`
@@ -23,7 +23,7 @@ Resolves an <inode> in subvolume <path> to all filesystem paths.
 -v::::
 verbose mode. print count of returned paths and ioctl() return value
 
-'logical-resolve' [-Pv] [-s <bufsize>] <logical> <path>::
+*logical-resolve* [-Pv] [-s <bufsize>] <logical> <path>::
 Resolves a <logical> address in the filesystem mounted at <path> to all inodes.
 +
 By default, each inode is then resolved to a file system path (similar to the
@@ -41,10 +41,10 @@ set inode container's size.
 This is used to increase inode container's size in case it is
 not enough to read all the resolved results. The max value one can set is 64k.
 
-'subvolid-resolve' <subvolid> <path>::
+*subvolid-resolve* <subvolid> <path>::
 Get file system paths for the given subvolume ID.
 
-'rootid' <path>::
+*rootid* <path>::
 For a given file or directory, return the containing tree root id. For a
 subvolume return it's own tree id.
 +
@@ -52,12 +52,12 @@ The result is undefined for the so-called empty subvolumes (identified by inode
 
 EXIT STATUS
 -----------
-'btrfs inspect-internal' returns a zero exist status if it succeeds. Non zero is
+*btrfs inspect-internal* returns a zero exist status if it succeeds. Non zero is
 returned in case of failure.
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
diff --git a/Documentation/btrfs-map-logical.txt b/Documentation/btrfs-map-logical.txt
index 2a93fb052514..a8710bfa24b0 100644
--- a/Documentation/btrfs-map-logical.txt
+++ b/Documentation/btrfs-map-logical.txt
@@ -7,11 +7,11 @@ btrfs-map-logical - map btrfs logical extent to physical extent
 
 SYNOPSIS
 --------
-'btrfs-map-logical' <options> <device>
+*btrfs-map-logical* <options> <device>
 
 DESCRIPTION
 -----------
-'btrfs-map-logical' can be used to find out what the physical offsets are
+*btrfs-map-logical* can be used to find out what the physical offsets are
 on the mirrors, the result is dumped into stdout in default.
 
 Mainly used for debug purpose.
@@ -29,7 +29,7 @@ Number of bytes to read.
 
 EXIT STATUS
 -----------
-'btrfs-map-logical' will return 0 if no error happened.
+*btrfs-map-logical* will return 0 if no error happened.
 If any problems happened, 1 will be returned.
 
 AUTHOR
diff --git a/Documentation/btrfs-property.txt b/Documentation/btrfs-property.txt
index 82466f9e6dff..4b0f49e04b20 100644
--- a/Documentation/btrfs-property.txt
+++ b/Documentation/btrfs-property.txt
@@ -7,20 +7,20 @@ btrfs-property - get/set/list properties for given btrfs object.
 
 SYNOPSIS
 --------
-'btrfs property' <subcommand> <args>
+*btrfs property* <subcommand> <args>
 
 DESCRIPTION
 -----------
-'btrfs property' is used to get/set/list property, like lable or compression
+*btrfs property* is used to get/set/list property, like lable or compression
 state, for given btrfs object.
 
-'btrfs property' provides an unified and user-friendly method to tune different
+*btrfs property* provides an unified and user-friendly method to tune different
 btrfs properties instead of using the traditional method like `chattr`(1) or
 `lsattr`(1).
 
 SUBCOMMAND
 ----------
-'get' [-t <type>] <object> [<name>]::
+*get* [-t <type>] <object> [<name>]::
 Gets a property from a btrfs object.
 +
 If no name is specified, all properties for the given object are
@@ -37,26 +37,26 @@ Possible types are 's[ubvol]', 'f[ilesystem]', 'i[node]' and 'd[evice]'.
 The <object> can be path of btrfs device, btrfs mount point, or any
 directories/files inside btrfs.
 
-'set' [-t <type>] <object> <name> <value>::
+*set* [-t <type>] <object> <name> <value>::
 Sets a property on a btrfs object.
 +
-See description of 'get' subcommand for a description of objects and object
+See description of *get* subcommand for a description of objects and object
 types.
 
-'list' [-t <type>] <object>::
+*list* [-t <type>] <object>::
 Lists available properties with their descriptions for the given object.
 +
-Please see the help of 'btrfs property get' for a description of
+Please see the help of *btrfs property get* for a description of
 objects and object types.
 
 EXIT STATUS
 -----------
-'btrfs property' returns a zero exist status if it succeeds. Non zero is
+*btrfs property* returns a zero exist status if it succeeds. Non zero is
 returned in case of failure.
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
diff --git a/Documentation/btrfs-qgroup.txt b/Documentation/btrfs-qgroup.txt
index 531febb3a086..12321926b25b 100644
--- a/Documentation/btrfs-qgroup.txt
+++ b/Documentation/btrfs-qgroup.txt
@@ -7,13 +7,13 @@ btrfs-qgroup - control the quota group of a btrfs filesystem
 
 SYNOPSIS
 --------
-'btrfs qgroup' <subcommand> <args>
+*btrfs qgroup* <subcommand> <args>
 
 DESCRIPTION
 -----------
-'btrfs qgroup' is used to control quota group(qgroup) of a btrfs filesystem.
+*btrfs qgroup* is used to control quota group(qgroup) of a btrfs filesystem.
 
-NOTE: To use qgroup, it needs to enable quota first using 'btrfs quota'
+NOTE: To use qgroup, it needs to enable quota first using *btrfs quota*
 command.
 
 WARNING: Qgroup is not stable yet and will impact performance in current mainline
@@ -29,34 +29,34 @@ Also for snapshot, it consumes no quota initially since all its data
 shares with its parent, so only modification in snapshot consumes quota.
 
 Every subvolume/snapshot will have its own qgroup with id '0/<subvolume id>'
-upon creating, but can be later destroyed by 'btrfs qgroup destroy' command.
+upon creating, but can be later destroyed by *btrfs qgroup destroy* command.
 
 NOTE: If the qgroup of a subvolume is destroyed, quota about the subvolume
 will not be functional until qgroup '0/<subvolume id>' is created again.
 
 SUBCOMMAND
 ----------
-'assign' <src> <dst> <path>::
+*assign* <src> <dst> <path>::
 Assign qgroup <src> as the child qgroup of <dst> in the btrfs filesystem
 identified by <path>.
 
-'remove' <src> <dst> <path>::
+*remove* <src> <dst> <path>::
 Remove the relationship between child qgroup <src> and parent qgroup <dst> in
 the btrfs filesystem identified by <path>.
 
-'create' <qgroupid> <path>::
+*create* <qgroupid> <path>::
 Create a subvolume quota group.
 +
 For the '0/<subvolume id>' qgroup, a qgroup can be created even before the
 subvolume created.
 
-'destroy' <qgroupid> <path>::
+*destroy* <qgroupid> <path>::
 Destroy a qgroup.
 +
 If a qgroup is no isolated,which means it is a parent or child qgroup, it
 can't be destroyed.
 
-'show' [options] <path>::
+*show* [options] <path>::
 Show all qgroups in the btrfs filesystem identified by <path>.
 +
 `Options`
@@ -83,7 +83,7 @@ If no prefix is given, use ascending order by default.
 +
 If multiple <attr>s is given, use comma to separate.
 
-'limit' [options] <size>|none [<qgroupid>] <path>::
+*limit* [options] <size>|none [<qgroupid>] <path>::
 Limit the size of a qgroup to <size> or no limit in the btrfs filesystem
 identified by <path>.
 +
@@ -92,12 +92,12 @@ is used if possible.
 
 EXIT STATUS
 -----------
-'btrfs qgroup' returns a zero exist status if it succeeds. Non zero is
+*btrfs qgroup* returns a zero exist status if it succeeds. Non zero is
 returned in case of failure.
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
diff --git a/Documentation/btrfs-quota.txt b/Documentation/btrfs-quota.txt
index 82f2f499c730..f7b0fd13b0db 100644
--- a/Documentation/btrfs-quota.txt
+++ b/Documentation/btrfs-quota.txt
@@ -7,11 +7,11 @@ btrfs-quota - control the quota of a btrfs filesystem
 
 SYNOPSIS
 --------
-'btrfs quota' <subcommand> <args>
+*btrfs quota* <subcommand> <args>
 
 DESCRIPTION
 -----------
-'btrfs quota' is used to enable/disable or rescan subvolume quota of a btrfs
+*btrfs quota* is used to enable/disable or rescan subvolume quota of a btrfs
 filesystem.
 
 For setting quota or other quota operations on a btrfs filesystem, please see
@@ -22,14 +22,14 @@ performance in mainline kernel yet(v3.14 so far).
 
 SUBCOMMAND
 ----------
-'enable' <path>::
+*enable* <path>::
 Enable subvolume quota support for a filesystem.
 
 
-'disable' <path>::
+*disable* <path>::
 Disable subvolume quota support for a filesystem.
 
-'rescan' [-s] <path>::
+*rescan* [-s] <path>::
 Trash all qgroup numbers and scan the metadata again with the current config.
 +
 `Options`
@@ -41,12 +41,12 @@ wait for rescan operation to finish(can be already in progress).
 
 EXIT STATUS
 -----------
-'btrfs quota' returns a zero exist status if it succeeds. Non zero is
+*btrfs quota* returns a zero exist status if it succeeds. Non zero is
 returned in case of failure.
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
diff --git a/Documentation/btrfs-receive.txt b/Documentation/btrfs-receive.txt
index a67bc6645051..fba39269f929 100644
--- a/Documentation/btrfs-receive.txt
+++ b/Documentation/btrfs-receive.txt
@@ -7,15 +7,15 @@ btrfs-receive - receive subvolumes from stdin/file.
 
 SYNOPSIS
 --------
-'btrfs receive' [-ve] [-f <infile>] <mount>
+*btrfs receive* [-ve] [-f <infile>] <mount>
 
 DESCRIPTION
 -----------
 Receives one or more subvolumes that were previously
-sent with 'btrfs send'. The received subvolumes are stored
+sent with *btrfs send*. The received subvolumes are stored
 into <mount>.
 
-'btrfs receive' will fail with the following case:
+*btrfs receive* will fail with the following case:
 
 1. a receiving subvolume already exists.
 
@@ -41,12 +41,12 @@ or on EOF.
 
 EXIT STATUS
 -----------
-'btrfs receive' returns a zero exist status if it succeeds. Non zero is
+*btrfs receive* returns a zero exist status if it succeeds. Non zero is
 returned in case of failure.
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
diff --git a/Documentation/btrfs-replace.txt b/Documentation/btrfs-replace.txt
index 0d3b3185506e..46ff08d960ab 100644
--- a/Documentation/btrfs-replace.txt
+++ b/Documentation/btrfs-replace.txt
@@ -7,11 +7,11 @@ btrfs-replace - replace devices managed by btrfs with other device.
 
 SYNOPSIS
 --------
-'btrfs replace' <subcommand> <args>
+*btrfs replace* <subcommand> <args>
 
 DESCRIPTION
 -----------
-'btrfs replace' is used to replace btrfs managed devices with other device.
+*btrfs replace* is used to replace btrfs managed devices with other device.
 
 Note: this is not currently supported for RAID5/6 profiles and must use the
 device add/delete workaround.
@@ -21,7 +21,7 @@ management.
 
 SUBCOMMAND
 ----------
-'start' [-Bfr] <srcdev>|<devid> <targetdev> <path>::
+*start* [-Bfr] <srcdev>|<devid> <targetdev> <path>::
 Replace device of a btrfs filesystem.
 +
 On a live filesystem, duplicate the data to the target device which
@@ -52,7 +52,7 @@ never allowed to be used as the <targetdev>.
 -B::::
 no background replace.
 
-'status' [-1] <mount_point>::
+*status* [-1] <mount_point>::
 Print status and progress information of a running device replace operation.
 +
 `Options`
@@ -61,17 +61,17 @@ Print status and progress information of a running device replace operation.
 print once instead of print continuously until the replace
 operation finishes (or is canceled)
 
-'cancel' <mount_point>::
+*cancel* <mount_point>::
 Cancel a running device replace operation.
 
 EXIT STATUS
 -----------
-'btrfs replace' returns a zero exist status if it succeeds. Non zero is
+*btrfs replace* returns a zero exist status if it succeeds. Non zero is
 returned in case of failure.
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
diff --git a/Documentation/btrfs-rescue.txt b/Documentation/btrfs-rescue.txt
index f66ca856c8ec..0b75befade47 100644
--- a/Documentation/btrfs-rescue.txt
+++ b/Documentation/btrfs-rescue.txt
@@ -7,15 +7,15 @@ btrfs-rescue - Recover a damaged btrfs filesystem
 
 SYNOPSIS
 --------
-'btrfs rescue' <subcommand> <args>
+*btrfs rescue* <subcommand> <args>
 
 DESCRIPTION
 -----------
-'btrfs rescue' is used to try to recover a damaged btrfs filesystem.
+*btrfs rescue* is used to try to recover a damaged btrfs filesystem.
 
 SUBCOMMAND
 ----------
-'chunk-recover' [options] <device>::
+*chunk-recover* [options] <device>::
 Recover the chunk tree by scanning the devices
 +
 `Options`
@@ -27,10 +27,10 @@ verbose mode.
 -h::::
 help.
 
-NOTE: Since 'chunk-recover' will scan the whole device, it will be *VERY* slow
+NOTE: Since *chunk-recover* will scan the whole device, it will be *VERY* slow
 especially executed on a large device.
 
-'super-recover' [options] <device>::
+*super-recover* [options] <device>::
 Recover bad superblocks from good copies.
 +
 `Options`
@@ -42,12 +42,12 @@ verbose mode.
 
 EXIT STATUS
 -----------
-'btrfs rescue' returns a zero exist status if it succeeds. Non zero is
+*btrfs rescue* returns a zero exist status if it succeeds. Non zero is
 returned in case of failure.
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
diff --git a/Documentation/btrfs-restore.txt b/Documentation/btrfs-restore.txt
index c1d1607ae393..1882f0d0362d 100644
--- a/Documentation/btrfs-restore.txt
+++ b/Documentation/btrfs-restore.txt
@@ -7,15 +7,15 @@ btrfs-restore - try to restore files from a damaged btrfs filesystem(unmounted)
 
 SYNOPSIS
 --------
-'btrfs restore' [options] <device> <path> | -l <device>
+*btrfs restore* [options] <device> <path> | -l <device>
 
 DESCRIPTION
 -----------
-'btrfs restore' is used to try to salvage files from a damaged filesystem and
+*btrfs restore* is used to try to salvage files from a damaged filesystem and
 restore them into <path> or just list the tree roots.
 
 Since current `btrfs-check`(8) or `btrfs-rescue`(8) only has very limited usage,
-'btrfs restore' is normally a better choice.
+*btrfs restore* is normally a better choice.
 
 NOTE: It is recommended to read the following btrfs wiki page if your data is
 not salvaged with default option: +
@@ -58,12 +58,12 @@ list tree roots.
 
 EXIT STATUS
 -----------
-'btrfs restore' returns a zero exist status if it succeeds. Non zero is
+*btrfs restore* returns a zero exist status if it succeeds. Non zero is
 returned in case of failure.
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
diff --git a/Documentation/btrfs-scrub.txt b/Documentation/btrfs-scrub.txt
index c87658739620..2928e1d1afb8 100644
--- a/Documentation/btrfs-scrub.txt
+++ b/Documentation/btrfs-scrub.txt
@@ -7,21 +7,21 @@ btrfs-scrub - scrub btrfs filesystem
 
 SYNOPSIS
 --------
-'btrfs scrub' <subcommand> <args>
+*btrfs scrub* <subcommand> <args>
 
 DESCRIPTION
 -----------
-'btrfs scrub' is used to scrub a btrfs filesystem, which will reading all data
+*btrfs scrub* is used to scrub a btrfs filesystem, which will reading all data
 from all disks and verifying checksums.
 
 SUBCOMMAND
 ----------
-'start' [-BdqrRf] [-c <ioprio_class> -n <ioprio_classdata>] <path>|<device>::
+*start* [-BdqrRf] [-c <ioprio_class> -n <ioprio_classdata>] <path>|<device>::
 Start a scrub on all devices of the filesystem identified by <path> or on
 a single <device>.
 +
 Without options, scrub is started as a background process.
-Progress can be obtained with the 'scrub status' command. Scrubbing
+Progress can be obtained with the *scrub status* command. Scrubbing
 involves reading all data from all disks and verifying checksums. Errors are
 corrected along the way if possible.
 +
@@ -50,7 +50,7 @@ Set IO priority classdata (see `ionice`(1) manpage).
 force to check whether scrub has started or resumed in userspace.
 this is useful when scrub stat record file is damaged.
 
-'cancel' <path>|<device>::
+*cancel* <path>|<device>::
 If a scrub is running on the filesystem identified by <path>, cancel it.
 +
 Progress is saved in the scrub progress file and scrubbing can be resumed later
@@ -58,7 +58,7 @@ using the scrub resume command.
 If a <device> is given, the corresponding filesystem is found and
 scrub cancel behaves as if it was called on that filesystem.
 
-'resume' [-BdqrR] [-c <ioprio_class> -n <ioprio_classdata>] <path>|<device>::
+*resume* [-BdqrR] [-c <ioprio_class> -n <ioprio_classdata>] <path>|<device>::
 Resume a canceled or interrupted scrub cycle on the filesystem identified by
 <path> or on a given <device>.
 +
@@ -66,9 +66,9 @@ Does not start a new scrub if the last scrub finished successfully.
 +
 `Options`
 +
-see 'scrub start'.
+see *scrub start*.
 
-'status' [-d] <path>|<device>::
+*status* [-d] <path>|<device>::
 Show status of a running scrub for the filesystem identified by <path> or
 for the specified <device>.
 +
@@ -82,12 +82,12 @@ Print separate statistics for each device of the filesystem.
 
 EXIT STATUS
 -----------
-'btrfs scrub' returns a zero exist status if it succeeds. Non zero is
+*btrfs scrub* returns a zero exist status if it succeeds. Non zero is
 returned in case of failure.
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
diff --git a/Documentation/btrfs-send.txt b/Documentation/btrfs-send.txt
index 18a98fa3861e..2fbb4cb6094d 100644
--- a/Documentation/btrfs-send.txt
+++ b/Documentation/btrfs-send.txt
@@ -7,7 +7,7 @@ btrfs-send - send data of subvolume(s) to stdout/file.
 
 SYNOPSIS
 --------
-'btrfs send' [-ve] [-p <parent>] [-c <clone-src>] [-f <outfile>] <subvol> [<subvol>...]
+*btrfs send* [-ve] [-p <parent>] [-c <clone-src>] [-f <outfile>] <subvol> [<subvol>...]
 
 DESCRIPTION
 -----------
@@ -23,7 +23,7 @@ You must not specify clone sources unless you guarantee that these snapshots
 are exactly in the same state on both sides, the sender and the receiver.
 
 It is allowed to omit the '-p <parent>' option when '-c <clone-src>' options
-are given, in which case 'btrfs send' will determine a suitable parent among the
+are given, in which case *btrfs send* will determine a suitable parent among the
 clone sources itself.
 
 `Options`
@@ -43,12 +43,12 @@ An alternative would be to use pipes.
 
 EXIT STATUS
 -----------
-'btrfs send' returns a zero exist status if it succeeds. Non zero is
+*btrfs send* returns a zero exist status if it succeeds. Non zero is
 returned in case of failure.
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
diff --git a/Documentation/btrfs-show-super.txt b/Documentation/btrfs-show-super.txt
index e8e17abc042f..e06157f5d1b6 100644
--- a/Documentation/btrfs-show-super.txt
+++ b/Documentation/btrfs-show-super.txt
@@ -7,11 +7,11 @@ btrfs-show-super - show btrfs superblock information stored in devices
 
 SYNOPSIS
 --------
-'btrfs-show-super' [options] <dev> [<dev>...]
+*btrfs-show-super* [options] <dev> [<dev>...]
 
 DESCRIPTION
 -----------
-'btrfs-show-super' is used to print the information of superblock,
+*btrfs-show-super* is used to print the information of superblock,
 you can specify which mirror to print out.
 
 By default, every device's first superblock will be printed out.
@@ -33,7 +33,7 @@ If several '-i <super_mirror>' are given, only the last one is valid.
 
 EXIT STATUS
 -----------
-'btrfs-show-super' will return 0 if no error happened.
+*btrfs-show-super* will return 0 if no error happened.
 If any problems happened, 1 will be returned.
 
 AUTHOR
diff --git a/Documentation/btrfs-subvolume.txt b/Documentation/btrfs-subvolume.txt
index 6cc72803b34a..3fd29282e32f 100644
--- a/Documentation/btrfs-subvolume.txt
+++ b/Documentation/btrfs-subvolume.txt
@@ -7,11 +7,11 @@ btrfs-subvolume - control btrfs subvolume(s)
 
 SYNOPSIS
 --------
-'btrfs subvolume' <subcommand> [<args>]
+*btrfs subvolume* <subcommand> [<args>]
 
 DESCRIPTION
 -----------
-'btrfs subvolume' is used to control the filesystem to create/delete/list/show
+*btrfs subvolume* is used to control the filesystem to create/delete/list/show
 subvolumes and snapshots.
 
 SUBVOLUME AND SNAPSHOT
@@ -43,7 +43,7 @@ from normal directories.
 
 SUBCOMMAND
 -----------
-'create' [-i <qgroupid>] [<dest>]<name>::
+*create* [-i <qgroupid>] [<dest>]<name>::
 Create a subvolume <name> in <dest>.
 +
 If <dest> is not given, subvolume <name> will be created in the currently
@@ -55,7 +55,7 @@ directory.
 Add the newly created subvolume to a qgroup. This option can be given multiple
 times.
 
-'delete' [options] <subvolume> [<subvolume>...]::
+*delete* [options] <subvolume> [<subvolume>...]::
 Delete the subvolume(s) from the filesystem.
 +
 If <subvolume> is not a subvolume, btrfs returns an error but continues if
@@ -75,7 +75,7 @@ wait for transaction commit at the end of the operation
 -C|--commit-each::::
 wait for transaction commit after delet each subvolume
 
-'list' [options] [-G [\+|-]<value>] [-C [+|-]<value>] [--sort=rootid,gen,ogen,path] <path>::
+*list* [options] [-G [\+|-]<value>] [-C [+|-]<value>] [--sort=rootid,gen,ogen,path] <path>::
 List the subvolumes present in the filesystem <path>.
 +
 For every subvolume the following information is shown by default. +
@@ -125,7 +125,7 @@ you can add \'\+' or \'-' in front of each items, \'+' means ascending,
 for --sort you can combine some items together by \',', just like
 -sort=+ogen,-gen,path,rootid.
 
-'snapshot' [-r] <source> <dest>|[<dest>/]<name>::
+*snapshot* [-r] <source> <dest>|[<dest>/]<name>::
 Create a writable/readonly snapshot of the subvolume <source> with the
 name <name> in the <dest> directory.
 +
@@ -133,32 +133,32 @@ If only <dest> is given, the subvolume will be named the basename of <source>.
 If <source> is not a subvolume, btrfs returns an error.
 If '-r' is given, the snapshot will be readonly.
 
-'get-default' <path>::
+*get-default* <path>::
 Get the default subvolume of the filesystem <path>.
 +
-The output format is similar to 'subvolume list' command.
+The output format is similar to *subvolume list* command.
 
-'set-default' <id> <path>::
+*set-default* <id> <path>::
 Set the subvolume of the filesystem <path> which is mounted as
 default.
 +
-The subvolume is identified by <id>, which is returned by the 'subvolume list'
+The subvolume is identified by <id>, which is returned by the *subvolume list*
 command.
 
-'find-new' <subvolume> <last_gen>::
+*find-new* <subvolume> <last_gen>::
 List the recently modified files in a subvolume, after <last_gen> ID.
 
-'show' <path>::
+*show* <path>::
 Show information of a given subvolume in the <path>.
 
 EXIT STATUS
 -----------
-'btrfs subvolume' returns a zero exist status if it succeeds. Non zero is
+*btrfs subvolume* returns a zero exist status if it succeeds. Non zero is
 returned in case of failure.
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
diff --git a/Documentation/btrfs-zero-log.txt b/Documentation/btrfs-zero-log.txt
index a8e4dd347cd0..0a8d3e33ae4d 100644
--- a/Documentation/btrfs-zero-log.txt
+++ b/Documentation/btrfs-zero-log.txt
@@ -7,17 +7,17 @@ btrfs-zero-log - clear out log tree
 
 SYNOPSIS
 --------
-'btrfs-zero-log' <dev>
+*btrfs-zero-log* <dev>
 
 DESCRIPTION
 -----------
-'btrfs-zero-log' will remove the log tree if log tree is corrupt, which will
+*btrfs-zero-log* will remove the log tree if log tree is corrupt, which will
 allow you to mount the filesystem again.
 
 The common case where this happens has been fixed a long time ago,
 so it is unlikely that you will see this particular problem.
 
-One can determine whether 'btrfs-zero-log' is needed according to the kernel
+One can determine whether *btrfs-zero-log* is needed according to the kernel
 backtrace:
 ----
 ? replay_one_dir_item+0xb5/0xb5 [btrfs]
@@ -29,15 +29,15 @@ backtrace:
 ? open_ctree+0xff6/0x132c [btrfs]
 ----
 
-If the errors are like above, then 'btrfs-zero-log' should be used to clear
+If the errors are like above, then *btrfs-zero-log* should be used to clear
 the log and the filesystem may be mounted normally again.
 
 NOTE: If you use btrfs as the root filesystem, you may want to include
-'btrfs-zero-log' into initramdisk if the log problems hits you often.
+*btrfs-zero-log* into initramdisk if the log problems hits you often.
 
 EXIT STATUS
 -----------
-'btrfs-zero-log' will return 0 if no error happened.
+*btrfs-zero-log* will return 0 if no error happened.
 Other exit code means some problems happened.
 
 AUTHOR
diff --git a/Documentation/btrfs.txt b/Documentation/btrfs.txt
index c9bed7026a61..d0b3f35aaeb0 100644
--- a/Documentation/btrfs.txt
+++ b/Documentation/btrfs.txt
@@ -7,92 +7,92 @@ btrfs - control a btrfs filesystem
 
 SYNOPSIS
 --------
-'btrfs' <command> [<args>]
+*btrfs* <command> [<args>]
 
 DESCRIPTION
 -----------
-'btrfs' is used to control the filesystem and the files and directories stored.
+*btrfs* is used to control the filesystem and the files and directories stored.
 It is the tool to create or destroy a snapshot or a subvolume for the
 filesystem, to defrag a file or a directory, flush the data to the disk,
 to resize the filesystem, to scan the device.
 
 It is possible to abbreviate the commands unless the commands are ambiguous.
-For example: it is possible to run 'btrfs sub snaps' instead of
-'btrfs subvolume snapshot'.
-But 'btrfs file s' is not allowed, because 'file s' may be interpreted
-both as 'filesystem show' and as 'filesystem sync'.
+For example: it is possible to run *btrfs sub snaps* instead of
+*btrfs subvolume snapshot*.
+But *btrfs file s* is not allowed, because *file s* may be interpreted
+both as *filesystem show* and as *filesystem sync*.
 
 If a command is terminated by '--help', the detailed help is showed.
 If the passed command matches more commands,
 detailed help of all the matched commands is showed. For example
-'btrfs dev --help' shows the help of all 'device*' commands.
+*btrfs dev --help* shows the help of all *device** commands.
 
 COMMANDS
 --------
-'subvolume'::
+*subvolume*::
 	Create/delete/list/manage btrfs subvolume. +
 	See `btrfs-subvolume`(8) for details.
 
-'filesystem'::
+*filesystem*::
 	Manage a btrfs filesystem, including label setting/sync and so on. +
 	See `btrfs-filesystem`(8) for details.
 
-'[filesystem] balance'::
+*[filesystem] balance*::
 	Balance btrfs filesystem chunks across single or several devices. +
 	See `btrfs-balance`(8) for details.
 
-'device'::
+*device*::
 	Manage devices managed by btrfs, including add/delete/scan and so
 	on. +
 	See `btrfs-device`(8) for details.
 
-'scrub'::
+*scrub*::
 	Scrub a btrfs filesystem. +
 	See `btrfs-scrub`(8) for details.
 
-'check'::
+*check*::
 	Do off-line check on a btrfs filesystem. +
 	See `btrfs-check`(8) for details.
 
-'rescue'::
+*rescue*::
 	Try to rescue damaged btrfs filesystem. +
 	See `btrfs-rescue`(8) for details.
 
-'restore'::
+*restore*::
 	Manage a btrfs filesystem, including label setting/sync and so on. +
 	See `btrfs-restore`(8) for details.
 
-'inspect-internal'::
+*inspect-internal*::
 	Debug tools for developers/hackers. +
 	See `btrfs-inspect-internal`(8) for details.
 
-'send'::
+*send*::
 	Send subvolume data to stdout/file for backup and etc. +
 	See `btrfs-send`(8) for details.
 
-'receive'::
+*receive*::
 	Receive subvolume data from stdin/file for restore and etc. +
 	See `btrfs-receive`(8) for details.
-'quota'::
+*quota*::
 	Manage quota on btrfs filesystem like enabling/rescan and etc. +
 	See `btrfs-quota`(8) and `btrfs-qgroup`(8) for details.
 
-'qgroup'::
+*qgroup*::
 	Manage quota group(qgroup) for btrfs filesystem. +
 	See `btrfs-qgroup`(8) for details.
 
-'replace'::
+*replace*::
 	Replace btrfs devices. +
 	See `btrfs-replace`(8) for details.
 
 EXIT STATUS
 -----------
-'btrfs' returns a zero exist status if it succeeds. Non zero is returned in
+*btrfs* returns a zero exist status if it succeeds. Non zero is returned in
 case of failure.
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
diff --git a/Documentation/btrfstune.txt b/Documentation/btrfstune.txt
index bf4bfcecdc21..1309fb6ab99e 100644
--- a/Documentation/btrfstune.txt
+++ b/Documentation/btrfstune.txt
@@ -7,11 +7,11 @@ btrfstune - tune various btrfs filesystem parameters
 
 SYNOPSIS
 --------
-'btrfstune' [options] <dev> [<dev>...]
+*btrfstune* [options] <dev> [<dev>...]
 
 DESCRIPTION
 -----------
-'btrfstune' is used to tune various btrfs filesystem parameters,you can
+*btrfstune* is used to tune various btrfs filesystem parameters,you can
 enable/disable some extended features for btrfs.
 
 OPTIONS
@@ -27,7 +27,7 @@ Enable skinny metadata extent refs.
 
 EXIT STATUS
 -----------
-'btrfstune' will return 0 if no error happened.
+*btrfstune* will return 0 if no error happened.
 If any problems happened, 1 will be returned.
 
 AUTHOR
diff --git a/Documentation/fsck.btrfs.txt b/Documentation/fsck.btrfs.txt
index cc4544a58b1b..0bad075b68fa 100644
--- a/Documentation/fsck.btrfs.txt
+++ b/Documentation/fsck.btrfs.txt
@@ -7,11 +7,11 @@ fsck.btrfs - do nothing, successfully
 
 SYNOPSIS
 --------
-'fsck.btrfs' [-aApy] [<device>...]
+*fsck.btrfs* [-aApy] [<device>...]
 
 DESCRIPTION
 -----------
-'fsck.btrfs' is a type of utility that should exist for any filesystem and is
+*fsck.btrfs* is a type of utility that should exist for any filesystem and is
 called during system setup when the corresponding `/etc/fstab` entries
 contain non-zero value for `fs_passno` , see `fstab`(5) for more.
 
@@ -26,7 +26,7 @@ with care!).
 
 OPTIONS
 -------
-The options are all the same and detect if 'fsck.btrfs' is executed in
+The options are all the same and detect if *fsck.btrfs* is executed in
 non-interactive mode and exits with success,
 otherwise prints a message about btrfs check.
 
diff --git a/Documentation/mkfs.btrfs.txt b/Documentation/mkfs.btrfs.txt
index 95098328bb68..634e486105a2 100644
--- a/Documentation/mkfs.btrfs.txt
+++ b/Documentation/mkfs.btrfs.txt
@@ -7,7 +7,7 @@ mkfs.btrfs - create a btrfs filesystem
 
 SYNOPSIS
 --------
-'mkfs.btrfs'
+*mkfs.btrfs*
 $$[-A|--alloc-start <alloc-start>]$$
 $$[-b|--byte-count <byte-count>]$$
 $$[-d|--data <data-profile>]$$
@@ -27,7 +27,7 @@ $$<device> [<device>...]$$
 
 DESCRIPTION
 -----------
-'mkfs.btrfs'
+*mkfs.btrfs*
 is used to create a btrfs filesystem (usually in a disk partition, or an array
 of disk partitions).
 
@@ -110,7 +110,7 @@ To see all features run::::
 mkfs.btrfs -O list-all
 
 -V|--version::
-Print the 'mkfs.btrfs' version and exit.
+Print the *mkfs.btrfs* version and exit.
 
 -h::
 Print help.
@@ -122,7 +122,7 @@ to the arguments like 'k' for KBytes, 'm' for MBytes...
 
 AVAILABILITY
 ------------
-'btrfs' is part of btrfs-progs. Btrfs filesystem is currently under heavy
+*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
 development,
 and not suitable for any uses other than benchmarking and review.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
-- 
1.9.0


^ permalink raw reply related	[flat|nested] 6+ messages in thread
* [PATCH 5/5] btrfs-progs: doc: update the Availability section
  2014-05-19 16:19 [PATCH 0/5] Documentation updates David Sterba
                   ` (3 preceding siblings ...)
  2014-05-19 16:20 ` [PATCH 4/5] btrfs-progs: doc: make all commands and subcommands bold David Sterba
@ 2014-05-19 16:20 ` David Sterba
  4 siblings, 0 replies; 6+ messages in thread
From: David Sterba @ 2014-05-19 16:20 UTC (permalink / raw)
  To: linux-btrfs; +Cc: David Sterba

Does not reflect the current state. The wiki contains more details on
the first page.

Signed-off-by: David Sterba <dsterba@suse.cz>
---
 Documentation/btrfs-balance.txt          | 4 +---
 Documentation/btrfs-check.txt            | 4 +---
 Documentation/btrfs-device.txt           | 4 +---
 Documentation/btrfs-filesystem.txt       | 4 +---
 Documentation/btrfs-inspect-internal.txt | 4 +---
 Documentation/btrfs-property.txt         | 4 +---
 Documentation/btrfs-qgroup.txt           | 4 +---
 Documentation/btrfs-quota.txt            | 4 +---
 Documentation/btrfs-receive.txt          | 4 +---
 Documentation/btrfs-replace.txt          | 4 +---
 Documentation/btrfs-rescue.txt           | 4 +---
 Documentation/btrfs-restore.txt          | 4 +---
 Documentation/btrfs-scrub.txt            | 4 +---
 Documentation/btrfs-send.txt             | 4 +---
 Documentation/btrfs-subvolume.txt        | 4 +---
 Documentation/btrfs.txt                  | 4 +---
 Documentation/mkfs.btrfs.txt             | 4 +---
 17 files changed, 17 insertions(+), 51 deletions(-)

diff --git a/Documentation/btrfs-balance.txt b/Documentation/btrfs-balance.txt
index d34833d6f380..37d8781eee4e 100644
--- a/Documentation/btrfs-balance.txt
+++ b/Documentation/btrfs-balance.txt
@@ -68,9 +68,7 @@ returned in case of failure.
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
diff --git a/Documentation/btrfs-check.txt b/Documentation/btrfs-check.txt
index 073667265c13..027032b2efb8 100644
--- a/Documentation/btrfs-check.txt
+++ b/Documentation/btrfs-check.txt
@@ -38,9 +38,7 @@ returned in case of failure.
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
diff --git a/Documentation/btrfs-device.txt b/Documentation/btrfs-device.txt
index 4f847763bb66..0f7917d894a0 100644
--- a/Documentation/btrfs-device.txt
+++ b/Documentation/btrfs-device.txt
@@ -105,9 +105,7 @@ returned in case of failure.
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
diff --git a/Documentation/btrfs-filesystem.txt b/Documentation/btrfs-filesystem.txt
index e3e270ff0957..0ee79cbabc34 100644
--- a/Documentation/btrfs-filesystem.txt
+++ b/Documentation/btrfs-filesystem.txt
@@ -108,9 +108,7 @@ returned in case of failure.
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
diff --git a/Documentation/btrfs-inspect-internal.txt b/Documentation/btrfs-inspect-internal.txt
index fe76217365b0..5ae4997b9bc0 100644
--- a/Documentation/btrfs-inspect-internal.txt
+++ b/Documentation/btrfs-inspect-internal.txt
@@ -57,9 +57,7 @@ returned in case of failure.
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
diff --git a/Documentation/btrfs-property.txt b/Documentation/btrfs-property.txt
index 4b0f49e04b20..6b23e2e52aad 100644
--- a/Documentation/btrfs-property.txt
+++ b/Documentation/btrfs-property.txt
@@ -56,9 +56,7 @@ returned in case of failure.
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
diff --git a/Documentation/btrfs-qgroup.txt b/Documentation/btrfs-qgroup.txt
index 12321926b25b..55c4747449ff 100644
--- a/Documentation/btrfs-qgroup.txt
+++ b/Documentation/btrfs-qgroup.txt
@@ -97,9 +97,7 @@ returned in case of failure.
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
diff --git a/Documentation/btrfs-quota.txt b/Documentation/btrfs-quota.txt
index f7b0fd13b0db..c092e328593c 100644
--- a/Documentation/btrfs-quota.txt
+++ b/Documentation/btrfs-quota.txt
@@ -46,9 +46,7 @@ returned in case of failure.
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
diff --git a/Documentation/btrfs-receive.txt b/Documentation/btrfs-receive.txt
index fba39269f929..82611603102f 100644
--- a/Documentation/btrfs-receive.txt
+++ b/Documentation/btrfs-receive.txt
@@ -46,9 +46,7 @@ returned in case of failure.
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
diff --git a/Documentation/btrfs-replace.txt b/Documentation/btrfs-replace.txt
index 46ff08d960ab..eecf9b00ae5f 100644
--- a/Documentation/btrfs-replace.txt
+++ b/Documentation/btrfs-replace.txt
@@ -71,9 +71,7 @@ returned in case of failure.
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
diff --git a/Documentation/btrfs-rescue.txt b/Documentation/btrfs-rescue.txt
index 0b75befade47..82297fa4455c 100644
--- a/Documentation/btrfs-rescue.txt
+++ b/Documentation/btrfs-rescue.txt
@@ -47,9 +47,7 @@ returned in case of failure.
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
diff --git a/Documentation/btrfs-restore.txt b/Documentation/btrfs-restore.txt
index 1882f0d0362d..d774343b91b1 100644
--- a/Documentation/btrfs-restore.txt
+++ b/Documentation/btrfs-restore.txt
@@ -63,9 +63,7 @@ returned in case of failure.
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
diff --git a/Documentation/btrfs-scrub.txt b/Documentation/btrfs-scrub.txt
index 2928e1d1afb8..7b27d63c99b6 100644
--- a/Documentation/btrfs-scrub.txt
+++ b/Documentation/btrfs-scrub.txt
@@ -87,9 +87,7 @@ returned in case of failure.
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
diff --git a/Documentation/btrfs-send.txt b/Documentation/btrfs-send.txt
index 2fbb4cb6094d..ce926a77e58f 100644
--- a/Documentation/btrfs-send.txt
+++ b/Documentation/btrfs-send.txt
@@ -48,9 +48,7 @@ returned in case of failure.
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
diff --git a/Documentation/btrfs-subvolume.txt b/Documentation/btrfs-subvolume.txt
index 3fd29282e32f..a5191316b24d 100644
--- a/Documentation/btrfs-subvolume.txt
+++ b/Documentation/btrfs-subvolume.txt
@@ -158,9 +158,7 @@ returned in case of failure.
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
diff --git a/Documentation/btrfs.txt b/Documentation/btrfs.txt
index d0b3f35aaeb0..2d121a805d72 100644
--- a/Documentation/btrfs.txt
+++ b/Documentation/btrfs.txt
@@ -92,9 +92,7 @@ case of failure.
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
diff --git a/Documentation/mkfs.btrfs.txt b/Documentation/mkfs.btrfs.txt
index 634e486105a2..0cab626b2c3c 100644
--- a/Documentation/mkfs.btrfs.txt
+++ b/Documentation/mkfs.btrfs.txt
@@ -122,9 +122,7 @@ to the arguments like 'k' for KBytes, 'm' for MBytes...
 
 AVAILABILITY
 ------------
-*btrfs* is part of btrfs-progs. Btrfs filesystem is currently under heavy
-development,
-and not suitable for any uses other than benchmarking and review.
+*btrfs* is part of btrfs-progs.
 Please refer to the btrfs wiki http://btrfs.wiki.kernel.org for
 further details.
 
-- 
1.9.0


^ permalink raw reply related	[flat|nested] 6+ messages in thread
end of thread, other threads:[~2014-05-19 16:20 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2014-05-19 16:19 [PATCH 0/5] Documentation updates David Sterba
2014-05-19 16:19 ` [PATCH 1/5] btrfs-progs: doc: fix argument notation and typos David Sterba
2014-05-19 16:20 ` [PATCH 2/5] btrfs-progs: doc: remove text for unmerged features David Sterba
2014-05-19 16:20 ` [PATCH 3/5] btrfs-progs: doc: autoformat user-supplied arguments by sed David Sterba
2014-05-19 16:20 ` [PATCH 4/5] btrfs-progs: doc: make all commands and subcommands bold David Sterba
2014-05-19 16:20 ` [PATCH 5/5] btrfs-progs: doc: update the Availability section David Sterba

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).