Script for checking sanity of manpages

Change-Id: Ia27b0ecf6a3267eb51f8a6562721dca72f128915

Author: onovy

.manpages

@@ -0,0 +1,18 @@
+#!/bin/sh
+
+RET=0
+for MAN in doc/manpages/* ; do
+    OUTPUT=$(LC_ALL=en_US.UTF-8 MANROFFSEQ='' MANWIDTH=80 man --warnings -E UTF-8 -l \
+        -Tutf8 -Z "$MAN" 2>&1 >/dev/null)
+    if [ -n "$OUTPUT" ] ; then
+        RET=1
+        echo "$MAN:"
+        echo "$OUTPUT"
+    fi
+done
+
+if [ "$RET" -eq "0" ] ; then
+    echo "All manpages are fine"
+fi
+
+exit "$RET"

doc/source/development_guidelines.rst

@@ -164,6 +164,14 @@ Installing Sphinx:
   #. Install sphinx (On Ubuntu: `sudo apt-get install python-sphinx`)
   #. `python setup.py build_sphinx`
 
+--------
+Manpages
+--------
+
+For sanity check of your change in manpage, use this command in the root
+of your Swift repo::
+
+  ./.manpages
 
 ---------------------
 License and Copyright