Add examples for building a documentation host.

doc/README.md

@@ -20,6 +20,27 @@ Each `os-type` has a default container image that will be used as a base for cre
 ```bash
 ./doc.pl --out=html --include=user-guide --var=os-type=debian --var=os-image=debian:9
 ```
+The following is a sample CentOS/RHEL 7 configuration that can be used for building the documentation.
+```bash
+# Install docker
+sudo yum install -y yum-utils device-mapper-persistent-data lvm2
+sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
+sudo yum install -y docker-ce
+sudo systemctl start docker
+
+# Install tools
+sudo yum install -y git wget
+
+# Install Perl modules that do not have CentOS packages via CPAN
+sudo yum install -y yum cpanminus
+sudo yum groupinstall -y "Development Tools" "Development Libraries"
+sudo cpanm install --force XML::Checker::Parser
+
+# Add documentation test user
+sudo groupadd test
+sudo adduser -gtest -n testdoc
+sudo usermod -aG docker testdoc
+```
 
 ## Building with Packages
 
@@ -39,3 +60,26 @@ CentOS/RHEL 7:
 ```bash
 ./doc.pl --out=html --include=user-guide --no-cache --var=os-type=centos7 --var=package=test/package/pgbackrest-2.08-1.el7.x86_64.rpm
 ```
+Packages can be built with `test.pl` using the following configuration on top of the configuration given for building the documentation.
+```bash
+# Install recent git
+sudo yum remove -y git
+sudo yum install -y https://centos7.iuscommunity.org/ius-release.rpm
+sudo yum install -y git2u-all
+
+# Install Perl modules
+sudo yum install -y perl-ExtUtils-ParseXS perl-ExtUtils-Embed perl-ExtUtils-MakeMaker perl-YAML-LibYAML
+
+# Install dev libraries
+sudo yum install -y libxml2-devel
+
+# Add test user with sudo privileges
+sudo adduser -gtest -n test
+sudo usermod -aG docker test
+sudo chmod 750 /home/test
+
+sudo echo 'test ALL=(ALL) NOPASSWD: ALL' > /etc/sudoers.d/pgbackrest
+
+# Add pgbackrest user required by tests
+sudo adduser -gtest -n pgbackrest
+```