cxf-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Andrew Janke (JIRA)" <j...@apache.org>
Subject [jira] [Created] (CXF-5696) Bad links/references on Debugging and Logging doc page
Date Wed, 16 Apr 2014 20:28:17 GMT
Andrew Janke created CXF-5696:
---------------------------------

             Summary: 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.11, 2.7.10
         Environment: Firefox on Windows 7 Pro
            Reporter: Andrew Janke
            Priority: Minor


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.2#6252)

Mime
View raw message