Convert things that look like man page references (i.e.,

command(number)) from the variety of different existing markup
(which included <command>, <emphasis>, and <ulink>s to man2html
CGI scripts) to a common format, which is

    <citerefentry>
      <refentrytitle>command</refentrytitle>
      <manvolnum>number</manvolnum>
    </citerefentry>

although in the interests of keeping the changes as simple as possible
for the translators, the above was flattened on to one line.

en/handbook/README

@@ -293,3 +293,23 @@ for example,
 
      Convert the first lot to <command>...</command>
 
+ 24. Fixed manual page references to use the right markup, which is
+
+       <citerefentry>
+         <refentrytitle>page_name</refentrytitle>
+         <manvolnum>number</manvolnum>
+       </citerefentry>
+
+     Did this with a regexp search for
+
+       \([a-z-_\.]+\)(\([1-9]\))
+
+     and replacing with
+
+       <citerefentry><refentrytitle>\1</refentrytitle><manvolnum>\2</manvolnum>
+
+     Since most of the page references had <command>, <emphasis>, or
+     <ulink> elements wrapped around them, you then have to sweep through the
+     file looking for "><cite" and using C-c C-k to kill the markup 
+     immediately before and after.
+