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&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 +