Path: csiph.com!x330-a1.tempe.blueboxinc.net!usenet.pasdenom.info!weretis.net!feeder4.news.weretis.net!nuzba.szn.dk!pnx.dk!fu-berlin.de!uni-berlin.de!individual.net!not-for-mail From: blmblm@myrealbox.com Newsgroups: comp.lang.java.programmer Subject: Java 7 javadocs (was Re: Ubuntu) Date: 20 Oct 2011 14:16:43 GMT Organization: None Lines: 40 Message-ID: <9gaoqbFbrlU3@mid.individual.net> References: <9g81i2Fj6eU4@mid.individual.net> X-Trace: individual.net TlaJnLUhBHmMIZHvu8+R2AVPUOfHeNPIbCr/DTpUq6rYuxnOpj X-Orig-Path: not-for-mail Cancel-Lock: sha1:qukdALojJYGSJlc2qfbfP6abnIw= X-Newsreader: trn 4.0-test76 (Apr 2, 2001) Xref: x330-a1.tempe.blueboxinc.net comp.lang.java.programmer:9028 In article , Martin Gregorie wrote: > On Wed, 19 Oct 2011 13:27:30 +0000, blmblm@myrealbox.com wrote: > > > In article , > > Martin Gregorie wrote: [ snip ] > >> and firing up Opera remotely if I want to proof read Javadocs. > > > > Once upon a time you could proofread javadocs with a frames-capable > > text-mode browser (such as elinks). Not so much with Java 7, > > alas .... Maybe a rant for another thread, but at least a return from > > topic drift? > > > Have you any idea why? Why what? Why "not so much"? because that may be a bit of an exaggeration -- but the HTML produced by the Java 7 "javadoc" tool has a fairly different look from what was produced by previous versions, and it explicitly complains if you use a browser that doesn't support Javascript, and .... : > I prefer just tried lynx, which I prefer to elinks, on a Java 6 javadocs > set. It did a reasonable job despite insisting on the non-frames set of > pages. Apart from that, the worst you can say about it is that its > formatting of method parameters with long fully qualified types is > somewhat untidy. Generally I also prefer lynx, but it doesn't support frames, and elinks does, and to me that makes a difference for this use case. Anyway, try either one on on a Java 7 javadocs set -- both still display the content, but IMO the formatting is noticeably less satisfactory than for Java 6, -- B. L. Massingill ObDisclaimer: I don't speak for my employers; they return the favor.