X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=HACKING;h=d1c655cc59793a8563d5c9baebec6ae9453f88c8;hb=03d35993b87f49753542e705e37949a46964be17;hp=d2edcc16ab05aa895ac14290d50db50b8356f07f;hpb=c16fd3fc28fac913bb8c42560de58bf61ed04922;p=bup.git diff --git a/HACKING b/HACKING index d2edcc1..d1c655c 100644 --- a/HACKING +++ b/HACKING @@ -19,22 +19,27 @@ via email. Current Trajectory ================== -Now that we've finished the 0.26 release, we're working on 0.27, and +Now that we've finished the 0.27 release, we're working on 0.28, and although we're not certain which new features will be included, here -are some possible candidates: +are likely candidates: + + - Support for rm/gc. - 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...). - Incremental indexing via inotify. - - Support for rm/gc. - - 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.) @@ -54,13 +59,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, 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 ./pending, ready for submission to the list, like this: +patches in ./patches, ready for submission to the list, like this: git format-patch -s -o patches origin/master