@@ -671,76 +671,3 @@ Then, at the top-level:
671671That'll generate a detailed cover report in the "cover_db_html"
672672directory, which you can then copy to a webserver, or inspect locally
673673in a browser.
674-
675- Smoke testing
676- -------------
677-
678- The Git test suite has support for smoke testing. Smoke testing is
679- when you submit the results of a test run to a central server for
680- analysis and aggregation.
681-
682- Running a smoke tester is an easy and valuable way of contributing to
683- Git development, particularly if you have access to an uncommon OS on
684- obscure hardware.
685-
686- After building Git you can generate a smoke report like this in the
687- "t" directory:
688-
689- make clean smoke
690-
691- You can also pass arguments via the environment. This should make it
692- faster:
693-
694- GIT_TEST_OPTS='--root=/dev/shm' TEST_JOBS=10 make clean smoke
695-
696- The "smoke" target will run the Git test suite with Perl's
697- "TAP::Harness" module, and package up the results in a .tar.gz archive
698- with "TAP::Harness::Archive". The former is included with Perl v5.10.1
699- or later, but you'll need to install the latter from the CPAN. See the
700- "Test coverage" section above for how you might do that.
701-
702- Once the "smoke" target finishes you'll see a message like this:
703-
704- TAP Archive created at <path to git>/t/test-results/git-smoke.tar.gz
705-
706- To upload the smoke report you need to have curl(1) installed, then
707- do:
708-
709- make smoke_report
710-
711- To upload the report anonymously. Hopefully that'll return something
712- like "Reported #7 added.".
713-
714- If you're going to be uploading reports frequently please request a
715- user account by E-Mailing gitsmoke@v.nix.is. Once you have a username
716- and password you'll be able to do:
717-
718- SMOKE_USERNAME=<username> SMOKE_PASSWORD=<password> make smoke_report
719-
720- You can also add an additional comment to attach to the report, and/or
721- a comma separated list of tags:
722-
723- SMOKE_USERNAME=<username> SMOKE_PASSWORD=<password> \
724- SMOKE_COMMENT=<comment> SMOKE_TAGS=<tags> \
725- make smoke_report
726-
727- Once the report is uploaded it'll be made available at
728- http://smoke.git.nix.is, here's an overview of Recent Smoke Reports
729- for Git:
730-
731- http://smoke.git.nix.is/app/projects/smoke_reports/1
732-
733- The reports will also be mirrored to GitHub every few hours:
734-
735- http://github.com/gitsmoke/smoke-reports
736-
737- The Smolder SQLite database is also mirrored and made available for
738- download:
739-
740- http://github.com/gitsmoke/smoke-database
741-
742- Note that the database includes hashed (with crypt()) user passwords
743- and E-Mail addresses. Don't use a valuable password for the smoke
744- service if you have an account, or an E-Mail address you don't want to
745- be publicly known. The user accounts are just meant to be convenient
746- labels, they're not meant to be secure.
0 commit comments