From f84858101803153a04caeb1b300b80e376fc105d Mon Sep 17 00:00:00 2001
From: xsipewe <par.wennstad@combitech.se>
Date: Fri, 2 Oct 2015 13:01:27 +0200
Subject: sasl: Editorial changes

---
 lib/sasl/doc/src/relup.xml | 70 +++++++++++++++++++++-------------------------
 1 file changed, 32 insertions(+), 38 deletions(-)

(limited to 'lib/sasl/doc/src/relup.xml')

diff --git a/lib/sasl/doc/src/relup.xml b/lib/sasl/doc/src/relup.xml
index 8eecf3fce2..58918fc8e8 100644
--- a/lib/sasl/doc/src/relup.xml
+++ b/lib/sasl/doc/src/relup.xml
@@ -36,59 +36,53 @@
     <p>The <em>release upgrade file</em> describes how a release is
       upgraded in a running system.</p>
     <p>This file is automatically generated by
-      <c>systools:make_relup/3,4</c>, using a release resource file
-      (<c>.rel</c>), application resource files (<c>.app</c>) and
+      <seealso marker="systools#make_relup/3"><c>systools:make_relup/3,4</c></seealso>, 
+      using a release resource file
+      (<c>.rel</c>), application resource files (<c>.app</c>), and
       application upgrade files (<c>.appup</c>) as input.</p>
   </description>
 
   <section>
-    <title>FILE SYNTAX</title>
-    <p>In a target system, the release upgrade file should be located in
-      the <c>OTP_ROOT/erts-EVsn/Vsn</c> directory.</p>
+    <title>File Syntax</title>
+    <p>In a target system, the release upgrade file is to be located in
+      directory <c>$ROOT/releases/Vsn</c>.</p>
     <p>The <c>relup</c> file contains one single Erlang term, which
       defines the instructions used to upgrade the release. The file has
       the following syntax:</p>
     <code type="none">
 {Vsn,
   [{UpFromVsn, Descr, Instructions}, ...],
-  [{DownToVsn, Descr, Instructions}, ...]}.
-    </code>
-    <list type="bulleted">
-      <item>
-        <p><c>Vsn = string()</c> is the current version of the release.</p>
-      </item>
-      <item>
-        <p><c>UpFromVsn = string()</c> is an earlier version of the release
-          to upgrade from.</p>
-      </item>
-      <item>
-        <p><c>Descr = term()</c> is a user defined parameter passed
-          from the <c>systools:make_relup/3,4</c> function. It will
-          be used in the return value of
-          <c>release_handler:install_release/1,2</c>.</p>
-      </item>
-      <item>
-        <p><c>Instructions</c> is a list of low-level release upgrade
-          instructions, see <c>appup(4)</c>.</p>
-        <p>It consists of the release upgrade instructions from
+  [{DownToVsn, Descr, Instructions}, ...]}.</code>
+    <taglist>
+      <tag><c>Vsn = string()</c></tag>
+        <item><p>Current release version.</p></item>
+      <tag><c>UpFromVsn = string()</c></tag>
+        <item><p>Earlier version of the release to upgrade from.</p></item>
+      <tag><c>Descr = term()</c></tag>
+        <item><p>A user-defined parameter passed
+          from the function 
+	  <seealso marker="systools#make_relup/3"><c>systools:make_relup/3,4</c></seealso>.
+	  It is used in the return value of
+          <seealso marker="release_handler#install_release/1"><c>release_handler:install_release/1,2</c></seealso>.</p></item>
+      <tag><c>Instructions</c></tag>
+        <item><p>A list of low-level release upgrade instructions, see
+          <seealso marker="appup"><c>appup(4)</c></seealso>.
+          It consists of the release upgrade instructions from
           the respective application upgrade files (high-level instructions
           are translated to low-level instructions), in the same order
-          as in the start script.</p>
-      </item>
-      <item>
-        <p><c>DownToVsn = string()</c> is an earlier version of the release
-          to downgrade to.</p>
-      </item>
-    </list>
-    <p>When upgrading from <c>UpFromVsn</c> with
-      <c>release_handler:install_release/1,2</c>, there does not have to be
-      an exact match of versions, but <c>UpFromVsn</c> can be a sub-string
-      of the current release version.</p>
+          as in the start script.</p></item>
+      <tag><c>DownToVsn = string()</c></tag>
+        <item><p>Earlier version of the release to downgrade to.</p></item>
+    </taglist>
   </section>
 
   <section>
-    <title>SEE ALSO</title>
-    <p>app(4), appup(4), rel(4), release_handler(3), systools(3)</p>
+    <title>See Also</title>
+    <p><seealso marker="kernel:app"><c>app(4)</c></seealso>,
+      <seealso marker="appup"><c>appup(4)</c></seealso>,
+      <seealso marker="rel"><c>rel(4)</c></seealso>,
+      <seealso marker="release_handler"><c>release_handler(3)</c></seealso>,
+      <seealso marker="systools"><c>systools(3)</c></seealso></p>
   </section>
 </fileref>
 
-- 
cgit v1.2.3