dotnet-installer/Documentation/manpages/tool
2018-03-30 13:02:08 -04:00
..
man-pandoc-filter.py Add readme for tool and make script generic 2018-03-30 12:13:31 -04:00
README.md Add a note on older version of pandoc 2018-03-30 13:02:08 -04:00
update-man-pages.sh Add readme for tool and make script generic 2018-03-30 12:13:31 -04:00

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

./update-man-pages.sh

Ubuntu example (from scratch)

sudo apt install -y pandoc python python-pip wget unzip < /dev/null
sudo pip install pandocfilters

git clone https://github.com/dotnet/cli
./cli/Documentation/manpage/tool/update-man-pages.sh

The version of pandoc is printed in first line as code comment in .1 (manpage) files. If your version of pandoc is older than (or even equal to) the last modifed version, please install the latest stable version of pandoc from https://github.com/jgm/pandoc/releases (deb file for Ubuntu):

wget -q https://github.com/jgm/pandoc/releases/download/$pandocVersion/$pandocVersionedName.deb > /dev/null
# or
# curl -sSLO https://github.com/jgm/pandoc/releases/download/$pandocVersion/$pandocVersionedName.deb > /dev/null
sudo dpkg -i $pandocVersionedName.deb
rm $pandocVersionedName.deb*

after that update manpages by calling update-man-pages.sh script.