|
|
|
@ -1,9 +1,9 @@ |
|
|
|
|
# Using wraptool |
|
|
|
|
|
|
|
|
|
Wraptool is a helper tool that allows you to manage your source |
|
|
|
|
dependencies using the WrapDB database. It gives you all things you |
|
|
|
|
would expect, such as installing and updating dependencies. The wrap |
|
|
|
|
tool works on all platforms, the only limitation is that the wrap |
|
|
|
|
Wraptool is a subcommand of Meson that allows you to manage your |
|
|
|
|
source dependencies using the WrapDB database. It gives you all things |
|
|
|
|
you would expect, such as installing and updating dependencies. The |
|
|
|
|
wrap tool works on all platforms, the only limitation is that the wrap |
|
|
|
|
definition works on your target platform. If you find some Wraps that |
|
|
|
|
don't work, please file bugs or, even better, patches. |
|
|
|
|
|
|
|
|
@ -16,7 +16,7 @@ are commands to type. |
|
|
|
|
The simplest operation to do is to query the list of packages |
|
|
|
|
available. To list them all issue the following command: |
|
|
|
|
|
|
|
|
|
$ wraptool list |
|
|
|
|
$ meson wrap list |
|
|
|
|
box2d |
|
|
|
|
enet |
|
|
|
|
gtest |
|
|
|
@ -33,13 +33,13 @@ available. To list them all issue the following command: |
|
|
|
|
Usually you want to search for a specific package. This can be done |
|
|
|
|
with the `search` command: |
|
|
|
|
|
|
|
|
|
$ wraptool search jpeg |
|
|
|
|
$ meson wrap search jpeg |
|
|
|
|
libjpeg |
|
|
|
|
|
|
|
|
|
To determine which versions of libjpeg are available to install, issue |
|
|
|
|
the `info` command: |
|
|
|
|
|
|
|
|
|
$ wraptool info libjpeg |
|
|
|
|
$ meson wrap info libjpeg |
|
|
|
|
Available versions of libjpeg: |
|
|
|
|
9a 2 |
|
|
|
|
|
|
|
|
@ -54,7 +54,7 @@ Installing dependencies is just as straightforward. First just create |
|
|
|
|
the `subprojects` directory at the top of your source tree and issue |
|
|
|
|
the install command. |
|
|
|
|
|
|
|
|
|
$ wraptool install libjpeg |
|
|
|
|
$ meson wrap install libjpeg |
|
|
|
|
Installed libjpeg branch 9a revision 2 |
|
|
|
|
|
|
|
|
|
Now you can issue a `subproject('libjpeg')` in your `meson.build` file |
|
|
|
@ -62,7 +62,7 @@ to use it. |
|
|
|
|
|
|
|
|
|
To check if your projects are up to date you can issue the `status` command. |
|
|
|
|
|
|
|
|
|
$ wraptool status |
|
|
|
|
$ meson wrap status |
|
|
|
|
Subproject status |
|
|
|
|
libjpeg up to date. Branch 9a, revision 2. |
|
|
|
|
zlib not up to date. Have 1.2.8 2, but 1.2.8 4 is available. |
|
|
|
@ -70,12 +70,12 @@ To check if your projects are up to date you can issue the `status` command. |
|
|
|
|
In this case `zlib` has a newer release available. Updating it is |
|
|
|
|
straightforward: |
|
|
|
|
|
|
|
|
|
$ wraptool update zlib |
|
|
|
|
$ meson wrap update zlib |
|
|
|
|
Updated zlib to branch 1.2.8 revision 4 |
|
|
|
|
|
|
|
|
|
Wraptool can do other things besides these. Documentation for these |
|
|
|
|
can be found in the command line help, which can be accessed by |
|
|
|
|
`wraptool --help`. |
|
|
|
|
`meson wrap --help`. |
|
|
|
|
|
|
|
|
|
## Promoting dependencies |
|
|
|
|
|
|
|
|
|