X-Git-Url: http://www.git.stargrave.org/?a=blobdiff_plain;f=HACKING;h=74a3096f5318749f547b28c6f4ba784ebc0acfed;hb=43b66634d508a1cd81023b5d567abae3804420c4;hp=5e02302c64c0941516a3a720a7f414fc232bb4d3;hpb=d87053bf6cae0258125e84e1531d5f1206c53288;p=public-inbox.git diff --git a/HACKING b/HACKING index 5e02302c..74a3096f 100644 --- a/HACKING +++ b/HACKING @@ -56,6 +56,27 @@ requirements. See design_www.txt and design_notes.txt in the Documentation/ directory for design decisions made during development. +See Documentation/technical/ in the source tree for more details +on specific topics, in particular data_structures.txt + +Faster tests +------------ + +The `make test' target provided by MakeMaker does not run in +parallel. Our `make check' target supports parallel runs, and +it also creates a `.prove' file to optimize `make check-run'. + +The prove(1) command (distributed with Perl) may also be used +for finer-grained testing: prove -bvw t/foo.t + +If using a make(1) (e.g. GNU make) with `include' support, the +`config.mak' Makefile snippet can be used to set environment +variables such as PERL_INLINE_DIRECTORY and TMPDIR. + +With PERL_INLINE_DIRECTORY set to enable Inline::C support and +TMPDIR pointed to a tmpfs(5) mount, `make check-run' takes 6-10s +(load-dependent) on a busy workstation built in 2010. + Perl notes ----------