[jira] [Created] (LUCENE-4302) Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)

classic Classic list List threaded Threaded
14 messages Options
Reply | Threaded
Open this post in threaded view
|

[jira] [Created] (LUCENE-4302) Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)

JIRA jira@apache.org
Karl Nicholas created LUCENE-4302:
-------------------------------------

             Summary: Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)
                 Key: LUCENE-4302
                 URL: https://issues.apache.org/jira/browse/LUCENE-4302
             Project: Lucene - Core
          Issue Type: Bug
          Components: general/javadocs
    Affects Versions: 4.0-ALPHA
         Environment: Windows 7-64bit/Eclipse Juno (4.2)/Maven m2e plugin/firefox latest
            Reporter: Karl Nicholas
            Priority: Minor


I have opened javadoc for Facet API while using Eclipse, which downloaded the javadocs using Maven m2e plugin. When I click on facet User Guide on the overview page I get the following exception in FireFox:

http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html


An error occured while processing the requested document:

org.xml.sax.SAXParseException; lineNumber: 121; columnNumber: 16; The element type "br" must be terminated by the matching end-tag "</br>".

        at com.sun.org.apache.xerces.internal.parsers.DOMParser.parse(Unknown Source)

        at com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl.parse(Unknown Source)

The link, or requested document is:

http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html


--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

[jira] [Commented] (LUCENE-4302) Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)

JIRA jira@apache.org

    [ https://issues.apache.org/jira/browse/LUCENE-4302?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13433252#comment-13433252 ]

Uwe Schindler commented on LUCENE-4302:
---------------------------------------

The facet userguide is HTML and not XML, so a non-closing <br> element is fine. This is a bug in eclipse, it should use a HTML parser like nekohtml.
               

> Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)
> -------------------------------------------------------------------------------------------
>
>                 Key: LUCENE-4302
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4302
>             Project: Lucene - Core
>          Issue Type: Bug
>          Components: general/javadocs
>    Affects Versions: 4.0-ALPHA
>         Environment: Windows 7-64bit/Eclipse Juno (4.2)/Maven m2e plugin/firefox latest
>            Reporter: Karl Nicholas
>            Priority: Minor
>              Labels: documentation
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> I have opened javadoc for Facet API while using Eclipse, which downloaded the javadocs using Maven m2e plugin. When I click on facet User Guide on the overview page I get the following exception in FireFox:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html
> An error occured while processing the requested document:
> org.xml.sax.SAXParseException; lineNumber: 121; columnNumber: 16; The element type "br" must be terminated by the matching end-tag "</br>".
> at com.sun.org.apache.xerces.internal.parsers.DOMParser.parse(Unknown Source)
> at com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl.parse(Unknown Source)
> The link, or requested document is:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

[jira] [Commented] (LUCENE-4302) Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)

JIRA jira@apache.org
In reply to this post by JIRA jira@apache.org

    [ https://issues.apache.org/jira/browse/LUCENE-4302?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13433336#comment-13433336 ]

Shai Erera commented on LUCENE-4302:
------------------------------------

I agree. We cannot guarantee that the userguide will be XML compliant.

Karl, I opened the userguide in Firefox without any problem, not through eclipse though.
               

> Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)
> -------------------------------------------------------------------------------------------
>
>                 Key: LUCENE-4302
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4302
>             Project: Lucene - Core
>          Issue Type: Bug
>          Components: general/javadocs
>    Affects Versions: 4.0-ALPHA
>         Environment: Windows 7-64bit/Eclipse Juno (4.2)/Maven m2e plugin/firefox latest
>            Reporter: Karl Nicholas
>            Priority: Minor
>              Labels: documentation
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> I have opened javadoc for Facet API while using Eclipse, which downloaded the javadocs using Maven m2e plugin. When I click on facet User Guide on the overview page I get the following exception in FireFox:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html
> An error occured while processing the requested document:
> org.xml.sax.SAXParseException; lineNumber: 121; columnNumber: 16; The element type "br" must be terminated by the matching end-tag "</br>".
> at com.sun.org.apache.xerces.internal.parsers.DOMParser.parse(Unknown Source)
> at com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl.parse(Unknown Source)
> The link, or requested document is:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

