maven-doxia-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jvan...@apache.org
Subject svn commit: r416972 [3/3] - in /maven/doxia/trunk: doxia-core/src/main/java/org/apache/maven/doxia/module/ doxia-modules/doxia-module-itext/ doxia-modules/doxia-module-itext/src/main/java/org/apache/maven/doxia/module/itext/ doxia-modules/doxia-module-...
Date Sat, 24 Jun 2006 23:41:41 GMT
Propchange: maven/doxia/trunk/doxia-modules/doxia-module-itext/src/test/resources/apt/itext.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: maven/doxia/trunk/doxia-modules/doxia-module-itext/src/test/resources/apt/itext.xml
------------------------------------------------------------------------------
    svn:keywords = "Author Date Id Revision"

Modified: maven/doxia/trunk/doxia-modules/doxia-module-itext/src/test/resources/apt/test.apt
URL: http://svn.apache.org/viewvc/maven/doxia/trunk/doxia-modules/doxia-module-itext/src/test/resources/apt/test.apt?rev=416972&r1=416971&r2=416972&view=diff
==============================================================================
--- maven/doxia/trunk/doxia-modules/doxia-module-itext/src/test/resources/apt/test.apt (original)
+++ maven/doxia/trunk/doxia-modules/doxia-module-itext/src/test/resources/apt/test.apt Sat
Jun 24 16:41:41 2006
@@ -173,35 +173,19 @@
  its life time and we are trying create tools to help normal people sort out licensing issues.
For example, knowing all the licenses
  for a particular graph of artifacts we could have some strategies that would identify potential
licensing problems.
 
-* Maven partners
+~~* Maven partners
 
- The following sites sync automatically their project repository with the central one.
- If you want a project from any of this sites to be uploaded to ibiblio you'll have to
- contact the project maintainers.
+~~ The following sites sync automatically their project repository with the central one.
+~~ If you want a project from any of this sites to be uploaded to ibiblio you'll have to
+~~ contact the project maintainers.
 
