rpmvercmp.xml Add tags, separate operator groups (GH-3792)

Author: mmalferov

reference/rpminfo/functions/rpmvercmp.xml

@@ -16,7 +16,7 @@
    <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>operator</parameter><initializer>&null;</initializer></methodparam>
   </methodsynopsis>
   <para>
-   Compare 2 RPM versions.
+   Compare two RPM package versions.
   </para>
  </refsect1>
 
@@ -27,15 +27,15 @@
     <term><parameter>evr1</parameter></term>
     <listitem>
      <para>
-      First epoch:version-release string
+      First <literal>epoch:version-release</literal> string.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>evr2</parameter></term>
     <listitem>
      <para>
-      Second epoch:version-release string
+      Second <literal>epoch:version-release</literal> string.
      </para>
     </listitem>
    </varlistentry>
@@ -44,12 +44,12 @@
     <listitem>
      <para>
       An optional operator. The possible operators
-      are: <literal>&lt;</literal>, <literal>lt</literal>,
-      <literal>&lt;=</literal>, <literal>le</literal>, <literal>&gt;</literal>,
-      <literal>gt</literal>, <literal>&gt;=</literal>, <literal>ge</literal>,
-      <literal>==</literal>, <literal>=</literal>, <literal>eq</literal>,
-      <literal>!=</literal>, <literal>&lt;&gt;</literal>, <literal>ne</literal>
-      respectively.
+      are: <literal>&lt;</literal> or <literal>lt</literal>;
+      <literal>&lt;=</literal> or <literal>le</literal>;
+      <literal>&gt;</literal> or <literal>gt</literal>;
+      <literal>&gt;=</literal> or <literal>ge</literal>;
+      <literal>==</literal>, <literal>=</literal> or <literal>eq</literal>;
+      <literal>!=</literal>, <literal>&lt;&gt;</literal> or <literal>ne</literal>.
      </para>
      <para>
       This parameter is case-sensitive, values should be lowercase.
@@ -62,7 +62,9 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns &lt; 0 if evr1 is less than evr2, &gt; 0 if evr1 is greater than evr2, and 0 if they are equal.
+   Returns <literal>-1</literal> if <parameter>evr1</parameter> is less than
+   <parameter>evr2</parameter>, <literal>1</literal> if <parameter>evr1</parameter> is
+   greater than <parameter>evr2</parameter>, and <literal>0</literal> if they are equal.
   </para>
   <para>
    When using the optional <parameter>operator</parameter> argument, the