brett       2004/09/22 04:49:54

  Modified:    src/test/touchstone-build maven.xml
               xdocs    changes.xml navigation-pdf.xml navigation.xml
  Added:       xdocs    backwards-compatibility.xml
  Removed:     xdocs    cvs-status.xml status.xml
  Log:
  documentation updates
  
  Revision  Changes    Path
  1.51      +1 -3      maven/src/test/touchstone-build/maven.xml
  
  Index: maven.xml
  ===================================================================
  RCS file: /home/cvs/maven/src/test/touchstone-build/maven.xml,v
  retrieving revision 1.50
  retrieving revision 1.51
  diff -u -r1.50 -r1.51
  --- maven.xml 21 Sep 2004 13:46:01 -0000      1.50
  +++ maven.xml 22 Sep 2004 11:49:53 -0000      1.51
  @@ -804,12 +804,10 @@
         <ant:fail>path = ${jarPath}, expected ${jarRepoPath}</ant:fail>
       </j:if>
     
  -    <u:replace oldChar="\" newChar="/" var="warPath" 
value="${pom.getDependencyPath('touchstone:test')}" />
  +    <u:replace oldChar="\" newChar="/" var="warPath" 
value="${pom.getDependencyPath('touchstone:test:war')}" />
       <u:replace oldChar="\" newChar="/" var="warRepoPath" 
value="${maven.repo.local}/touchstone/wars/test-SNAPSHOT.war" />
       <j:if test="${warPath != warRepoPath}">
  -<!-- TODO: restore
         <ant:fail>path = ${warPath}, expected ${warRepoPath}</ant:fail>
  --->
       </j:if>
     </goal>
   
  
  
  
  1.27      +4 -19     maven/xdocs/changes.xml
  
  Index: changes.xml
  ===================================================================
  RCS file: /home/cvs/maven/xdocs/changes.xml,v
  retrieving revision 1.26
  retrieving revision 1.27
  diff -u -r1.26 -r1.27
  --- changes.xml       23 Jul 2004 04:52:09 -0000      1.26
  +++ changes.xml       22 Sep 2004 11:49:54 -0000      1.27
  @@ -26,26 +26,11 @@
     <body>
   
       <release version="1.1-SNAPSHOT" date="in CVS HEAD">
  -      <action dev="vmassol" type="remove">
  -             Removed <code>&lt;id&gt;</code> element from POM version 4.
  -             <code>&lt;artifactId&gt;</code> must now be used.
  +      <action dev="brett" type="update" issue="MAVEN-1400"> <!-- TODO: check issues 
# -->
  +        Updated to more recent releases of Jelly, its tag libraries and JEXL.
         </action>
  -      <action dev="vmassol" type="update">
  -             Made <code>&lt;groupId&gt;</code> element mandatory in POM version 4.
  -             It was optional in POM version 3.
  -      </action>
  -      <action dev="vmassol" type="add">
  -             Added new mandatory <code>&lt;type&gt;</code> element in POM version 4.
  -      </action>
  -      <action dev="vmassol" type="remove">
  -             Removed <code>&lt;versions&gt;</code>/<code>&lt;version&gt;</code> 
  -             element from POM version 4. It was conflicting with new 
  -             <code>&lt;version&gt;</code> element.
  -      </action>
  -      <action dev="vmassol" type="add">
  -        Deprecated <code>&lt;currentVersion&gt;</code> element. It is now 
  -        replaced by the <code>&lt;version&gt;</code> element. Created new 
  -        version 4 of the POM and added support for several POM versions.
  +      <action dev="brett" type="update" issue="MAVEN-1038"> <!-- TODO: check issues 
# -->
  +        Replaced project classes with new generated model code.
         </action>
       </release>
   
  
  
  
  1.10      +1 -1      maven/xdocs/navigation-pdf.xml
  
  Index: navigation-pdf.xml
  ===================================================================
  RCS file: /home/cvs/maven/xdocs/navigation-pdf.xml,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- navigation-pdf.xml        24 Jul 2004 17:03:48 -0000      1.9
  +++ navigation-pdf.xml        22 Sep 2004 11:49:54 -0000      1.10
  @@ -23,7 +23,6 @@
           <menu name="Overview">
               <item name="Goals" href="/goals.html"/>
               <item name="Features" href="/features.html"/>
  -            <item name="News and Status" href="/status.html"/>
               <item name="Changes" href="/changes-report.html"/>            
               <item name="Mailing Lists" href="/mail-lists.html"/>
               <item name="Source" href="/cvs-usage.html"/>
  @@ -35,6 +34,7 @@
               <item name="Integrate" href="/start/integrate.html"/>
               <item name="Use" href="/start/use.html"/>
               <item name="Release Notes" href="/start/release-notes-1.0.html"/>
  +            <item name="Backwards Compatibility" 
