X-Git-Url: https://git.heureux-cyclage.org/?a=blobdiff_plain;f=maintenance%2FmanageForeignResources.php;h=54554b8c5b519135d69fe749b950136d25dc117c;hb=d994407830c65f7bcb6c1f9130b2e74b0d576a16;hp=87f2e83144b7809cb25a234375fee8a259ed71ee;hpb=f8fcff31aaaf3230ab69c57d7bb4e5b7adc5bc0b;p=lhc%2Fweb%2Fwiklou.git

diff --git a/maintenance/manageForeignResources.php b/maintenance/manageForeignResources.php
index 87f2e83144..54554b8c5b 100644
--- a/maintenance/manageForeignResources.php
+++ b/maintenance/manageForeignResources.php
@@ -33,14 +33,20 @@ class ManageForeignResources extends Maintenance {
 		$this->addDescription( <<<TEXT
 Manage foreign resources registered with ResourceLoader.
 
-This helps developers to download, verify and update local copies of upstream
-libraries registered as ResourceLoader modules. See also foreign-resources.yaml.
+This helps developers with downloading, verifying, and updating local copies of upstream
+libraries registered as ResourceLoader modules. See resources/lib/foreign-resources.yaml.
 
-For sources that don't publish an integrity hash, omit "integrity" (or leave empty)
-and run the "make-sri" action to compute the missing hashes.
+Use the "update" action to download urls specified in foreign-resources.yaml, and unpack
+them to the resources directory. This will also verify them against the integrity hashes.
 
-This script runs in dry-run mode by default. Use --update to actually change,
-remove, or add files to resources/lib/.
+Use the "verify" action to verify the files currently in the resources directory match
+what "update" would replace them with. This is effectively a dry-run and will not change
+any module resources on disk.
+
+Use the "make-sri" action to compute an integrity hash for upstreams that do not publish
+one themselves. Add or update the urls foreign-resources.yaml as needed, but omit (or
+leave empty) the "integrity" key. Then, run the "make-sri" action for the module and
+copy the integrity into the file. Then, you can use "verify" or "update" normally.
 TEXT
 		);
 		$this->addArg( 'action', 'One of "update", "verify" or "make-sri"', true );