Add readme for tool and make script generic

Author: kasper

Documentation/manpages/tool/README.md

@@ -0,0 +1,28 @@
+# Manpage update tool
+
+Utility to update dotnet-cli documentation from https://github.com/dotnet/docs.
+
+## Prerequisites
+
+* Unix OS
+* `python` in PATH
+* `pandoc` installed
+* `pandocfilters` package installed
+* `unzip`
+* `wget` or `curl`
+
+## Usage
+
+```sh
+./update-man-pages.sh
+```
+
+## Ubuntu example (from scratch)
+
+```sh
+sudo apt install -y pandoc python python-pip wget unzip < /dev/null
+sudo pip install pandocfilters
+
+git clone https://github.com/dotnet/cli
+./Documentation/manpage/tool/update-man-pages.sh
+```

…umentation/manpages/man-pandoc-filter.py …ation/manpages/tool/man-pandoc-filter.pyDocumentation/manpages/man-pandoc-filter.py renamed to Documentation/manpages/tool/man-pandoc-filter.py Documentation/manpages/man-pandoc-filter.py renamed to Documentation/manpages/tool/man-pandoc-filter.py

@@ -0,0 +1,31 @@
+#!/usr/bin/env sh
+#
+# Copyright (c) .NET Foundation and contributors. All rights reserved.
+# Licensed under the MIT license. See LICENSE file in the project root for full license information.
+#
+
+MANPAGE_TOOL_DIR=$(cd $(dirname $0); pwd)
+
+cd $MANPAGE_TOOL_DIR/../sdk
+
+echo "Downloading dotnet/docs master"
+
+if [ -x "$(command -v curl)" ]; then
+  curl -sSLO https://github.com/dotnet/docs/archive/master.zip > /dev/null
+elif [ -x "$(command -v wget)" ]; then
+  wget -q https://github.com/dotnet/docs/archive/master.zip > /dev/null
+else
+  echo "Please install curl or wget to proceed"
+  exit 1
+fi
+
+unzip -o master.zip > /dev/null
+rm master.zip*
+
+ls docs-master/docs/core/tools/dotnet*.md | while read -r line;
+  do
+    echo "Working on $line"
+    pandoc -s -t man -V section=1 -V header=".NET Core" --column=500 --filter $MANPAGE_TOOL_DIR/man-pandoc-filter.py "$line" -o "$(basename ${line%.md}.1)"
+done
+
+rm -rf docs-master