Updated COMMON_FEATURES.md to reflect new format

main
Michal 2 years ago
parent 5f58c8f45d
commit a24a3d9c29

@ -29,15 +29,15 @@ on_gen = false
[repositories] [repositories]
name = [ name = [
"1::foo", "foo:repo1",
"1::bar", "foo::repo2/testing",
"2::baz", "bar::baz!",
"2::qux", "bar::qux/testing!",
]
urls = [
"https://example.org/%repo%.git",
"https://example.org/other/%repo%.git",
] ]
[repositories.urls]
foo = "https://example.org/%repo%.git"
bar = "https://example.org/other/%repo%.git"
``` ```
Now this is going to look really confusing at first, but bear with me. Now this is going to look really confusing at first, but bear with me.
@ -87,23 +87,29 @@ facilitate many packages without having to type each url out a million times.
```toml ```toml
[repositories] [repositories]
name = [ repos = [
"1::foo", "foo:repo1",
"1::bar", "foo:repo2/testing",
"2::baz", "bar:baz!",
"2::qux", "bar:qux/testing!",
]
urls = [
"https://example.org/%repo%.git",
"https://example.org/other/%repo%.git",
] ]
[repositories.urls]
foo = "https://example.org/%repo%.git"
bar = "https://example.org/other/%repo%.git"
``` ```
The way this works is simple: The way this works is simple:
- We have 2 urls in the `repositories.urls` key. - We have 2 urls in the `repositories.urls` key.
- Each `name` in the `repositories.name` key is prefixed with an index. - Each `repo` in the `repositories.repos` key is prefixed with an identifier.
- If the number is `N`, it'll insert the name into the `N`th URL. - If the number is `foo`, it'll insert the url with the id `foo`.
- Specifically, in the repo's URL, it'll insert the defined `name` in place of the `%repo%` substring. - Specifically, in the URL, it'll insert the defined `repo`'s name in place of the `%repo%` substring.
#### Hang on, what are the special symbols????
I'm glad you asked!
- If you want to clone a specific branch, simply use the `/` delimiter. To clone repository `foo` on branch `bar`, use `id:foo/bar`.
- If you want a specific package to build first, use instances of `!` to set priority. This is explained later in the [Repository Mode](REPOSITORY_MODE.md) page
That's literally it! That's literally it!

Loading…
Cancel
Save