You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@servicemix.apache.org by "Nancy Rosenfield (JIRA)" <ji...@apache.org> on 2008/08/27 19:15:52 UTC

[jira] Created: (SM-1525) significant typo in servicemix classloader documentation

significant typo in servicemix classloader documentation 
---------------------------------------------------------

                 Key: SM-1525
                 URL: https://issues.apache.org/activemq/browse/SM-1525
             Project: ServiceMix
          Issue Type: Bug
          Components: documentation
    Affects Versions: 3.2.2, 3.2.1
         Environment: This is a documentation typo so it affects all os's and all platforms
            Reporter: Nancy Rosenfield
             Fix For: 3.2.3


There are two places on the page describing servicemix classloaders where the 
nonOverridable element is misspelled as nonOverrideable.   The link to the erroneous page is:

http://servicemix.apache.org/classloaders.html

If I had copied and pasted from the doc,
I would no doubt have gotten an xml parsing error.  But I read the documentation and just
typed it in manually and picked the wrong spelling.  I didn't get any runtime error on the xml - it apparently just ignored my misspelled element.  So it took me a long time to figure out what the real problem was.
I finally looked at your source code to see that it was looking for nonOverridable.  

The two places to be fixed look like:

<classpath [inverse="true"]>
  [<nonOverrideable>xxx</nonOverridable>]*
  [<hidden>xxx</hidden>]*
  [<location>xxx</location>]*
</classpath>

and

<classpath [inverse="true"]>
  [<nonOverrideable>xxx</nonOverridable>]*
  [<hidden>xxx</hidden>]*
  [<location>xxx</location>]*
  [<library>xxx</library>]*
  [<component>xxx</component>]*
</classpath>

The documentation should be fixed as soon as possible as it it quite confusing and misleading.
If there were some way to have the code check for unknown elements and give
an error or at least a warning, that would be even better.




-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

[jira] Commented: (SM-1525) significant typo in servicemix classloader documentation

Posted by "Nancy Rosenfield (JIRA)" <ji...@apache.org>.
    [ https://issues.apache.org/activemq/browse/SM-1525?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=45199#action_45199 ] 

Nancy Rosenfield commented on SM-1525:
--------------------------------------

Thanks!

Nancy Rosenfield




> significant typo in servicemix classloader documentation 
> ---------------------------------------------------------
>
>                 Key: SM-1525
>                 URL: https://issues.apache.org/activemq/browse/SM-1525
>             Project: ServiceMix
>          Issue Type: Bug
>          Components: documentation
>    Affects Versions: 3.2.1, 3.2.2
>         Environment: This is a documentation typo so it affects all os's and all platforms
>            Reporter: Nancy Rosenfield
>            Assignee: Bruce Snyder
>             Fix For: 3.2.3
>
>
> There are two places on the page describing servicemix classloaders where the 
> nonOverridable element is misspelled as nonOverrideable.   The link to the erroneous page is:
> http://servicemix.apache.org/classloaders.html
> If I had copied and pasted from the doc,
> I would no doubt have gotten an xml parsing error.  But I read the documentation and just
> typed it in manually and picked the wrong spelling.  I didn't get any runtime error on the xml - it apparently just ignored my misspelled element.  So it took me a long time to figure out what the real problem was.
> I finally looked at your source code to see that it was looking for nonOverridable.  
> The two places to be fixed look like:
> <classpath [inverse="true"]>
>   [<nonOverrideable>xxx</nonOverridable>]*
>   [<hidden>xxx</hidden>]*
>   [<location>xxx</location>]*
> </classpath>
> and
> <classpath [inverse="true"]>
>   [<nonOverrideable>xxx</nonOverridable>]*
>   [<hidden>xxx</hidden>]*
>   [<location>xxx</location>]*
>   [<library>xxx</library>]*
>   [<component>xxx</component>]*
> </classpath>
> The documentation should be fixed as soon as possible as it it quite confusing and misleading.
> If there were some way to have the code check for unknown elements and give
> an error or at least a warning, that would be even better.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.

[jira] Resolved: (SM-1525) significant typo in servicemix classloader documentation

Posted by "Bruce Snyder (JIRA)" <ji...@apache.org>.
     [ https://issues.apache.org/activemq/browse/SM-1525?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Bruce Snyder resolved SM-1525.
------------------------------

      Assignee: Bruce Snyder
    Resolution: Fixed

Fixed in the wiki. The change will be propagated to the website in about an hour. 

> significant typo in servicemix classloader documentation 
> ---------------------------------------------------------
>
>                 Key: SM-1525
>                 URL: https://issues.apache.org/activemq/browse/SM-1525
>             Project: ServiceMix
>          Issue Type: Bug
>          Components: documentation
>    Affects Versions: 3.2.1, 3.2.2
>         Environment: This is a documentation typo so it affects all os's and all platforms
>            Reporter: Nancy Rosenfield
>            Assignee: Bruce Snyder
>             Fix For: 3.2.3
>
>
> There are two places on the page describing servicemix classloaders where the 
> nonOverridable element is misspelled as nonOverrideable.   The link to the erroneous page is:
> http://servicemix.apache.org/classloaders.html
> If I had copied and pasted from the doc,
> I would no doubt have gotten an xml parsing error.  But I read the documentation and just
> typed it in manually and picked the wrong spelling.  I didn't get any runtime error on the xml - it apparently just ignored my misspelled element.  So it took me a long time to figure out what the real problem was.
> I finally looked at your source code to see that it was looking for nonOverridable.  
> The two places to be fixed look like:
> <classpath [inverse="true"]>
>   [<nonOverrideable>xxx</nonOverridable>]*
>   [<hidden>xxx</hidden>]*
>   [<location>xxx</location>]*
> </classpath>
> and
> <classpath [inverse="true"]>
>   [<nonOverrideable>xxx</nonOverridable>]*
>   [<hidden>xxx</hidden>]*
>   [<location>xxx</location>]*
>   [<library>xxx</library>]*
>   [<component>xxx</component>]*
> </classpath>
> The documentation should be fixed as soon as possible as it it quite confusing and misleading.
> If there were some way to have the code check for unknown elements and give
> an error or at least a warning, that would be even better.

-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.