Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | bk-kernel-howto.txt: Description of kernel workflow under BitKeeper |
| 2 | |
| 3 | bk-make-sum: Create summary of changesets in one repository and not |
| 4 | another, typically in preparation to be sent to an upstream maintainer. |
| 5 | Typical usage: |
| 6 | cd my-updated-repo |
| 7 | bk-make-sum ~/repo/original-repo |
| 8 | mv /tmp/linus.txt ../original-repo.txt |
| 9 | |
| 10 | bksend: Create readable text output containing summary of changes, GNU |
| 11 | patch of the changes, and BK metadata of changes (as needed for proper |
| 12 | importing into BitKeeper by an upstream maintainer). This output is |
| 13 | suitable for emailing BitKeeper changes. The recipient of this output |
| 14 | may pipe it directly to 'bk receive'. |
| 15 | |
| 16 | bz64wrap: helper script. Uncompressed input is piped to this script, |
| 17 | which compresses its input, and then outputs the uu-/base64-encoded |
| 18 | version of the compressed input. |
| 19 | |
| 20 | cpcset: Copy changeset between unrelated repositories. |
| 21 | Attempts to preserve changeset user, user address, description, in |
| 22 | addition to the changeset (the patch) itself. |
| 23 | Typical usage: |
| 24 | cd my-updated-repo |
| 25 | bk changes # looking for a changeset... |
| 26 | cpcset 1.1511 . ../another-repo |
| 27 | |
| 28 | csets-to-patches: Produces a delta of two BK repositories, in the form |
| 29 | of individual files, each containing a single cset as a GNU patch. |
| 30 | Output is several files, each with the filename "/tmp/rev-$REV.patch" |
| 31 | Typical usage: |
| 32 | cd my-updated-repo |
| 33 | bk changes -L ~/repo/original-repo 2>&1 | \ |
| 34 | perl csets-to-patches |
| 35 | |
| 36 | cset-to-linus: Produces a delta of two BK repositories, in the form of |
| 37 | changeset descriptions, with 'diffstat' output created for each |
| 38 | individual changset. |
| 39 | Typical usage: |
| 40 | cd my-updated-repo |
| 41 | bk changes -L ~/repo/original-repo 2>&1 | \ |
| 42 | perl cset-to-linus > summary.txt |
| 43 | |
| 44 | gcapatch: Generates patch containing changes in local repository. |
| 45 | Typical usage: |
| 46 | cd my-updated-repo |
| 47 | gcapatch > foo.patch |
| 48 | |
| 49 | unbz64wrap: Reverse an encoded, compressed data stream created by |
| 50 | bz64wrap into an uncompressed, typically text/plain output. |
| 51 | |