Thread: [Java-gnome-developer] javadoc on website
Brought to you by:
afcowie
From: Nicholas R. <ni...@mn...> - 2004-12-22 14:23:20
|
How can we update the javadoc that's available on the website? there are currently 2 links: - to the outdated 2.6 docs - to the 2.9 docs (link broken). i've got the 2.8 docs generated using the gentoo ebuilds (thanks afc) so i could tar this up and put it somewhere, but i'm not sure how to get it onto the website. i could also generate the javadocs for the current CVS and put them under the 2.9 docs link. can anyone tell me what's the best way to do this? thx nick |
From: Mark H. <mh...@ti...> - 2004-12-22 15:50:38
|
scp them to somewhere under use...@ja...:/home/groups/j/ja/java-gnome/htdocs/ Then update the website links if they need it. Also, please ssh to the server, delete the old copy and make the new copy group writable. -- .''`. Mark Howard : :' : `. `' http://www.tildemh.com `- mh...@de... | mh...@ti... |
From: Andrew C. <an...@op...> - 2004-12-22 22:46:21
|
On Wed, 2004-22-12 at 15:23 +0100, Nicholas Rahn wrote: > i've got the 2.8 docs generated using the gentoo ebuilds (thanks afc) /me blushes > I could also generate the javadocs for the current > CVS and put them under the 2.9 docs link. Speaking of Javadocs, I'm by no means a ninja, and it strikes me we should be linking in the local JDK's Javadocs somehow so things like String and System are recognized. If someone can tell me how to do so, that'd be great. AfC Sydney |
From: Mark H. <mh...@ti...> - 2004-12-23 08:52:10
|
Quoting Andrew Cowie <an...@op...>: > On Wed, 2004-22-12 at 15:23 +0100, Nicholas Rahn wrote: > > i've got the 2.8 docs generated using the gentoo ebuilds (thanks afc) > > /me blushes > > > I could also generate the javadocs for the current > > CVS and put them under the 2.9 docs link. > > Speaking of Javadocs, I'm by no means a ninja, and it strikes me we > should be linking in the local JDK's Javadocs somehow so things like > String and System are recognized. If someone can tell me how to do so, > that'd be great. man javadoc. --link /path/to/javadoc, IIRC. Unfortunately doesn't work with gjdoc though. -- .""`. Mark Howard : :" : `. `" http://www.tildemh.com `- mh...@de... | mh...@ti... |
From: Laurent M. <la...@ao...> - 2004-12-23 04:41:12
|
>>>>> "Andrew" == Andrew Cowie <an...@op...> writes: Andrew> On Wed, 2004-22-12 at 15:23 +0100, Nicholas Rahn wrote: >> i've got the 2.8 docs generated using the gentoo ebuilds (thanks >> afc) Andrew> /me blushes >> I could also generate the javadocs for the current CVS and put >> them under the 2.9 docs link. Andrew> Speaking of Javadocs, I'm by no means a ninja, and it Andrew> strikes me we should be linking in the local JDK's Javadocs Andrew> somehow so things like String and System are recognized. If Andrew> someone can tell me how to do so, that'd be great. You can use -link http://java.sun.com/j2se/1.3/docs/api/ (at leat with sun's javadoc) -- Laurent Martelli la...@ao... Java Aspect Components http://www.aopsys.com/ http://jac.objectweb.org |
From: Nicholas R. <ni...@mn...> - 2004-12-23 09:08:36
|
The javadocs for both stable (2.8.2) and development (2.9/CVS) versions are now available on the web site. On-line browsable versions and downloadable "bundles" (tar.gz) are available. On Thu, 2004-12-23 at 09:46 +1100, Andrew Cowie wrote: > Speaking of Javadocs, I'm by no means a ninja, and it strikes me we > should be linking in the local JDK's Javadocs somehow so things like > String and System are recognized. If someone can tell me how to do so, > that'd be great. i've created a make target in java-gnome/Makefile.in to generate the javadoc for the core modules. this should simplify things for people that want to distribute or use the javadocs (for example, in your gentoo ebuild). as mark said, i think you can use the -link <extURL> for linking to external referenced classes. i think you can also use -sourcepath if your going to link to something local. Java's tooldocs are pretty detailed on the use of javadoc. nick |
From: Andrew C. <an...@op...> - 2004-12-23 10:35:19
|
On Thu, 2004-23-12 at 10:08 +0100, Nicholas Rahn wrote: > i've created a make target in java-gnome/Makefile.in to generate the > javadoc for the core modules. this should simplify things for people > that want to distribute or use the javadocs (for example, in your > gentoo ebuild). Actually, no, it won't really help that particular problem. There's a fundamental mismatch now that libgtk-java, libgnome-java, libglade-java and libgconf-java are released independently. The fact that they are in CVS under the module java-gnome doesn't matter - specifically the presence of java-gnome/anything doesn't help because that doesn't make it into the release tarballs. As the decision to split things up like this is from before my time, I presume that people took this sort of thing into account. What you created will certainly help people who are developing out of CVS, though, which is nice. [In the case of Gentoo's java-gnome task ebuild, I do the kludge of unpacking the source balls and then running javadoc over them manually - precisely *because* lib*java are released individually and aren't released as a single tree anymore. <shrug> It's no matter now, and it works fine. I've done the work to make the individual packages, and created the java-gnome task ebuild to bring in the individual lib*-java packages as dependencies. I presume other distros are going to do similar] > javadocs on web site Good show! AfC Sydney |
From: Jeff M. <ku...@gm...> - 2004-12-23 12:54:52
|
On Thu, 23 Dec 2004 21:35:04 +1100, Andrew Cowie <an...@op...> wrote: > As the decision to split things up like this is from before my time, I > presume that people took this sort of thing into account. What you > created will certainly help people who are developing out of CVS, > though, which is nice. This changed was a prerequisite to joining the Bindings Platform. |