You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-commits@maven.apache.org by mi...@apache.org on 2022/11/26 15:50:13 UTC

svn commit: r1905545 [33/34] - in /maven/doxia/website/components/doxia-sitetools-archives/doxia-sitetools-LATEST: ./ apidocs/ apidocs/org/apache/maven/doxia/site/decoration/ apidocs/org/apache/maven/doxia/site/decoration/class-use/ apidocs/org/apache/...

Modified: maven/doxia/website/components/doxia-sitetools-archives/doxia-sitetools-LATEST/xref/org/apache/maven/doxia/tools/DefaultSiteTool.html
==============================================================================
--- maven/doxia/website/components/doxia-sitetools-archives/doxia-sitetools-LATEST/xref/org/apache/maven/doxia/tools/DefaultSiteTool.html (original)
+++ maven/doxia/website/components/doxia-sitetools-archives/doxia-sitetools-LATEST/xref/org/apache/maven/doxia/tools/DefaultSiteTool.html Sat Nov 26 15:50:09 2022
@@ -177,1194 +177,1300 @@
 <a class="jxr_linenumber" name="L169" href="#L169">169</a>         <strong class="jxr_keyword">return</strong> artifact;
 <a class="jxr_linenumber" name="L170" href="#L170">170</a>     }
 <a class="jxr_linenumber" name="L171" href="#L171">171</a> 
