I looked at the new man pages for javac and found
a couple of problems:

- They contain headers and footers for every page.
  All other man pages I see only have a single
  footer at the end. This includes the currently
  released man pages for javac.1 on both linux and solaris

- All other man pages contain items like this
  for See Also:

  jar(1), java(1), javadoc(1), javah(1), javap(1), jdb(1),

  The new pages contain this sort of thing:
       * java - the Java Application Launcher

       * jdb - Java Application Debugger

  This breaks the xemacs 'man' function -
  when you put the cursor on jar(1), it is highlighed
  and if you click, it brings up the man page

- it has illegal use of \, ie all on one line:

        % javac -classpath /examples:/lib/Banners.jar \ /examples/greetings/Hi.java

  instead of
        % javac -classpath /examples:/lib/Banners.jar \
                           /examples/greetings/Hi.java

  (I think the old man pages suffered from this too).


- there is junk at the bottom:


   * The Java Extensions Framework @
     http://java.sun.com/javase/6/docs/technotes/guides/extensions/index.html

  What is that @ ? This is an improvement over
  the junk at the bottom of the tiger man pages:

     See or search the Java web site for the following:

     The Java Extensions Mechanism
          @" 6
          http://java.sun.com/j2se/1.5/docs/guide/extensions/index.html

     Setting the Class Path
          @" 6
          http://java.sun.com/j2se/1.5/docs/tooldocs/solaris/classpath.html