What do you want us to write next? We're wondering if, you, the reader, have any input into what you are looking for when it comes to Maven documentation. Are you looking for a more task-centric book like a Cookbook? Or, are you looking for longer tutorials? Please let me know, we're also interested in known what specific areas of Maven documentation you think could use more attention.
In section 16.4 of v0.14 of the book, I've found that the following confuses me:
* Section 16.4.1: The text "Once you've configured Nexus to be the mirror for all repositories, Maven will now consult the local installation of Nexus instead of going out to the central Maven repository." is confusing. When I first read it, I thought that it was directly related to example 16.1 which it isn't as in example 16.1 Nexus is only the mirror of central. Secondly, the part "instead of going out to the central Maven repository" is incorrect if we're talking about settings up a mirrors for ALL repositories. Thirdly, it's talking about configuring Nexus while the section is regarding how Maven should be configured to use Nexus as a mirror. Some kind of re-phrasing is needed.
* Section 16.4.1: "After you've run a few builds against your local Nexus installation, you can then start to browse the contents cached in your local instance of Maven." should most likely be changed to "...you can then start to browse the artifacts cached in Nexus.".
* Section 16.4.2: I guess that "...will allow you to use the Nexus public group which resolves artifacts from four repositories..." talks about the default configuration of Nexus as it might not be true for an altered configuration. Some remark regarding this would be good.
* The title of section 16.4 is "Configuring Maven to Use Nexus Repositories". However, sections 16.4.3 and especially 16.4.4 and 16.4.5 is regarding configuring repositories in Nexus. Either the title should be changed or the sections moved/rearranged.
4.12.2. Skipping Unit Tests
To skip tests from the command-line, simply add the maven.test.skip property to any goal:
$ mvn install -Dmaven.test.skip=true
I'm just beginning with maven but isn't install a lifecycle phase and not a goal? Acording to chapter 3 a goal would be something like compiler:compile.
"14.1 ... The m2eclipse project, provides " - superfluous comma.
"14.2. m2eclipse The m2Eclipse plugins (http://m2eclipse.codehaus.org/) provide" - incorrect pluralisation? Should be "The m2eclipse plugin (url) provides" ?
"14.2 ... interact with Subversion repositories ... mylyn... " would it be possible to expand on how m2eclipse uses the repository access it gains from Subclipse? Ditto Mylyn, how is the task-focused UI mediated/changed when m2eclipse is used?
"14.3.1 ... agree to the plugin license" should read "agree to the plugins' licenses".
When i try to assembly my project with my own assembly.xml file which is situated in the src/main/resources/assemblies I got always the error:
Error reading assemblies: Descriptor with ID 'XY' not found
I've no idea what I'm doing wrong. I tried only the ID or the complete path in the pom.xml of my project.
Thanks for any help.
Martin
In the provided settings.xml snippet, configuration for 'releases' is duplicated. On of them should most likely be changed to say 'snapshots' to relate better to the text "When you attempt to deploy to a server with an identifier of releases or snapshots...". That text should probably also include the thirdparty identifier as it is included in the settings.xml example.
The second paragraph of section 16.7 (v0.14 of the book) incorrectly states that Nexus does not provide for any security for hosted repositories. However, in section 16.7.1 it is explained how to configure user name and password for deployment. That paragraph should be updated to correctly state the security provided in Nexus beta5.
In section 16.3.4 of v0.14 of the book, "...load the RSS feed in your browse and..." should read "...load the RSS feed in your browser and..."..
Also, it states that there are "six system feeds". Unless there are different types of feeds, there are seven system feeds. If in fact only six of the seven feeds are SYSTEM feeds, and one of the feeds is of some other type, this should be clarified.
In section 14.12, references are made to the "Dependency tree" tab in the pom editor of m2eclipse. That tab seems to have been renamed to "Dependency Hierarchy" in the latest m2eclipse release (0.9.5.20080717-1821). Figure 14.32 also need to be updated.
When referring to a plugin goal, we frequently use the shorthand notation: pluginId:goalId. For example, when referring to the create plugin in the Archetype plugin, we write archetype:create.
Shouldn't that be:
When referring to a plugin goal, we frequently use the shorthand notation: pluginId:goalId. For example, when referring to the create goal in the Archetype plugin, we write archetype:create.
some confusion about the feature outputFileNameMapping:
WRONG in sonatype doc, 12.5.4.1. Customizing Dependency Output Location :
${module.artifactId}.${module.extension}
CORRECT:
${artifact.artifactId}.${artifact.extension}
OR default:
${artifact.artifactId}-${artifact.version}${dashClassifier?}.${artifact.extension}
Due to a problem with the PDF generation, there are currently no figures in the PDF. We regret this inconvenience, and are currently working to address this problem. In the meantime, we ask that you use the online HTML version of the book.
Loading Profile...
Chris Patti
last replied
on September 26, 2008 18:49
mavenbook (Official Rep)
last replied
on June 29, 2008 18:38
Brian Fox (Official Rep)
last replied
on August 21, 2008 04:41
EMPLOYEE