-<a class="jxr_linenumber" name="L172" href="#L172">172</a>     <strong class="jxr_keyword">public</strong> Artifact getDefaultSkinArtifact( ArtifactRepository localRepository,
-<a class="jxr_linenumber" name="L173" href="#L173">173</a>                                             List&lt;ArtifactRepository&gt; remoteArtifactRepositories )
-<a class="jxr_linenumber" name="L174" href="#L174">174</a>         <strong class="jxr_keyword">throws</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>
-<a class="jxr_linenumber" name="L175" href="#L175">175</a>     {
-<a class="jxr_linenumber" name="L176" href="#L176">176</a>         <a name="DecorationModel" href="../../../../../org/apache/maven/doxia/site/decoration/DecorationModel.html#DecorationModel">DecorationModel</a> decorationModel = getDefaultDecorationModel();
-<a class="jxr_linenumber" name="L177" href="#L177">177</a>         <strong class="jxr_keyword">return</strong> getSkinArtifactFromRepository( localRepository, remoteArtifactRepositories, decorationModel );
-<a class="jxr_linenumber" name="L178" href="#L178">178</a>     }
-<a class="jxr_linenumber" name="L179" href="#L179">179</a> 
-<a class="jxr_linenumber" name="L180" href="#L180">180</a>     <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L181" href="#L181">181</a> <em class="jxr_javadoccomment">     * This method is not implemented according to the URI specification and has many weird</em>
-<a class="jxr_linenumber" name="L182" href="#L182">182</a> <em class="jxr_javadoccomment">     * corner cases where it doesn't do the right thing. Please consider using a better</em>
-<a class="jxr_linenumber" name="L183" href="#L183">183</a> <em class="jxr_javadoccomment">     * implemented method from a different library such as org.apache.http.client.utils.URIUtils#resolve.</em>
-<a class="jxr_linenumber" name="L184" href="#L184">184</a> <em class="jxr_javadoccomment">     */</em>
-<a class="jxr_linenumber" name="L185" href="#L185">185</a>     @Deprecated
-<a class="jxr_linenumber" name="L186" href="#L186">186</a>     <strong class="jxr_keyword">public</strong> String getRelativePath( String to, String from )
-<a class="jxr_linenumber" name="L187" href="#L187">187</a>     {
-<a class="jxr_linenumber" name="L188" href="#L188">188</a>         Objects.requireNonNull( to, <span class="jxr_string">"to cannot be null"</span> );
-<a class="jxr_linenumber" name="L189" href="#L189">189</a>         Objects.requireNonNull( from, <span class="jxr_string">"from cannot be null"</span> );
-<a class="jxr_linenumber" name="L190" href="#L190">190</a> 
-<a class="jxr_linenumber" name="L191" href="#L191">191</a>         <strong class="jxr_keyword">if</strong> ( to.contains( <span class="jxr_string">":"</span> ) &amp;&amp; from.contains( <span class="jxr_string">":"</span> ) )
-<a class="jxr_linenumber" name="L192" href="#L192">192</a>         {
-<a class="jxr_linenumber" name="L193" href="#L193">193</a>             String toScheme = to.substring( 0, to.lastIndexOf( ':' ) );
-<a class="jxr_linenumber" name="L194" href="#L194">194</a>             String fromScheme = from.substring( 0, from.lastIndexOf( ':' ) );
-<a class="jxr_linenumber" name="L195" href="#L195">195</a>             <strong class="jxr_keyword">if</strong> ( !toScheme.equals( fromScheme ) )
-<a class="jxr_linenumber" name="L196" href="#L196">196</a>             {
-<a class="jxr_linenumber" name="L197" href="#L197">197</a>                 <strong class="jxr_keyword">return</strong> to;
-<a class="jxr_linenumber" name="L198" href="#L198">198</a>             }
-<a class="jxr_linenumber" name="L199" href="#L199">199</a>         }
-<a class="jxr_linenumber" name="L200" href="#L200">200</a> 
-<a class="jxr_linenumber" name="L201" href="#L201">201</a>         URL toUrl = <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L202" href="#L202">202</a>         URL fromUrl = <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L203" href="#L203">203</a> 
-<a class="jxr_linenumber" name="L204" href="#L204">204</a>         String toPath = to;
-<a class="jxr_linenumber" name="L205" href="#L205">205</a>         String fromPath = from;
-<a class="jxr_linenumber" name="L206" href="#L206">206</a> 
-<a class="jxr_linenumber" name="L207" href="#L207">207</a>         <strong class="jxr_keyword">try</strong>
-<a class="jxr_linenumber" name="L208" href="#L208">208</a>         {
-<a class="jxr_linenumber" name="L209" href="#L209">209</a>             toUrl = <strong class="jxr_keyword">new</strong> URL( to );
-<a class="jxr_linenumber" name="L210" href="#L210">210</a>         }
-<a class="jxr_linenumber" name="L211" href="#L211">211</a>         <strong class="jxr_keyword">catch</strong> ( MalformedURLException e )
-<a class="jxr_linenumber" name="L212" href="#L212">212</a>         {
-<a class="jxr_linenumber" name="L213" href="#L213">213</a>             <strong class="jxr_keyword">try</strong>
-<a class="jxr_linenumber" name="L214" href="#L214">214</a>             {
-<a class="jxr_linenumber" name="L215" href="#L215">215</a>                 toUrl = <strong class="jxr_keyword">new</strong> File( getNormalizedPath( to ) ).toURI().toURL();
-<a class="jxr_linenumber" name="L216" href="#L216">216</a>             }
-<a class="jxr_linenumber" name="L217" href="#L217">217</a>             <strong class="jxr_keyword">catch</strong> ( MalformedURLException e1 )
-<a class="jxr_linenumber" name="L218" href="#L218">218</a>             {
-<a class="jxr_linenumber" name="L219" href="#L219">219</a>                 LOGGER.warn( <span class="jxr_string">"Unable to load a URL for '"</span> + to + <span class="jxr_string">"'"</span>, e );
-<a class="jxr_linenumber" name="L220" href="#L220">220</a>                 <strong class="jxr_keyword">return</strong> to;
-<a class="jxr_linenumber" name="L221" href="#L221">221</a>             }
-<a class="jxr_linenumber" name="L222" href="#L222">222</a>         }
-<a class="jxr_linenumber" name="L223" href="#L223">223</a> 
-<a class="jxr_linenumber" name="L224" href="#L224">224</a>         <strong class="jxr_keyword">try</strong>
-<a class="jxr_linenumber" name="L225" href="#L225">225</a>         {
-<a class="jxr_linenumber" name="L226" href="#L226">226</a>             fromUrl = <strong class="jxr_keyword">new</strong> URL( from );
-<a class="jxr_linenumber" name="L227" href="#L227">227</a>         }
-<a class="jxr_linenumber" name="L228" href="#L228">228</a>         <strong class="jxr_keyword">catch</strong> ( MalformedURLException e )
-<a class="jxr_linenumber" name="L229" href="#L229">229</a>         {
-<a class="jxr_linenumber" name="L230" href="#L230">230</a>             <strong class="jxr_keyword">try</strong>
-<a class="jxr_linenumber" name="L231" href="#L231">231</a>             {
-<a class="jxr_linenumber" name="L232" href="#L232">232</a>                 fromUrl = <strong class="jxr_keyword">new</strong> File( getNormalizedPath( from ) ).toURI().toURL();
-<a class="jxr_linenumber" name="L233" href="#L233">233</a>             }
-<a class="jxr_linenumber" name="L234" href="#L234">234</a>             <strong class="jxr_keyword">catch</strong> ( MalformedURLException e1 )
-<a class="jxr_linenumber" name="L235" href="#L235">235</a>             {
-<a class="jxr_linenumber" name="L236" href="#L236">236</a>                 LOGGER.warn( <span class="jxr_string">"Unable to load a URL for '"</span> + from + <span class="jxr_string">"'"</span>, e );
-<a class="jxr_linenumber" name="L237" href="#L237">237</a>                 <strong class="jxr_keyword">return</strong> to;
-<a class="jxr_linenumber" name="L238" href="#L238">238</a>             }
-<a class="jxr_linenumber" name="L239" href="#L239">239</a>         }
-<a class="jxr_linenumber" name="L240" href="#L240">240</a> 
-<a class="jxr_linenumber" name="L241" href="#L241">241</a>         <strong class="jxr_keyword">if</strong> ( toUrl != <strong class="jxr_keyword">null</strong> &amp;&amp; fromUrl != <strong class="jxr_keyword">null</strong> )
-<a class="jxr_linenumber" name="L242" href="#L242">242</a>         {
-<a class="jxr_linenumber" name="L243" href="#L243">243</a>             <em class="jxr_comment">// URLs, determine if they share protocol and domain info</em>
-<a class="jxr_linenumber" name="L244" href="#L244">244</a> 
-<a class="jxr_linenumber" name="L245" href="#L245">245</a>             <strong class="jxr_keyword">if</strong> ( ( toUrl.getProtocol().equalsIgnoreCase( fromUrl.getProtocol() ) )
-<a class="jxr_linenumber" name="L246" href="#L246">246</a>                 &amp;&amp; ( toUrl.getHost().equalsIgnoreCase( fromUrl.getHost() ) )
-<a class="jxr_linenumber" name="L247" href="#L247">247</a>                 &amp;&amp; ( toUrl.getPort() == fromUrl.getPort() ) )
-<a class="jxr_linenumber" name="L248" href="#L248">248</a>             {
-<a class="jxr_linenumber" name="L249" href="#L249">249</a>                 <em class="jxr_comment">// shared URL domain details, use URI to determine relative path</em>
-<a class="jxr_linenumber" name="L250" href="#L250">250</a> 
-<a class="jxr_linenumber" name="L251" href="#L251">251</a>                 toPath = toUrl.getFile();
-<a class="jxr_linenumber" name="L252" href="#L252">252</a>                 fromPath = fromUrl.getFile();
-<a class="jxr_linenumber" name="L253" href="#L253">253</a>             }
-<a class="jxr_linenumber" name="L254" href="#L254">254</a>             <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L255" href="#L255">255</a>             {
-<a class="jxr_linenumber" name="L256" href="#L256">256</a>                 <em class="jxr_comment">// don't share basic URL information, no relative available</em>
-<a class="jxr_linenumber" name="L257" href="#L257">257</a> 
-<a class="jxr_linenumber" name="L258" href="#L258">258</a>                 <strong class="jxr_keyword">return</strong> to;
-<a class="jxr_linenumber" name="L259" href="#L259">259</a>             }
-<a class="jxr_linenumber" name="L260" href="#L260">260</a>         }
-<a class="jxr_linenumber" name="L261" href="#L261">261</a>         <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> ( ( toUrl != <strong class="jxr_keyword">null</strong> &amp;&amp; fromUrl == <strong class="jxr_keyword">null</strong> ) || ( toUrl == <strong class="jxr_keyword">null</strong> &amp;&amp; fromUrl != <strong class="jxr_keyword">null</strong> ) )
-<a class="jxr_linenumber" name="L262" href="#L262">262</a>         {
-<a class="jxr_linenumber" name="L263" href="#L263">263</a>             <em class="jxr_comment">// one is a URL and the other isn't, no relative available.</em>
-<a class="jxr_linenumber" name="L264" href="#L264">264</a> 
-<a class="jxr_linenumber" name="L265" href="#L265">265</a>             <strong class="jxr_keyword">return</strong> to;
-<a class="jxr_linenumber" name="L266" href="#L266">266</a>         }
-<a class="jxr_linenumber" name="L267" href="#L267">267</a> 
-<a class="jxr_linenumber" name="L268" href="#L268">268</a>         <em class="jxr_comment">// either the two locations are not URLs or if they are they</em>
-<a class="jxr_linenumber" name="L269" href="#L269">269</a>         <em class="jxr_comment">// share the common protocol and domain info and we are left</em>
-<a class="jxr_linenumber" name="L270" href="#L270">270</a>         <em class="jxr_comment">// with their URI information</em>
-<a class="jxr_linenumber" name="L271" href="#L271">271</a> 
-<a class="jxr_linenumber" name="L272" href="#L272">272</a>         String relativePath = getRelativeFilePath( fromPath, toPath );
-<a class="jxr_linenumber" name="L273" href="#L273">273</a> 
-<a class="jxr_linenumber" name="L274" href="#L274">274</a>         <strong class="jxr_keyword">if</strong> ( relativePath == <strong class="jxr_keyword">null</strong> )
-<a class="jxr_linenumber" name="L275" href="#L275">275</a>         {
-<a class="jxr_linenumber" name="L276" href="#L276">276</a>             relativePath = to;
-<a class="jxr_linenumber" name="L277" href="#L277">277</a>         }
+<a class="jxr_linenumber" name="L172" href="#L172">172</a>     <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L173" href="#L173">173</a> <em class="jxr_javadoccomment">     * This method is not implemented according to the URI specification and has many weird</em>
+<a class="jxr_linenumber" name="L174" href="#L174">174</a> <em class="jxr_javadoccomment">     * corner cases where it doesn't do the right thing. Please consider using a better</em>
+<a class="jxr_linenumber" name="L175" href="#L175">175</a> <em class="jxr_javadoccomment">     * implemented method from a different library such as org.apache.http.client.utils.URIUtils#resolve.</em>
+<a class="jxr_linenumber" name="L176" href="#L176">176</a> <em class="jxr_javadoccomment">     */</em>
+<a class="jxr_linenumber" name="L177" href="#L177">177</a>     @Deprecated
+<a class="jxr_linenumber" name="L178" href="#L178">178</a>     <strong class="jxr_keyword">public</strong> String getRelativePath( String to, String from )
+<a class="jxr_linenumber" name="L179" href="#L179">179</a>     {
+<a class="jxr_linenumber" name="L180" href="#L180">180</a>         Objects.requireNonNull( to, <span class="jxr_string">"to cannot be null"</span> );
+<a class="jxr_linenumber" name="L181" href="#L181">181</a>         Objects.requireNonNull( from, <span class="jxr_string">"from cannot be null"</span> );
+<a class="jxr_linenumber" name="L182" href="#L182">182</a> 
+<a class="jxr_linenumber" name="L183" href="#L183">183</a>         <strong class="jxr_keyword">if</strong> ( to.contains( <span class="jxr_string">":"</span> ) &amp;&amp; from.contains( <span class="jxr_string">":"</span> ) )
+<a class="jxr_linenumber" name="L184" href="#L184">184</a>         {
+<a class="jxr_linenumber" name="L185" href="#L185">185</a>             String toScheme = to.substring( 0, to.lastIndexOf( ':' ) );
+<a class="jxr_linenumber" name="L186" href="#L186">186</a>             String fromScheme = from.substring( 0, from.lastIndexOf( ':' ) );
+<a class="jxr_linenumber" name="L187" href="#L187">187</a>             <strong class="jxr_keyword">if</strong> ( !toScheme.equals( fromScheme ) )
+<a class="jxr_linenumber" name="L188" href="#L188">188</a>             {
+<a class="jxr_linenumber" name="L189" href="#L189">189</a>                 <strong class="jxr_keyword">return</strong> to;
+<a class="jxr_linenumber" name="L190" href="#L190">190</a>             }
+<a class="jxr_linenumber" name="L191" href="#L191">191</a>         }
+<a class="jxr_linenumber" name="L192" href="#L192">192</a> 
+<a class="jxr_linenumber" name="L193" href="#L193">193</a>         URL toUrl = <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L194" href="#L194">194</a>         URL fromUrl = <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L195" href="#L195">195</a> 
+<a class="jxr_linenumber" name="L196" href="#L196">196</a>         String toPath = to;
+<a class="jxr_linenumber" name="L197" href="#L197">197</a>         String fromPath = from;
+<a class="jxr_linenumber" name="L198" href="#L198">198</a> 
+<a class="jxr_linenumber" name="L199" href="#L199">199</a>         <strong class="jxr_keyword">try</strong>
+<a class="jxr_linenumber" name="L200" href="#L200">200</a>         {
+<a class="jxr_linenumber" name="L201" href="#L201">201</a>             toUrl = <strong class="jxr_keyword">new</strong> URL( to );
+<a class="jxr_linenumber" name="L202" href="#L202">202</a>         }
+<a class="jxr_linenumber" name="L203" href="#L203">203</a>         <strong class="jxr_keyword">catch</strong> ( MalformedURLException e )
+<a class="jxr_linenumber" name="L204" href="#L204">204</a>         {
+<a class="jxr_linenumber" name="L205" href="#L205">205</a>             <strong class="jxr_keyword">try</strong>
+<a class="jxr_linenumber" name="L206" href="#L206">206</a>             {
+<a class="jxr_linenumber" name="L207" href="#L207">207</a>                 toUrl = <strong class="jxr_keyword">new</strong> File( getNormalizedPath( to ) ).toURI().toURL();
+<a class="jxr_linenumber" name="L208" href="#L208">208</a>             }
+<a class="jxr_linenumber" name="L209" href="#L209">209</a>             <strong class="jxr_keyword">catch</strong> ( MalformedURLException e1 )
+<a class="jxr_linenumber" name="L210" href="#L210">210</a>             {
+<a class="jxr_linenumber" name="L211" href="#L211">211</a>                 LOGGER.warn( <span class="jxr_string">"Unable to load a URL for '"</span> + to + <span class="jxr_string">"'"</span>, e );
+<a class="jxr_linenumber" name="L212" href="#L212">212</a>                 <strong class="jxr_keyword">return</strong> to;
+<a class="jxr_linenumber" name="L213" href="#L213">213</a>             }
+<a class="jxr_linenumber" name="L214" href="#L214">214</a>         }
+<a class="jxr_linenumber" name="L215" href="#L215">215</a> 
+<a class="jxr_linenumber" name="L216" href="#L216">216</a>         <strong class="jxr_keyword">try</strong>
+<a class="jxr_linenumber" name="L217" href="#L217">217</a>         {
+<a class="jxr_linenumber" name="L218" href="#L218">218</a>             fromUrl = <strong class="jxr_keyword">new</strong> URL( from );
+<a class="jxr_linenumber" name="L219" href="#L219">219</a>         }
+<a class="jxr_linenumber" name="L220" href="#L220">220</a>         <strong class="jxr_keyword">catch</strong> ( MalformedURLException e )
+<a class="jxr_linenumber" name="L221" href="#L221">221</a>         {
+<a class="jxr_linenumber" name="L222" href="#L222">222</a>             <strong class="jxr_keyword">try</strong>
+<a class="jxr_linenumber" name="L223" href="#L223">223</a>             {
+<a class="jxr_linenumber" name="L224" href="#L224">224</a>                 fromUrl = <strong class="jxr_keyword">new</strong> File( getNormalizedPath( from ) ).toURI().toURL();
+<a class="jxr_linenumber" name="L225" href="#L225">225</a>             }
+<a class="jxr_linenumber" name="L226" href="#L226">226</a>             <strong class="jxr_keyword">catch</strong> ( MalformedURLException e1 )
+<a class="jxr_linenumber" name="L227" href="#L227">227</a>             {
+<a class="jxr_linenumber" name="L228" href="#L228">228</a>                 LOGGER.warn( <span class="jxr_string">"Unable to load a URL for '"</span> + from + <span class="jxr_string">"'"</span>, e );
+<a class="jxr_linenumber" name="L229" href="#L229">229</a>                 <strong class="jxr_keyword">return</strong> to;
+<a class="jxr_linenumber" name="L230" href="#L230">230</a>             }
+<a class="jxr_linenumber" name="L231" href="#L231">231</a>         }
+<a class="jxr_linenumber" name="L232" href="#L232">232</a> 
+<a class="jxr_linenumber" name="L233" href="#L233">233</a>         <strong class="jxr_keyword">if</strong> ( toUrl != <strong class="jxr_keyword">null</strong> &amp;&amp; fromUrl != <strong class="jxr_keyword">null</strong> )
+<a class="jxr_linenumber" name="L234" href="#L234">234</a>         {
+<a class="jxr_linenumber" name="L235" href="#L235">235</a>             <em class="jxr_comment">// URLs, determine if they share protocol and domain info</em>
+<a class="jxr_linenumber" name="L236" href="#L236">236</a> 
+<a class="jxr_linenumber" name="L237" href="#L237">237</a>             <strong class="jxr_keyword">if</strong> ( ( toUrl.getProtocol().equalsIgnoreCase( fromUrl.getProtocol() ) )
+<a class="jxr_linenumber" name="L238" href="#L238">238</a>                 &amp;&amp; ( toUrl.getHost().equalsIgnoreCase( fromUrl.getHost() ) )
+<a class="jxr_linenumber" name="L239" href="#L239">239</a>                 &amp;&amp; ( toUrl.getPort() == fromUrl.getPort() ) )
+<a class="jxr_linenumber" name="L240" href="#L240">240</a>             {
+<a class="jxr_linenumber" name="L241" href="#L241">241</a>                 <em class="jxr_comment">// shared URL domain details, use URI to determine relative path</em>
+<a class="jxr_linenumber" name="L242" href="#L242">242</a> 
+<a class="jxr_linenumber" name="L243" href="#L243">243</a>                 toPath = toUrl.getFile();
+<a class="jxr_linenumber" name="L244" href="#L244">244</a>                 fromPath = fromUrl.getFile();
+<a class="jxr_linenumber" name="L245" href="#L245">245</a>             }
+<a class="jxr_linenumber" name="L246" href="#L246">246</a>             <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L247" href="#L247">247</a>             {
+<a class="jxr_linenumber" name="L248" href="#L248">248</a>                 <em class="jxr_comment">// don't share basic URL information, no relative available</em>
+<a class="jxr_linenumber" name="L249" href="#L249">249</a> 
+<a class="jxr_linenumber" name="L250" href="#L250">250</a>                 <strong class="jxr_keyword">return</strong> to;
+<a class="jxr_linenumber" name="L251" href="#L251">251</a>             }
+<a class="jxr_linenumber" name="L252" href="#L252">252</a>         }
+<a class="jxr_linenumber" name="L253" href="#L253">253</a>         <strong class="jxr_keyword">else</strong> <strong class="jxr_keyword">if</strong> ( ( toUrl != <strong class="jxr_keyword">null</strong> &amp;&amp; fromUrl == <strong class="jxr_keyword">null</strong> ) || ( toUrl == <strong class="jxr_keyword">null</strong> &amp;&amp; fromUrl != <strong class="jxr_keyword">null</strong> ) )
+<a class="jxr_linenumber" name="L254" href="#L254">254</a>         {
+<a class="jxr_linenumber" name="L255" href="#L255">255</a>             <em class="jxr_comment">// one is a URL and the other isn't, no relative available.</em>
+<a class="jxr_linenumber" name="L256" href="#L256">256</a> 
+<a class="jxr_linenumber" name="L257" href="#L257">257</a>             <strong class="jxr_keyword">return</strong> to;
+<a class="jxr_linenumber" name="L258" href="#L258">258</a>         }
+<a class="jxr_linenumber" name="L259" href="#L259">259</a> 
+<a class="jxr_linenumber" name="L260" href="#L260">260</a>         <em class="jxr_comment">// either the two locations are not URLs or if they are they</em>
+<a class="jxr_linenumber" name="L261" href="#L261">261</a>         <em class="jxr_comment">// share the common protocol and domain info and we are left</em>
+<a class="jxr_linenumber" name="L262" href="#L262">262</a>         <em class="jxr_comment">// with their URI information</em>
+<a class="jxr_linenumber" name="L263" href="#L263">263</a> 
+<a class="jxr_linenumber" name="L264" href="#L264">264</a>         String relativePath = getRelativeFilePath( fromPath, toPath );
+<a class="jxr_linenumber" name="L265" href="#L265">265</a> 
+<a class="jxr_linenumber" name="L266" href="#L266">266</a>         <strong class="jxr_keyword">if</strong> ( relativePath == <strong class="jxr_keyword">null</strong> )
+<a class="jxr_linenumber" name="L267" href="#L267">267</a>         {
+<a class="jxr_linenumber" name="L268" href="#L268">268</a>             relativePath = to;
+<a class="jxr_linenumber" name="L269" href="#L269">269</a>         }
+<a class="jxr_linenumber" name="L270" href="#L270">270</a> 
+<a class="jxr_linenumber" name="L271" href="#L271">271</a>         <strong class="jxr_keyword">if</strong> ( LOGGER.isDebugEnabled() &amp;&amp; !relativePath.toString().equals( to ) )
+<a class="jxr_linenumber" name="L272" href="#L272">272</a>         {
+<a class="jxr_linenumber" name="L273" href="#L273">273</a>             LOGGER.debug( <span class="jxr_string">"Mapped url: "</span> + to + <span class="jxr_string">" to relative path: "</span> + relativePath );
+<a class="jxr_linenumber" name="L274" href="#L274">274</a>         }
+<a class="jxr_linenumber" name="L275" href="#L275">275</a> 
+<a class="jxr_linenumber" name="L276" href="#L276">276</a>         <strong class="jxr_keyword">return</strong> relativePath;
+<a class="jxr_linenumber" name="L277" href="#L277">277</a>     }
 <a class="jxr_linenumber" name="L278" href="#L278">278</a> 
