Asciidoc: Convert man-common/README to Markdown

diff --git a/man-common/README b/man-common/README.md
similarity index 57%
rename from man-common/README
rename to man-common/README.md
index a5bce000d61f18ddd87f32f2af6b274b6d046c27..f9a9b8daa90179adbf2ae9702552c602fde30ec6 100644 (file)
--- a/man-common/README
+++ b/man-common/README.md
@@ -1,16 +1,18 @@
+# Working with the Asciidoc files
+
 To get the groff version from an asciidoc man page (example for a dummy man page filename.1.adoc): 
 
-asciidoctor -b manpage \
-            -a release-version=2.37 \
-            -a adjtime_path=/etc/adjtime \
-            -a docdir=/usr/share/doc \
-            -a runstatedir=/run \
-            -D output_directory \
-            filename.1.adoc
+    asciidoctor -b manpage \
+                -a release-version=2.37 \
+                -a adjtime_path=/etc/adjtime \
+                -a docdir=/usr/share/doc \
+                -a runstatedir=/run \
+                -D output_directory \
+                filename.1.adoc
             
 To get the translated versions, add an extra option which includes translation.adoc:
 
-            -a translation
+                -a translation
             
 The "-a" options are applicable to certain man pages. However, if the mentioned
 variable is unused, they don't produce an error message.