You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@camel.apache.org by Reuben Garrett <re...@gmail.com> on 2011/12/09 16:41:37 UTC

code snippets broken on confluence wiki

Greetings!

I'm working on a Camel-based integration project and am contributing to the
documentation by proof-reading as I go.  I noticed today that some code
snippets are "broken" - e.g. on the SEDA
<http://camel.apache.org/seda.html>page <
http://camel.apache.org/seda.html>

Wiki markup such as the following:
{snippet:id=e1|lang=java|url=camel/trunk/camel-core/src/test/java/org/apache/camel/component/seda/SedaAsyncRouteTest.java}

… produces this error message:
Error formatting macro: snippet: java.lang.IndexOutOfBoundsException:
Index: 20, Size: 20

I'm not sure if this is the correct forum to target the issue - but I am
committed to Apache, and in particular I want to build up and promote Camel
as an EIP leader.  Is there a way I can resolve this error?

Regards,
Reuben Garrett

Re: code snippets broken on confluence wiki

Posted by bvahdat <ba...@swissonline.ch>.
Just as an idea:

Could [1] be also relevant for this issue as well? I hit a bunch of "h3"
html tags just before those lines with:

Error formatting macro: snippet: java.lang.IndexOutOfBoundsException: Index:
20, Size: 20

[1] https://studio.plugins.atlassian.com/browse/NUMHEAD-26

Babak

--
View this message in context: http://camel.465427.n5.nabble.com/code-snippets-broken-on-confluence-wiki-tp5062145p5062258.html
Sent from the Camel Development mailing list archive at Nabble.com.

Re: code snippets broken on confluence wiki

Posted by Daniel Kulp <dk...@apache.org>.
On Friday, December 09, 2011 11:03:09 AM Daniel Kulp wrote:
> Hmmm...  the sync source is broken as well:
> 
> https://cwiki.apache.org/CAMEL/seda.html
> 
> I'll force  a rebuild of the page and see if that helps.

A full re-export of the space seems to have fixed it.   Thus, the next sync 
should be all set.   Likely an issue between the Confluence and SVN server on 
that particular day or something.


Dan



> 
> Dan
> 
> On Friday, December 09, 2011 4:53:34 PM Claus Ibsen wrote:
> > Hi
> > 
> > Thanks for reporting.
> > 
> > You can try browsing the source code on trunk and find the unit test
> > that provided the snippet tags for  the wiki documentation.
> > What happens sometime is that an unit test gets refactored, and then
> > the wiki pages may get out of sync.
> > 
> > However in this case it was not the case.
> > 
> > The dynamic page is correct
> > https://cwiki.apache.org/confluence/display/CAMEL/SEDA
> > 
> > The sync from cwiki -> html runs once in a while, so I guess Apache
> > ought to get the page properly updated.
> > 
> > On Fri, Dec 9, 2011 at 4:41 PM, Reuben Garrett <re...@gmail.com>
> 
> wrote:
> > > Greetings!
> > > 
> > > I'm working on a Camel-based integration project and am contributing
> > > to
> > > the documentation by proof-reading as I go.  I noticed today that
> > > some
> > > code snippets are "broken" - e.g. on the SEDA
> > > <http://camel.apache.org/seda.html>page <
> > > http://camel.apache.org/seda.html>
> > > 
> > > Wiki markup such as the following:
> > > {snippet:id=e1|lang=java|url=camel/trunk/camel-core/src/test/java/or
> > > g/ap ache/camel/component/seda/SedaAsyncRouteTest.java}
> > > 
> > > … produces this error message:
> > > Error formatting macro: snippet:
> > > java.lang.IndexOutOfBoundsException:
> > > Index: 20, Size: 20
> > > 
> > > I'm not sure if this is the correct forum to target the issue - but
> > > I am committed to Apache, and in particular I want to build up and
> > > promote Camel as an EIP leader.  Is there a way I can resolve this
> > > error?
> > > 
> > > Regards,
> > > Reuben Garrett
-- 
Daniel Kulp
dkulp@apache.org - http://dankulp.com/blog
Talend Community Coder - http://coders.talend.com

