You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@jena.apache.org by Martynas Jusevičius <ma...@atomgraph.com> on 2021/12/25 11:35:20 UTC
Javadoc links are broken?
Hi,
Happy holidays!
Is it just me or most Javadoc links are broken? Or is it a Google
indexing problem?
For example:
https://jena.apache.org/documentation/javadoc/rdfconnection/org/apache/jena/rdfconnection/RDFDatasetConnection.html
https://jena.apache.org/documentation/javadoc/arq/org/apache/jena/query/DatasetAccessor.html
Those are the links I get searching Google for "RDFDatasetConnection"
and "DatasetAccessor" and both return "Not Found".
Martynas
Re: Javadoc links are broken?
Posted by Andy Seaborne <an...@apache.org>.
The site should be fixed now.
There is a JS change, so it needs local browser caches refreshed
(cntl-F5 should work) for each area.
And a javadoc build fix
https://issues.apache.org/jira/browse/JENA-2232
Links across javadoc trees may not work.
Rinor - thank you!
Andy
On 28/12/2021 12:30, Andy Seaborne wrote:
>
>
> On 27/12/2021 12:56, Rinor Sefa wrote:
>> I think I found the issue,
>> https://bugs.openjdk.java.net/browse/JDK-8215291
>
> Good find - it fits the description and the javadoc build was with Java11.
>
> So "--no-module-directories", and external links, causes the problem.
> Fixed in Java >= 12.
> May be back ported to Java11.
>
> And it might be as little as a one line fix to search.js !!!
>
> Andy
>
>> -----Original Message-----
>> From: Andy Seaborne <an...@apache.org>
>> Sent: Monday, 27 December 2021 13:45
>> To: users@jena.apache.org
>> Subject: Re: Javadoc links are broken?
>>
>> On 27/12/2021 12:02, Rinor Sefa wrote:
>>> I also find some issues navigating documentation through search bar.
>>>
>>> Steps to reproduce
>>> 1) Go to https://jena.apache.org/documentation/javadoc/jena/index.html
>>> 2) Use Search Bar on top right.
>>> 3) Write ModelFactory(type)(example)
>>> 4) Click
>>> 5) NOT FOUND page displayed
>>> (https://jena.apache.org/documentation/javadoc/jena/undefined/org/apac
>>> he/jena/rdf/model/ModelFactory.html)
>>
>> Thanks.
>>
>> Does anyone know what causes the /undefined/? Is that where a module
>> name goes?
>>
>> Jena isn't java modules - a it does set automatic modules in the POMs.
>>
>> Is this new at 4.3? (because AFAICS we didn't change any thing from 4.2).
>>
>> 4.x was the start of using java11 where the javadoc tools is quite
>> different to the java8 one.
>>
>> Andy
>>
>>>
>>> Happy holidays,
>>> Rinor Sefa
>>>
>>> -----Original Message-----
>>> From: Andy Seaborne <an...@apache.org>
>>> Sent: Sunday, 26 December 2021 12:59
>>> To: users@jena.apache.org
>>> Subject: Re: Javadoc links are broken?
>>>
>>>
>>>
>>> On 25/12/2021 11:35, Martynas Jusevičius wrote:
>>>> Hi,
>>>>
>>>> Happy holidays!
>>>>
>>>> Is it just me or most Javadoc links are broken? Or is it a Google
>>>> indexing problem?
>>>
>>> The Apache Jena project is not responsible for Google indexing :-)
>>>
>>>> For example:
>>>> https://jena.apache.org/documentation/javadoc/rdfconnection/org/apach
>>>> e /jena/rdfconnection/RDFDatasetConnection.html
>>>
>>> Java11 javadoc is quite different to java8 javadoc.
>>> The material is there if you navigate to it.
>>>
>>> https://jena.apache.org/documentation/javadoc/rdfconnection/org.apache
>>> .jena.rdfconnection/org/apache/jena/rdfconnection/RDFDatasetConnection
>>> .html
>>>
>>>> https://jena.apache.org/documentation/javadoc/arq/org/apache/jena/que
>>>> r
>>>> y/DatasetAccessor.html
>>>
>>> Not in the codebase.
>>>
>>>> Those are the links I get searching Google for "RDFDatasetConnection"
>>>> and "DatasetAccessor" and both return "Not Found".
>>>>
>>>> Martynas
>>>>
Re: Javadoc links are broken?
Posted by Andy Seaborne <an...@apache.org>.
On 27/12/2021 12:56, Rinor Sefa wrote:
> I think I found the issue, https://bugs.openjdk.java.net/browse/JDK-8215291
Good find - it fits the description and the javadoc build was with Java11.
So "--no-module-directories", and external links, causes the problem.
Fixed in Java >= 12.
May be back ported to Java11.
And it might be as little as a one line fix to search.js !!!
Andy
> -----Original Message-----
> From: Andy Seaborne <an...@apache.org>
> Sent: Monday, 27 December 2021 13:45
> To: users@jena.apache.org
> Subject: Re: Javadoc links are broken?
>
> On 27/12/2021 12:02, Rinor Sefa wrote:
>> I also find some issues navigating documentation through search bar.
>>
>> Steps to reproduce
>> 1) Go to https://jena.apache.org/documentation/javadoc/jena/index.html
>> 2) Use Search Bar on top right.
>> 3) Write ModelFactory(type)(example)
>> 4) Click
>> 5) NOT FOUND page displayed
>> (https://jena.apache.org/documentation/javadoc/jena/undefined/org/apac
>> he/jena/rdf/model/ModelFactory.html)
>
> Thanks.
>
> Does anyone know what causes the /undefined/? Is that where a module name goes?
>
> Jena isn't java modules - a it does set automatic modules in the POMs.
>
> Is this new at 4.3? (because AFAICS we didn't change any thing from 4.2).
>
> 4.x was the start of using java11 where the javadoc tools is quite different to the java8 one.
>
> Andy
>
>>
>> Happy holidays,
>> Rinor Sefa
>>
>> -----Original Message-----
>> From: Andy Seaborne <an...@apache.org>
>> Sent: Sunday, 26 December 2021 12:59
>> To: users@jena.apache.org
>> Subject: Re: Javadoc links are broken?
>>
>>
>>
>> On 25/12/2021 11:35, Martynas Jusevičius wrote:
>>> Hi,
>>>
>>> Happy holidays!
>>>
>>> Is it just me or most Javadoc links are broken? Or is it a Google
>>> indexing problem?
>>
>> The Apache Jena project is not responsible for Google indexing :-)
>>
>>> For example:
>>> https://jena.apache.org/documentation/javadoc/rdfconnection/org/apach
>>> e /jena/rdfconnection/RDFDatasetConnection.html
>>
>> Java11 javadoc is quite different to java8 javadoc.
>> The material is there if you navigate to it.
>>
>> https://jena.apache.org/documentation/javadoc/rdfconnection/org.apache
>> .jena.rdfconnection/org/apache/jena/rdfconnection/RDFDatasetConnection
>> .html
>>
>>> https://jena.apache.org/documentation/javadoc/arq/org/apache/jena/que
>>> r
>>> y/DatasetAccessor.html
>>
>> Not in the codebase.
>>
>>> Those are the links I get searching Google for "RDFDatasetConnection"
>>> and "DatasetAccessor" and both return "Not Found".
>>>
>>> Martynas
>>>
RE: Javadoc links are broken?
Posted by Rinor Sefa <ri...@uzh.ch>.
I think I found the issue, https://bugs.openjdk.java.net/browse/JDK-8215291
-----Original Message-----
From: Andy Seaborne <an...@apache.org>
Sent: Monday, 27 December 2021 13:45
To: users@jena.apache.org
Subject: Re: Javadoc links are broken?
On 27/12/2021 12:02, Rinor Sefa wrote:
> I also find some issues navigating documentation through search bar.
>
> Steps to reproduce
> 1) Go to https://jena.apache.org/documentation/javadoc/jena/index.html
> 2) Use Search Bar on top right.
> 3) Write ModelFactory(type)(example)
> 4) Click
> 5) NOT FOUND page displayed
> (https://jena.apache.org/documentation/javadoc/jena/undefined/org/apac
> he/jena/rdf/model/ModelFactory.html)
Thanks.
Does anyone know what causes the /undefined/? Is that where a module name goes?
Jena isn't java modules - a it does set automatic modules in the POMs.
Is this new at 4.3? (because AFAICS we didn't change any thing from 4.2).
4.x was the start of using java11 where the javadoc tools is quite different to the java8 one.
Andy
>
> Happy holidays,
> Rinor Sefa
>
> -----Original Message-----
> From: Andy Seaborne <an...@apache.org>
> Sent: Sunday, 26 December 2021 12:59
> To: users@jena.apache.org
> Subject: Re: Javadoc links are broken?
>
>
>
> On 25/12/2021 11:35, Martynas Jusevičius wrote:
>> Hi,
>>
>> Happy holidays!
>>
>> Is it just me or most Javadoc links are broken? Or is it a Google
>> indexing problem?
>
> The Apache Jena project is not responsible for Google indexing :-)
>
>> For example:
>> https://jena.apache.org/documentation/javadoc/rdfconnection/org/apach
>> e /jena/rdfconnection/RDFDatasetConnection.html
>
> Java11 javadoc is quite different to java8 javadoc.
> The material is there if you navigate to it.
>
> https://jena.apache.org/documentation/javadoc/rdfconnection/org.apache
> .jena.rdfconnection/org/apache/jena/rdfconnection/RDFDatasetConnection
> .html
>
>> https://jena.apache.org/documentation/javadoc/arq/org/apache/jena/que
>> r
>> y/DatasetAccessor.html
>
> Not in the codebase.
>
>> Those are the links I get searching Google for "RDFDatasetConnection"
>> and "DatasetAccessor" and both return "Not Found".
>>
>> Martynas
>>
Re: Javadoc links are broken?
Posted by Andy Seaborne <an...@apache.org>.
On 27/12/2021 12:02, Rinor Sefa wrote:
> I also find some issues navigating documentation through search bar.
>
> Steps to reproduce
> 1) Go to https://jena.apache.org/documentation/javadoc/jena/index.html
> 2) Use Search Bar on top right.
> 3) Write ModelFactory(type)(example)
> 4) Click
> 5) NOT FOUND page displayed (https://jena.apache.org/documentation/javadoc/jena/undefined/org/apache/jena/rdf/model/ModelFactory.html)
Thanks.
Does anyone know what causes the /undefined/? Is that where a module
name goes?
Jena isn't java modules - a it does set automatic modules in the POMs.
Is this new at 4.3? (because AFAICS we didn't change any thing from 4.2).
4.x was the start of using java11 where the javadoc tools is quite
different to the java8 one.
Andy
>
> Happy holidays,
> Rinor Sefa
>
> -----Original Message-----
> From: Andy Seaborne <an...@apache.org>
> Sent: Sunday, 26 December 2021 12:59
> To: users@jena.apache.org
> Subject: Re: Javadoc links are broken?
>
>
>
> On 25/12/2021 11:35, Martynas Jusevičius wrote:
>> Hi,
>>
>> Happy holidays!
>>
>> Is it just me or most Javadoc links are broken? Or is it a Google
>> indexing problem?
>
> The Apache Jena project is not responsible for Google indexing :-)
>
>> For example:
>> https://jena.apache.org/documentation/javadoc/rdfconnection/org/apache
>> /jena/rdfconnection/RDFDatasetConnection.html
>
> Java11 javadoc is quite different to java8 javadoc.
> The material is there if you navigate to it.
>
> https://jena.apache.org/documentation/javadoc/rdfconnection/org.apache.jena.rdfconnection/org/apache/jena/rdfconnection/RDFDatasetConnection.html
>
>> https://jena.apache.org/documentation/javadoc/arq/org/apache/jena/quer
>> y/DatasetAccessor.html
>
> Not in the codebase.
>
>> Those are the links I get searching Google for "RDFDatasetConnection"
>> and "DatasetAccessor" and both return "Not Found".
>>
>> Martynas
>>
RE: Javadoc links are broken?
Posted by Rinor Sefa <ri...@uzh.ch>.
I also find some issues navigating documentation through search bar.
Steps to reproduce
1) Go to https://jena.apache.org/documentation/javadoc/jena/index.html
2) Use Search Bar on top right.
3) Write ModelFactory(type)(example)
4) Click
5) NOT FOUND page displayed (https://jena.apache.org/documentation/javadoc/jena/undefined/org/apache/jena/rdf/model/ModelFactory.html)
Happy holidays,
Rinor Sefa
-----Original Message-----
From: Andy Seaborne <an...@apache.org>
Sent: Sunday, 26 December 2021 12:59
To: users@jena.apache.org
Subject: Re: Javadoc links are broken?
On 25/12/2021 11:35, Martynas Jusevičius wrote:
> Hi,
>
> Happy holidays!
>
> Is it just me or most Javadoc links are broken? Or is it a Google
> indexing problem?
The Apache Jena project is not responsible for Google indexing :-)
> For example:
> https://jena.apache.org/documentation/javadoc/rdfconnection/org/apache
> /jena/rdfconnection/RDFDatasetConnection.html
Java11 javadoc is quite different to java8 javadoc.
The material is there if you navigate to it.
https://jena.apache.org/documentation/javadoc/rdfconnection/org.apache.jena.rdfconnection/org/apache/jena/rdfconnection/RDFDatasetConnection.html
> https://jena.apache.org/documentation/javadoc/arq/org/apache/jena/quer
> y/DatasetAccessor.html
Not in the codebase.
> Those are the links I get searching Google for "RDFDatasetConnection"
> and "DatasetAccessor" and both return "Not Found".
>
> Martynas
>
Re: Javadoc links are broken?
Posted by Andy Seaborne <an...@apache.org>.
On 25/12/2021 11:35, Martynas Jusevičius wrote:
> Hi,
>
> Happy holidays!
>
> Is it just me or most Javadoc links are broken? Or is it a Google
> indexing problem?
The Apache Jena project is not responsible for Google indexing :-)
> For example:
> https://jena.apache.org/documentation/javadoc/rdfconnection/org/apache/jena/rdfconnection/RDFDatasetConnection.html
Java11 javadoc is quite different to java8 javadoc.
The material is there if you navigate to it.
https://jena.apache.org/documentation/javadoc/rdfconnection/org.apache.jena.rdfconnection/org/apache/jena/rdfconnection/RDFDatasetConnection.html
> https://jena.apache.org/documentation/javadoc/arq/org/apache/jena/query/DatasetAccessor.html
Not in the codebase.
> Those are the links I get searching Google for "RDFDatasetConnection"
> and "DatasetAccessor" and both return "Not Found".
>
> Martynas
>