Maven
  1. Maven
  2. MNG-2026

Document how parent-child POM relationships, <modules/>, and <parent><relativePath/> works

    Details

    • Type: Task Task
    • Status: Closed
    • Priority: Major Major
    • Resolution: Incomplete
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: Documentation: General
    • Labels:
      None

      Description

      Create a document that will describe how POMs can be related to one another in a multimodule build. Specifically, document:

      • The parent-child relationship - how is this manifest in the POMs
      • How does the <modules/> section work
      • How does the <relativePath/> element of the <parent/> section work...and what is required in the <parent/> section?
      • How to install ONLY the parent POM for a multimodule setup (mvn -N pom.xml at the top level)
      • How to build an entire multimodule setup from one command (tie all of this together into a working example)

      Related to this, but in another document, should be a list of things that are inherited (could be a link to somewhere else, if this documentation exists in other places). Also, the algorithm used to merge inherited and local POM sections should be in this other document.

        Issue Links

          Activity

          Transition Time In Source Status Execution Times Last Executer Last Execution Date
          Open Open Closed Closed
          2910d 8h 22m 1 Jason van Zyl 19/Jan/14 18:06
          Mark Thomas made changes -
          Workflow jira [ 12951625 ] Default workflow, editable Closed status [ 12987406 ]
          Mark Thomas made changes -
          Project Import Sun Apr 05 21:45:26 UTC 2015 [ 1428270326204 ]
          Mark Thomas made changes -
          Workflow jira [ 12712710 ] Default workflow, editable Closed status [ 12752426 ]
          Mark Thomas made changes -
          Project Import Sun Apr 05 08:49:45 UTC 2015 [ 1428223785911 ]
          Michael Osipov made changes -
          Fix Version/s Documentation Deficit [ 13554 ]
          Jason van Zyl made changes -
          Status Open [ 1 ] Closed [ 6 ]
          Resolution Incomplete [ 4 ]
          Hide
          Jason van Zyl added a comment -

          All these issues have been sitting around for years. If someone wants to actually follow up with them they can reopen.

          Show
          Jason van Zyl added a comment - All these issues have been sitting around for years. If someone wants to actually follow up with them they can reopen.
          Hide
          Stan Devitt added a comment -

          1. Parents capture shared configurations. This role should not be confused with aggregation.
          2. In the absence of <relativePath/> it is not safe to assume the pom in the parent directory is the parent pom. It might be an aggregation pom.
          3. It is very useful to gain access to the parent solely through the repository.

          Show
          Stan Devitt added a comment - 1. Parents capture shared configurations. This role should not be confused with aggregation. 2. In the absence of <relativePath/> it is not safe to assume the pom in the parent directory is the parent pom. It might be an aggregation pom. 3. It is very useful to gain access to the parent solely through the repository.
          Stan Devitt made changes -
          Link This issue depends upon MNG-4687 [ MNG-4687 ]
          Jason van Zyl made changes -
          Fix Version/s Documentation [ 13554 ]
          Jason van Zyl made changes -
          Fix Version/s 2.0.6 [ 13010 ]
          Dennis Lundberg made changes -
          Link This issue is related to MNG-1141 [ MNG-1141 ]
          kenneyw made changes -
          Fix Version/s 2.0.6 [ 13010 ]
          Fix Version/s 2.0.5 [ 12294 ]
          John Casey made changes -
          Fix Version/s 2.0.5 [ 12294 ]
          Fix Version/s documentation [ 12291 ]
          Allan Ramirez made changes -
          Assignee Allan Ramirez [ aramirez ]
          Allan Ramirez made changes -
          Assignee Allan Ramirez [ aramirez ]
          Vincent Massol made changes -
          Workflow Maven [ 46836 ] Maven New [ 48154 ]
          John Casey made changes -
          Field Original Value New Value
          Fix Version/s documentation [ 12291 ]
          John Casey created issue -

            People

            • Assignee:
              Unassigned
              Reporter:
              John Casey
            • Votes:
              4 Vote for this issue
              Watchers:
              5 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Development