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
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
