You are viewing a plain text version of this content. The canonical link for it is here.
Posted to nmaven-commits@incubator.apache.org by si...@apache.org on 2008/01/24 20:16:43 UTC
svn commit: r614971 - in /incubator/nmaven/trunk/site: general/
general/src/site/apt/ versioned/ versioned/src/site/ versioned/src/site/apt/
Author: sisbell
Date: Thu Jan 24 12:16:40 2008
New Revision: 614971
URL: http://svn.apache.org/viewvc?rev=614971&view=rev
Log:
Updated site docs.
Added:
incubator/nmaven/trunk/site/versioned/src/site/apt/getting-started.apt
Removed:
incubator/nmaven/trunk/site/versioned/src/site/apt/getting-started
Modified:
incubator/nmaven/trunk/site/general/pom.xml
incubator/nmaven/trunk/site/general/src/site/apt/index.apt
incubator/nmaven/trunk/site/versioned/pom.xml
incubator/nmaven/trunk/site/versioned/src/site/apt/features.apt
incubator/nmaven/trunk/site/versioned/src/site/site.xml
Modified: incubator/nmaven/trunk/site/general/pom.xml
URL: http://svn.apache.org/viewvc/incubator/nmaven/trunk/site/general/pom.xml?rev=614971&r1=614970&r2=614971&view=diff
==============================================================================
--- incubator/nmaven/trunk/site/general/pom.xml (original)
+++ incubator/nmaven/trunk/site/general/pom.xml Thu Jan 24 12:16:40 2008
@@ -22,7 +22,7 @@
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<parent>
<groupId>org.apache.maven.dotnet</groupId>
- <artifactId>maven-dotnet-parent</artifactId>
+ <artifactId>maven-site</artifactId>
<version>0.15-incubating-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
@@ -30,7 +30,7 @@
<artifactId>maven-site-general</artifactId>
<packaging>pom</packaging>
<version>0.15-incubating-SNAPSHOT</version>
- <name>NMaven Site General</name>
+ <name>Apache NMaven</name>
<distributionManagement>
<site>
<id>nmaven-apache-site</id>
Modified: incubator/nmaven/trunk/site/general/src/site/apt/index.apt
URL: http://svn.apache.org/viewvc/incubator/nmaven/trunk/site/general/src/site/apt/index.apt?rev=614971&r1=614970&r2=614971&view=diff
==============================================================================
--- incubator/nmaven/trunk/site/general/src/site/apt/index.apt (original)
+++ incubator/nmaven/trunk/site/general/src/site/apt/index.apt Thu Jan 24 12:16:40 2008
@@ -15,7 +15,7 @@
All information contained within this web-site is based on the latest work at
the {{{https://svn.apache.org/repos/asf/incubator/nmaven/trunk} SVN trunk }}
- Older documentation can be found here:
+ Documentation can be found here:
* {{{http://incubator.apache.org/nmaven/0.15} 0.15 (Current trunk)}}
Modified: incubator/nmaven/trunk/site/versioned/pom.xml
URL: http://svn.apache.org/viewvc/incubator/nmaven/trunk/site/versioned/pom.xml?rev=614971&r1=614970&r2=614971&view=diff
==============================================================================
--- incubator/nmaven/trunk/site/versioned/pom.xml (original)
+++ incubator/nmaven/trunk/site/versioned/pom.xml Thu Jan 24 12:16:40 2008
@@ -22,7 +22,7 @@
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
<parent>
<groupId>org.apache.maven.dotnet</groupId>
- <artifactId>maven-dotnet-parent</artifactId>
+ <artifactId>maven-site</artifactId>
<version>0.15-incubating-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
@@ -30,7 +30,7 @@
<artifactId>maven-site-versioned</artifactId>
<packaging>pom</packaging>
<version>0.15-incubating-SNAPSHOT</version>
- <name>NMaven Site Versioned</name>
+ <name>Apache NMaven 0.15</name>
<distributionManagement>
<site>
<id>nmaven-apache-site</id>
Modified: incubator/nmaven/trunk/site/versioned/src/site/apt/features.apt
URL: http://svn.apache.org/viewvc/incubator/nmaven/trunk/site/versioned/src/site/apt/features.apt?rev=614971&r1=614970&r2=614971&view=diff
==============================================================================
--- incubator/nmaven/trunk/site/versioned/src/site/apt/features.apt (original)
+++ incubator/nmaven/trunk/site/versioned/src/site/apt/features.apt Thu Jan 24 12:16:40 2008
@@ -8,3 +8,15 @@
* Framework Version Support: Microsoft - 1.1/2.0; Mono 2.0
+* Compatible with Standard Maven Plugins/Functionality
+
+ * Resolving from remote repository
+
+ * Snapshot support
+
+ * Deploying artifacts
+
+ * Artifact dependency scope
+
+
+
Added: incubator/nmaven/trunk/site/versioned/src/site/apt/getting-started.apt
URL: http://svn.apache.org/viewvc/incubator/nmaven/trunk/site/versioned/src/site/apt/getting-started.apt?rev=614971&view=auto
==============================================================================
--- incubator/nmaven/trunk/site/versioned/src/site/apt/getting-started.apt (added)
+++ incubator/nmaven/trunk/site/versioned/src/site/apt/getting-started.apt Thu Jan 24 12:16:40 2008
@@ -0,0 +1,223 @@
+Getting Started
+
+Sections
+
+ * {{{getting-started.html#Building NMaven}Building NMaven}}
+
+ * {{{getting-started.html#Signing Assemblies}Signing Assemblies}}
+
+ * {{{getting-started.html#Assembly Info}Assembly Info}}
+
+ * {{{getting-started.html#Compiling Projects} Compiling Projects}}
+
+ * {{{getting-started.html#Project Dependencies} Project Dependencies}}
+
+* {Building NMaven}
+
+** Prerequisites
+
+ Prior to building NMaven, make sure that you have the following installed on your system:
+
+ [[1]] {{{ http://java.sun.com/javase/downloads/index_jdk5.jsp} JDK 5.0 Update x}}
+
+ [[2]] For Microsoft builds you will need both {{{http://msdn2.microsoft.com/en-us/downloads/default.aspx} Microsoft .NET Framework}} (1.1+)
+ AND {{{http://msdn2.microsoft.com/en-us/downloads/default.aspx} NET Framework SDK}}. For Mono builds, you will need
+ {{{http://www.mono-project.com} Mono}} (1.2.3.1+).
+
+ [[3]] Subversion client 1.3+. Click here for
+ {{{ http://subversion.tigris.org/servlets/ProjectDocumentView?documentID=35379&showInfo=true} Windows Subversion Client}}.
+
+ [[4]] {{{http://maven.apache.org/download.html} Maven 2.0.7 or higher}}
+
+ You will need to make sure that you have both the SDK and the .NET framework locations within your path.
+ On Linux distributions, this should already be in your path. Typical locations for Microsoft include:
+
+ * install root: C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727
+
+ * SDK root: C:\Program Files\Microsoft.NET\SDK\v2.0\
+
+ []
+
+ On Windows, Mono looks something like:
+
+ * install/sdk path: C:\Program Files\Mono-1.2.3.1\bin
+
+** Build
+
+ To build NMaven:
+
+ [[1]] Do an SVN checkout
+
++----+
+ svn co https://svn.apache.org/repos/asf/incubator/nmaven/trunk nmaven
++----+
+
+ [[2]] Run
+
++----+
+ mvn install
++----+
+
+** Linux Specific Setup
+
+ Building on Linux, may take some extra steps. By default, on many Linux environments, the GNU Compiler for Java is already
+ installed. The current GNU version will not work with NMaven. To check which version the system uses, type "java -version"
+ on the command line. If you see something similar to the following, you will need to take additional steps to get the
+ build setup:
+
++----+
+
+java version "1.4.2"
+gij (GNU libgcj) version 4.1.1 20060525 (Red Hat 4.1.1-1)
++----+
+
+ Create a file "/etc/profile.d/java.sh" with the following entries:
+
++----+
+
+ export JAVA_HOME=/usr/java/jdk1.5.0_09
+ export PATH=$JAVA_HOME/bin:$PATH
++----+
+
+ Type "mvn -version" from the command line. You should see the following:
+
++----+
+
+java version "1.5.0_09"
+Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_09-b01)
+Java HotSpot(TM) Client VM (build 1.5.0_09-b01, mixed mode, sharing)
++----+
+
+ 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}}. Make sure to su to root before installing with these
+ instructions!
+
+* {Signing Assemblies}
+
+ To create a key
+
++----+
+ sn -k sgKey.snk
++----+
+
+ NMaven supports compile-time signing of assemblies. You can sign assemblies by using the keyfile field in the
+ maven-compiler-plugin.
+
++----+
+ <build>
+ <sourceDirectory>src/main/csharp</sourceDirectory>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.dotnet.plugins</groupId>
+ <artifactId>maven-compiler-plugin</artifactId>
+ <extensions>true</extensions>
+ <configuration>
+ <keyfile>sgKey.snk/keyfile>
+ </configuration>
+ </plugin>
+ </plugins>
+ </build>
++----+
+
+ Key signing is currently only supported for .NET framework 2.0.
+
+
+* {Assembly Info}
+
+ Provided that you do not have your own AssemblyInfo class in your project, NMaven will automatically generate
+ an AssemblyInfo.* for you. It does the following mapping:
+
+*-------------------------+--------------------------------------------+
+| AssemblyDescription | $\{project.description\} |
+*-------------------------+--------------------------------------------+
+| AssemblyVersion | $\{project.version\} |
+*-------------------------+--------------------------------------------+
+| AssemblyTitle | $\{project.name\} |
+*-------------------------+--------------------------------------------+
+| AssemblyCompany | $\{project.organization.name\} |
+*-------------------------+--------------------------------------------+
+| AssemblyProduct | $\{project.organization.name\}-$\{project.name\} |
+*-------------------------+--------------------------------------------+
+| AssemblyCopyright | place a COPYRIGHT.txt file in your module directory and NMaven will pick it up and put it in the assembly |
+*-------------------------+--------------------------------------------+
+
+ Since the pom version is mapped to the assembly manifest, you MUST follow the 0.0.0.0 version convention or the build
+ will fail. You may, however, optionally add additional tags after the 0.0.0.0 version, such as -SNAPSHOT, alpha, etc.
+ Valid versions would include 1.3.4 or 1.2-SNAPSHOT or 1.2-RC1.
+
+* {Compiling Projects}
+
+ NMaven supports compiling of exe, winexe, library, and netmodule projects.
+
+*-------------------------+--------------------------------------------+
+| <<Target Type>> | <<Packaging>> |
+*-------------------------+--------------------------------------------+
+| exe | dotnet:exe |
+*-------------------------+--------------------------------------------+
+| winexe | dotnet:winexe |
+*-------------------------+--------------------------------------------+
+| library | dotnet:library |
+*-------------------------+--------------------------------------------+
+| netmodule | dotnet:module |
+*-------------------------+--------------------------------------------+
+
+ For example, the pom for compiling a library would look like:
+
++----+
+<?xml version="1.0" encoding="UTF-8"?>
+
+<project>
+ <modelVersion>4.0.0</modelVersion>
+ <groupId>NMaven.Its</groupId>
+ <artifactId>NMaven.It.It0000</artifactId>
+ <packaging>dotnet:library</packaging>
+ <version>1.0.0</version>
+ <name>NMaven.It.It0000</name>
+ <build>
+ <sourceDirectory>.</sourceDirectory>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.dotnet.plugins</groupId>
+ <artifactId>maven-compiler-plugin</artifactId>
+ <extensions>true</extensions>
+ </plugin>
+ </plugins>
+ </build>
+</project>
++----+
+
+* {Project Dependencies}
+
+ To use a gac dependency, you will need to set a GAC_ROOT environment variable to point to either the Microsoft or Mono
+ GAC root location. Then use the system scope as shown below. You can also use types: dotnet:gac_32 and dotnet:gac.
+
++----+
+<dependency>
+ <groupId>System.Windows.Forms</groupId>
+ <artifactId>System.Windows.Forms</artifactId>
+ <version>2.0.0.0</version>
+ <type>dotnet:gac_msil</type>
+ <scope>system</scope>
+ <classifier>b77a5c561934e089</classifier>
+ <systemPath>
+ ${env.GAC_ROOT}\GAC_MSIL\System.Windows.Forms\2.0.0.0__b77a5c561934e089\System.Windows.Forms.dll
+ </systemPath>
+</dependency>
++----+
+
+ A typical dependency would look like.
+
++----+
+ <dependencies>
+ <dependency>
+ <groupId>NMaven.Its</groupId>
+ <artifactId>NMaven.It.It0004</artifactId>
+ <version>1.0.0</version>
+ <type>dotnet:library</type>
+ </dependency>
+ </dependencies>
++----+
+
+ dotnet:winexe and dotnet:exe can also be used as dependency types. dotnet:module can also be used but will not be transitive.
Modified: incubator/nmaven/trunk/site/versioned/src/site/site.xml
URL: http://svn.apache.org/viewvc/incubator/nmaven/trunk/site/versioned/src/site/site.xml?rev=614971&r1=614970&r2=614971&view=diff
==============================================================================
--- incubator/nmaven/trunk/site/versioned/src/site/site.xml (original)
+++ incubator/nmaven/trunk/site/versioned/src/site/site.xml Thu Jan 24 12:16:40 2008
@@ -13,6 +13,8 @@
</links>
<menu name="General Info">
<item name="About" href="index.html"/>
+ <item name="Features" href="features.html"/>
+ <item name="Getting Started" href="getting-started.html"/>
</menu>
${reports}
</body>