[jira] [Commented] (LUCENE-4302) Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)

JIRA jira@apache.org
In reply to this post by JIRA jira@apache.org

    [ https://issues.apache.org/jira/browse/LUCENE-4302?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13433394#comment-13433394 ]

Karl Nicholas commented on LUCENE-4302:
---------------------------------------

Well, I was certainly able to get to the userguide one way or another. I'll try posting this bug/comments into eclipse bugzilla, but this is starting to sound like a "not my problem" kind of issue and it seems silly to have the error when a couple of slash's could fix it. I'm happy to update the file, but I'm not sure I know how to go about getting myself setup for that or even if I'm welcome to do so.

Karl.
               

> Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)
> -------------------------------------------------------------------------------------------
>
>                 Key: LUCENE-4302
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4302
>             Project: Lucene - Core
>          Issue Type: Bug
>          Components: general/javadocs
>    Affects Versions: 4.0-ALPHA
>         Environment: Windows 7-64bit/Eclipse Juno (4.2)/Maven m2e plugin/firefox latest
>            Reporter: Karl Nicholas
>            Priority: Minor
>              Labels: documentation
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> I have opened javadoc for Facet API while using Eclipse, which downloaded the javadocs using Maven m2e plugin. When I click on facet User Guide on the overview page I get the following exception in FireFox:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html
> An error occured while processing the requested document:
> org.xml.sax.SAXParseException; lineNumber: 121; columnNumber: 16; The element type "br" must be terminated by the matching end-tag "</br>".
> at com.sun.org.apache.xerces.internal.parsers.DOMParser.parse(Unknown Source)
> at com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl.parse(Unknown Source)
> The link, or requested document is:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

[jira] [Comment Edited] (LUCENE-4302) Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)

JIRA jira@apache.org
In reply to this post by JIRA jira@apache.org

    [ https://issues.apache.org/jira/browse/LUCENE-4302?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13433394#comment-13433394 ]

Karl Nicholas edited comment on LUCENE-4302 at 8/14/12 5:35 AM:
----------------------------------------------------------------

Well, I was certainly able to get to the userguide one way or another. I'll try posting this bug/comments into eclipse bugzilla, but this is starting to sound like a "not my problem" kind of issue and it seems silly to have the error when a couple of slash's could fix it. I'm happy to update the file, but I'm not sure I know how to go about getting myself setup for that or even if I'm welcome to do so.
               
      was (Author: karlnicholas):
    Well, I was certainly able to get to the userguide one way or another. I'll try posting this bug/comments into eclipse bugzilla, but this is starting to sound like a "not my problem" kind of issue and it seems silly to have the error when a couple of slash's could fix it. I'm happy to update the file, but I'm not sure I know how to go about getting myself setup for that or even if I'm welcome to do so.

Karl.
                 

> Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)
> -------------------------------------------------------------------------------------------
>
>                 Key: LUCENE-4302
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4302
>             Project: Lucene - Core
>          Issue Type: Bug
>          Components: general/javadocs
>    Affects Versions: 4.0-ALPHA
>         Environment: Windows 7-64bit/Eclipse Juno (4.2)/Maven m2e plugin/firefox latest
>            Reporter: Karl Nicholas
>            Priority: Minor
>              Labels: documentation
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> I have opened javadoc for Facet API while using Eclipse, which downloaded the javadocs using Maven m2e plugin. When I click on facet User Guide on the overview page I get the following exception in FireFox:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html
> An error occured while processing the requested document:
> org.xml.sax.SAXParseException; lineNumber: 121; columnNumber: 16; The element type "br" must be terminated by the matching end-tag "</br>".
> at com.sun.org.apache.xerces.internal.parsers.DOMParser.parse(Unknown Source)
> at com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl.parse(Unknown Source)
> The link, or requested document is:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

