incubator-nmaven-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sisb...@apache.org
Subject svn commit: r614971 - in /incubator/nmaven/trunk/site: general/ general/src/site/apt/ versioned/ versioned/src/site/ versioned/src/site/apt/
Date Thu, 24 Jan 2008 20:16:43 GMT
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>



Mime
View raw message