readme revision ada1678a4262b208a7b87391f520a7767d25287c
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS HEADER.
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa Copyright (c) 2010 Oracle and/or its affiliates. All rights reserved.
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa The contents of this file are subject to the terms of either the GNU
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa General Public License Version 2 only ("GPL") or the Common Development
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa and Distribution License("CDDL") (collectively, the "License"). You
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa may not use this file except in compliance with the License. You can
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa obtain a copy of the License at
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa https://glassfish.dev.java.net/public/CDDL+GPL_1_1.html
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa or packager/legal/LICENSE.txt. See the License for the specific
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa language governing permissions and limitations under the License.
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa When distributing the software, include this License Header Notice in each
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa file and include the License file at packager/legal/LICENSE.txt.
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa GPL Classpath Exception:
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa Oracle designates this particular file as subject to the "Classpath"
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa exception as provided by Oracle in the GPL Version 2 section of the License
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa file that accompanied this code.
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa Modifications:
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa If applicable, add the following below the License Header, with the fields
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa enclosed by brackets [] replaced by your own identifying information:
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa "Portions Copyright [year] [name of copyright owner]"
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa Contributor(s):
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa If you wish your version of this file to be governed by only the CDDL or
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa only the GPL Version 2, indicate your decision by adding "[Contributor]
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa elects to include this software in this distribution under the [CDDL or GPL
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa Version 2] license." If you don't indicate a single choice of license, a
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa recipient has the option to distribute your version of this file under
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa either the CDDL, the GPL Version 2 or to extend the choice of license to
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa its licensees as provided above. However, if you add GPL Version 2 code
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa and therefore, elected the GPL Version 2 license, then the option applies
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa only if the new code is made subject to such option by the copyright
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen KuksaThis is a project (POM) created to help admin backend developers. If
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksayou are an admin developer, you have to deal with sources scattered
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksaover GFv3 workspace, at the same time, there are sources that you don't
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksaever touch during your normal development. This rules out the possibility
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksaof top-level v3/pom.xml to be opened by your favorite IDE. What I have
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksadone here is "hand-picked" the parts of GFv3 workspace so that you can
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksaopen all those parts "as a single maven/IDE project". The benefits of
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksadoing this are:
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa0- You don't need the entire sources (although this assumes that all of
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa the workspace is actually checked out) and can only open single
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa1- You don't need to open multiple projects in IDE.
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen KuksaI have tested this with Intellij 8.1.3 and it works great (for me).
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen KuksaTypically, here is what I do:
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa- checkout v3 source code and build it once.
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa- open <v3>/admin/debug/pom.xml in your favorite IDE that supports POM
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa (e.g. NetBeans, Intellij).
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa- in a shell, do: mvn dependency:sources -> this downloads all the
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa other sources (external dependencies) in your local repo, should you
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa need to debug them.
ec6df36a0df3319d7d3556af15f9a6dbf8834e51Eugen Kuksa-Kedar, 02 Oct 2009