Re: code snippets broken on confluence wiki

Posted by Daniel Kulp <dk...@apache.org>.

Hmmm...  the sync source is broken as well:

https://cwiki.apache.org/CAMEL/seda.html


I'll force  a rebuild of the page and see if that helps.

Dan



On Friday, December 09, 2011 4:53:34 PM Claus Ibsen wrote:
> Hi
> 
> Thanks for reporting.
> 
> You can try browsing the source code on trunk and find the unit test
> that provided the snippet tags for  the wiki documentation.
> What happens sometime is that an unit test gets refactored, and then
> the wiki pages may get out of sync.
> 
> However in this case it was not the case.
> 
> The dynamic page is correct
> https://cwiki.apache.org/confluence/display/CAMEL/SEDA
> 
> The sync from cwiki -> html runs once in a while, so I guess Apache
> ought to get the page properly updated.
> 
> On Fri, Dec 9, 2011 at 4:41 PM, Reuben Garrett <re...@gmail.com> 
wrote:
> > Greetings!
> > 
> > I'm working on a Camel-based integration project and am contributing to
> > the documentation by proof-reading as I go.  I noticed today that some
> > code snippets are "broken" - e.g. on the SEDA
> > <http://camel.apache.org/seda.html>page <
> > http://camel.apache.org/seda.html>
> > 
> > Wiki markup such as the following:
> > {snippet:id=e1|lang=java|url=camel/trunk/camel-core/src/test/java/org/ap
> > ache/camel/component/seda/SedaAsyncRouteTest.java}
> > 
> > … produces this error message:
> > Error formatting macro: snippet: java.lang.IndexOutOfBoundsException:
> > Index: 20, Size: 20
> > 
> > I'm not sure if this is the correct forum to target the issue - but I am
> > committed to Apache, and in particular I want to build up and promote
> > Camel as an EIP leader.  Is there a way I can resolve this error?
> > 
> > Regards,
> > Reuben Garrett
-- 
Daniel Kulp
dkulp@apache.org - http://dankulp.com/blog
Talend Community Coder - http://coders.talend.com

Re: code snippets broken on confluence wiki

Posted by Claus Ibsen <cl...@gmail.com>.
Hi

Thanks for reporting.

You can try browsing the source code on trunk and find the unit test
that provided the snippet tags for  the wiki documentation.
What happens sometime is that an unit test gets refactored, and then
the wiki pages may get out of sync.

However in this case it was not the case.

The dynamic page is correct
https://cwiki.apache.org/confluence/display/CAMEL/SEDA

The sync from cwiki -> html runs once in a while, so I guess Apache
ought to get the page properly updated.



On Fri, Dec 9, 2011 at 4:41 PM, Reuben Garrett <re...@gmail.com> wrote:
> Greetings!
>
> I'm working on a Camel-based integration project and am contributing to the
> documentation by proof-reading as I go.  I noticed today that some code
> snippets are "broken" - e.g. on the SEDA
> <http://camel.apache.org/seda.html>page <
> http://camel.apache.org/seda.html>
>
> Wiki markup such as the following:
> {snippet:id=e1|lang=java|url=camel/trunk/camel-core/src/test/java/org/apache/camel/component/seda/SedaAsyncRouteTest.java}
>
> … produces this error message:
> Error formatting macro: snippet: java.lang.IndexOutOfBoundsException:
> Index: 20, Size: 20
>
> I'm not sure if this is the correct forum to target the issue - but I am
> committed to Apache, and in particular I want to build up and promote Camel
> as an EIP leader.  Is there a way I can resolve this error?
>
> Regards,
> Reuben Garrett



-- 
Claus Ibsen
-----------------
FuseSource
Email: cibsen@fusesource.com
Web: http://fusesource.com
Twitter: davsclaus, fusenews
Blog: http://davsclaus.blogspot.com/
Author of Camel in Action: http://www.manning.com/ibsen/