X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=HACKING;h=2cc93a4f02c1fc1ff95c3b0d7a5a2e3dd5b655ed;hb=7ce77b74ba29ee028a119e5eecb001d64af2deed;hp=fbc98afcf4afdd21e001ce7f170b4078cb9ecaee;hpb=17e36bd3d4d001fcd8cf82c061dbc6e374cc471e;p=bup.git diff --git a/HACKING b/HACKING index fbc98af..2cc93a4 100644 --- a/HACKING +++ b/HACKING @@ -7,10 +7,6 @@ Code Branching Model The master branch is what we consider the main-line of development, and the last, non-rc tag on master is the most recent stable release. -Of course, in all fairness, it has been a *long* time since the last -stable release, but we're working fairly hard to fix that -- no, -seriously. - Any branch with a "tmp/" prefix might be rebased (often), so keep that in mind when using or depending on one. @@ -23,21 +19,27 @@ via email. Current Trajectory ================== -At the moment, the primary goal is to test master in preparation for a -0.25 release, which among many other things will include more complete -support for filesystem metadata. +Now that we've finished the 0.29.1 release, we're working on 0.30, and +although we're not certain which new features will be included, here +are likely candidates: -If you have the time and inclination, please help review patches -posted to the list for inclusion in 0.25. (See "ways to help" below.) + - Support for transferring saves between repositories and rewriting + branches. + +and these are also under consideration: + + - Better VFS performance for large repositories (i.e. fuse, ls, + web...). -We'd like to try to release (0.25) soon, so we're limiting the scope -of prospective changes -- definitely in-scope: + - Incremental indexing via inotify. - - fixes to the new metadata support - - fixes for regressions (portability included) - - fixes for "serious" bugs - - "simple" fixes - - documentation improvements + - Smarter (and quieter) handling of cross-filesystem metadata. + + - Support for more general purpose push/pull of branches, saves, and + tags between repositories. (See the bup-get patch series.) + +If you have the time and inclination, please help review patches +posted to the list, or post your own. (See "ways to help" below.) More specific ways to help @@ -55,14 +57,31 @@ incorporating it into master, so reviews are an important way to help. We also love a good "Tested-by:" -- the more the merrier. +Testing +======= + +You can run the test suite much more quickly via "make -j test" (as +compared to "make test"), at the expense of slightly more confusing +output (interleaved parallel test output), and inaccurate intermediate +success/failure counts, but the final counts displayed should be +correct. + +Individual non-Python tests can be run via "./wvtest run t/TEST" and +if you'd like to see all of the test output, you can omit the wvtest +run wrapper: "t/TEST" + +Individual Python tests can be run via "./wvtest run ./wvtest.py +lib/bup/t/TEST", and as above, you can see all the output by omitting +the wvtest run wrapper like this: "./wvtest.py lib/bup/t/TEST" + + Submitting patches ================== As mentioned, all patches should be posted to the mailing list for -review. - -You can create a "signed off" (see ./SIGNED-OFF-BY) set of patches in -./pending, ready for submission to the list, like this: +review, and must be "signed off" by the author before official +inclusion (see ./SIGNED-OFF-BY). You can create a "signed off" set of +patches in ./patches, ready for submission to the list, like this: git format-patch -s -o patches origin/master