Update docs
Ximin Luo
5 years ago
2 | 2 | |
3 | 3 | ``cargo install debcargo``, then for each new package: |
4 | 4 | |
5 | **To package a new crate:** | |
5 | **To package a new crate, or to update an existing crate:** | |
6 | 6 | |
7 | $ ``./new-package.sh <rust-crate-name>`` and follow its instructions. | |
7 | $ ``./new-package.sh <rust-crate-name>`` | |
8 | 8 | |
9 | **To update a crate:** | |
9 | or | |
10 | 10 | |
11 | 11 | $ ``./update.sh <rust-crate-name>`` |
12 | 12 | |
13 | Note that new-package.sh is just a symlink to update.sh. This has been created | |
14 | to help new comers. | |
13 | and follow its instructions. | |
14 | ||
15 | Note that new-package.sh is just a symlink to update.sh, to help newcomers. | |
15 | 16 | |
16 | 17 | **To package an older version of a crate:** |
17 | 18 | |
19 | To maintain an old version of a crate alongside the latest one, first make sure | |
20 | the latest version is packaged by doing all of the above, then run: | |
21 | ||
22 | $ ``./new-package.sh <rust-crate-name> <old-version>`` | |
23 | ||
24 | or | |
25 | ||
18 | 26 | $ ``./update.sh <rust-crate-name> <old-version>`` |
19 | 27 | |
20 | To maintain an old version of a crate alongside the latest one, first | |
21 | make sure the latest version is packaged by doing all of the above, then run | |
22 | the command above and copy anything relevant from the config directory | |
23 | for the latest version, to that for the old version. | |
28 | and follow its instructions. To make this easier, you can start by copying | |
29 | anything relevant from ``src/<rust-crate-name>`` to | |
30 | ``src/<rust-crate-name>-<old-version>``, then adapting it as needed. | |
24 | 31 | |
25 | 32 | **To prepare the release:** |
26 | 33 | |
27 | 34 | $ ``./release.sh <rust-crate-name>`` |
28 | 35 | |
29 | This will prepare the necessary Debian files in build/. It will also creating a | |
30 | git branch to manage the packaging until it is accepted in Debian itself. | |
36 | This will prepare the necessary Debian files in ``build/``. It will also create | |
37 | a git branch to manage the packaging until it is accepted in Debian itself. | |
38 | ||
31 | 39 | |
32 | 40 | NEWS |
33 | 41 | ==== |