[jira] [Commented] (LUCENE-4302) Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)

JIRA jira@apache.org
In reply to this post by JIRA jira@apache.org

    [ https://issues.apache.org/jira/browse/LUCENE-4302?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13433402#comment-13433402 ]

Shai Erera commented on LUCENE-4302:
------------------------------------

bq. even if I'm welcome to do so

People are always welcome to contribute code changes / bug fixes. In fact, if you scan the HTML and make it more XML compliant, I don't mind helping you get it committed.

bq. this is starting to sound like a "not my problem"

That's not true (nor a fair statement). This is an HTML document and it needs to be HTML compliant. Web browsers display it properly and therefore we think that this is not a bug in the file.

Also, even if we fix the current issues (is it just that single <br> tag? I doubt it ...), I'm not sure that future changes to the file will keep it XML-compliant, since I (we) usually 'test' these files by viewing them in a web browser, and not eclipse.
               

> Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)
> -------------------------------------------------------------------------------------------
>
>                 Key: LUCENE-4302
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4302
>             Project: Lucene - Core
>          Issue Type: Bug
>          Components: general/javadocs
>    Affects Versions: 4.0-ALPHA
>         Environment: Windows 7-64bit/Eclipse Juno (4.2)/Maven m2e plugin/firefox latest
>            Reporter: Karl Nicholas
>            Priority: Minor
>              Labels: documentation
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> I have opened javadoc for Facet API while using Eclipse, which downloaded the javadocs using Maven m2e plugin. When I click on facet User Guide on the overview page I get the following exception in FireFox:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html
> An error occured while processing the requested document:
> org.xml.sax.SAXParseException; lineNumber: 121; columnNumber: 16; The element type "br" must be terminated by the matching end-tag "</br>".
> at com.sun.org.apache.xerces.internal.parsers.DOMParser.parse(Unknown Source)
> at com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl.parse(Unknown Source)
> The link, or requested document is:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

[jira] [Commented] (LUCENE-4302) Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)

JIRA jira@apache.org
In reply to this post by JIRA jira@apache.org

    [ https://issues.apache.org/jira/browse/LUCENE-4302?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13433404#comment-13433404 ]

Gilad Barkai commented on LUCENE-4302:
--------------------------------------

I'm with Shai on this - According to w3schools this is actually not a problem.
Please see: http://www.w3schools.com/tags/tag_br.asp

In HTML <br> has no closing tag.

               

> Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)
> -------------------------------------------------------------------------------------------
>
>                 Key: LUCENE-4302
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4302
>             Project: Lucene - Core
>          Issue Type: Bug
>          Components: general/javadocs
>    Affects Versions: 4.0-ALPHA
>         Environment: Windows 7-64bit/Eclipse Juno (4.2)/Maven m2e plugin/firefox latest
>            Reporter: Karl Nicholas
>            Priority: Minor
>              Labels: documentation
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> I have opened javadoc for Facet API while using Eclipse, which downloaded the javadocs using Maven m2e plugin. When I click on facet User Guide on the overview page I get the following exception in FireFox:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html
> An error occured while processing the requested document:
> org.xml.sax.SAXParseException; lineNumber: 121; columnNumber: 16; The element type "br" must be terminated by the matching end-tag "</br>".
> at com.sun.org.apache.xerces.internal.parsers.DOMParser.parse(Unknown Source)
> at com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl.parse(Unknown Source)
> The link, or requested document is:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

[jira] [Commented] (LUCENE-4302) Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)

