You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@logging.apache.org by "Ralph Goers (Jira)" <ji...@apache.org> on 2020/04/04 22:29:03 UTC

[jira] [Updated] (LOG4NET-459) Generated API docs are unreadable

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

Ralph Goers updated LOG4NET-459:
--------------------------------

LOG4NET is now dormant.  

> Generated API docs are unreadable
> ---------------------------------
>
>                 Key: LOG4NET-459
>                 URL: https://issues.apache.org/jira/browse/LOG4NET-459
>             Project: Log4net
>          Issue Type: Bug
>            Reporter: Berin Loritsch
>            Priority: Major
>
> Due to a character encoding problem, important characters like < and > and whatever character is used as a leader in the object hierarchy are completely mangled and hinders readability.
> For an example see:
> http://logging.apache.org/log4net/release/sdk/log4net.Appender.RollingFileAppender.html
> Something in the build processing is messing things up, or the HTML is really UTF-8 but we are calling it "Windows 1252".  See the following line the header section of the HTML:
> {code}
> <meta http-equiv="Content-Type" content="text/html; charset=Windows-1252" />
> {code}
> By manually changing that line to 
> {code}
> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
> {code}
> The readability improves, but is still not the correct character encoding.  Not sure what the encoding is supposed to be, or if the tool is introducing another layer of mangling.
> The API docs really help, but having to sort through visual noise doesn't help.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)