Changes between Version 2 and Version 3 of GettingStartedWithPlumage
- Timestamp:
- 07/19/11 03:38:24 (11 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
GettingStartedWithPlumage
v2 v3 1 1 = Plumage = 2 2 3 Plumage is the Parrot VM module ecosystem. It includes tools to search the ecosystem,3 Plumage is a package manager for the Parrot VM module ecosystem. It includes tools to search the ecosystem, 4 4 browse the module metadata, install modules, and so forth. 5 5 6 The ecosystem currently includes various compilers target ting Parrot VM, libraries,7 language bindings and more.6 The ecosystem currently includes various compilers targeting Parrot, libraries, 7 language bindings, and more. 8 8 9 9 = Getting Plumage = 10 10 11 The Plumage repo is located on Github (https://github.com/parrot/plumage). You can either 12 download a tarball or simply clone the repository with `git clone git://github.com/parrot/plumage.git`. 13 To build plumage, execute 11 The Plumage repository is hosted on [https://github.com/parrot/plumage Github]. You can obtain a copy of the 12 source code by running `git clone git://github.com/parrot/plumage.git`. 13 To install Plumage, run the following sequence of commands: 14 14 15 {{{ 15 parrot setup.pir build 16 parrot setup.pir test # optional, to see if everything is working properly17 parrot setur.pir install 16 parrot setup.pir build # Builds executable 17 parrot setup.pir test # Optional, runs test suite 18 parrot setur.pir install # Installs executable 18 19 }}} 19 20 20 You may need a root access in the last step, depending on where your Parrot is located. 21 Plumage will install itself into the Parrot directory tree. After that, you're ready to go. 21 If you received an error message in the last step that's similar to: 22 22 23 Note: on Windows, since Parrot 3.0.0, plumage is shipped with Parrot binaries [http://sourceforge.net/projects/parrotwin32/]. 23 {{{ 24 Can't mkdir '/usr/local/lib/parrot/[version]/library/Plumage' (Permission denied) 25 }}} 26 27 Where `[version]` is the version of Parrot installed, you need root access to complete the installation. Try prefixing the last 28 command with `sudo` or `su -c`. 29 30 Plumage is installed to the same directory that Parrot was installed to. This is `/usr/local/bin` by default. If you want to change this, 31 you need to re-install Parrot. Use the `--prefix` switch when running `Configure.pl`. For example, 32 `perl Configure.pl --prefix=/foo/bar/baz`. 33 34 Once the above steps have been completed, you can then begin using Plumage. 35 36 ''NOTE FOR WINDOWS USERS'': Since Parrot 3.0.0, Plumage is shipped with the Parrot binaries at [http://sourceforge.net/projects/parrotwin32/]. 24 37 25 38 = Usage = 26 39 27 To show a list of projects, use`plumage projects`. After choosing the one you want to install, simply28 run `plumage install <project>`. This will build, test and install the desired project into the Parrot40 To show the list of projects that are in the ecosystem, run `plumage projects`. After choosing the one you want to install, simply 41 run `plumage install <project>`. This will build, test, and install the desired project into the Parrot 29 42 directory tree. 30 43 31 For more usage information run `plumage usage` 44 For example, if you want to install `partcl` (an implementation of Tcl), run: 45 46 {{{ 47 plumage install partcl 48 }}} 49 50 Just like when installing Plumage, root access may be required depending on where the default installation directory is. If 51 that is the case, you will be prompted to enter your password. 52 53 If you decide that you no longer need a particular package, you can remove it with the `uninstall` command. Using `partcl` as an example again, run: 54 55 {{{ 56 plumage uninstall partcl 57 }}} 58 59 Plumage is able to resolve package dependencies. If package `Foo` depends on package `Bar`, installing `Foo` will also silently install `Bar`. 60 61 For more usage information, run `plumage usage`.