JIRA jira@apache.org
In reply to this post by JIRA jira@apache.org

    [ https://issues.apache.org/jira/browse/LUCENE-4302?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13433439#comment-13433439 ]

Karl Nicholas commented on LUCENE-4302:
---------------------------------------

OK, I've fixed it without editing all the HTML. The problem is that the DOCTYPE as specified by the DTD in the file says it is supposed to be xhtml, but all the rest of the javadocs say that they are supposed to be "loose." So, I put changed the dtd at the top of the userguide file and now it works just fine.

Set the first line of userguide.html to:

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

So, I'm happy to try and figure out how to edit the source because I'm curious how to do so and like to be helpful. Shall I go for it?
               

> Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)
> -------------------------------------------------------------------------------------------
>
>                 Key: LUCENE-4302
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4302
>             Project: Lucene - Core
>          Issue Type: Bug
>          Components: general/javadocs
>    Affects Versions: 4.0-ALPHA
>         Environment: Windows 7-64bit/Eclipse Juno (4.2)/Maven m2e plugin/firefox latest
>            Reporter: Karl Nicholas
>            Priority: Minor
>              Labels: documentation
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> I have opened javadoc for Facet API while using Eclipse, which downloaded the javadocs using Maven m2e plugin. When I click on facet User Guide on the overview page I get the following exception in FireFox:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html
> An error occured while processing the requested document:
> org.xml.sax.SAXParseException; lineNumber: 121; columnNumber: 16; The element type "br" must be terminated by the matching end-tag "</br>".
> at com.sun.org.apache.xerces.internal.parsers.DOMParser.parse(Unknown Source)
> at com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl.parse(Unknown Source)
> The link, or requested document is:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

[jira] [Comment Edited] (LUCENE-4302) Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)

JIRA jira@apache.org
In reply to this post by JIRA jira@apache.org

    [ https://issues.apache.org/jira/browse/LUCENE-4302?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13433439#comment-13433439 ]

Karl Nicholas edited comment on LUCENE-4302 at 8/14/12 6:26 AM:
----------------------------------------------------------------

OK, I've fixed it without editing all the HTML. The problem is that the DOCTYPE as specified by the DTD in the file says it is supposed to be xhtml, but all the rest of the javadocs say that they are supposed to be "loose." So, I put changed the dtd at the top of the userguide file and now it works just fine.

Set the first line of userguide.html to:

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

So, I'm happy to try and figure out how to edit the source.
               
      was (Author: karlnicholas):
    OK, I've fixed it without editing all the HTML. The problem is that the DOCTYPE as specified by the DTD in the file says it is supposed to be xhtml, but all the rest of the javadocs say that they are supposed to be "loose." So, I put changed the dtd at the top of the userguide file and now it works just fine.

Set the first line of userguide.html to:

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

So, I'm happy to try and figure out how to edit the source because I'm curious how to do so and like to be helpful. Shall I go for it?
                 

> Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)
> -------------------------------------------------------------------------------------------
>
>                 Key: LUCENE-4302
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4302
>             Project: Lucene - Core
>          Issue Type: Bug
>          Components: general/javadocs
>    Affects Versions: 4.0-ALPHA
>         Environment: Windows 7-64bit/Eclipse Juno (4.2)/Maven m2e plugin/firefox latest
>            Reporter: Karl Nicholas
>            Priority: Minor
>              Labels: documentation
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> I have opened javadoc for Facet API while using Eclipse, which downloaded the javadocs using Maven m2e plugin. When I click on facet User Guide on the overview page I get the following exception in FireFox:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html
> An error occured while processing the requested document:
> org.xml.sax.SAXParseException; lineNumber: 121; columnNumber: 16; The element type "br" must be terminated by the matching end-tag "</br>".
> at com.sun.org.apache.xerces.internal.parsers.DOMParser.parse(Unknown Source)
> at com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl.parse(Unknown Source)
> The link, or requested document is:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

[jira] [Assigned] (LUCENE-4302) Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)

