incubator-nmaven-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sisb...@apache.org
Subject svn commit: r539916 - in /incubator/nmaven/trunk/site/src/site/apt: adding-plugins.apt environment-configuration.apt features.apt getting-started.apt index.apt net-plugins.apt
Date Sun, 20 May 2007 19:32:27 GMT
Author: sisbell
Date: Sun May 20 12:32:26 2007
New Revision: 539916

URL: http://svn.apache.org/viewvc?view=rev&rev=539916
Log:
Updated site docs.

Modified:
    incubator/nmaven/trunk/site/src/site/apt/adding-plugins.apt
    incubator/nmaven/trunk/site/src/site/apt/environment-configuration.apt
    incubator/nmaven/trunk/site/src/site/apt/features.apt
    incubator/nmaven/trunk/site/src/site/apt/getting-started.apt
    incubator/nmaven/trunk/site/src/site/apt/index.apt
    incubator/nmaven/trunk/site/src/site/apt/net-plugins.apt

Modified: incubator/nmaven/trunk/site/src/site/apt/adding-plugins.apt
URL: http://svn.apache.org/viewvc/incubator/nmaven/trunk/site/src/site/apt/adding-plugins.apt?view=diff&rev=539916&r1=539915&r2=539916
==============================================================================
--- incubator/nmaven/trunk/site/src/site/apt/adding-plugins.apt (original)
+++ incubator/nmaven/trunk/site/src/site/apt/adding-plugins.apt Sun May 20 12:32:26 2007
@@ -11,7 +11,7 @@
 
  Of course, if your compiler does not work with the <<<org.apache.maven.dotnet.executable.compiler.impl.DefaultCompiler>>>,
you will also need to
  create your own implementation of <<<org.apache.maven.dotnet.executable.compiler.CompilerExecutable>>>
and add the
- fully-qualified class name implementation to the pluginClass tag.
+ fully-qualified class name implementation to the <<pluginClass>> tag.
 
 * compiler-plugins.xml
 

Modified: incubator/nmaven/trunk/site/src/site/apt/environment-configuration.apt
URL: http://svn.apache.org/viewvc/incubator/nmaven/trunk/site/src/site/apt/environment-configuration.apt?view=diff&rev=539916&r1=539915&r2=539916
==============================================================================
--- incubator/nmaven/trunk/site/src/site/apt/environment-configuration.apt (original)
+++ incubator/nmaven/trunk/site/src/site/apt/environment-configuration.apt Sun May 20 12:32:26
2007
@@ -163,6 +163,9 @@
 
  The <<<CompilerExecutable>>> is returned to the <<<CompilerMojo>>>
(16, 17, 18), which then executes the Compiler (19).
 
+ For those curious enough, if you add the -X full debug output flag, say "mvn install -X",
you will see NMaven write out the states it goes through
+ in choosing the vendor info.
+
 {Sample Configuration Files}
 
 * CSharp2.0:exe:Microsoft

Modified: incubator/nmaven/trunk/site/src/site/apt/features.apt
URL: http://svn.apache.org/viewvc/incubator/nmaven/trunk/site/src/site/apt/features.apt?view=diff&rev=539916&r1=539915&r2=539916
==============================================================================
--- incubator/nmaven/trunk/site/src/site/apt/features.apt (original)
+++ incubator/nmaven/trunk/site/src/site/apt/features.apt Sun May 20 12:32:26 2007
@@ -1,4 +1,6 @@
-Features
+Key Features
+
+* Platforms
 
  * Mono Support: C#, Nemerle, PHP
 
@@ -8,9 +10,13 @@
 
  * Multiple Framework Version Support: 1.1, 2.0, 3.0
 
- * NUnit support
+ * Pluggable architecture for adding new compilers and executables.
+
+ * nmaven-settings file for selecting the environment (MONO/MS/GNU, vendor/framework version,
install location, etc)
 
- * Writing Maven Plugins in .NET
+* Other
+
+ * NUnit support
 
  * Resource generation and embedding
 
@@ -18,8 +24,12 @@
 
  * XSD and WSDL Generation
 
- * Pluggable architecture for adding new compilers and executables.
+ * Assembly Signing
+ 
+* Cool New Features
 
