website: start adding content to the manual
[dragora.git] / sources / README.md
blob5e85c003680b76fd91100b23600fe1d8606a8652
1 # README
3 There are two ways to get the sources used by Dragora:
5   1. Source list.
6   2. RSYNC protocol.
8   Normally we obtain the sources from original sites (upstream).
10 Full address of sources files are in the "SOURCELIST.txt" file.  A copy
11 of these files can be found via RSYNC at [rsync://rsync.dragora.org][1]
13 Please, [check our mirrors][2].
15 ## Instructions
17 ### 1. Source list.
19 Download all the sources from the list, one by one:
21     wget -c -i SOURCELIST.txt
23 If your wget(1) implementation lacks '-i', try with:
25     cat SOURCELIST.txt | wget -c -
27 ### 2. RSYNC protocol.
29     rsync -rvaiz --progress rsync://rsync.dragora.org/dragora/current/sources/ .
31 Note, if you are upgrading an (already) out-of-date sources directory
32 and want to make it clear, add the following options:
34     rsync -rvaiz --progress --exclude=README.md --delete-delay \
35      rsync://rsync.dragora.org/dragora/current/sources/ .
37 The command and options above will preserve the README.md file while deletes
38 any previous source.
40 The tarballs will be stored on the current working directory.
42 ## Check sums
44 Remember to check if everything is OK.  To check the integrity of all
45 the tarballs using sha256sum(1), type:
47     sha256sum -c *.sha256
50 [1]: http://rsync.dragora.org "Browse via HTTP"
51 [2]: /wiki?name=Mirrors