JIRA jira@apache.org
In reply to this post by JIRA jira@apache.org

     [ https://issues.apache.org/jira/browse/LUCENE-4302?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Uwe Schindler reassigned LUCENE-4302:
-------------------------------------

    Assignee: Uwe Schindler

I have a patch. I checked all doc-files folders in source tree for invalid documents, facet guide is the only one.

Thanks for reporting!
               

> Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)
> -------------------------------------------------------------------------------------------
>
>                 Key: LUCENE-4302
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4302
>             Project: Lucene - Core
>          Issue Type: Bug
>          Components: general/javadocs
>    Affects Versions: 4.0-ALPHA
>         Environment: Windows 7-64bit/Eclipse Juno (4.2)/Maven m2e plugin/firefox latest
>            Reporter: Karl Nicholas
>            Assignee: Uwe Schindler
>            Priority: Minor
>              Labels: documentation
>             Fix For: 5.0, 3.6.2, 4.0
>
>         Attachments: LUCENE-4302.patch
>
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> I have opened javadoc for Facet API while using Eclipse, which downloaded the javadocs using Maven m2e plugin. When I click on facet User Guide on the overview page I get the following exception in FireFox:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html
> An error occured while processing the requested document:
> org.xml.sax.SAXParseException; lineNumber: 121; columnNumber: 16; The element type "br" must be terminated by the matching end-tag "</br>".
> at com.sun.org.apache.xerces.internal.parsers.DOMParser.parse(Unknown Source)
> at com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl.parse(Unknown Source)
> The link, or requested document is:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

[jira] [Updated] (LUCENE-4302) Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)

JIRA jira@apache.org
In reply to this post by JIRA jira@apache.org

     [ https://issues.apache.org/jira/browse/LUCENE-4302?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Uwe Schindler updated LUCENE-4302:
----------------------------------

    Attachment: LUCENE-4302.patch

Patch for Lucene trunk. I will commit this soon.
               

> Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)
> -------------------------------------------------------------------------------------------
>
>                 Key: LUCENE-4302
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4302
>             Project: Lucene - Core
>          Issue Type: Bug
>          Components: general/javadocs
>    Affects Versions: 4.0-ALPHA
>         Environment: Windows 7-64bit/Eclipse Juno (4.2)/Maven m2e plugin/firefox latest
>            Reporter: Karl Nicholas
>            Assignee: Uwe Schindler
>            Priority: Minor
>              Labels: documentation
>             Fix For: 5.0, 3.6.2, 4.0
>
>         Attachments: LUCENE-4302.patch
>
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> I have opened javadoc for Facet API while using Eclipse, which downloaded the javadocs using Maven m2e plugin. When I click on facet User Guide on the overview page I get the following exception in FireFox:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html
> An error occured while processing the requested document:
> org.xml.sax.SAXParseException; lineNumber: 121; columnNumber: 16; The element type "br" must be terminated by the matching end-tag "</br>".
> at com.sun.org.apache.xerces.internal.parsers.DOMParser.parse(Unknown Source)
> at com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl.parse(Unknown Source)
> The link, or requested document is:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

[jira] [Updated] (LUCENE-4302) Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)

JIRA jira@apache.org
In reply to this post by JIRA jira@apache.org

     [ https://issues.apache.org/jira/browse/LUCENE-4302?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Uwe Schindler updated LUCENE-4302:
----------------------------------

    Fix Version/s: 4.0
                   3.6.2
                   5.0
   

> Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)
> -------------------------------------------------------------------------------------------
>
>                 Key: LUCENE-4302
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4302
>             Project: Lucene - Core
>          Issue Type: Bug
>          Components: general/javadocs
>    Affects Versions: 4.0-ALPHA
>         Environment: Windows 7-64bit/Eclipse Juno (4.2)/Maven m2e plugin/firefox latest
>            Reporter: Karl Nicholas
>            Assignee: Uwe Schindler
>            Priority: Minor
>              Labels: documentation
>             Fix For: 5.0, 3.6.2, 4.0
>
>         Attachments: LUCENE-4302.patch
>
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> I have opened javadoc for Facet API while using Eclipse, which downloaded the javadocs using Maven m2e plugin. When I click on facet User Guide on the overview page I get the following exception in FireFox:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html
> An error occured while processing the requested document:
> org.xml.sax.SAXParseException; lineNumber: 121; columnNumber: 16; The element type "br" must be terminated by the matching end-tag "</br>".
> at com.sun.org.apache.xerces.internal.parsers.DOMParser.parse(Unknown Source)
> at com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl.parse(Unknown Source)
> The link, or requested document is:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

