Commit ae470a2c authored by Cyril Brulebois's avatar Cyril Brulebois

Adapt syntax for better output through markdown.

parent 0c14b8d1
...@@ -2,7 +2,7 @@ ...@@ -2,7 +2,7 @@
## Foreword ## Foreword
Although it's not required to maintain any package, "mr" is recommended so Although it's not required to maintain any package, `mr` is recommended so
that one can clone all packages at once. It also helps keeping up-to-date, that one can clone all packages at once. It also helps keeping up-to-date,
by fetching everything through a single command. by fetching everything through a single command.
...@@ -10,7 +10,7 @@ by fetching everything through a single command. ...@@ -10,7 +10,7 @@ by fetching everything through a single command.
## Bootstrap ## Bootstrap
Go to the directory where you want to clone all XSF packages (let's Go to the directory where you want to clone all XSF packages (let's
call it ~/debian-x) and run this: call it `~/debian-x`) and run this:
# Get XSF tools: # Get XSF tools:
git clone git://git.debian.org/pkg-xorg/debian/xsf-tools.git debian/xsf-tools.git git clone git://git.debian.org/pkg-xorg/debian/xsf-tools.git debian/xsf-tools.git
...@@ -19,45 +19,45 @@ call it ~/debian-x) and run this: ...@@ -19,45 +19,45 @@ call it ~/debian-x) and run this:
# Needed to get custom commands to work: # Needed to get custom commands to work:
echo $(pwd)/.mrconfig >> ~/.mrtrust echo $(pwd)/.mrconfig >> ~/.mrtrust
You're now ready to fetch everything. By calling "mr up", if a local You're now ready to fetch everything. By calling `mr up`, if a local
repository is missing, cloning happens, fetching otherwise: repository is missing, cloning happens, fetching otherwise:
mr -c .mrconfig up mr -c .mrconfig up
To speed things up, you can pass --jobs to fetch in parallel: To speed things up, you can pass `--jobs` to fetch in parallel:
mr -c .mrconfig --jobs 4 up mr -c .mrconfig --jobs 4 up
## Further configuration ## Further configuration
To avoid passing "-c .mrconfig" every time, you can add the following stanza To avoid passing `-c .mrconfig` every time, you can add the following stanza
to ~/.mrconfig: to `~/.mrconfig`:
[~/debian-x] [~/debian-x]
chain = true chain = true
update = echo "Updating XSF packages." update = echo "Updating XSF packages."
It's now sufficient to call "mr up" in any directory in the ~/debian-x It's now sufficient to call `mr up` in any directory in the `~/debian-x`
directory to update all repositories the former contains. directory to update all repositories the former contains.
## But I want to commit! ## But I want to commit!
By default all repositories are cloned anonymously through the git protocol. By default all repositories are cloned anonymously through the git protocol.
To be able to push, you can just perform an s,git://,ssh://, substitution in To be able to push, you can just perform an `s,git://,ssh://`, substitution in
the appropriate .git/config file. An alias is available in our mrconfig file: the appropriate `.git/config` file. An alias is available in our mrconfig file:
mr git2ssh mr git2ssh
It should only fail on the top-level directory (in our case: ~/debian-x) for It should only fail on the top-level directory (in our case: `~/debian-x`) for
which the alias is not defined (in ~/.mrconfig), but since that should only be which the alias is not defined (in `~/.mrconfig`), but since that should only
one-shot, that's probably not a big deal. be one-shot, that's probably not a big deal.
## I want to update that file! ## I want to update that file!
The mrconfig-update script is what you want. As long as you have an The `mrconfig-update` script is what you want. As long as you have an account
account on git.debian.org, it's going to run a find command there to on `git.debian.org`, it's going to run a find command there to fetch an
fetch an updated list of all repositories, and generate an updated updated list of all repositories, and generate an updated mrconfig file
mrconfig file accordingly, using mrconfig.head as header. accordingly, using `mrconfig.head` as header.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment