@@ -6,6 +6,23 @@ Print and check availability of latest versions of [Linux][] [distro][] images.

 [Linux]: https://en.wikipedia.org/wiki/Linux

 [distro]: https://en.wikipedia.org/wiki/Linux_distribution

+## Usage

+

+```

+distro-url [test] [<distro> [<variant> [<arch> [<mirror>]]]]

+```

+

+-   `test`: Optional verbatim prefix to check that the server responds with a

+    non-error code for the [URL][].

+-   `<distro>`, `<variant>`, `<arch>`: Optional [glob][]s to match against the

+    combinations `distro-url` knows about. All default to `*`, which matches

+    everything.

+-   `<mirror>`: Optional override of the default server. Probably only useful

+    when the above globs only match a single distro.

+

+[URL]: https://en.wikipedia.org/wiki/URL

+[glob]: https://en.wikipedia.org/wiki/Glob_(programming)

+

 ## License

 Licensed under the [ISC License][] unless otherwise noted, see the

@@ -5,3 +5,11 @@ Print and check availability of latest versions of [Linux][] [distro][] images.

 [`distro-url`]: https://git.rcrnstn.net/rcrnstn/distro-url

 [Linux]: https://en.wikipedia.org/wiki/Linux

 [distro]: https://en.wikipedia.org/wiki/Linux_distribution

+

+## License

+

+Licensed under the [ISC License][] unless otherwise noted, see the

+[`LICENSE`][] file.

+

+[ISC License]: https://choosealicense.com/licenses/isc

+[`LICENSE`]: LICENSE

new file mode 100644

@@ -0,0 +1,7 @@

+# [`distro-url`][]

+

+Print and check availability of latest versions of [Linux][] [distro][] images.

+

+[`distro-url`]: https://git.rcrnstn.net/rcrnstn/distro-url

+[Linux]: https://en.wikipedia.org/wiki/Linux

+[distro]: https://en.wikipedia.org/wiki/Linux_distribution