href="/start/backwards-compatibility.html"/>
               <item name="Build" href="/start/bootstrap.html"/>
               <item name="Anakia Users" href="/start/anakia.html"/>
           </menu>
  
  
  
  1.46      +1 -1      maven/xdocs/navigation.xml
  
  Index: navigation.xml
  ===================================================================
  RCS file: /home/cvs/maven/xdocs/navigation.xml,v
  retrieving revision 1.45
  retrieving revision 1.46
  diff -u -r1.45 -r1.46
  --- navigation.xml    24 Jul 2004 17:03:48 -0000      1.45
  +++ navigation.xml    22 Sep 2004 11:49:54 -0000      1.46
  @@ -38,13 +38,13 @@
      <menu name="Overview">
         <item name="Goals"                   href="/goals.html"/>
         <item name="Features"                href="/features.html"/>
  -      <item name="News and Status"         href="/status.html"/>
         <item name="Getting Started"         href="/start/index.html" collapse="true">
           <item name="Download"              href="/start/download.html"/>
           <item name="Install"               href="/start/install.html"/>
           <item name="Integrate"             href="/start/integrate.html"/>
           <item name="Use"                   href="/start/use.html"/>
           <item name="Release Notes"         href="/start/release-notes-1.0.html"/>
  +        <item name="Backwards Compatibility" 
href="/start/backwards-compatibility.html"/>
           <item name="Build"                 href="/start/bootstrap.html"/>
           <item name="Anakia Users"          href="/start/anakia.html"/>
         </item>
  
  
  
  1.1                  maven/xdocs/backwards-compatibility.xml
  
  Index: backwards-compatibility.xml
  ===================================================================
  <?xml version="1.0"?>
  <!-- 
  /*
   * Copyright 2001-2004 The Apache Software Foundation.
   * 
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   * 
   *      http://www.apache.org/licenses/LICENSE-2.0
   * 
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
   -->
  
  <document>
  
    <properties>
      <author email="[EMAIL PROTECTED]">Brett Porter</author>
      <title>Backwards Compatibility Issues</title>
    </properties>
  
    <body>
      <section name="Backwards Compatibility Issues">
        <p>
          This page details some of the backwards compatibility issues that you
          might encounter upgrading between Maven versions, and how to update your
          project.
        </p>
        <subsection name="Changes Between Maven 1.0 and Maven 1.1">
          <p>
            <b>Upgrading <code>maven.jar</code></b>
          </p>
          <p>
            If you are directly importing and using classes from this package, you may 
find classes
            from the <code>org.apache.maven.project</code> package are missing as they 
have moved.
            This may also apply if you are using <code>maven-jelly-tags</code>.
          </p>
          <p>
            <b>Fix:</b> Include <code>maven-model-1.1</code> in your project's 
dependencies.
          </p>
          <p>
            <b>Use of static helpers in 
<code>org.apache.maven.project.Repository</code></b>
          </p>
          <p>
            The <code>Repository</code> class now houses only the information from the 
project model.
            You may find that methods such as <code>splitSCMConnection</code> and 
<code>tokenizerToArray</code>
            are missing.
          </p>
          <p>
            <b>Fix:</b> These functions have been moved to 
<code>org.apache.maven.project.RepositoryUtils</code>.
            Please update your code accordingly. <b>Note: </b> These may be moved to 
maven-scm in the near future
            before 1.1 final.
          </p>
          <p>
            <b>Use of <code>Project.getDependencyPath</code> and 
<code>Project.getDependency</code></b>
          </p>
          <p>
            If you have a single non-JAR artifact that you resolve using this 
function, it will no longer be
            found.
          </p>
          <p>
            <b>Fix:</b> Specify the type in the argument. The full form is
            <code>getDependency('groupId:artifactId:type')</code>. Type is defaulted 
to <code>jar</code>.
          </p>
          <p>
            <b>Parse errors on previously 'valid' project files</b>
          </p>
          <p>
            <code>project.xml</code> files that used to work in older versions of 
Maven may now present parse
            errors. The parser in Maven 1.1 is much less tolerant of invalid 
<code>project.xml</code> files
            to avoid silently masking syntax errors.
          </p>
          <p>
            <b>Fix:</b> Check your project file against the XSD published for the 
model version you are using.
          </p>
        </subsection>
      </section>
    </body>
  </document>
  
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to