[ https://issues.apache.org/jira/browse/TILES-571?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13807057#comment-13807057 ]
Mck SembWever commented on TILES-571: ------------------------------------- Regarding TilesConfigurer, that's spring and the documentation update belongs in either http://docs.spring.io/spring/docs/3.2.x/javadoc-api/org/springframework/web/servlet/view/tiles3/TilesConfigurer.html or http://docs.spring.io/spring/docs/3.2.x/spring-framework-reference/html/view.html#view-tiles-integrate At Tiles i think the following page needs this information: http://tiles.apache.org/framework/config-reference.html but i'm unsure where to put it in or what will make most sense. [~analogkid76] Being new to this and seeing this documentation from the newcomer's perspective i'd appreciate your opinion on how this page really should be improved. > Please make the significance of underscore (_) in tiles definition filename > more obvious > ---------------------------------------------------------------------------------------- > > Key: TILES-571 > URL: https://issues.apache.org/jira/browse/TILES-571 > Project: Tiles > Issue Type: Task > Affects Versions: 3.0.1 > Environment: Apache Tomcat 7.0.42, JSE 1.7.0_45, Windows > Reporter: Eric E > Assignee: Mck SembWever > Priority: Minor > > In reading the Tiles documentation, it was not obvious to me that including > an underscore (_) in my tiles definition filename would cause Tiles to > interpret whatever follows the underscore as a locale. > For example, in my TilesConfigurer configuration, I had the following: > {code} > <bean id="tilesConfigurer" > class="org.springframework.web.servlet.view.tiles3.TilesConfigurer"> > <property name="definitions"> > <list> > <value>/WEB-INF/templates/layouts.xml</value> > <value>/WEB-INF/views/base_views.xml</value> > </list> > </property> > </bean> > {code} > This caused Tiles, apparently, to assign the Locale "views" to the second > definition. This was clearly not what I intended, and the side effect of > this was that Tiles discarded the second definition, and my view contained in > that definition could not be resolved. > Only after spending some time with a debugger did I discover the code in > org.apache.tiles.request.locale.PostfixedApplicationResource that causes this > behaviour. > It would be nice if the documentation more clearly warns developers about > this so that others do not have to go through the same trouble. -- This message was sent by Atlassian JIRA (v6.1#6144)