[jira] [Resolved] (LUCENE-4302) Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)

JIRA jira@apache.org
In reply to this post by JIRA jira@apache.org

     [ https://issues.apache.org/jira/browse/LUCENE-4302?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Uwe Schindler resolved LUCENE-4302.
-----------------------------------

    Resolution: Fixed

Committed trunk rev 1372633, 4.x rev 1372635, 3.6 rev 1372641

Thanks Karl!
               

> Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)
> -------------------------------------------------------------------------------------------
>
>                 Key: LUCENE-4302
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4302
>             Project: Lucene - Core
>          Issue Type: Bug
>          Components: general/javadocs
>    Affects Versions: 4.0-ALPHA
>         Environment: Windows 7-64bit/Eclipse Juno (4.2)/Maven m2e plugin/firefox latest
>            Reporter: Karl Nicholas
>            Assignee: Uwe Schindler
>            Priority: Minor
>              Labels: documentation
>             Fix For: 5.0, 3.6.2, 4.0
>
>         Attachments: LUCENE-4302.patch
>
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> I have opened javadoc for Facet API while using Eclipse, which downloaded the javadocs using Maven m2e plugin. When I click on facet User Guide on the overview page I get the following exception in FireFox:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html
> An error occured while processing the requested document:
> org.xml.sax.SAXParseException; lineNumber: 121; columnNumber: 16; The element type "br" must be terminated by the matching end-tag "</br>".
> at com.sun.org.apache.xerces.internal.parsers.DOMParser.parse(Unknown Source)
> at com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl.parse(Unknown Source)
> The link, or requested document is:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

[jira] [Commented] (LUCENE-4302) Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)

JIRA jira@apache.org
In reply to this post by JIRA jira@apache.org

    [ https://issues.apache.org/jira/browse/LUCENE-4302?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13433698#comment-13433698 ]

Karl Nicholas commented on LUCENE-4302:
---------------------------------------

No problem. Happy to help.
               

> Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)
> -------------------------------------------------------------------------------------------
>
>                 Key: LUCENE-4302
>                 URL: https://issues.apache.org/jira/browse/LUCENE-4302
>             Project: Lucene - Core
>          Issue Type: Bug
>          Components: general/javadocs
>    Affects Versions: 4.0-ALPHA
>         Environment: Windows 7-64bit/Eclipse Juno (4.2)/Maven m2e plugin/firefox latest
>            Reporter: Karl Nicholas
>            Assignee: Uwe Schindler
>            Priority: Minor
>              Labels: documentation
>             Fix For: 5.0, 3.6.2, 4.0
>
>         Attachments: LUCENE-4302.patch
>
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> I have opened javadoc for Facet API while using Eclipse, which downloaded the javadocs using Maven m2e plugin. When I click on facet User Guide on the overview page I get the following exception in FireFox:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html
> An error occured while processing the requested document:
> org.xml.sax.SAXParseException; lineNumber: 121; columnNumber: 16; The element type "br" must be terminated by the matching end-tag "</br>".
> at com.sun.org.apache.xerces.internal.parsers.DOMParser.parse(Unknown Source)
> at com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderImpl.parse(Unknown Source)
> The link, or requested document is:
> http://127.0.0.1:49231/help/nftopic/jar:file:/C:/Users/karl/.m2/repository/org/apache/lucene/lucene-facet/4.0.0-ALPHA/
> lucene-facet-4.0.0-ALPHA-javadoc.jar!/org/apache/lucene/facet/doc-files/userguide.html

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

       

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]