-<a class="jxr_linenumber" name="L279" href="#L279">279</a>         <strong class="jxr_keyword">if</strong> ( LOGGER.isDebugEnabled() &amp;&amp; !relativePath.toString().equals( to ) )
-<a class="jxr_linenumber" name="L280" href="#L280">280</a>         {
-<a class="jxr_linenumber" name="L281" href="#L281">281</a>             LOGGER.debug( <span class="jxr_string">"Mapped url: "</span> + to + <span class="jxr_string">" to relative path: "</span> + relativePath );
-<a class="jxr_linenumber" name="L282" href="#L282">282</a>         }
-<a class="jxr_linenumber" name="L283" href="#L283">283</a> 
-<a class="jxr_linenumber" name="L284" href="#L284">284</a>         <strong class="jxr_keyword">return</strong> relativePath;
-<a class="jxr_linenumber" name="L285" href="#L285">285</a>     }
-<a class="jxr_linenumber" name="L286" href="#L286">286</a> 
-<a class="jxr_linenumber" name="L287" href="#L287">287</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> String getRelativeFilePath( <strong class="jxr_keyword">final</strong> String oldPath, <strong class="jxr_keyword">final</strong> String newPath )
-<a class="jxr_linenumber" name="L288" href="#L288">288</a>     {
-<a class="jxr_linenumber" name="L289" href="#L289">289</a>         <em class="jxr_comment">// normalize the path delimiters</em>
-<a class="jxr_linenumber" name="L290" href="#L290">290</a> 
-<a class="jxr_linenumber" name="L291" href="#L291">291</a>         String fromPath = <strong class="jxr_keyword">new</strong> File( oldPath ).getPath();
-<a class="jxr_linenumber" name="L292" href="#L292">292</a>         String toPath = <strong class="jxr_keyword">new</strong> File( newPath ).getPath();
-<a class="jxr_linenumber" name="L293" href="#L293">293</a> 
-<a class="jxr_linenumber" name="L294" href="#L294">294</a>         <em class="jxr_comment">// strip any leading slashes if its a windows path</em>
-<a class="jxr_linenumber" name="L295" href="#L295">295</a>         <strong class="jxr_keyword">if</strong> ( toPath.matches( <span class="jxr_string">"^&#92;&#92;[a-zA-Z]:"</span> ) )
-<a class="jxr_linenumber" name="L296" href="#L296">296</a>         {
-<a class="jxr_linenumber" name="L297" href="#L297">297</a>             toPath = toPath.substring( 1 );
-<a class="jxr_linenumber" name="L298" href="#L298">298</a>         }
-<a class="jxr_linenumber" name="L299" href="#L299">299</a>         <strong class="jxr_keyword">if</strong> ( fromPath.matches( <span class="jxr_string">"^&#92;&#92;[a-zA-Z]:"</span> ) )
-<a class="jxr_linenumber" name="L300" href="#L300">300</a>         {
-<a class="jxr_linenumber" name="L301" href="#L301">301</a>             fromPath = fromPath.substring( 1 );
-<a class="jxr_linenumber" name="L302" href="#L302">302</a>         }
-<a class="jxr_linenumber" name="L303" href="#L303">303</a> 
-<a class="jxr_linenumber" name="L304" href="#L304">304</a>         <em class="jxr_comment">// lowercase windows drive letters.</em>
-<a class="jxr_linenumber" name="L305" href="#L305">305</a>         <strong class="jxr_keyword">if</strong> ( fromPath.startsWith( <span class="jxr_string">":"</span>, 1 ) )
-<a class="jxr_linenumber" name="L306" href="#L306">306</a>         {
-<a class="jxr_linenumber" name="L307" href="#L307">307</a>             fromPath = Character.toLowerCase( fromPath.charAt( 0 ) ) + fromPath.substring( 1 );
-<a class="jxr_linenumber" name="L308" href="#L308">308</a>         }
-<a class="jxr_linenumber" name="L309" href="#L309">309</a>         <strong class="jxr_keyword">if</strong> ( toPath.startsWith( <span class="jxr_string">":"</span>, 1 ) )
-<a class="jxr_linenumber" name="L310" href="#L310">310</a>         {
-<a class="jxr_linenumber" name="L311" href="#L311">311</a>             toPath = Character.toLowerCase( toPath.charAt( 0 ) ) + toPath.substring( 1 );
-<a class="jxr_linenumber" name="L312" href="#L312">312</a>         }
-<a class="jxr_linenumber" name="L313" href="#L313">313</a> 
-<a class="jxr_linenumber" name="L314" href="#L314">314</a>         <em class="jxr_comment">// check for the presence of windows drives. No relative way of</em>
-<a class="jxr_linenumber" name="L315" href="#L315">315</a>         <em class="jxr_comment">// traversing from one to the other.</em>
-<a class="jxr_linenumber" name="L316" href="#L316">316</a> 
-<a class="jxr_linenumber" name="L317" href="#L317">317</a>         <strong class="jxr_keyword">if</strong> ( ( toPath.startsWith( <span class="jxr_string">":"</span>, 1 ) &amp;&amp; fromPath.startsWith( <span class="jxr_string">":"</span>, 1 ) )
-<a class="jxr_linenumber" name="L318" href="#L318">318</a>             &amp;&amp; ( !toPath.substring( 0, 1 ).equals( fromPath.substring( 0, 1 ) ) ) )
-<a class="jxr_linenumber" name="L319" href="#L319">319</a>         {
-<a class="jxr_linenumber" name="L320" href="#L320">320</a>             <em class="jxr_comment">// they both have drive path element but they don't match, no</em>
-<a class="jxr_linenumber" name="L321" href="#L321">321</a>             <em class="jxr_comment">// relative path</em>
-<a class="jxr_linenumber" name="L322" href="#L322">322</a> 
-<a class="jxr_linenumber" name="L323" href="#L323">323</a>             <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L324" href="#L324">324</a>         }
-<a class="jxr_linenumber" name="L325" href="#L325">325</a> 
-<a class="jxr_linenumber" name="L326" href="#L326">326</a>         <strong class="jxr_keyword">if</strong> ( ( toPath.startsWith( <span class="jxr_string">":"</span>, 1 ) &amp;&amp; !fromPath.startsWith( <span class="jxr_string">":"</span>, 1 ) )
-<a class="jxr_linenumber" name="L327" href="#L327">327</a>             || ( !toPath.startsWith( <span class="jxr_string">":"</span>, 1 ) &amp;&amp; fromPath.startsWith( <span class="jxr_string">":"</span>, 1 ) ) )
-<a class="jxr_linenumber" name="L328" href="#L328">328</a>         {
-<a class="jxr_linenumber" name="L329" href="#L329">329</a> 
-<a class="jxr_linenumber" name="L330" href="#L330">330</a>             <em class="jxr_comment">// one has a drive path element and the other doesn't, no relative</em>
-<a class="jxr_linenumber" name="L331" href="#L331">331</a>             <em class="jxr_comment">// path.</em>
-<a class="jxr_linenumber" name="L332" href="#L332">332</a> 
-<a class="jxr_linenumber" name="L333" href="#L333">333</a>             <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L334" href="#L334">334</a> 
-<a class="jxr_linenumber" name="L335" href="#L335">335</a>         }
-<a class="jxr_linenumber" name="L336" href="#L336">336</a> 
-<a class="jxr_linenumber" name="L337" href="#L337">337</a>         <strong class="jxr_keyword">final</strong> String relativePath = buildRelativePath( toPath, fromPath, File.separatorChar );
-<a class="jxr_linenumber" name="L338" href="#L338">338</a> 
-<a class="jxr_linenumber" name="L339" href="#L339">339</a>         <strong class="jxr_keyword">return</strong> relativePath.toString();
-<a class="jxr_linenumber" name="L340" href="#L340">340</a>     }
-<a class="jxr_linenumber" name="L341" href="#L341">341</a> 
-<a class="jxr_linenumber" name="L342" href="#L342">342</a>     <em class="jxr_javadoccomment">/** {@inheritDoc} */</em>
-<a class="jxr_linenumber" name="L343" href="#L343">343</a>     <strong class="jxr_keyword">public</strong> File getSiteDescriptor( File siteDirectory, Locale locale )
-<a class="jxr_linenumber" name="L344" href="#L344">344</a>     {
-<a class="jxr_linenumber" name="L345" href="#L345">345</a>         Objects.requireNonNull( siteDirectory, <span class="jxr_string">"siteDirectory cannot be null"</span> );
-<a class="jxr_linenumber" name="L346" href="#L346">346</a>         <strong class="jxr_keyword">final</strong> Locale llocale = ( locale == <strong class="jxr_keyword">null</strong> ) ? <strong class="jxr_keyword">new</strong> Locale( <span class="jxr_string">""</span> ) : locale;
-<a class="jxr_linenumber" name="L347" href="#L347">347</a> 
-<a class="jxr_linenumber" name="L348" href="#L348">348</a>         File siteDescriptor = <strong class="jxr_keyword">new</strong> File( siteDirectory, <span class="jxr_string">"site_"</span> + llocale.getLanguage() + <span class="jxr_string">".xml"</span> );
-<a class="jxr_linenumber" name="L349" href="#L349">349</a> 
-<a class="jxr_linenumber" name="L350" href="#L350">350</a>         <strong class="jxr_keyword">if</strong> ( !siteDescriptor.isFile() )
-<a class="jxr_linenumber" name="L351" href="#L351">351</a>         {
-<a class="jxr_linenumber" name="L352" href="#L352">352</a>             siteDescriptor = <strong class="jxr_keyword">new</strong> File( siteDirectory, <span class="jxr_string">"site.xml"</span> );
-<a class="jxr_linenumber" name="L353" href="#L353">353</a>         }
-<a class="jxr_linenumber" name="L354" href="#L354">354</a>         <strong class="jxr_keyword">return</strong> siteDescriptor;
-<a class="jxr_linenumber" name="L355" href="#L355">355</a>     }
-<a class="jxr_linenumber" name="L356" href="#L356">356</a> 
-<a class="jxr_linenumber" name="L357" href="#L357">357</a>     <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L358" href="#L358">358</a> <em class="jxr_javadoccomment">     * Get a site descriptor from one of the repositories.</em>
-<a class="jxr_linenumber" name="L359" href="#L359">359</a> <em class="jxr_javadoccomment">     *</em>
-<a class="jxr_linenumber" name="L360" href="#L360">360</a> <em class="jxr_javadoccomment">     * @param project the Maven project, not null.</em>
-<a class="jxr_linenumber" name="L361" href="#L361">361</a> <em class="jxr_javadoccomment">     * @param localRepository the Maven local repository, not null.</em>
-<a class="jxr_linenumber" name="L362" href="#L362">362</a> <em class="jxr_javadoccomment">     * @param repositories the Maven remote repositories, not null.</em>
-<a class="jxr_linenumber" name="L363" href="#L363">363</a> <em class="jxr_javadoccomment">     * @param locale the locale wanted for the site descriptor. If not null, searching for</em>
-<a class="jxr_linenumber" name="L364" href="#L364">364</a> <em class="jxr_javadoccomment">     * &lt;code&gt;site_&lt;i&gt;localeLanguage&lt;/i&gt;.xml&lt;/code&gt;, otherwise searching for &lt;code&gt;site.xml&lt;/code&gt;.</em>
-<a class="jxr_linenumber" name="L365" href="#L365">365</a> <em class="jxr_javadoccomment">     * @return the site descriptor into the local repository after download of it from repositories or null if not</em>
-<a class="jxr_linenumber" name="L366" href="#L366">366</a> <em class="jxr_javadoccomment">     * found in repositories.</em>
-<a class="jxr_linenumber" name="L367" href="#L367">367</a> <em class="jxr_javadoccomment">     * @throws SiteToolException if any</em>
-<a class="jxr_linenumber" name="L368" href="#L368">368</a> <em class="jxr_javadoccomment">     */</em>
-<a class="jxr_linenumber" name="L369" href="#L369">369</a>     File getSiteDescriptorFromRepository( MavenProject project, ArtifactRepository localRepository,
-<a class="jxr_linenumber" name="L370" href="#L370">370</a>                                                  List&lt;ArtifactRepository&gt; repositories, Locale locale )
-<a class="jxr_linenumber" name="L371" href="#L371">371</a>         <strong class="jxr_keyword">throws</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>
-<a class="jxr_linenumber" name="L372" href="#L372">372</a>     {
-<a class="jxr_linenumber" name="L373" href="#L373">373</a>         Objects.requireNonNull( project, <span class="jxr_string">"project cannot be null"</span> );
-<a class="jxr_linenumber" name="L374" href="#L374">374</a>         Objects.requireNonNull( localRepository, <span class="jxr_string">"localRepository cannot be null"</span> );
-<a class="jxr_linenumber" name="L375" href="#L375">375</a>         Objects.requireNonNull( repositories, <span class="jxr_string">"repositories cannot be null"</span> );
-<a class="jxr_linenumber" name="L376" href="#L376">376</a> 
-<a class="jxr_linenumber" name="L377" href="#L377">377</a>         <strong class="jxr_keyword">final</strong> Locale llocale = ( locale == <strong class="jxr_keyword">null</strong> ) ? <strong class="jxr_keyword">new</strong> Locale( <span class="jxr_string">""</span> ) : locale;
-<a class="jxr_linenumber" name="L378" href="#L378">378</a> 
-<a class="jxr_linenumber" name="L379" href="#L379">379</a>         <strong class="jxr_keyword">try</strong>
-<a class="jxr_linenumber" name="L380" href="#L380">380</a>         {
-<a class="jxr_linenumber" name="L381" href="#L381">381</a>             <strong class="jxr_keyword">return</strong> resolveSiteDescriptor( project, localRepository, repositories, llocale );
-<a class="jxr_linenumber" name="L382" href="#L382">382</a>         }
-<a class="jxr_linenumber" name="L383" href="#L383">383</a>         <strong class="jxr_keyword">catch</strong> ( ArtifactNotFoundException e )
-<a class="jxr_linenumber" name="L384" href="#L384">384</a>         {
-<a class="jxr_linenumber" name="L385" href="#L385">385</a>             LOGGER.debug( <span class="jxr_string">"Unable to locate site descriptor"</span>, e );
-<a class="jxr_linenumber" name="L386" href="#L386">386</a>             <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
-<a class="jxr_linenumber" name="L387" href="#L387">387</a>         }
-<a class="jxr_linenumber" name="L388" href="#L388">388</a>         <strong class="jxr_keyword">catch</strong> ( ArtifactResolutionException e )
-<a class="jxr_linenumber" name="L389" href="#L389">389</a>         {
-<a class="jxr_linenumber" name="L390" href="#L390">390</a>             <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>( <span class="jxr_string">"Unable to locate site descriptor"</span>, e );
-<a class="jxr_linenumber" name="L391" href="#L391">391</a>         }
-<a class="jxr_linenumber" name="L392" href="#L392">392</a>         <strong class="jxr_keyword">catch</strong> ( IOException e )
-<a class="jxr_linenumber" name="L393" href="#L393">393</a>         {
-<a class="jxr_linenumber" name="L394" href="#L394">394</a>             <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>( <span class="jxr_string">"Unable to locate site descriptor"</span>, e );
-<a class="jxr_linenumber" name="L395" href="#L395">395</a>         }
-<a class="jxr_linenumber" name="L396" href="#L396">396</a>     }
-<a class="jxr_linenumber" name="L397" href="#L397">397</a> 
-<a class="jxr_linenumber" name="L398" href="#L398">398</a>     <em class="jxr_javadoccomment">/** {@inheritDoc} */</em>
-<a class="jxr_linenumber" name="L399" href="#L399">399</a>     <strong class="jxr_keyword">public</strong> <a name="DecorationModel" href="../../../../../org/apache/maven/doxia/site/decoration/DecorationModel.html#DecorationModel">DecorationModel</a> getDecorationModel( File siteDirectory, Locale locale, MavenProject project,
-<a class="jxr_linenumber" name="L400" href="#L400">400</a>                                                List&lt;MavenProject&gt; reactorProjects, ArtifactRepository localRepository,
-<a class="jxr_linenumber" name="L401" href="#L401">401</a>                                                List&lt;ArtifactRepository&gt; repositories )
-<a class="jxr_linenumber" name="L402" href="#L402">402</a>         <strong class="jxr_keyword">throws</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>
-<a class="jxr_linenumber" name="L403" href="#L403">403</a>     {
-<a class="jxr_linenumber" name="L404" href="#L404">404</a>         Objects.requireNonNull( project, <span class="jxr_string">"project cannot be null"</span> );
-<a class="jxr_linenumber" name="L405" href="#L405">405</a>         Objects.requireNonNull( reactorProjects, <span class="jxr_string">"reactorProjects cannot be null"</span> );
-<a class="jxr_linenumber" name="L406" href="#L406">406</a>         Objects.requireNonNull( localRepository, <span class="jxr_string">"localRepository cannot be null"</span> );
-<a class="jxr_linenumber" name="L407" href="#L407">407</a>         Objects.requireNonNull( repositories, <span class="jxr_string">"repositories cannot be null"</span> );
+<a class="jxr_linenumber" name="L279" href="#L279">279</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">static</strong> String getRelativeFilePath( <strong class="jxr_keyword">final</strong> String oldPath, <strong class="jxr_keyword">final</strong> String newPath )
+<a class="jxr_linenumber" name="L280" href="#L280">280</a>     {
+<a class="jxr_linenumber" name="L281" href="#L281">281</a>         <em class="jxr_comment">// normalize the path delimiters</em>
+<a class="jxr_linenumber" name="L282" href="#L282">282</a> 
+<a class="jxr_linenumber" name="L283" href="#L283">283</a>         String fromPath = <strong class="jxr_keyword">new</strong> File( oldPath ).getPath();
+<a class="jxr_linenumber" name="L284" href="#L284">284</a>         String toPath = <strong class="jxr_keyword">new</strong> File( newPath ).getPath();
+<a class="jxr_linenumber" name="L285" href="#L285">285</a> 
+<a class="jxr_linenumber" name="L286" href="#L286">286</a>         <em class="jxr_comment">// strip any leading slashes if its a windows path</em>
+<a class="jxr_linenumber" name="L287" href="#L287">287</a>         <strong class="jxr_keyword">if</strong> ( toPath.matches( <span class="jxr_string">"^&#92;&#92;[a-zA-Z]:"</span> ) )
+<a class="jxr_linenumber" name="L288" href="#L288">288</a>         {
+<a class="jxr_linenumber" name="L289" href="#L289">289</a>             toPath = toPath.substring( 1 );
+<a class="jxr_linenumber" name="L290" href="#L290">290</a>         }
+<a class="jxr_linenumber" name="L291" href="#L291">291</a>         <strong class="jxr_keyword">if</strong> ( fromPath.matches( <span class="jxr_string">"^&#92;&#92;[a-zA-Z]:"</span> ) )
+<a class="jxr_linenumber" name="L292" href="#L292">292</a>         {
+<a class="jxr_linenumber" name="L293" href="#L293">293</a>             fromPath = fromPath.substring( 1 );
+<a class="jxr_linenumber" name="L294" href="#L294">294</a>         }
+<a class="jxr_linenumber" name="L295" href="#L295">295</a> 
+<a class="jxr_linenumber" name="L296" href="#L296">296</a>         <em class="jxr_comment">// lowercase windows drive letters.</em>
+<a class="jxr_linenumber" name="L297" href="#L297">297</a>         <strong class="jxr_keyword">if</strong> ( fromPath.startsWith( <span class="jxr_string">":"</span>, 1 ) )
+<a class="jxr_linenumber" name="L298" href="#L298">298</a>         {
+<a class="jxr_linenumber" name="L299" href="#L299">299</a>             fromPath = Character.toLowerCase( fromPath.charAt( 0 ) ) + fromPath.substring( 1 );
+<a class="jxr_linenumber" name="L300" href="#L300">300</a>         }
+<a class="jxr_linenumber" name="L301" href="#L301">301</a>         <strong class="jxr_keyword">if</strong> ( toPath.startsWith( <span class="jxr_string">":"</span>, 1 ) )
+<a class="jxr_linenumber" name="L302" href="#L302">302</a>         {
+<a class="jxr_linenumber" name="L303" href="#L303">303</a>             toPath = Character.toLowerCase( toPath.charAt( 0 ) ) + toPath.substring( 1 );
+<a class="jxr_linenumber" name="L304" href="#L304">304</a>         }
+<a class="jxr_linenumber" name="L305" href="#L305">305</a> 
+<a class="jxr_linenumber" name="L306" href="#L306">306</a>         <em class="jxr_comment">// check for the presence of windows drives. No relative way of</em>
+<a class="jxr_linenumber" name="L307" href="#L307">307</a>         <em class="jxr_comment">// traversing from one to the other.</em>
+<a class="jxr_linenumber" name="L308" href="#L308">308</a> 
+<a class="jxr_linenumber" name="L309" href="#L309">309</a>         <strong class="jxr_keyword">if</strong> ( ( toPath.startsWith( <span class="jxr_string">":"</span>, 1 ) &amp;&amp; fromPath.startsWith( <span class="jxr_string">":"</span>, 1 ) )
+<a class="jxr_linenumber" name="L310" href="#L310">310</a>             &amp;&amp; ( !toPath.substring( 0, 1 ).equals( fromPath.substring( 0, 1 ) ) ) )
+<a class="jxr_linenumber" name="L311" href="#L311">311</a>         {
+<a class="jxr_linenumber" name="L312" href="#L312">312</a>             <em class="jxr_comment">// they both have drive path element but they don't match, no</em>
+<a class="jxr_linenumber" name="L313" href="#L313">313</a>             <em class="jxr_comment">// relative path</em>
+<a class="jxr_linenumber" name="L314" href="#L314">314</a> 
+<a class="jxr_linenumber" name="L315" href="#L315">315</a>             <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L316" href="#L316">316</a>         }
+<a class="jxr_linenumber" name="L317" href="#L317">317</a> 
+<a class="jxr_linenumber" name="L318" href="#L318">318</a>         <strong class="jxr_keyword">if</strong> ( ( toPath.startsWith( <span class="jxr_string">":"</span>, 1 ) &amp;&amp; !fromPath.startsWith( <span class="jxr_string">":"</span>, 1 ) )
+<a class="jxr_linenumber" name="L319" href="#L319">319</a>             || ( !toPath.startsWith( <span class="jxr_string">":"</span>, 1 ) &amp;&amp; fromPath.startsWith( <span class="jxr_string">":"</span>, 1 ) ) )
+<a class="jxr_linenumber" name="L320" href="#L320">320</a>         {
+<a class="jxr_linenumber" name="L321" href="#L321">321</a> 
+<a class="jxr_linenumber" name="L322" href="#L322">322</a>             <em class="jxr_comment">// one has a drive path element and the other doesn't, no relative</em>
+<a class="jxr_linenumber" name="L323" href="#L323">323</a>             <em class="jxr_comment">// path.</em>
+<a class="jxr_linenumber" name="L324" href="#L324">324</a> 
+<a class="jxr_linenumber" name="L325" href="#L325">325</a>             <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L326" href="#L326">326</a> 
+<a class="jxr_linenumber" name="L327" href="#L327">327</a>         }
+<a class="jxr_linenumber" name="L328" href="#L328">328</a> 
+<a class="jxr_linenumber" name="L329" href="#L329">329</a>         <strong class="jxr_keyword">final</strong> String relativePath = buildRelativePath( toPath, fromPath, File.separatorChar );
+<a class="jxr_linenumber" name="L330" href="#L330">330</a> 
+<a class="jxr_linenumber" name="L331" href="#L331">331</a>         <strong class="jxr_keyword">return</strong> relativePath.toString();
+<a class="jxr_linenumber" name="L332" href="#L332">332</a>     }
+<a class="jxr_linenumber" name="L333" href="#L333">333</a> 
+<a class="jxr_linenumber" name="L334" href="#L334">334</a>     <em class="jxr_javadoccomment">/** {@inheritDoc} */</em>
+<a class="jxr_linenumber" name="L335" href="#L335">335</a>     <strong class="jxr_keyword">public</strong> File getSiteDescriptor( File siteDirectory, Locale locale )
+<a class="jxr_linenumber" name="L336" href="#L336">336</a>     {
+<a class="jxr_linenumber" name="L337" href="#L337">337</a>         Objects.requireNonNull( siteDirectory, <span class="jxr_string">"siteDirectory cannot be null"</span> );
+<a class="jxr_linenumber" name="L338" href="#L338">338</a>         Objects.requireNonNull( locale, <span class="jxr_string">"locale cannot be null"</span> );
+<a class="jxr_linenumber" name="L339" href="#L339">339</a> 
+<a class="jxr_linenumber" name="L340" href="#L340">340</a>         String variant = locale.getVariant();
+<a class="jxr_linenumber" name="L341" href="#L341">341</a>         String country = locale.getCountry();
+<a class="jxr_linenumber" name="L342" href="#L342">342</a>         String language = locale.getLanguage();
+<a class="jxr_linenumber" name="L343" href="#L343">343</a> 
+<a class="jxr_linenumber" name="L344" href="#L344">344</a>         File siteDescriptor = <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L345" href="#L345">345</a> 
+<a class="jxr_linenumber" name="L346" href="#L346">346</a>         <strong class="jxr_keyword">if</strong> ( !variant.isEmpty() )
+<a class="jxr_linenumber" name="L347" href="#L347">347</a>         {
+<a class="jxr_linenumber" name="L348" href="#L348">348</a>             siteDescriptor = <strong class="jxr_keyword">new</strong> File( siteDirectory, <span class="jxr_string">"site_"</span> + language + <span class="jxr_string">"_"</span> + country + <span class="jxr_string">"_"</span> + variant + <span class="jxr_string">".xml"</span> );
+<a class="jxr_linenumber" name="L349" href="#L349">349</a>         }
+<a class="jxr_linenumber" name="L350" href="#L350">350</a> 
+<a class="jxr_linenumber" name="L351" href="#L351">351</a>         <strong class="jxr_keyword">if</strong> ( ( siteDescriptor == <strong class="jxr_keyword">null</strong> || !siteDescriptor.isFile() ) &amp;&amp; !country.isEmpty() )
+<a class="jxr_linenumber" name="L352" href="#L352">352</a>         {
+<a class="jxr_linenumber" name="L353" href="#L353">353</a>             siteDescriptor = <strong class="jxr_keyword">new</strong> File( siteDirectory, <span class="jxr_string">"site_"</span> + language + <span class="jxr_string">"_"</span> + country + <span class="jxr_string">".xml"</span> );
+<a class="jxr_linenumber" name="L354" href="#L354">354</a>         }
+<a class="jxr_linenumber" name="L355" href="#L355">355</a> 
+<a class="jxr_linenumber" name="L356" href="#L356">356</a>         <strong class="jxr_keyword">if</strong> ( ( siteDescriptor == <strong class="jxr_keyword">null</strong> || !siteDescriptor.isFile() ) &amp;&amp; !language.isEmpty() )
+<a class="jxr_linenumber" name="L357" href="#L357">357</a>         {
+<a class="jxr_linenumber" name="L358" href="#L358">358</a>             siteDescriptor = <strong class="jxr_keyword">new</strong> File( siteDirectory, <span class="jxr_string">"site_"</span> + language + <span class="jxr_string">".xml"</span> );
+<a class="jxr_linenumber" name="L359" href="#L359">359</a>         }
+<a class="jxr_linenumber" name="L360" href="#L360">360</a> 
+<a class="jxr_linenumber" name="L361" href="#L361">361</a>         <strong class="jxr_keyword">if</strong> ( siteDescriptor == <strong class="jxr_keyword">null</strong> || !siteDescriptor.isFile() )
+<a class="jxr_linenumber" name="L362" href="#L362">362</a>         {
+<a class="jxr_linenumber" name="L363" href="#L363">363</a>             siteDescriptor = <strong class="jxr_keyword">new</strong> File( siteDirectory, <span class="jxr_string">"site.xml"</span> );
+<a class="jxr_linenumber" name="L364" href="#L364">364</a>         }
+<a class="jxr_linenumber" name="L365" href="#L365">365</a> 
+<a class="jxr_linenumber" name="L366" href="#L366">366</a>         <strong class="jxr_keyword">return</strong> siteDescriptor;
+<a class="jxr_linenumber" name="L367" href="#L367">367</a>     }
+<a class="jxr_linenumber" name="L368" href="#L368">368</a> 
+<a class="jxr_linenumber" name="L369" href="#L369">369</a>     <em class="jxr_javadoccomment">/**</em>
+<a class="jxr_linenumber" name="L370" href="#L370">370</a> <em class="jxr_javadoccomment">     * Get a site descriptor from one of the repositories.</em>
+<a class="jxr_linenumber" name="L371" href="#L371">371</a> <em class="jxr_javadoccomment">     *</em>
+<a class="jxr_linenumber" name="L372" href="#L372">372</a> <em class="jxr_javadoccomment">     * @param project the Maven project, not null.</em>
+<a class="jxr_linenumber" name="L373" href="#L373">373</a> <em class="jxr_javadoccomment">     * @param localRepository the Maven local repository, not null.</em>
+<a class="jxr_linenumber" name="L374" href="#L374">374</a> <em class="jxr_javadoccomment">     * @param repositories the Maven remote repositories, not null.</em>
+<a class="jxr_linenumber" name="L375" href="#L375">375</a> <em class="jxr_javadoccomment">     * @param locale the locale wanted for the site descriptor, not null.</em>
+<a class="jxr_linenumber" name="L376" href="#L376">376</a> <em class="jxr_javadoccomment">     * See {@link #getSiteDescriptor(File, Locale)} for details.</em>
+<a class="jxr_linenumber" name="L377" href="#L377">377</a> <em class="jxr_javadoccomment">     * @return the site descriptor into the local repository after download of it from repositories or null if not</em>
+<a class="jxr_linenumber" name="L378" href="#L378">378</a> <em class="jxr_javadoccomment">     * found in repositories.</em>
+<a class="jxr_linenumber" name="L379" href="#L379">379</a> <em class="jxr_javadoccomment">     * @throws SiteToolException if any</em>
+<a class="jxr_linenumber" name="L380" href="#L380">380</a> <em class="jxr_javadoccomment">     */</em>
+<a class="jxr_linenumber" name="L381" href="#L381">381</a>     File getSiteDescriptorFromRepository( MavenProject project, ArtifactRepository localRepository,
+<a class="jxr_linenumber" name="L382" href="#L382">382</a>                                                  List&lt;ArtifactRepository&gt; repositories, Locale locale )
+<a class="jxr_linenumber" name="L383" href="#L383">383</a>         <strong class="jxr_keyword">throws</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>
+<a class="jxr_linenumber" name="L384" href="#L384">384</a>     {
+<a class="jxr_linenumber" name="L385" href="#L385">385</a>         Objects.requireNonNull( project, <span class="jxr_string">"project cannot be null"</span> );
+<a class="jxr_linenumber" name="L386" href="#L386">386</a>         Objects.requireNonNull( localRepository, <span class="jxr_string">"localRepository cannot be null"</span> );
+<a class="jxr_linenumber" name="L387" href="#L387">387</a>         Objects.requireNonNull( repositories, <span class="jxr_string">"repositories cannot be null"</span> );
+<a class="jxr_linenumber" name="L388" href="#L388">388</a>         Objects.requireNonNull( locale, <span class="jxr_string">"locale cannot be null"</span> );
+<a class="jxr_linenumber" name="L389" href="#L389">389</a> 
+<a class="jxr_linenumber" name="L390" href="#L390">390</a>         <strong class="jxr_keyword">try</strong>
+<a class="jxr_linenumber" name="L391" href="#L391">391</a>         {
+<a class="jxr_linenumber" name="L392" href="#L392">392</a>             <strong class="jxr_keyword">return</strong> resolveSiteDescriptor( project, localRepository, repositories, locale );
+<a class="jxr_linenumber" name="L393" href="#L393">393</a>         }
+<a class="jxr_linenumber" name="L394" href="#L394">394</a>         <strong class="jxr_keyword">catch</strong> ( ArtifactNotFoundException e )
+<a class="jxr_linenumber" name="L395" href="#L395">395</a>         {
+<a class="jxr_linenumber" name="L396" href="#L396">396</a>             LOGGER.debug( <span class="jxr_string">"Unable to locate site descriptor"</span>, e );
+<a class="jxr_linenumber" name="L397" href="#L397">397</a>             <strong class="jxr_keyword">return</strong> <strong class="jxr_keyword">null</strong>;
+<a class="jxr_linenumber" name="L398" href="#L398">398</a>         }
+<a class="jxr_linenumber" name="L399" href="#L399">399</a>         <strong class="jxr_keyword">catch</strong> ( ArtifactResolutionException e )
+<a class="jxr_linenumber" name="L400" href="#L400">400</a>         {
+<a class="jxr_linenumber" name="L401" href="#L401">401</a>             <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>( <span class="jxr_string">"Unable to locate site descriptor"</span>, e );
+<a class="jxr_linenumber" name="L402" href="#L402">402</a>         }
+<a class="jxr_linenumber" name="L403" href="#L403">403</a>         <strong class="jxr_keyword">catch</strong> ( IOException e )
+<a class="jxr_linenumber" name="L404" href="#L404">404</a>         {
+<a class="jxr_linenumber" name="L405" href="#L405">405</a>             <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>( <span class="jxr_string">"Unable to locate site descriptor"</span>, e );
+<a class="jxr_linenumber" name="L406" href="#L406">406</a>         }
+<a class="jxr_linenumber" name="L407" href="#L407">407</a>     }
 <a class="jxr_linenumber" name="L408" href="#L408">408</a> 
-<a class="jxr_linenumber" name="L409" href="#L409">409</a>         <strong class="jxr_keyword">final</strong> Locale llocale = ( locale == <strong class="jxr_keyword">null</strong> ) ? Locale.getDefault() : locale;
-<a class="jxr_linenumber" name="L410" href="#L410">410</a> 
-<a class="jxr_linenumber" name="L411" href="#L411">411</a>         LOGGER.debug( <span class="jxr_string">"Computing decoration model of "</span> + project.getId() + <span class="jxr_string">" for locale "</span> + llocale );
-<a class="jxr_linenumber" name="L412" href="#L412">412</a> 
-<a class="jxr_linenumber" name="L413" href="#L413">413</a>         Map.Entry&lt;DecorationModel, MavenProject&gt; result =
-<a class="jxr_linenumber" name="L414" href="#L414">414</a>             getDecorationModel( 0, siteDirectory, llocale, project, reactorProjects, localRepository, repositories );
-<a class="jxr_linenumber" name="L415" href="#L415">415</a>         <a name="DecorationModel" href="../../../../../org/apache/maven/doxia/site/decoration/DecorationModel.html#DecorationModel">DecorationModel</a> decorationModel = result.getKey();
-<a class="jxr_linenumber" name="L416" href="#L416">416</a>         MavenProject parentProject = result.getValue();
-<a class="jxr_linenumber" name="L417" href="#L417">417</a> 
-<a class="jxr_linenumber" name="L418" href="#L418">418</a>         <strong class="jxr_keyword">if</strong> ( decorationModel == <strong class="jxr_keyword">null</strong> )
-<a class="jxr_linenumber" name="L419" href="#L419">419</a>         {
-<a class="jxr_linenumber" name="L420" href="#L420">420</a>             LOGGER.debug( <span class="jxr_string">"Using default site descriptor"</span> );
-<a class="jxr_linenumber" name="L421" href="#L421">421</a>             decorationModel = getDefaultDecorationModel();
-<a class="jxr_linenumber" name="L422" href="#L422">422</a>         }
+<a class="jxr_linenumber" name="L409" href="#L409">409</a>     <em class="jxr_javadoccomment">/** {@inheritDoc} */</em>
+<a class="jxr_linenumber" name="L410" href="#L410">410</a>     <strong class="jxr_keyword">public</strong> <a name="DecorationModel" href="../../../../../org/apache/maven/doxia/site/decoration/DecorationModel.html#DecorationModel">DecorationModel</a> getDecorationModel( File siteDirectory, Locale locale, MavenProject project,
+<a class="jxr_linenumber" name="L411" href="#L411">411</a>                                                List&lt;MavenProject&gt; reactorProjects, ArtifactRepository localRepository,
+<a class="jxr_linenumber" name="L412" href="#L412">412</a>                                                List&lt;ArtifactRepository&gt; repositories )
+<a class="jxr_linenumber" name="L413" href="#L413">413</a>         <strong class="jxr_keyword">throws</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>
+<a class="jxr_linenumber" name="L414" href="#L414">414</a>     {
+<a class="jxr_linenumber" name="L415" href="#L415">415</a>         Objects.requireNonNull( locale, <span class="jxr_string">"locale cannot be null"</span> );
+<a class="jxr_linenumber" name="L416" href="#L416">416</a>         Objects.requireNonNull( project, <span class="jxr_string">"project cannot be null"</span> );
+<a class="jxr_linenumber" name="L417" href="#L417">417</a>         Objects.requireNonNull( reactorProjects, <span class="jxr_string">"reactorProjects cannot be null"</span> );
+<a class="jxr_linenumber" name="L418" href="#L418">418</a>         Objects.requireNonNull( localRepository, <span class="jxr_string">"localRepository cannot be null"</span> );
+<a class="jxr_linenumber" name="L419" href="#L419">419</a>         Objects.requireNonNull( repositories, <span class="jxr_string">"repositories cannot be null"</span> );
+<a class="jxr_linenumber" name="L420" href="#L420">420</a> 
+<a class="jxr_linenumber" name="L421" href="#L421">421</a>         LOGGER.debug( <span class="jxr_string">"Computing decoration model of '"</span> + project.getId() + <span class="jxr_string">"' for "</span>
+<a class="jxr_linenumber" name="L422" href="#L422">422</a>                 + ( locale.equals( SiteTool.DEFAULT_LOCALE ) ? <span class="jxr_string">"default locale"</span> : <span class="jxr_string">"locale '"</span> + locale + <span class="jxr_string">"'"</span> ) );
 <a class="jxr_linenumber" name="L423" href="#L423">423</a> 
-<a class="jxr_linenumber" name="L424" href="#L424">424</a>         <em class="jxr_comment">// DecorationModel back to String to interpolate, then go back to DecorationModel</em>
-<a class="jxr_linenumber" name="L425" href="#L425">425</a>         String siteDescriptorContent = decorationModelToString( decorationModel );
-<a class="jxr_linenumber" name="L426" href="#L426">426</a> 
-<a class="jxr_linenumber" name="L427" href="#L427">427</a>         <em class="jxr_comment">// "classical" late interpolation, after full inheritance</em>
-<a class="jxr_linenumber" name="L428" href="#L428">428</a>         siteDescriptorContent = getInterpolatedSiteDescriptorContent( project, siteDescriptorContent, false );
-<a class="jxr_linenumber" name="L429" href="#L429">429</a> 
-<a class="jxr_linenumber" name="L430" href="#L430">430</a>         decorationModel = readDecorationModel( siteDescriptorContent );
-<a class="jxr_linenumber" name="L431" href="#L431">431</a> 
-<a class="jxr_linenumber" name="L432" href="#L432">432</a>         <strong class="jxr_keyword">if</strong> ( parentProject != <strong class="jxr_keyword">null</strong> )
-<a class="jxr_linenumber" name="L433" href="#L433">433</a>         {
-<a class="jxr_linenumber" name="L434" href="#L434">434</a>             populateParentMenu( decorationModel, llocale, project, parentProject, <strong class="jxr_keyword">true</strong> );
-<a class="jxr_linenumber" name="L435" href="#L435">435</a>         }
-<a class="jxr_linenumber" name="L436" href="#L436">436</a> 
-<a class="jxr_linenumber" name="L437" href="#L437">437</a>         <strong class="jxr_keyword">try</strong>
-<a class="jxr_linenumber" name="L438" href="#L438">438</a>         {
-<a class="jxr_linenumber" name="L439" href="#L439">439</a>             populateModulesMenu( decorationModel, llocale, project, reactorProjects, localRepository, <strong class="jxr_keyword">true</strong> );
-<a class="jxr_linenumber" name="L440" href="#L440">440</a>         }
-<a class="jxr_linenumber" name="L441" href="#L441">441</a>         <strong class="jxr_keyword">catch</strong> ( IOException e )
-<a class="jxr_linenumber" name="L442" href="#L442">442</a>         {
-<a class="jxr_linenumber" name="L443" href="#L443">443</a>             <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>( <span class="jxr_string">"Error while populating modules menu"</span>, e );
-<a class="jxr_linenumber" name="L444" href="#L444">444</a>         }
-<a class="jxr_linenumber" name="L445" href="#L445">445</a> 
-<a class="jxr_linenumber" name="L446" href="#L446">446</a>         <strong class="jxr_keyword">return</strong> decorationModel;
-<a class="jxr_linenumber" name="L447" href="#L447">447</a>     }
-<a class="jxr_linenumber" name="L448" href="#L448">448</a> 
-<a class="jxr_linenumber" name="L449" href="#L449">449</a>     <em class="jxr_javadoccomment">/** {@inheritDoc} */</em>
-<a class="jxr_linenumber" name="L450" href="#L450">450</a>     <strong class="jxr_keyword">public</strong> String getInterpolatedSiteDescriptorContent( Map&lt;String, String&gt; props, MavenProject aProject,
-<a class="jxr_linenumber" name="L451" href="#L451">451</a>                                                         String siteDescriptorContent )
-<a class="jxr_linenumber" name="L452" href="#L452">452</a>         <strong class="jxr_keyword">throws</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>
-<a class="jxr_linenumber" name="L453" href="#L453">453</a>     {
-<a class="jxr_linenumber" name="L454" href="#L454">454</a>         Objects.requireNonNull( props, <span class="jxr_string">"props cannot be null"</span> );
-<a class="jxr_linenumber" name="L455" href="#L455">455</a> 
-<a class="jxr_linenumber" name="L456" href="#L456">456</a>         <em class="jxr_comment">// "classical" late interpolation</em>
-<a class="jxr_linenumber" name="L457" href="#L457">457</a>         <strong class="jxr_keyword">return</strong> getInterpolatedSiteDescriptorContent( aProject, siteDescriptorContent, false );
+<a class="jxr_linenumber" name="L424" href="#L424">424</a>         Map.Entry&lt;DecorationModel, MavenProject&gt; result =
+<a class="jxr_linenumber" name="L425" href="#L425">425</a>             getDecorationModel( 0, siteDirectory, locale, project, reactorProjects, localRepository, repositories );
+<a class="jxr_linenumber" name="L426" href="#L426">426</a>         <a name="DecorationModel" href="../../../../../org/apache/maven/doxia/site/decoration/DecorationModel.html#DecorationModel">DecorationModel</a> decorationModel = result.getKey();
+<a class="jxr_linenumber" name="L427" href="#L427">427</a>         MavenProject parentProject = result.getValue();
+<a class="jxr_linenumber" name="L428" href="#L428">428</a> 
+<a class="jxr_linenumber" name="L429" href="#L429">429</a>         <strong class="jxr_keyword">if</strong> ( decorationModel == <strong class="jxr_keyword">null</strong> )
+<a class="jxr_linenumber" name="L430" href="#L430">430</a>         {
+<a class="jxr_linenumber" name="L431" href="#L431">431</a>             LOGGER.debug( <span class="jxr_string">"Using default site descriptor"</span> );
+<a class="jxr_linenumber" name="L432" href="#L432">432</a>             decorationModel = getDefaultDecorationModel();
+<a class="jxr_linenumber" name="L433" href="#L433">433</a>         }
+<a class="jxr_linenumber" name="L434" href="#L434">434</a> 
+<a class="jxr_linenumber" name="L435" href="#L435">435</a>         <em class="jxr_comment">// DecorationModel back to String to interpolate, then go back to DecorationModel</em>
+<a class="jxr_linenumber" name="L436" href="#L436">436</a>         String siteDescriptorContent = decorationModelToString( decorationModel );
+<a class="jxr_linenumber" name="L437" href="#L437">437</a> 
+<a class="jxr_linenumber" name="L438" href="#L438">438</a>         <em class="jxr_comment">// "classical" late interpolation, after full inheritance</em>
+<a class="jxr_linenumber" name="L439" href="#L439">439</a>         siteDescriptorContent = getInterpolatedSiteDescriptorContent( project, siteDescriptorContent, false );
+<a class="jxr_linenumber" name="L440" href="#L440">440</a> 
+<a class="jxr_linenumber" name="L441" href="#L441">441</a>         decorationModel = readDecorationModel( siteDescriptorContent );
+<a class="jxr_linenumber" name="L442" href="#L442">442</a> 
+<a class="jxr_linenumber" name="L443" href="#L443">443</a>         <strong class="jxr_keyword">if</strong> ( parentProject != <strong class="jxr_keyword">null</strong> )
+<a class="jxr_linenumber" name="L444" href="#L444">444</a>         {
+<a class="jxr_linenumber" name="L445" href="#L445">445</a>             populateParentMenu( decorationModel, locale, project, parentProject, <strong class="jxr_keyword">true</strong> );
+<a class="jxr_linenumber" name="L446" href="#L446">446</a>         }
+<a class="jxr_linenumber" name="L447" href="#L447">447</a> 
+<a class="jxr_linenumber" name="L448" href="#L448">448</a>         <strong class="jxr_keyword">try</strong>
+<a class="jxr_linenumber" name="L449" href="#L449">449</a>         {
+<a class="jxr_linenumber" name="L450" href="#L450">450</a>             populateModulesMenu( decorationModel, locale, project, reactorProjects, localRepository, <strong class="jxr_keyword">true</strong> );
+<a class="jxr_linenumber" name="L451" href="#L451">451</a>         }
+<a class="jxr_linenumber" name="L452" href="#L452">452</a>         <strong class="jxr_keyword">catch</strong> ( IOException e )
+<a class="jxr_linenumber" name="L453" href="#L453">453</a>         {
+<a class="jxr_linenumber" name="L454" href="#L454">454</a>             <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>( <span class="jxr_string">"Error while populating modules menu"</span>, e );
+<a class="jxr_linenumber" name="L455" href="#L455">455</a>         }
+<a class="jxr_linenumber" name="L456" href="#L456">456</a> 
+<a class="jxr_linenumber" name="L457" href="#L457">457</a>         <strong class="jxr_keyword">return</strong> decorationModel;
 <a class="jxr_linenumber" name="L458" href="#L458">458</a>     }
 <a class="jxr_linenumber" name="L459" href="#L459">459</a> 
-<a class="jxr_linenumber" name="L460" href="#L460">460</a>     <strong class="jxr_keyword">private</strong> String getInterpolatedSiteDescriptorContent( MavenProject aProject,
-<a class="jxr_linenumber" name="L461" href="#L461">461</a>                                                         String siteDescriptorContent, <strong class="jxr_keyword">boolean</strong> isEarly )
-<a class="jxr_linenumber" name="L462" href="#L462">462</a>         <strong class="jxr_keyword">throws</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>
-<a class="jxr_linenumber" name="L463" href="#L463">463</a>     {
-<a class="jxr_linenumber" name="L464" href="#L464">464</a>         Objects.requireNonNull( aProject, <span class="jxr_string">"aProject cannot be null"</span> );
-<a class="jxr_linenumber" name="L465" href="#L465">465</a>         Objects.requireNonNull( siteDescriptorContent, <span class="jxr_string">"siteDescriptorContent cannot be null"</span> );
+<a class="jxr_linenumber" name="L460" href="#L460">460</a>     <em class="jxr_javadoccomment">/** {@inheritDoc} */</em>
+<a class="jxr_linenumber" name="L461" href="#L461">461</a>     <strong class="jxr_keyword">public</strong> String getInterpolatedSiteDescriptorContent( Map&lt;String, String&gt; props, MavenProject aProject,
+<a class="jxr_linenumber" name="L462" href="#L462">462</a>                                                         String siteDescriptorContent )
+<a class="jxr_linenumber" name="L463" href="#L463">463</a>         <strong class="jxr_keyword">throws</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>
+<a class="jxr_linenumber" name="L464" href="#L464">464</a>     {
+<a class="jxr_linenumber" name="L465" href="#L465">465</a>         Objects.requireNonNull( props, <span class="jxr_string">"props cannot be null"</span> );
 <a class="jxr_linenumber" name="L466" href="#L466">466</a> 
-<a class="jxr_linenumber" name="L467" href="#L467">467</a>         RegexBasedInterpolator interpolator = <strong class="jxr_keyword">new</strong> RegexBasedInterpolator();
-<a class="jxr_linenumber" name="L468" href="#L468">468</a> 
-<a class="jxr_linenumber" name="L469" href="#L469">469</a>         <strong class="jxr_keyword">if</strong> ( isEarly )
-<a class="jxr_linenumber" name="L470" href="#L470">470</a>         {
-<a class="jxr_linenumber" name="L471" href="#L471">471</a>             interpolator.addValueSource( <strong class="jxr_keyword">new</strong> PrefixedObjectValueSource( <span class="jxr_string">"this."</span>, aProject ) );
-<a class="jxr_linenumber" name="L472" href="#L472">472</a>             interpolator.addValueSource( <strong class="jxr_keyword">new</strong> PrefixedPropertiesValueSource( <span class="jxr_string">"this."</span>, aProject.getProperties() ) );
-<a class="jxr_linenumber" name="L473" href="#L473">473</a>         }
-<a class="jxr_linenumber" name="L474" href="#L474">474</a>         <strong class="jxr_keyword">else</strong>
-<a class="jxr_linenumber" name="L475" href="#L475">475</a>         {
-<a class="jxr_linenumber" name="L476" href="#L476">476</a>             interpolator.addValueSource( <strong class="jxr_keyword">new</strong> PrefixedObjectValueSource( <span class="jxr_string">"project."</span>, aProject ) );
-<a class="jxr_linenumber" name="L477" href="#L477">477</a>             interpolator.addValueSource( <strong class="jxr_keyword">new</strong> MapBasedValueSource( aProject.getProperties() ) );
-<a class="jxr_linenumber" name="L478" href="#L478">478</a> 
-<a class="jxr_linenumber" name="L479" href="#L479">479</a>             <strong class="jxr_keyword">try</strong>
-<a class="jxr_linenumber" name="L480" href="#L480">480</a>             {
-<a class="jxr_linenumber" name="L481" href="#L481">481</a>                 interpolator.addValueSource( <strong class="jxr_keyword">new</strong> EnvarBasedValueSource() );
-<a class="jxr_linenumber" name="L482" href="#L482">482</a>             }
-<a class="jxr_linenumber" name="L483" href="#L483">483</a>             <strong class="jxr_keyword">catch</strong> ( IOException e )
-<a class="jxr_linenumber" name="L484" href="#L484">484</a>             {
-<a class="jxr_linenumber" name="L485" href="#L485">485</a>                 <em class="jxr_comment">// Prefer logging?</em>
-<a class="jxr_linenumber" name="L486" href="#L486">486</a>                 <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>( <span class="jxr_string">"Cannot interpolate environment properties"</span>, e );
-<a class="jxr_linenumber" name="L487" href="#L487">487</a>             }
-<a class="jxr_linenumber" name="L488" href="#L488">488</a>         }
+<a class="jxr_linenumber" name="L467" href="#L467">467</a>         <em class="jxr_comment">// "classical" late interpolation</em>
+<a class="jxr_linenumber" name="L468" href="#L468">468</a>         <strong class="jxr_keyword">return</strong> getInterpolatedSiteDescriptorContent( aProject, siteDescriptorContent, false );
+<a class="jxr_linenumber" name="L469" href="#L469">469</a>     }
+<a class="jxr_linenumber" name="L470" href="#L470">470</a> 
+<a class="jxr_linenumber" name="L471" href="#L471">471</a>     <strong class="jxr_keyword">private</strong> String getInterpolatedSiteDescriptorContent( MavenProject aProject,
+<a class="jxr_linenumber" name="L472" href="#L472">472</a>                                                         String siteDescriptorContent, <strong class="jxr_keyword">boolean</strong> isEarly )
+<a class="jxr_linenumber" name="L473" href="#L473">473</a>         <strong class="jxr_keyword">throws</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>
+<a class="jxr_linenumber" name="L474" href="#L474">474</a>     {
+<a class="jxr_linenumber" name="L475" href="#L475">475</a>         Objects.requireNonNull( aProject, <span class="jxr_string">"aProject cannot be null"</span> );
+<a class="jxr_linenumber" name="L476" href="#L476">476</a>         Objects.requireNonNull( siteDescriptorContent, <span class="jxr_string">"siteDescriptorContent cannot be null"</span> );
+<a class="jxr_linenumber" name="L477" href="#L477">477</a> 
+<a class="jxr_linenumber" name="L478" href="#L478">478</a>         RegexBasedInterpolator interpolator = <strong class="jxr_keyword">new</strong> RegexBasedInterpolator();
+<a class="jxr_linenumber" name="L479" href="#L479">479</a> 
+<a class="jxr_linenumber" name="L480" href="#L480">480</a>         <strong class="jxr_keyword">if</strong> ( isEarly )
+<a class="jxr_linenumber" name="L481" href="#L481">481</a>         {
+<a class="jxr_linenumber" name="L482" href="#L482">482</a>             interpolator.addValueSource( <strong class="jxr_keyword">new</strong> PrefixedObjectValueSource( <span class="jxr_string">"this."</span>, aProject ) );
+<a class="jxr_linenumber" name="L483" href="#L483">483</a>             interpolator.addValueSource( <strong class="jxr_keyword">new</strong> PrefixedPropertiesValueSource( <span class="jxr_string">"this."</span>, aProject.getProperties() ) );
+<a class="jxr_linenumber" name="L484" href="#L484">484</a>         }
+<a class="jxr_linenumber" name="L485" href="#L485">485</a>         <strong class="jxr_keyword">else</strong>
+<a class="jxr_linenumber" name="L486" href="#L486">486</a>         {
+<a class="jxr_linenumber" name="L487" href="#L487">487</a>             interpolator.addValueSource( <strong class="jxr_keyword">new</strong> PrefixedObjectValueSource( <span class="jxr_string">"project."</span>, aProject ) );
+<a class="jxr_linenumber" name="L488" href="#L488">488</a>             interpolator.addValueSource( <strong class="jxr_keyword">new</strong> MapBasedValueSource( aProject.getProperties() ) );
 <a class="jxr_linenumber" name="L489" href="#L489">489</a> 
-<a class="jxr_linenumber" name="L490" href="#L490">490</a>         <strong class="jxr_keyword">try</strong>
-<a class="jxr_linenumber" name="L491" href="#L491">491</a>         {
-<a class="jxr_linenumber" name="L492" href="#L492">492</a>             <em class="jxr_comment">// FIXME: this does not escape xml entities, see MSITE-226, PLXCOMP-118</em>
-<a class="jxr_linenumber" name="L493" href="#L493">493</a>             <strong class="jxr_keyword">return</strong> interpolator.interpolate( siteDescriptorContent );
-<a class="jxr_linenumber" name="L494" href="#L494">494</a>         }
-<a class="jxr_linenumber" name="L495" href="#L495">495</a>         <strong class="jxr_keyword">catch</strong> ( InterpolationException e )
-<a class="jxr_linenumber" name="L496" href="#L496">496</a>         {
-<a class="jxr_linenumber" name="L497" href="#L497">497</a>             <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>( <span class="jxr_string">"Cannot interpolate site descriptor"</span>, e );
-<a class="jxr_linenumber" name="L498" href="#L498">498</a>         }
-<a class="jxr_linenumber" name="L499" href="#L499">499</a>     }
+<a class="jxr_linenumber" name="L490" href="#L490">490</a>             <strong class="jxr_keyword">try</strong>
+<a class="jxr_linenumber" name="L491" href="#L491">491</a>             {
+<a class="jxr_linenumber" name="L492" href="#L492">492</a>                 interpolator.addValueSource( <strong class="jxr_keyword">new</strong> EnvarBasedValueSource() );
+<a class="jxr_linenumber" name="L493" href="#L493">493</a>             }
+<a class="jxr_linenumber" name="L494" href="#L494">494</a>             <strong class="jxr_keyword">catch</strong> ( IOException e )
+<a class="jxr_linenumber" name="L495" href="#L495">495</a>             {
+<a class="jxr_linenumber" name="L496" href="#L496">496</a>                 <em class="jxr_comment">// Prefer logging?</em>
+<a class="jxr_linenumber" name="L497" href="#L497">497</a>                 <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>( <span class="jxr_string">"Cannot interpolate environment properties"</span>, e );
+<a class="jxr_linenumber" name="L498" href="#L498">498</a>             }
+<a class="jxr_linenumber" name="L499" href="#L499">499</a>         }
 <a class="jxr_linenumber" name="L500" href="#L500">500</a> 
-<a class="jxr_linenumber" name="L501" href="#L501">501</a>     <em class="jxr_javadoccomment">/** {@inheritDoc} */</em>
-<a class="jxr_linenumber" name="L502" href="#L502">502</a>     <strong class="jxr_keyword">public</strong> MavenProject getParentProject( MavenProject aProject, List&lt;MavenProject&gt; reactorProjects,
-<a class="jxr_linenumber" name="L503" href="#L503">503</a>                                           ArtifactRepository localRepository )
-<a class="jxr_linenumber" name="L504" href="#L504">504</a>     {
-<a class="jxr_linenumber" name="L505" href="#L505">505</a>         Objects.requireNonNull( aProject, <span class="jxr_string">"aProject cannot be null"</span> );
-<a class="jxr_linenumber" name="L506" href="#L506">506</a>         Objects.requireNonNull( reactorProjects, <span class="jxr_string">"reactorProjects cannot be null"</span> );
-<a class="jxr_linenumber" name="L507" href="#L507">507</a>         Objects.requireNonNull( localRepository, <span class="jxr_string">"localRepository cannot be null"</span> );
-<a class="jxr_linenumber" name="L508" href="#L508">508</a> 
-<a class="jxr_linenumber" name="L509" href="#L509">509</a>         <strong class="jxr_keyword">return</strong> aProject.getParent();
+<a class="jxr_linenumber" name="L501" href="#L501">501</a>         <strong class="jxr_keyword">try</strong>
+<a class="jxr_linenumber" name="L502" href="#L502">502</a>         {
+<a class="jxr_linenumber" name="L503" href="#L503">503</a>             <em class="jxr_comment">// FIXME: this does not escape xml entities, see MSITE-226, PLXCOMP-118</em>
+<a class="jxr_linenumber" name="L504" href="#L504">504</a>             <strong class="jxr_keyword">return</strong> interpolator.interpolate( siteDescriptorContent );
+<a class="jxr_linenumber" name="L505" href="#L505">505</a>         }
+<a class="jxr_linenumber" name="L506" href="#L506">506</a>         <strong class="jxr_keyword">catch</strong> ( InterpolationException e )
+<a class="jxr_linenumber" name="L507" href="#L507">507</a>         {
+<a class="jxr_linenumber" name="L508" href="#L508">508</a>             <strong class="jxr_keyword">throw</strong> <strong class="jxr_keyword">new</strong> <a name="SiteToolException" href="../../../../../org/apache/maven/doxia/tools/SiteToolException.html#SiteToolException">SiteToolException</a>( <span class="jxr_string">"Cannot interpolate site descriptor"</span>, e );
+<a class="jxr_linenumber" name="L509" href="#L509">509</a>         }
 <a class="jxr_linenumber" name="L510" href="#L510">510</a>     }
 <a class="jxr_linenumber" name="L511" href="#L511">511</a> 
-<a class="jxr_linenumber" name="L512" href="#L512">512</a>     <em class="jxr_javadoccomment">/**</em>
-<a class="jxr_linenumber" name="L513" href="#L513">513</a> <em class="jxr_javadoccomment">     * Populate the pre-defined &lt;code&gt;parent&lt;/code&gt; menu of the decoration model,</em>
-<a class="jxr_linenumber" name="L514" href="#L514">514</a> <em class="jxr_javadoccomment">     * if used through &lt;code&gt;&amp;lt;menu ref="parent"/&amp;gt;&lt;/code&gt;.</em>
-<a class="jxr_linenumber" name="L515" href="#L515">515</a> <em class="jxr_javadoccomment">     *</em>
-<a class="jxr_linenumber" name="L516" href="#L516">516</a> <em class="jxr_javadoccomment">     * @param decorationModel the Doxia Sitetools DecorationModel, not null.</em>
-<a class="jxr_linenumber" name="L517" href="#L517">517</a> <em class="jxr_javadoccomment">     * @param locale the locale used for the i18n in DecorationModel. If null, using the default locale in the jvm.</em>
-<a class="jxr_linenumber" name="L518" href="#L518">518</a> <em class="jxr_javadoccomment">     * @param project a Maven project, not null.</em>
-<a class="jxr_linenumber" name="L519" href="#L519">519</a> <em class="jxr_javadoccomment">     * @param parentProject a Maven parent project, not null.</em>
-<a class="jxr_linenumber" name="L520" href="#L520">520</a> <em class="jxr_javadoccomment">     * @param keepInheritedRefs used for inherited references.</em>
-<a class="jxr_linenumber" name="L521" href="#L521">521</a> <em class="jxr_javadoccomment">     */</em>
-<a class="jxr_linenumber" name="L522" href="#L522">522</a>     <strong class="jxr_keyword">private</strong> <strong class="jxr_keyword">void</strong> populateParentMenu( <a name="DecorationModel" href="../../../../../org/apache/maven/doxia/site/decoration/DecorationModel.html#DecorationModel">DecorationModel</a> decorationModel, Locale locale, MavenProject project,
-<a class="jxr_linenumber" name="L523" href="#L523">523</a>                                     MavenProject parentProject, <strong class="jxr_keyword">boolean</strong> keepInheritedRefs )
-<a class="jxr_linenumber" name="L524" href="#L524">524</a>     {
-<a class="jxr_linenumber" name="L525" href="#L525">525</a>         Objects.requireNonNull( decorationModel, <span class="jxr_string">"decorationModel cannot be null"</span> );
-<a class="jxr_linenumber" name="L526" href="#L526">526</a>         Objects.requireNonNull( project, <span class="jxr_string">"project cannot be null"</span> );
-<a class="jxr_linenumber" name="L527" href="#L527">527</a>         Objects.requireNonNull( parentProject, <span class="jxr_string">"parentProject cannot be null"</span> );
-<a class="jxr_linenumber" name="L528" href="#L528">528</a> 
-<a class="jxr_linenumber" name="L529" href="#L529">529</a>         <a name="Menu" href="../../../../../org/apache/maven/doxia/site/decoration/Menu.html#Menu">Menu</a> menu = decorationModel.getMenuRef( <span class="jxr_string">"parent"</span> );
-<a class="jxr_linenumber" name="L530" href="#L530">530</a> 
-<a class="jxr_linenumber" name="L531" href="#L531">531</a>         <strong class="jxr_keyword">if</strong> ( menu == <strong class="jxr_keyword">null</strong> )
-<a class="jxr_linenumber" name="L532" href="#L532">532</a>         {
-<a class="jxr_linenumber" name="L533" href="#L533">533</a>             <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="L534" href="#L534">534</a>         }
-<a class="jxr_linenumber" name="L535" href="#L535">535</a> 
-<a class="jxr_linenumber" name="L536" href="#L536">536</a>         <strong class="jxr_keyword">if</strong> ( keepInheritedRefs &amp;&amp; menu.isInheritAsRef() )
-<a class="jxr_linenumber" name="L537" href="#L537">537</a>         {
-<a class="jxr_linenumber" name="L538" href="#L538">538</a>             <strong class="jxr_keyword">return</strong>;
-<a class="jxr_linenumber" name="L539" href="#L539">539</a>         }
+<a class="jxr_linenumber" name="L512" href="#L512">512</a>     <em class="jxr_javadoccomment">/** {@inheritDoc} */</em>
+<a class="jxr_linenumber" name="L513" href="#L513">513</a>     <strong class="jxr_keyword">public</strong> MavenProject getParentProject( MavenProject aProject, List&lt;MavenProject&gt; reactorProjects,
+<a class="jxr_linenumber" name="L514" href="#L514">514</a>                                           ArtifactRepository localRepository )
+<a class="jxr_linenumber" name="L515" href="#L515">515</a>     {
+<a class="jxr_linenumber" name="L516" href="#L516">516</a>         Objects.requireNonNull( aProject, <span class="jxr_string">"aProject cannot be null"</span> );
+<a class="jxr_linenumber" name="L517" href="#L517">517</a>         Objects.requireNonNull( reactorProjects, <span class="jxr_string">"reactorProjects cannot be null"</span> );

[... 1747 lines stripped ...]