[jira] [Resolved] (CXF-5696) Bad links/references on Debugging and Logging doc page

["Daniel Kulp (JIRA)" <ji...@apache.org>]

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

Daniel Kulp resolved CXF-5696.
------------------------------
       Resolution: Fixed
         Assignee: Daniel Kulp
    Fix Version/s: Invalid

> Bad links/references on Debugging and Logging doc page
> ------------------------------------------------------
>
>                 Key: CXF-5696
>                 URL: https://issues.apache.org/jira/browse/CXF-5696
>             Project: CXF
>          Issue Type: Bug
>          Components: Documentation
>    Affects Versions: 2.7.10, 2.7.11
>         Environment: Firefox on Windows 7 Pro
>            Reporter: Andrew Janke
>            Assignee: Daniel Kulp
>            Priority: Minor
>             Fix For: Invalid
>
>
> The User's Guide "Debugging and Logging" page (http://cxf.apache.org/docs/debugging-and-logging.html) has some bad links and refers to a nonexistent file in the distribution.
> Listed by section:
> *Logging Messages*
> The "Java SE Logging" link points to http://www.oracle.com/technology/pub/articles/hunter_logging.html, which is bad and just redirects to their main "technetwork" articles list.
> *Configure logging levels* 
> It says:
> >   In the /etc folder of the CXF distribution there is a sample Java SE logging.properties file you can use to configure logging. 
> But the /etc folder of the 2.7.10 distribution does not have a `logging.properties` file. And the "/etc folder:" is a link to http://svn.apache.org/viewvc/cxf/trunk/distribution/src/main/release/etc/, which is 404 - there's no "etc/" folder there.
> *SLF4J and Log4J*
> The sections for using SLF4J and Log4J refer to adding system properties "to the classpath" with `-D`. They're not really on the classpath; maybe it would be clearer to refer to adding them to the "command line" or "Java system properties".
> Also, suggesting that clients modify the system-wide logging.properties file under $JDK_HOME sounds a little extreme.
> *NetBeans IDE*
> The "profiler" link is old and now redirects to the NetBeans unit testing section; profiler info is now included in the debugger page.
> *tcpmon and tcptrace*
> The "tcpmon" leading to tcpmon.dev.java.net link is dead. The whole dev.java.net subdomain is defunct.
> *WSMonitor*
> Another dead link to dev.java.net.
> *Programming Style*
> The "using org.apache.cxf.jaxrs.ext.logging.atom package" pointing to http://cxf.apache.org/javadoc/latest/org/apache/cxf/management/web/logging/atom/package-summary.html is 404.
> *Poll Style*
> The "AtomPullServer", "ReadWriteLogStorage", and "ReadableLogStorage" links go to raw source code. Might be better from a CXF user's perspective to link to Javadoc.



--
This message was sent by Atlassian JIRA
(v6.3.15#6346)