From c7a6e9d2f2b58ca7832c58c3e25c65c1d03079e3 Mon Sep 17 00:00:00 2001
From: David Steele <david@pgmasters.net>
Date: Fri, 23 Mar 2018 16:08:32 -0400
Subject: [PATCH] Document build improvements.

* Perform apt-get update to ensure packages are up to date before installing.
* Add -p to the repository mkdir so it won't fail if the directory already exists, handy for testing packages.
---
 doc/xml/release.xml    | 8 ++++++++
 doc/xml/user-guide.xml | 6 +++++-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/doc/xml/release.xml b/doc/xml/release.xml
index 15f14aca8..f287674b6 100644
--- a/doc/xml/release.xml
+++ b/doc/xml/release.xml
@@ -25,6 +25,14 @@
                 </release-development-list>
             </release-core-list>
 
+            <release-doc-list>
+                <release-development-list>
+                    <release-item>
+                        <p>Document build improvements.  Perform <code>apt-get update</code> to ensure packages are up to date before installing.  Add <id>-p</id> to the repository <file>mkdir</file> so it won't fail if the directory already exists, handy for testing packages.</p>
+                    </release-item>
+                </release-development-list>
+            </release-doc-list>
+
             <release-test-list>
                 <release-feature-list>
                     <release-item>
diff --git a/doc/xml/user-guide.xml b/doc/xml/user-guide.xml
index b36dd22ae..624e3978c 100644
--- a/doc/xml/user-guide.xml
+++ b/doc/xml/user-guide.xml
@@ -208,6 +208,10 @@
         <execute-list host="{[br-install-host]}" keyword="default">
             <title>Install required Perl packages</title>
 
+            <execute user="root">
+                <exe-cmd>apt-get update</exe-cmd>
+            </execute>
+
             <execute user="root">
                 <exe-cmd>apt-get install libdbd-pg-perl libio-socket-ssl-perl libxml-libxml-perl</exe-cmd>
                 <exe-cmd-extra>-y 2>&amp;1</exe-cmd-extra>
@@ -326,7 +330,7 @@
             <title>Create the <backrest/> repository</title>
 
             <execute user="root">
-                <exe-cmd>mkdir {[backrest-repo-path]}</exe-cmd>
+                <exe-cmd>mkdir -p {[backrest-repo-path]}</exe-cmd>
             </execute>
             <execute user="root">
                 <exe-cmd>chmod 750 {[backrest-repo-path]}</exe-cmd>