lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Karl Nicholas (JIRA)" <j...@apache.org>
Subject [jira] [Comment Edited] (LUCENE-4302) Javadoc for facet User Guide does not display because of SAXParseException (Eclipse, Maven)
Date Mon, 13 Aug 2012 19:26:37 GMT

    [ 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: dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: dev-help@lucene.apache.org


Mime
View raw message