I have to write documentation describing the OSGi packaging functions (newjar, dojar etc have their equivalent in java-osgi). Need to decide where to put such a documentation first. Reproducible: Always
Here: http://www.gentoo.org/proj/en/java/java-devel.xml
I commited the documentation. Can someone briefly review it? (Note that I also changed to java_dohtml to reflect the fact it is deprecated).
(In reply to comment #2) > I commited the documentation. Can someone briefly review it? > I improved the grammar.
(In reply to comment #2) > I commited the documentation. Can someone briefly review it? > You are using quite long lines in the file, might want to make them a little shorter.
Removed another java-pkg_dohtml In my short hand diff format -- HTML documentation should be installed using <uri link="#func_install">java-pkg_dohtml</uri> ++ HTML documentation should be installed using <uri link="http://devmanual.gentoo.org/function-reference/install-functions/index.html">dohtml</uri> and a cvs diff Index: java-devel.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/java/java-devel.xml,v retrieving revision 1.31 diff -u -b -B -r1.31 java-devel.xml --- java-devel.xml 18 Jan 2008 22:43:30 -0000 1.31 +++ java-devel.xml 19 Jan 2008 05:27:22 -0000 @@ -328,7 +328,7 @@ <body> <p> -If a manual or other extensive documentation is available, it should be installed using the doc USE flag. If the build system can, you should build javadocs also using the <c>doc</c> USE flag. If it does not, you should consider patching it to do so, and provide the patch upstream. HTML documentation should be installed using <uri link="#func_install">java-pkg_dohtml</uri> and javadocs using <uri link="#func_install">java-pkg_dojavadoc</uri>. + If a manual or other extensive documentation is available, it should be installed using the doc USE flag. If the build system can, you should build javadocs also using the <c>doc</c> USE flag. If it does not, you should consider patching it to do so, and provide the patch upstream. HTML documentation should be installed using <uri link="http://devmanual.gentoo.org/function-reference/install-functions/index.html">dohtml</uri> and javadocs using <uri link="#func_install">java-pkg_dojavadoc</uri>. </p> <p>
It's documented and reviewed by a couple of devs so let's mark this as fixed.