diff options
Diffstat (limited to 'docs/markdown/fallback-wraptool.md')
-rw-r--r-- | docs/markdown/fallback-wraptool.md | 31 |
1 files changed, 31 insertions, 0 deletions
diff --git a/docs/markdown/fallback-wraptool.md b/docs/markdown/fallback-wraptool.md new file mode 100644 index 0000000..fc3cc02 --- /dev/null +++ b/docs/markdown/fallback-wraptool.md @@ -0,0 +1,31 @@ +--- +title: fallback wraptool +... + +# In case of emergency + +In case wraptool is down we have created a backup script that you can use to download wraps directly from the Github repos. It is not as slick and may have bugs but at least it will allow you to use wraps. + +## Using it + +Currently the emergency tool is only in Meson trunk so you need a git checkout to use it. It also does not on releases older than 0.32.0 because they had a bug. (A workaround for older versions is to delete existing `foobar.wrap` files if you have them.) + +To list all available wraps: + + ghwt.py list + +To install a wrap, go to your source root, make sure that the `subprojects` directory exists and run this command: + + ghwt.py install <projectname> + +This will stage the subproject ready to use. If you have multiple subprojects you need to download them all manually. + +## How to upgrade an existing dir/fix broken state/any other problem + +Nuke the contents of `subprojects` and start again. + +## Known issues + +Some repositories show up in the list but are not installable. They would not show up in the real wrapdb because they are works in progress. + +Github web API limits the amount of queries you can do to 60/hour. If you exceed that you need to wait for the timer to reset. |