- * nmaven-settings file for selecting the environment (MONO/MS/GNU, vendor/framework version,
install location, etc)
+ * Writing Maven Plugins in .NET (Microsoft Only)
+
+ * Experimental IDE Support (VS2005, #develop)
 
- * Assembly Signing
\ No newline at end of file
+ * Deploying and Retrieving of .NET Artifacts from a Remote Repository
\ No newline at end of file

Modified: incubator/nmaven/trunk/site/src/site/apt/getting-started.apt
URL: http://svn.apache.org/viewvc/incubator/nmaven/trunk/site/src/site/apt/getting-started.apt?view=diff&rev=539916&r1=539915&r2=539916
==============================================================================
--- incubator/nmaven/trunk/site/src/site/apt/getting-started.apt (original)
+++ incubator/nmaven/trunk/site/src/site/apt/getting-started.apt Sun May 20 12:32:26 2007
@@ -29,7 +29,7 @@
   [[1]] {{{ http://java.sun.com/javase/downloads/index_jdk5.jsp} JDK 5.0 Update x}}
 
   [[2]] {{{http://msdn2.microsoft.com/en-us/netframework/default.aspx} Microsoft .NET Framework}}
(2.0+)
-  OR {{{http://www.mono-project.com} Mono}} (1.1.13+ for Windows and 1.1.18+ for Linux).
Note that the 2.0+ framework
+  OR {{{http://www.mono-project.com} Mono}} (1.2.3.1+). Note that the 2.0+ framework
   (either MONO or Microsoft) is required to run NMaven but you can still target 1.1 for your
builds provided that the 1.1 version
   is installed.
 
@@ -38,23 +38,47 @@
 
   [[4]] {{{http://nunit.org/index.php?p=download} NUnit 2.2+}}.
 
-  [[5]] {{{http://maven.apache.org/download.html} Maven 2.0.5 or higher}}
+  [[5]] {{{http://maven.apache.org/download.html} Maven 2.0.4 or higher}}
 
   [[]]
 
-  If you are planning on using NMaven with Visual Studio 2005 you will also need VS installed
-  prior to building NMaven. Since NMaven does not directly use any Sharp Develop APIs (yet),
you do not need Sharp Develop
-  installed prior to a build.
+  If you are planning on using NMaven with Visual Studio 2005, you will also need VS installed
+  prior to building NMaven.
 
 ** Bootstrap Build
 
   To build NMaven:
 
-  [[1]] Do an SVN checkout: svn co https://svn.apache.org/repos/asf/incubator/nmaven/trunk
nmaven.
+  [[1]] Do an SVN checkout
 
-  [[2]] If compiling on Windows:
+     [[a]] For the latest, unstable version:
 
-   [[a]] the csc executable directory should be located on the system path. This is only
needed for the initial bootstrap build
++----+
+svn co https://svn.apache.org/repos/asf/incubator/nmaven/trunk nmaven
++----+
+
+     [[b]] For a stable version:
+
++----+
+svn ls https://svn.apache.org/repos/asf/incubator/nmaven/tags
++----+
+
+      You will see something like:
+
++----+
+STABLE-2007-05-18/
+STABLE-2007-05-20/
++----+
+
+      Choose the latest stable date, which in this case is:
+
++----+
+svn co https://svn.apache.org/repos/asf/incubator/nmaven/tags/STABLE-2007-05-20 nmaven
++----+
+
+  [[2]] If compiling on Windows with either Microsoft or Mono:
+
+   [[a]] the csc (or gmcs) executable directory should be located on the system path. This
is only needed for the initial bootstrap build
    and may be removed afterwards.
 
    [[b]] the directory path containing nunit-console should also be located on the system
path. After the bootstrap build, you should leave
@@ -62,10 +86,10 @@
    {{{getting-started.html#Unit Testing with NUnit}Unit Testing with NUnit}}
 
    [[c]] If using Mono on Windows, both the csc executable and the nunit-console executable
are located within the same path:
-   typically something like "C:\Program Files\Mono-1.1.18\bin"
+   typically something like "C:\Program Files\Mono-1.2.3.1\bin"
 
   [[3]] Execute bootstrap-build.bat (or bootstrap-build.sh) from the nmaven directory. If
you want to compile with
-  Visual Studio 2005 support execute: bootstrap-build.bat -DVisualStudio2005
+  Visual Studio 2005 support (Windows only) execute: bootstrap-build.bat -DVisualStudio2005
 
  During step (1), you may receive an error similar to the following:
 
@@ -107,10 +131,11 @@
 Java HotSpot(TM) Client VM (build 1.5.0_09-b01, mixed mode, sharing)
 +----+
 
- On Linux, you also need Mono version 1.1.18 or higher. Type "mono -V" on the command line
to see what version you
- are running. If it is below 1.1.18, then download the latest mono version, unzip and run
rpm from the commandline.
+ On Linux, you also need Mono version 2.1.3.1 or higher. Type "mono -V" on the command line
to see what version you
+ are running. If it is below 2.1.3.1, then download the latest mono version, unzip and run
rpm from the commandline.
  Detailed instructions are located here:
- {{{ http://www.mono-project.com/Getting_Mono}Installing Mono}}
+ {{{ http://www.mono-project.com/Getting_Mono}Installing Mono}}. Make sure that su to root
before installing with these
+ instructions!
 
 * {Assembly Info}
 
@@ -137,6 +162,8 @@
  within the version will not be included within the file name, but rather is contained both
within the InformationalVersion attribute of the
  AssemblyInfo class and within the pom.xml file.
 
+ Due to a bug, SNAPSHOTS are only supported for C#: {{{http://jira.codehaus.org/browse/NMAVEN-62}
NMAVEN-62}}
+
 * {Unit Testing with NUnit}
 
  Add the NUnit dependency to your pom.xml (as shown below). You
@@ -238,7 +265,7 @@
 
 +----+
 
- You also have the option of changing changing the framework version by modifying the default
setup within the nmaven-settings.xml file. See
+ You also have the option of changing the framework version by modifying the default setup
within the nmaven-settings.xml file. See
  {{{getting-started.html#Using NMaven Settings File}Using NMaven Settings File}}.
 
  To disable the NUnit tests, add the system property -Dmaven.test.skip=true to the command
line. You can also disable
@@ -253,8 +280,8 @@
  ASPX files.
 
  You will only need to add the nmaven-webapp-plugin to the pom if you are planning on deploying
the web application. In
- that case, add the deployPath pom configuration as shown below. Type "mvn deploy" from the
command line and NMaven will
- copy the web application to the deployPath location.
+ that case, add the <<deployPath>> pom configuration as shown below. Type "mvn
deploy" from the command line and NMaven will
+ copy the web application to the <<deployPath>> location.
 
 +----+
 
@@ -273,7 +300,6 @@
             <version>2.0.0</version>
         </dependency>
     </dependencies>
-
     <build>
         <sourceDirectory>src/main/csharp</sourceDirectory>
         <testSourceDirectory>src/test/csharp</testSourceDirectory>
@@ -331,7 +357,8 @@
     </dependencies>
 +----+
 
- Note that there is no current support for the use of classifiers within NMaven.
+ Note that there is no current support for the use of classifiers within NMaven:
+ {{{http://jira.codehaus.org/browse/NMAVEN-2} NMAVEN-2}}
 
 * {Generating Resources}
 
@@ -384,6 +411,15 @@
  NMaven in determining the capabilities of the build platform and in choosing the correct
compiler and vendor for the
  build. By going into the defaultSetup tag, you can change which vendor and framework version
that NMaven will use
  without needing to specify this information within the various pom.xml files.
+
+ The nmaven-settings default values will be ignored if they are specified either through
the command line of the pom file.
+ The values that NMaven uses for building and testing, in order of priority, are
+
+  [[1]] commandline: -Dvendor, -DframeworkVersion, -DvendorVersion
+
+  [[2]] pom.xml file configuration of the compiler
+
+  [[3]] nmaven-settings.xml file
 
  In the case of Linux, there is no registry so the nmaven-settings.xml file is not automatically
generated. You may,
  however, create one by hand, allowing you to specify the location of DotGNU and Mono implementations.

Modified: incubator/nmaven/trunk/site/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/incubator/nmaven/trunk/site/src/site/apt/index.apt?view=diff&rev=539916&r1=539915&r2=539916
==============================================================================
--- incubator/nmaven/trunk/site/src/site/apt/index.apt (original)
+++ incubator/nmaven/trunk/site/src/site/apt/index.apt Sun May 20 12:32:26 2007
@@ -2,24 +2,28 @@
 
  NMaven provides Maven 2.x plugins to support building of .NET applications. NMaven is its
own framework
  that provides the correct .NET compiler based on the environment (vendor/language/operating
system).  This framework
- leverages Maven (and its plugin architecture) for the build
- lifecycle, making it a small, compiler-plugin-framework on top of the larger Maven build-framework.
+ leverages Maven for the build lifecycle, making it a small, compiler-plugin-framework on
top of the larger Maven build-framework.
+
+ NMaven originally started as a project on Sourceforge in September 2006. Over the course
of 2 months, it went 
+ through 13 small releases.
 
 Road Map
 
  The primary goal of NMaven is to provide a common Maven build environment across .NET compilers
(C#, VB),
  vendors (Microsoft, Novell, DotGNU) and platforms (Windows, Linux). Specific, near-term
goals include:
 
- * .NET Integration Test module
+ * Browse Maven repository and add/delete dependencies through IDE (VS2005/SharpDevelop)
+
+ * Write .NET Maven plugins with Mono (Similar to the one for Microsoft)
+
+ * Generate project templates through archetypes
 
- * Expanded Support for Assembly Signing
- 
- * Support for Classifiers
+ []
 
- * IDE Support: Visual Studio and SharpDevelop
+ Click here for a complete {{{http://docs.codehaus.org/display/MAVENUSER/Roadmap} Road Map
}}
 
 Reporting Bugs/Requesting Features
 
  * {{{http://jira.codehaus.org/browse/NMAVEN} NMaven Issue Tracking}}
 
- * {{{mailto:nmaven-dev@incubator.apache.org} Post to Mailing List}} 
\ No newline at end of file
+ * {{{mailto:nmaven-dev@incubator.apache.org} Post to Mailing List}}

Modified: incubator/nmaven/trunk/site/src/site/apt/net-plugins.apt
URL: http://svn.apache.org/viewvc/incubator/nmaven/trunk/site/src/site/apt/net-plugins.apt?view=diff&rev=539916&r1=539915&r2=539916
==============================================================================
--- incubator/nmaven/trunk/site/src/site/apt/net-plugins.apt (original)
+++ incubator/nmaven/trunk/site/src/site/apt/net-plugins.apt Sun May 20 12:32:26 2007
@@ -1,4 +1,4 @@
-Writing .NET Mojos
+Writing .NET Mojos (Microsoft Only)
 
  The first thing to do is to create an implementation of the NMaven.Plugin.AbstractMojo class.
You will need to become
  familiar with two attributes:



Mime
View raw message