PT-2340 - Support MySQL 8.4

- Changed write-user-docs script, so it creates special documentation pages for symbolic links.

util/write-user-docs

@@ -159,11 +159,28 @@ write_rst() {
       return
    fi
 
-   $BRANCH/util/pod2rst-fixed.packed $file > $RST_DIR/$tool.rst
-   if [ $? -eq 0 ]; then
-      echo "Wrote $RST_DIR/$tool.rst"
+   if [ -h $file ]; then
+      local link="$(readlink $file)"
+      echo "
+.. program:: ${tool}
+
+============================
+:program:\`${tool}\`
+============================
+
+NAME
+====
+
+:program:\`$(basename $file)\` is a symbolic link to ${link}. Please read documentation for ${link}.
+
+" > $RST_DIR/$tool.rst
    else
-      die "Error writing $RST_DIR/$tool.rst"
+      $BRANCH/util/pod2rst-fixed.packed $file > $RST_DIR/$tool.rst
+      if [ $? -eq 0 ]; then
+         echo "Wrote $RST_DIR/$tool.rst"
+      else
+         die "Error writing $RST_DIR/$tool.rst"
+      fi
    fi
 }