From martinrb at google.com Sat Mar 3 02:41:57 2018 From: martinrb at google.com (Martin Buchholz) Date: Fri, 2 Mar 2018 18:41:57 -0800 Subject: How to get api doc search box on a separate web page? Message-ID: The new SEARCH: box recently added to api docs e.g. https://download.java.net/java/early_access/jdk11/docs/api/overview-summary.html is *awesome* (thanks!) and I would like to embed those SEARCH: boxes in my own home page, and I'm guessing I'm not the only one. Do you have a snippet of html to offer for me to copy-paste? -------------- next part -------------- An HTML attachment was scrubbed... URL: From jonathan.gibbons at oracle.com Mon Mar 5 15:55:01 2018 From: jonathan.gibbons at oracle.com (Jonathan Gibbons) Date: Mon, 5 Mar 2018 07:55:01 -0800 Subject: How to get api doc search box on a separate web page? In-Reply-To: References: Message-ID: On 3/2/18 6:41 PM, Martin Buchholz wrote: > The new SEARCH: box recently added to api docs e.g. > https://download.java.net/java/early_access/jdk11/docs/api/overview-summary.html > is *awesome* (thanks!) and I would like to embed those SEARCH: boxes > in my own home page, and I'm guessing I'm not the only one.? Do you > have a snippet of html to offer for me to copy-paste? Martin, I'll investigate and get back to you. -- Jon From jonathan.gibbons at oracle.com Tue Mar 20 23:18:03 2018 From: jonathan.gibbons at oracle.com (Jonathan Gibbons) Date: Tue, 20 Mar 2018 16:18:03 -0700 Subject: RFR: 8199902: {@docRoot} references need to be updated to reflect new module/package structure Message-ID: <5AB196AB.3010900@oracle.com> Please review some simple fixes to update {@docRoot} references in documentation comments, in accordance with the new documentation organization. JBS: https://bugs.openjdk.java.net/browse/JDK-8199902 Webrev: http://cr.openjdk.java.net/~jjg/8199902/webrev.00/ -- Jon From kumar.x.srinivasan at oracle.com Wed Mar 21 16:35:13 2018 From: kumar.x.srinivasan at oracle.com (Kumar Srinivasan) Date: Wed, 21 Mar 2018 09:35:13 -0700 Subject: RFR: 8199902: {@docRoot} references need to be updated to reflect new module/package structure In-Reply-To: <5AB196AB.3010900@oracle.com> References: <5AB196AB.3010900@oracle.com> Message-ID: <5AB289C1.3030905@oracle.com> Hi Jon, Looks ok to me. Kumar On 3/20/2018 4:18 PM, Jonathan Gibbons wrote: > Please review some simple fixes to update {@docRoot} references in > documentation comments, in accordance with the new documentation > organization. > > JBS: https://bugs.openjdk.java.net/browse/JDK-8199902 > Webrev: http://cr.openjdk.java.net/~jjg/8199902/webrev.00/ > > -- Jon From bhavesh.x.patel at oracle.com Thu Mar 22 04:36:59 2018 From: bhavesh.x.patel at oracle.com (Bhavesh Patel) Date: Wed, 21 Mar 2018 21:36:59 -0700 Subject: RFR: 8199705: Docs.gmk needs to be updated to remove the -html5 option Message-ID: <8a982c39-4818-8554-8dcb-ca2c8d05b1dd@oracle.com> Hi, ??? This is a simple fix to Docs.gmk. A fix for JDK-8182765 was pushed recently to javadoc enabling it to generate HTML 5 output by default. This makes the "-html5" option, defined in the initial set of javadoc options in Docs.gmk, redundant. I have removed the -html5? option. Please review this fix. JBS: https://bugs.openjdk.java.net/browse/JDK-8199705 Webrev: http://cr.openjdk.java.net/~bpatel/8199705/webrev.00/ -------------- next part -------------- An HTML attachment was scrubbed... URL: From erik.joelsson at oracle.com Thu Mar 22 14:08:19 2018 From: erik.joelsson at oracle.com (Erik Joelsson) Date: Thu, 22 Mar 2018 07:08:19 -0700 Subject: RFR: 8199705: Docs.gmk needs to be updated to remove the -html5 option In-Reply-To: <8a982c39-4818-8554-8dcb-ca2c8d05b1dd@oracle.com> References: <8a982c39-4818-8554-8dcb-ca2c8d05b1dd@oracle.com> Message-ID: Looks good. /Erik On 2018-03-21 21:36, Bhavesh Patel wrote: > Hi, > > ??? This is a simple fix to Docs.gmk. A fix for JDK-8182765 > was pushed recently > to javadoc enabling it to generate HTML 5 output by default. This > makes the "-html5" option, defined in the initial set of javadoc > options in Docs.gmk, redundant. I have removed the -html5? option. > Please review this fix. > > > JBS: https://bugs.openjdk.java.net/browse/JDK-8199705 > > Webrev: http://cr.openjdk.java.net/~bpatel/8199705/webrev.00/ > > From martinrb at google.com Mon Mar 26 23:17:43 2018 From: martinrb at google.com (Martin Buchholz) Date: Mon, 26 Mar 2018 16:17:43 -0700 Subject: Why can't my search engine index jdk10 javadocs? Message-ID: Google search seems to do a lousy job of crawling the jdk10 javadocs. E.g. a Google search for site:https://docs.oracle.com/javase/10/docs inurl:ArrayList comes up empty Who do I complain to? Could there be a robots.txt file? -------------- next part -------------- An HTML attachment was scrubbed... URL: From jonathan.gibbons at oracle.com Mon Mar 26 23:40:13 2018 From: jonathan.gibbons at oracle.com (Jonathan Gibbons) Date: Mon, 26 Mar 2018 16:40:13 -0700 Subject: Why can't my search engine index jdk10 javadocs? In-Reply-To: References: Message-ID: <7cb319c9-0fa0-c785-018d-b9d874e33c2a@oracle.com> On 3/26/18 4:17 PM, Martin Buchholz wrote: > Google search seems to do a lousy job of crawling the jdk10 javadocs. > > E.g. a Google search for > site:https://docs.oracle.com/javase/10/docs inurl:ArrayList > comes up empty > > Who do I complain to?? Could there be a robots.txt file? I suspect that no one who actually knows the answer is on this list. I'll ask around for you. -- Jon From jonathan.gibbons at oracle.com Tue Mar 27 23:35:30 2018 From: jonathan.gibbons at oracle.com (Jonathan Gibbons) Date: Tue, 27 Mar 2018 16:35:30 -0700 Subject: Why can't my search engine index jdk10 javadocs? In-Reply-To: References: Message-ID: <4a0e95e3-a7ed-8abc-1ba1-86ab012e0ea7@oracle.com> Martin, This seems to have resolved itself.?? Maybe "Google search" finally read the release announcement ;-) -- Jon On 3/26/18 4:17 PM, Martin Buchholz wrote: > Google search seems to do a lousy job of crawling the jdk10 javadocs. > > E.g. a Google search for > site:https://docs.oracle.com/javase/10/docs inurl:ArrayList > comes up empty > > Who do I complain to?? Could there be a robots.txt file? From martinrb at google.com Wed Mar 28 18:03:01 2018 From: martinrb at google.com (Martin Buchholz) Date: Wed, 28 Mar 2018 11:03:01 -0700 Subject: Why can't my search engine index jdk10 javadocs? In-Reply-To: <4a0e95e3-a7ed-8abc-1ba1-86ab012e0ea7@oracle.com> References: <4a0e95e3-a7ed-8abc-1ba1-86ab012e0ea7@oracle.com> Message-ID: On Tue, Mar 27, 2018 at 4:35 PM, Jonathan Gibbons < jonathan.gibbons at oracle.com> wrote: > Martin, > > This seems to have resolved itself. Maybe "Google search" finally read > the release announcement ;-) > Maybe "Google search" was reading this thread and made this specific search succeed just to prove me wrong! Meanwhile site:https://docs.oracle.com/javase/10/docs inurl:arraydeque only finds the "Uses of" page. Maybe if I post all my favorite google searches on this mailing list they will magically start working better. -------------- next part -------------- An HTML attachment was scrubbed... URL: From arafalov at gmail.com Thu Mar 29 16:09:50 2018 From: arafalov at gmail.com (Alexandre Rafalovitch) Date: Thu, 29 Mar 2018 12:09:50 -0400 Subject: Why can't my search engine index jdk10 javadocs? In-Reply-To: References: <4a0e95e3-a7ed-8abc-1ba1-86ab012e0ea7@oracle.com> Message-ID: And it is not just Google having issues. When I go to https://docs.oracle.com/javase/10/docs/api/overview-summary.html I get 5 zip files returning 404 (with new search information I think). Though perhaps that's by design, the search seems to actually work (magic!). Regards, Alex. On 28 March 2018 at 14:03, Martin Buchholz wrote: > > > On Tue, Mar 27, 2018 at 4:35 PM, Jonathan Gibbons > wrote: >> >> Martin, >> >> This seems to have resolved itself. Maybe "Google search" finally read >> the release announcement ;-) > > > Maybe "Google search" was reading this thread and made this specific search > succeed just to prove me wrong! > > Meanwhile > site:https://docs.oracle.com/javase/10/docs inurl:arraydeque > only finds the "Uses of" page. > > Maybe if I post all my favorite google searches on this mailing list they > will magically start working better. > From jonathan.gibbons at oracle.com Thu Mar 29 16:55:28 2018 From: jonathan.gibbons at oracle.com (Jonathan Gibbons) Date: Thu, 29 Mar 2018 09:55:28 -0700 Subject: Why can't my search engine index jdk10 javadocs? In-Reply-To: References: <4a0e95e3-a7ed-8abc-1ba1-86ab012e0ea7@oracle.com> Message-ID: Alexandre, Can you explain in more detail: what do you mean when you say that you visit that page and get back 5 zip files returning 404? -- Jon On 3/29/18 9:09 AM, Alexandre Rafalovitch wrote: > And it is not just Google having issues. > > When I go to https://docs.oracle.com/javase/10/docs/api/overview-summary.html > I get 5 zip files returning 404 (with new search information I think). > > Though perhaps that's by design, the search seems to actually work (magic!). > > Regards, > Alex. > > On 28 March 2018 at 14:03, Martin Buchholz wrote: >> >> On Tue, Mar 27, 2018 at 4:35 PM, Jonathan Gibbons >> wrote: >>> Martin, >>> >>> This seems to have resolved itself. Maybe "Google search" finally read >>> the release announcement ;-) >> >> Maybe "Google search" was reading this thread and made this specific search >> succeed just to prove me wrong! >> >> Meanwhile >> site:https://docs.oracle.com/javase/10/docs inurl:arraydeque >> only finds the "Uses of" page. >> >> Maybe if I post all my favorite google searches on this mailing list they >> will magically start working better. >> From arafalov at gmail.com Thu Mar 29 17:21:42 2018 From: arafalov at gmail.com (Alexandre Rafalovitch) Date: Thu, 29 Mar 2018 13:21:42 -0400 Subject: Why can't my search engine index jdk10 javadocs? In-Reply-To: References: <4a0e95e3-a7ed-8abc-1ba1-86ab012e0ea7@oracle.com> Message-ID: Sorry, I meant to say that if I open a Network Analyser/Developer Tools panel, it shows the URLs that did not load. For that specific page, the URLs that did not load were: *) https://docs.oracle.com/javase/10/docs/api/module-search-index.zip *) https://docs.oracle.com/javase/10/docs/api/tag-search-index.zip *) https://docs.oracle.com/javase/10/docs/api/type-search-index.zip *) https://docs.oracle.com/javase/10/docs/api/package-search-index.zip *) https://docs.oracle.com/javase/10/docs/api/member-search-index.zip The server returned HTTP code 404 (Not Found). Hope this is clearer, Alex. On 29 March 2018 at 12:55, Jonathan Gibbons wrote: > Alexandre, > > Can you explain in more detail: what do you mean when you say that you visit > that page and get back 5 zip files returning 404? > > -- Jon > > > > On 3/29/18 9:09 AM, Alexandre Rafalovitch wrote: >> >> And it is not just Google having issues. >> >> When I go to >> https://docs.oracle.com/javase/10/docs/api/overview-summary.html >> I get 5 zip files returning 404 (with new search information I think). >> >> Though perhaps that's by design, the search seems to actually work >> (magic!). >> >> Regards, >> Alex. >> >> On 28 March 2018 at 14:03, Martin Buchholz wrote: >>> >>> >>> On Tue, Mar 27, 2018 at 4:35 PM, Jonathan Gibbons >>> wrote: >>>> >>>> Martin, >>>> >>>> This seems to have resolved itself. Maybe "Google search" finally read >>>> the release announcement ;-) >>> >>> >>> Maybe "Google search" was reading this thread and made this specific >>> search >>> succeed just to prove me wrong! >>> >>> Meanwhile >>> site:https://docs.oracle.com/javase/10/docs inurl:arraydeque >>> only finds the "Uses of" page. >>> >>> Maybe if I post all my favorite google searches on this mailing list they >>> will magically start working better. >>> > From jonathan.gibbons at oracle.com Thu Mar 29 17:29:46 2018 From: jonathan.gibbons at oracle.com (Jonathan Gibbons) Date: Thu, 29 Mar 2018 10:29:46 -0700 Subject: Why can't my search engine index jdk10 javadocs? In-Reply-To: References: <4a0e95e3-a7ed-8abc-1ba1-86ab012e0ea7@oracle.com> Message-ID: Thank you for the additional details. -- Jon On 3/29/18 10:21 AM, Alexandre Rafalovitch wrote: > Sorry, > > I meant to say that if I open a Network Analyser/Developer Tools > panel, it shows the URLs that did not load. For that specific page, > the URLs that did not load were: > *) https://docs.oracle.com/javase/10/docs/api/module-search-index.zip > *) https://docs.oracle.com/javase/10/docs/api/tag-search-index.zip > *) https://docs.oracle.com/javase/10/docs/api/type-search-index.zip > *) https://docs.oracle.com/javase/10/docs/api/package-search-index.zip > *) https://docs.oracle.com/javase/10/docs/api/member-search-index.zip > > The server returned HTTP code 404 (Not Found). > > Hope this is clearer, > Alex. > > On 29 March 2018 at 12:55, Jonathan Gibbons wrote: >> Alexandre, >> >> Can you explain in more detail: what do you mean when you say that you visit >> that page and get back 5 zip files returning 404? >> >> -- Jon >> >> >> >> On 3/29/18 9:09 AM, Alexandre Rafalovitch wrote: >>> And it is not just Google having issues. >>> >>> When I go to >>> https://docs.oracle.com/javase/10/docs/api/overview-summary.html >>> I get 5 zip files returning 404 (with new search information I think). >>> >>> Though perhaps that's by design, the search seems to actually work >>> (magic!). >>> >>> Regards, >>> Alex. >>> >>> On 28 March 2018 at 14:03, Martin Buchholz wrote: >>>> >>>> On Tue, Mar 27, 2018 at 4:35 PM, Jonathan Gibbons >>>> wrote: >>>>> Martin, >>>>> >>>>> This seems to have resolved itself. Maybe "Google search" finally read >>>>> the release announcement ;-) >>>> >>>> Maybe "Google search" was reading this thread and made this specific >>>> search >>>> succeed just to prove me wrong! >>>> >>>> Meanwhile >>>> site:https://docs.oracle.com/javase/10/docs inurl:arraydeque >>>> only finds the "Uses of" page. >>>> >>>> Maybe if I post all my favorite google searches on this mailing list they >>>> will magically start working better. >>>>