- * {{{http://www.apache.org}The Apache Software Foundation}}
+~~ * {{{http://www.apache.org}The Apache Software Foundation}}
 
- * {{{http://www.codehaus.org}Codehaus}}
+~~ * {{{http://www.codehaus.org}Codehaus}}
 
- * {{{http://jetty.mortbay.org}MortBay Jetty}}
+~~ * {{{http://jetty.mortbay.org}MortBay Jetty}}
 
- * {{{http://www.opensymphony.com/}OpenSymphony}}
+~~ * {{{http://www.opensymphony.com/}OpenSymphony}}
 
- * {{{http://www.osjava.org}OS Java}}
-
-
-*-------------------------+---------+----------+-----------+
-|                         | Mirrors | Checksum | Signature |
-*-------------------------+---------+----------+-----------+
-| Maven 2.0.3 (tar.bz2)     | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/maven-2.0.3-bin.tar.bz2}
maven-2.0.3-bin.tar.bz2}} | {{{http://www.apache.org/dist/maven/binaries/maven-2.0.3-bin.tar.bz2.md5}
maven-2.0.3-bin.tar.bz2.md5}} | {{{http://www.apache.org/dist/maven/binaries/maven-2.0.3-bin.tar.bz2.asc}
maven-2.0.3-bin.tar.bz2.asc}} |
-*-------------------------+---------+----------+-----------+
-| Maven 2.0.3 (tar.gz)      | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/maven-2.0.3-bin.tar.gz}
maven-2.0.3-bin.tar.gz}} | {{{http://www.apache.org/dist/maven/binaries/maven-2.0.3-bin.tar.gz.md5}
maven-2.0.3-bin.tar.gz.md5}} | {{{http://www.apache.org/dist/maven/binaries/maven-2.0.3-bin.tar.gz.asc}
maven-2.0.3-bin.tar.gz.asc}} |
-*-------------------------+---------+----------+-----------+
-| Maven 2.0.3 (zip)         | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/maven-2.0.3-bin.zip}
maven-2.0.3-bin.zip}} | {{{http://www.apache.org/dist/maven/binaries/maven-2.0.3-bin.zip.md5}
maven-2.0.3-bin.zip.md5}} | {{{http://www.apache.org/dist/maven/binaries/maven-2.0.3-bin.zip.asc}
maven-2.0.3-bin.zip.asc}} |
-*-------------------------+---------+----------+-----------+
-| Maven 2.0.3 Tasks for Ant | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/maven-artifact-ant-2.0.3-dep.jar}
maven-artifact-ant-2.0.3-dep.jar}} | {{{http://www.apache.org/dist/maven/binaries/maven-artifact-ant-2.0.3-dep.jar.md5}
maven-artifact-ant-2.0.3-dep.jar.md5}} | {{{http://www.apache.org/dist/maven/binaries/maven-artifact-ant-2.0.3-dep.jar.asc}
maven-artifact-ant-2.0.3-dep.jar.asc}} |
-*-------------------------+---------+----------+-----------+
-| Maven 2.0.3 Embedder | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/maven-embedder-2.0.3-dep.jar}
maven-embedder-2.0.3-dep.jar}} | {{{http://www.apache.org/dist/maven/binaries/maven-embedder-2.0.3-dep.jar.md5}
maven-embedder-2.0.3-dep.jar.md5}} | {{{http://www.apache.org/dist/maven/binaries/maven-embedder-2.0.3-dep.jar.asc}
maven-embedder-2.0.3-dep.jar.asc}} |
-*-------------------------+---------+----------+-----------+
-Table caption
+~~ * {{{http://www.osjava.org}OS Java}}
 

Added: maven/doxia/trunk/doxia-modules/doxia-module-itext/src/test/resources/apt/test.apt.org
URL: http://svn.apache.org/viewvc/maven/doxia/trunk/doxia-modules/doxia-module-itext/src/test/resources/apt/test.apt.org?rev=416972&view=auto
==============================================================================
--- maven/doxia/trunk/doxia-modules/doxia-module-itext/src/test/resources/apt/test.apt.org
(added)
+++ maven/doxia/trunk/doxia-modules/doxia-module-itext/src/test/resources/apt/test.apt.org
Sat Jun 24 16:41:41 2006
@@ -0,0 +1,207 @@
+ ------
+ Guide to uploading artifacts to Ibiblio
+ ------
+ Jason van Zyl
+ ------
+ 12 October 2005
+ ------
+
+Guide to uploading artifacts to Ibiblio
+
+ In order for users of Maven to utilize artifacts produced by your project you must deploy
them to
+ a remote repository. Many open source projects want to allow users of their projects who
build with
+ Maven to have transparent access to their project's artifacts. In order to allow for this
a project
+ must have their artifacts deployed the Ibiblio which acts as Maven's central global repostory.
+
+* Step 1: Create an upload bundle
+
+ Use the repository plugin provided with the standard Maven distribution to create an upload
bundle:
+
++----+
+
+ mvn repository:bundle-create
+
++----+
+
+ The bundle will be created in your <<<target>>> directory of the form:
+ <<<${pom.artifactId}-${pom.currentVersion}-bundle.jar>>>
+
+ If you want to include a jar with java sources in your upload (recommended, unless your
license doesn't
+ allow sources to be redistributed) the command to run is:
+
++----+
+
+ mvn source:jar repository:bundle-create
+
++----+
+
+ If you are not using maven as your build system but want something
+ uploaded to Ibiblio then you just need to make a JAR (using the <<<jar>>>
executable,
+ not <<<zip>>>, <<<pkzip>>> or equivalent) with the following
format:
+
++----+
+
+pom.xml
+foo-1.0.jar (or whatever artifact is referred to in the pom.xml)
+foo-1.0-sources.jar (optional, jar containing java sources)
+
++----+
+
+ Note that the bundle will be read by a script, so it must follow the above format. Also,
+ the <<<pom.xml>>> should at least contain the following elements:
+
+ * modelVersion
+
+ * groupId
+
+ * artifactId
+
+ * packaging
+
+ * name
+
+ * version
+
+ * url
+
+ * licenses
+
+ * scm url
+
+ * description
+
+ * dependencies
+
+
+ A basic sample:
+
++----+
+
+<project>
+  <modelVersion>4.0.0</modelVersion>
+  <groupId>org.apache.maven</groupId>
+  <artifactId>maven</artifactId>
+  <version>2.0</version>
+  <packaging>jar</packaging>
+  <name>Maven core</name>
+  <url>http://maven.apache.org</url>
+  <description>The maven main core project description</description>
+  <licenses>
+    <license>
+      <name>The Apache Software License, Version 2.0</name>
+      <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
+      <distribution>repo</distribution>
+    </license>
+  </licenses>
+  <scm>
+    <url>http://svn.apache.org/viewcvs.cgi/maven</url>
+  </scm>
+  <dependencies>
+    <dependency>
+      <groupId>...</groupId>
+      <artifactId>...</artifactId>
+      <version>...</version>
+    </dependency>
+    ...
+  </dependencies>
+</project>
+
++----+
+
+ []
+
+ Some considerations about the <<groupId>>: it will identify your project uniquely
across all
+ projects, so we need to enforce a naming schema. For projects with artifacts already uploaded
to ibiblio it can
+ be equal to the previous used, but for new projects it has to follow the package name rules,
what
+ means that has to be at least as a domain name you control, and you can create as many subgroups
+ as you want.
+ There are a lot of poorly defined package names so you have to provide proof that you control
the domain that
+ matches the package name. Provide proof means that the project is hosted at that domain
or they own it although
+ not using it. eg. If you use a com.sun.xyz package name we expect that the project is hosted
at http://xyz.sun.com.
+
+ Look at {{{http://java.sun.com/docs/books/jls/third_edition/html/packages.html#7.7}
+ More information about package names}}. Check also the guide about
+ {{{guide-naming-conventions.html}Maven naming conventions}}
+
+ Examples:
+
+ * www.springframework.org -> org.springframework
+
+ * oness.sf.net -> net.sf.oness
+
+ []
+
+* Step 2: Posting the request
+
+ Post your request to {{{http://jira.codehaus.org/secure/CreateIssue.jspa?pid=10367&amp;issuetype=3}JIRA}}.
+ In the description you should write the URL of the upload bundle
+ (if you're uploading more than one bundle please add all the urls under the same issue),
+ then leave a blank line and provide the following:
+
+ * a url where the project can be found.
+
+ * if you are one of its developers, a url where your name or email can be found inside the
project site.
+
+ []
+
+ This will speed up the uploading process.
+
+ You can place any additional comments you wish in the following paragraph. So the description
field might look like:
+
++----+
+
+http://wiggle.sourceforge.net/downloads/wiggle-1.0-bundle.jar
+
+http://wiggle.sourceforge.net
+http://wiggle.sourceforge.net/team-list.html
+
+Wiggle is a fantastic new piece of software for automating the
+clipping of nose hairs. Please upload!
+
++----+
+
+* Explanation
+
+ Some folks have asked why do we require the POM and license each time an artifact is deployed
so here's a small explanation. The POM
+ being deployed with the artifact is part of the process to make transitive dependencies
a reality in Maven. The logic for getting
+ transitive dependencies working is really not that hard, the problem is getting the data.
The other applications
+ that may be possible having all the POMs available for artifacts are vast, so by placing
them into the repository as part of the
+ process we open up the doors to new ideas that involve unified
+ access to project POMs.
+
+ We also ask for a license now because it is possible that your project's license may change
in the course of
+ its life time and we are trying create tools to help normal people sort out licensing issues.
For example, knowing all the licenses
+ for a particular graph of artifacts we could have some strategies that would identify potential
licensing problems.
+
+* Maven partners
+
+ The following sites sync automatically their project repository with the central one.
+ If you want a project from any of this sites to be uploaded to ibiblio you'll have to
+ contact the project maintainers.
+
+ * {{{http://www.apache.org}The Apache Software Foundation}}
+
+ * {{{http://www.codehaus.org}Codehaus}}
+
+ * {{{http://jetty.mortbay.org}MortBay Jetty}}
+
+ * {{{http://www.opensymphony.com/}OpenSymphony}}
+
+ * {{{http://www.osjava.org}OS Java}}
+
+
+*-------------------------+---------+----------+-----------+
+|                         | Mirrors | Checksum | Signature |
+*-------------------------+---------+----------+-----------+
+| Maven 2.0.3 (tar.bz2)     | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/maven-2.0.3-bin.tar.bz2}
maven-2.0.3-bin.tar.bz2}} | {{{http://www.apache.org/dist/maven/binaries/maven-2.0.3-bin.tar.bz2.md5}
maven-2.0.3-bin.tar.bz2.md5}} | {{{http://www.apache.org/dist/maven/binaries/maven-2.0.3-bin.tar.bz2.asc}
maven-2.0.3-bin.tar.bz2.asc}} |
+*-------------------------+---------+----------+-----------+
+| Maven 2.0.3 (tar.gz)      | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/maven-2.0.3-bin.tar.gz}
maven-2.0.3-bin.tar.gz}} | {{{http://www.apache.org/dist/maven/binaries/maven-2.0.3-bin.tar.gz.md5}
maven-2.0.3-bin.tar.gz.md5}} | {{{http://www.apache.org/dist/maven/binaries/maven-2.0.3-bin.tar.gz.asc}
maven-2.0.3-bin.tar.gz.asc}} |
+*-------------------------+---------+----------+-----------+
+| Maven 2.0.3 (zip)         | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/maven-2.0.3-bin.zip}
maven-2.0.3-bin.zip}} | {{{http://www.apache.org/dist/maven/binaries/maven-2.0.3-bin.zip.md5}
maven-2.0.3-bin.zip.md5}} | {{{http://www.apache.org/dist/maven/binaries/maven-2.0.3-bin.zip.asc}
maven-2.0.3-bin.zip.asc}} |
+*-------------------------+---------+----------+-----------+
+| Maven 2.0.3 Tasks for Ant | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/maven-artifact-ant-2.0.3-dep.jar}
maven-artifact-ant-2.0.3-dep.jar}} | {{{http://www.apache.org/dist/maven/binaries/maven-artifact-ant-2.0.3-dep.jar.md5}
maven-artifact-ant-2.0.3-dep.jar.md5}} | {{{http://www.apache.org/dist/maven/binaries/maven-artifact-ant-2.0.3-dep.jar.asc}
maven-artifact-ant-2.0.3-dep.jar.asc}} |
+*-------------------------+---------+----------+-----------+
+| Maven 2.0.3 Embedder | {{{http://www.apache.org/dyn/closer.cgi/maven/binaries/maven-embedder-2.0.3-dep.jar}
maven-embedder-2.0.3-dep.jar}} | {{{http://www.apache.org/dist/maven/binaries/maven-embedder-2.0.3-dep.jar.md5}
maven-embedder-2.0.3-dep.jar.md5}} | {{{http://www.apache.org/dist/maven/binaries/maven-embedder-2.0.3-dep.jar.asc}
maven-embedder-2.0.3-dep.jar.asc}} |
+*-------------------------+---------+----------+-----------+
+Table caption
+



Mime
View raw message