Skip to contentSkip to conversation

btrfs-progs: docs: Fix newlines for man btrfstune

PATCH Applied Hans van Kranenburg 2 participants 2 messages Apr 16, 2017 – Apr 19, 2017

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 btrfs-progs: docs: Fix newlines for man btrfstune

A bunch of newlines were missing, which resulted in only -S and -r to show as option after xmlto is used to convert the documentation to a man page.

The rest of the options would end up being appended to the explanation of -r.

---

By the way, I have no idea why -r was showing up in the first place, because it also had no newline before it.

I'm no asciidoc expert, but with consistent newlines, at least for me the resulting man page does contain all options nicely listed.

 Documentation/btrfstune.asciidoc | 6 ++++++
 1 file changed, 6 insertions(+)
Documentation/btrfstune.asciidoc +6 -0
index 04295ee3..bf4f495a 100644
@@ -29,11 +29,13 @@ OPTIONS
 Enable seeding on a given device. Value 1 will enable seeding, 0 will disable it. +
 A seeding filesystem is forced to be mounted read-only. A new device can be added
 to the filesystem and will capture all writes keeping the seeding device intact.
+
 -r::
 (since kernel: 3.7)
 +
 Enable extended inode refs (hardlink limit per file in a directory is 65536),
 enabled by mkfs feature 'extref'.
+
 -x::
 (since kernel: 3.10)
 +
@@ -43,17 +45,21 @@ enabled by mkfs feature 'skinny-metadata'.
 All newly created extents will use the new representation. To completely switch
 the entire filesystem, run a full balance of the metadata. Please refer to
 `btrfs-balance`(8).
+
 -n::
 (since kernel: 3.14)
 +
 Enable no-holes feature (more efficient representation of file holes), enabled
 by mkfs feature 'no-holes'.
+
 -f::
 Allow dangerous changes, e.g. clear the seeding flag or change fsid. Make sure
 that you are aware of the dangers.
+
 -u::
 Change fsid to a randomly generated UUID or continue previous fsid change
 operation in case it was interrupted.
+
 -U <UUID>::
 Change fsid to 'UUID'.
 +
Signature · 1 line
2.11.0
Applied
#1 lore raw
Quoted 8 lines · Hans van Kranenburg

A bunch of newlines were missing, which resulted in only -S and -r to show as option after xmlto is used to convert the documentation to a man page.

The rest of the options would end up being appended to the explanation of -r.

Applied, thanks.

Quoted 7 lines

---

By the way, I have no idea why -r was showing up in the first place, because it also had no newline before it.

I'm no asciidoc expert, but with consistent newlines, at least for me the resulting man page does contain all options nicely listed.

IIRC if the :: section is one paragraph, then the newline does not need to be there, while if there are more glued together with a +, then the newline before next :: must be added.