README
changeset 7760 4ab84455407c
parent 3836 56af60eb6020
child 7763 2a3817cf33cb
equal deleted inserted replaced
7759:ae98f8ab0971 7760:4ab84455407c
     4 
     4 
     5 Getting Started
     5 Getting Started
     6 
     6 
     7     This README provides a very brief overview of the gate, how to retrieve
     7     This README provides a very brief overview of the gate, how to retrieve
     8     a copy, and how to build it.  Detailed documentation about the Userland
     8     a copy, and how to build it.  Detailed documentation about the Userland
     9     gate can be found in the 'doc' directory.  Questions or comments about
     9     gate can be found in the 'doc' directory.
    10     the gate can be addressed to [email protected]
       
    11 
    10 
    12 Overview
    11 Overview
    13 
    12 
    14     The Userland consolidation maintains a project page at
    13     The Userland consolidation maintains a project at
    15 
    14 
    16          https://solaris-userland.java.net/
    15          https://github.com/oracle/solaris-userland
    17 
    16 
    18     and a Mercurial gate at
    17     That repo contains build recipes, patches, IPS manifests, etc. necessary
    19 
       
    20          https://hg.java.net/hg/solaris-userland~gate
       
    21 
       
    22     This gate contains build recipies, patches, IPS manifests, etc. necessary
       
    23     to download, prep, build, test, package and publish open source software.
    18     to download, prep, build, test, package and publish open source software.
    24     The build infrastructure is similiar to that of the SFW consolidation in
    19     The build infrastructure is similar to that of the SFW consolidation in
    25     that it makes use of herarchical Makefiles which provide dependency and
    20     that it makes use of hierarchical Makefiles which provide dependency and
    26     recipe information for building the components.  In order to build the
    21     recipe information for building the components.  In order to build the
    27     contents of the Userland gate, you need to clone it.  Since you are
    22     contents of the Userland gate, you need to clone it.  Since you are
    28     reading this, you probably already have.
    23     reading this, you probably already have.
    29 
    24 
    30 Getting the Bits
    25 Getting the Bits
    31 
    26 
    32     As mentioned, the gate is stored in a Mercurial repository.  In order to
    27     As mentioned, the gate is stored in a Mercurial repository.  In order to
    33     build or develop in the gate, you will need to clone it.  You can do so
    28     build or develop in the gate, you will need to clone it.  You can do so
    34     with the following command
    29     with the following command
    35     
    30     
    36       $ hg clone https://hg.java.net/hg/solaris-userland~gate /scratch/clone
    31       $ git clone https://github.com/oracle/solaris-userland.git /scratch/clone
    37 
    32 
    38     This will create a replica of the various pieces that are checked into the
    33     This will create a replica of the various pieces that are checked into the
    39     source code management system, but it does not retrieve the community
    34     source code management system, but it does not retrieve the community
    40     source archives associated with the gate content.  To download the
    35     source archives associated with the gate content.  To download the
    41     community source associated with your cloned workspace, you will need to
    36     community source associated with your cloned workspace, you will need to