diff --git a/src/uu/more/more.md b/src/uu/more/more.md
index cb626060e..e63ca1a87 100644
--- a/src/uu/more/more.md
+++ b/src/uu/more/more.md
@@ -1,7 +1,7 @@
 # more
 
 ```
-more [OPTIONS] <FILE>...
+more [OPTIONS] FILE...
 ```
 
 Display the contents of a text file
diff --git a/src/uu/test/src/test.rs b/src/uu/test/src/test.rs
index a0d0f3395..9d3c2b290 100644
--- a/src/uu/test/src/test.rs
+++ b/src/uu/test/src/test.rs
@@ -29,10 +29,11 @@ const ABOUT: &str = help_about!("test.md");
 // So, we use test or [ instead of {} so that the usage string is correct.
 const USAGE: &str = "\
 test EXPRESSION
-test
+[
 [ EXPRESSION ]
 [ ]
-[ OPTION";
+[ OPTION
+]";
 
 // We use after_help so that this comes after the usage string (it would come before if we used about)
 const AFTER_HELP: &str = help_section!("after help", "test.md");
diff --git a/src/uu/test/test.md b/src/uu/test/test.md
index e67eb1824..b198c220b 100644
--- a/src/uu/test/test.md
+++ b/src/uu/test/test.md
@@ -2,10 +2,11 @@
 
 ```
 test EXPRESSION
-test
+[
 [ EXPRESSION ]
 [ ]
 [ OPTION
+]
 ```
 
 Check file types and compare values.
diff --git a/src/uu/vdir/vdir.md b/src/uu/vdir/vdir.md
new file mode 100644
index 000000000..c7a0cae36
--- /dev/null
+++ b/src/uu/vdir/vdir.md
@@ -0,0 +1,10 @@
+# vdir
+
+```
+vdir [OPTION]... [FILE]...
+```
+
+List directory contents.
+Ignore files and directories starting with a '.' by default.
+
+Mandatory arguments to long options are mandatory for short options too.