Add howto for changing man pages

Signed-off-by: Dan Mick <dan.mick@inktank.com>

diff --git a/admin/manpage-howto.txt b/admin/manpage-howto.txt
new file mode 100644 (file)
index 0000000..c3bdea5
--- /dev/null
+++ b/admin/manpage-howto.txt
@@ -0,0 +1,7 @@
+Updating the manpages is a semi-manual process:
+(all paths below relative to top of git tree):
+
+1) make changes to the .rst files in doc/man
+2) use admin/build-doc to build the doc tree into build-doc/output
+3) copy changed manpage files from build-doc/output/man to man/
+4) commit both doc/man .rst changes and man/ changes