Re: javadoc location?
Thanks Hoss! Its nicely back on line. http://lucene.apache.org/solr/api/index.html I'll run ant javadoc before commiting anything else with javadoc links Chris Hostetter wrote: found the problem in DirectSolrConnection.java, we were tickling this bug... http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=5082928 ...my gut says not to try and manually fix the site right now, and just wait for the next nightly to take care of it -- mainly because i'm paranoid about messing it up. I certainly won't object if any other committers want to do it. : Date: Tue, 1 May 2007 10:52:16 -0700 (PDT) : From: Chris Hostetter [EMAIL PROTECTED] : Reply-To: solr-dev@lucene.apache.org : To: Solr Dev solr-dev@lucene.apache.org : Subject: Re: javadoc location? : : : : goes to: : : http://lucene.apache.org/solr/api/index.html (404) : : : : we should probably fix that! : : The link is correct, that's where they are suppose to be -- the : problem seems to be that buildingthe javadocs is currently broken : : When i run ant javadoc locally i'm getting a bunch of warnings and : errors, the most significant seems to be... : : [javadoc] Building index for all the packages and classes... : [javadoc] /home/chrish/svn/solr/src/java/org/apache/solr/util/ContentStreamBase.java:52: warning - @Link is an unknown tag -- same as a known tag except for case. : [javadoc] java.util.MissingResourceException: Can't find resource for bundle com.sun.tools.doclets.formats.html.resources.standard, key doclet.malformed_html_link_tag : [javadoc] at java.util.ResourceBundle.getObject(ResourceBundle.java:326) : [javadoc] at java.util.ResourceBundle.getString(ResourceBundle.java:286) : [javadoc] at com.sun.tools.doclets.internal.toolkit.util.MessageRetriever.getText(MessageRetriever.java:114) : [javadoc] at com.sun.tools.doclets.internal.toolkit.util.MessageRetriever.getText(MessageRetriever.java:92) : [javadoc] at com.sun.tools.doclets.internal.toolkit.util.MessageRetriever.getText(MessageRetriever.java:81) : [javadoc] at com.sun.tools.doclets.internal.toolkit.util.MessageRetriever.warning(MessageRetriever.java:290) : [javadoc] at com.sun.tools.doclets.formats.html.HtmlDocletWriter.redirectRelativeLinks(HtmlDocletWriter.java:1526) : [javadoc] at com.sun.tools.doclets.formats.html.HtmlDocletWriter.commentTagsToString(HtmlDocletWriter.java:1438) : [javadoc] at com.sun.tools.doclets.formats.html.HtmlDocletWriter.printCommentTags(HtmlDocletWriter.java:1397) : [javadoc] at com.sun.tools.doclets.formats.html.HtmlDocletWriter.printSummaryComment(HtmlDocletWriter.java:1370) : [javadoc] at com.sun.tools.doclets.formats.html.HtmlDocletWriter.printSummaryComment(HtmlDocletWriter.java:1366) : [javadoc] at com.sun.tools.doclets.formats.html.AbstractIndexWriter.printComment(AbstractIndexWriter.java:192) : [javadoc] at com.sun.tools.doclets.formats.html.AbstractIndexWriter.printDescription(AbstractIndexWriter.java:164) : [javadoc] at com.sun.tools.doclets.formats.html.AbstractIndexWriter.generateContents(AbstractIndexWriter.java:89) : [javadoc] at com.sun.tools.doclets.formats.html.SingleIndexWriter.generateIndexFile(SingleIndexWriter.java:76) : [javadoc] at com.sun.tools.doclets.formats.html.SingleIndexWriter.generate(SingleIndexWriter.java:52) : [javadoc] at com.sun.tools.doclets.formats.html.HtmlDoclet.generateOtherFiles(HtmlDoclet.java:103) : [javadoc] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.startGeneration(AbstractDoclet.java:122) : [javadoc] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.start(AbstractDoclet.java:64) : [javadoc] at com.sun.tools.doclets.formats.html.HtmlDoclet.start(HtmlDoclet.java:42) : [javadoc] at com.sun.tools.doclets.standard.Standard.start(Standard.java:23) : [javadoc] at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) : [javadoc] at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39) : [javadoc] at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25) : [javadoc] at java.lang.reflect.Method.invoke(Method.java:585) : [javadoc] at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:269) : [javadoc] at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:143) : [javadoc] at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:340) : [javadoc] at com.sun.tools.javadoc.Start.begin(Start.java:128) : [javadoc] at com.sun.tools.javadoc.Main.execute(Main.java:41) : [javadoc] at com.sun.tools.javadoc.Main.main(Main.java:31) : : : : -Hoss : -Hoss
Re: javadoc location?
found the problem in DirectSolrConnection.java, we were tickling this bug... http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=5082928 ...my gut says not to try and manually fix the site right now, and just wait for the next nightly to take care of it -- mainly because i'm paranoid about messing it up. I certainly won't object if any other committers want to do it. : Date: Tue, 1 May 2007 10:52:16 -0700 (PDT) : From: Chris Hostetter [EMAIL PROTECTED] : Reply-To: solr-dev@lucene.apache.org : To: Solr Dev solr-dev@lucene.apache.org : Subject: Re: javadoc location? : : : : goes to: : : http://lucene.apache.org/solr/api/index.html (404) : : : : we should probably fix that! : : The link is correct, that's where they are suppose to be -- the : problem seems to be that buildingthe javadocs is currently broken : : When i run ant javadoc locally i'm getting a bunch of warnings and : errors, the most significant seems to be... : : [javadoc] Building index for all the packages and classes... : [javadoc] /home/chrish/svn/solr/src/java/org/apache/solr/util/ContentStreamBase.java:52: warning - @Link is an unknown tag -- same as a known tag except for case. : [javadoc] java.util.MissingResourceException: Can't find resource for bundle com.sun.tools.doclets.formats.html.resources.standard, key doclet.malformed_html_link_tag : [javadoc] at java.util.ResourceBundle.getObject(ResourceBundle.java:326) : [javadoc] at java.util.ResourceBundle.getString(ResourceBundle.java:286) : [javadoc] at com.sun.tools.doclets.internal.toolkit.util.MessageRetriever.getText(MessageRetriever.java:114) : [javadoc] at com.sun.tools.doclets.internal.toolkit.util.MessageRetriever.getText(MessageRetriever.java:92) : [javadoc] at com.sun.tools.doclets.internal.toolkit.util.MessageRetriever.getText(MessageRetriever.java:81) : [javadoc] at com.sun.tools.doclets.internal.toolkit.util.MessageRetriever.warning(MessageRetriever.java:290) : [javadoc] at com.sun.tools.doclets.formats.html.HtmlDocletWriter.redirectRelativeLinks(HtmlDocletWriter.java:1526) : [javadoc] at com.sun.tools.doclets.formats.html.HtmlDocletWriter.commentTagsToString(HtmlDocletWriter.java:1438) : [javadoc] at com.sun.tools.doclets.formats.html.HtmlDocletWriter.printCommentTags(HtmlDocletWriter.java:1397) : [javadoc] at com.sun.tools.doclets.formats.html.HtmlDocletWriter.printSummaryComment(HtmlDocletWriter.java:1370) : [javadoc] at com.sun.tools.doclets.formats.html.HtmlDocletWriter.printSummaryComment(HtmlDocletWriter.java:1366) : [javadoc] at com.sun.tools.doclets.formats.html.AbstractIndexWriter.printComment(AbstractIndexWriter.java:192) : [javadoc] at com.sun.tools.doclets.formats.html.AbstractIndexWriter.printDescription(AbstractIndexWriter.java:164) : [javadoc] at com.sun.tools.doclets.formats.html.AbstractIndexWriter.generateContents(AbstractIndexWriter.java:89) : [javadoc] at com.sun.tools.doclets.formats.html.SingleIndexWriter.generateIndexFile(SingleIndexWriter.java:76) : [javadoc] at com.sun.tools.doclets.formats.html.SingleIndexWriter.generate(SingleIndexWriter.java:52) : [javadoc] at com.sun.tools.doclets.formats.html.HtmlDoclet.generateOtherFiles(HtmlDoclet.java:103) : [javadoc] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.startGeneration(AbstractDoclet.java:122) : [javadoc] at com.sun.tools.doclets.internal.toolkit.AbstractDoclet.start(AbstractDoclet.java:64) : [javadoc] at com.sun.tools.doclets.formats.html.HtmlDoclet.start(HtmlDoclet.java:42) : [javadoc] at com.sun.tools.doclets.standard.Standard.start(Standard.java:23) : [javadoc] at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method) : [javadoc] at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39) : [javadoc] at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25) : [javadoc] at java.lang.reflect.Method.invoke(Method.java:585) : [javadoc] at com.sun.tools.javadoc.DocletInvoker.invoke(DocletInvoker.java:269) : [javadoc] at com.sun.tools.javadoc.DocletInvoker.start(DocletInvoker.java:143) : [javadoc] at com.sun.tools.javadoc.Start.parseAndExecute(Start.java:340) : [javadoc] at com.sun.tools.javadoc.Start.begin(Start.java:128) : [javadoc] at com.sun.tools.javadoc.Main.execute(Main.java:41) : [javadoc] at com.sun.tools.javadoc.Main.main(Main.java:31) : : : : -Hoss : -Hoss
Re: javadoc location
: OK, I fixed nightly.sh and pointed the website at api : : I also just added a symlink from docs/api to api so older wiki links : won't break. : I think that should work. yeah ... the one other little thing is making the links point at api/index.html istead of api/ so that the local links from unpacking a distribution will work (most browsers just give a directory listng otherwise) i just commited .. updating site now (allthough it shouldn't matter) -Hoss
javadoc location
On 12/15/06, Chris Hostetter [EMAIL PROTECTED] wrote: Also: one hitch when adding the site to the distribution, was that the link the the left nav of the HTML pages ot the javadocs doesn't work ... it wants one extra level of docs tags and i couldn't think of anyway to fix it that wouldn't break the actual website. We may want to move stuff arround on the site so a relative link can work better. We could generate docs under site and that would fix the problem. Or are you thinking of moving everything in the real site under another directory so that docs could be ../docs ? -Yonik
Re: javadoc location
: We may want to move stuff arround on the site so a relative link can work : better. : : We could generate docs under site and that would fix the problem. : Or are you thinking of moving everything in the real site under : another directory so that docs could be ../docs ? i was just thinking that if on the live site, we created api directly in the main site directory (whatever it's called) then the relative link of ./api/index.html would work fine for the site navigation (and would work with what i added to the package target today) i'm not really sure why the current realtive link is ./docs/api/ (H... it looks like my change caused a whole copy of the site to pe put in /www/incubator.apache.org/solr/docs by the last run on the nightly cron). -Hoss
