Custom matchers may now work like regular matchers -- just return a boolean, don't call this.report(). The old style still works but is deprecated.

spec/suites/CustomMatchersSpec.js

@@ -9,7 +9,6 @@ describe("Custom Matchers", function() {
 
   it("should be easy to add more matchers local to a spec, suite, etc.", function() {
     var spec1, spec2, spec1Matcher, spec2Matcher;
-
     var suite = env.describe('some suite', function() {
       env.beforeEach(function() {
         this.addMatchers({ matcherForSuite: function(expected) {
@@ -37,5 +36,77 @@ describe("Custom Matchers", function() {
     expect(spec2Matcher.matcherForSuite("expected")).toEqual("matcherForSuite: actual: yyy; expected: expected");
     expect(spec2Matcher.matcherForSpec).toBe(jasmine.undefined);
   });
-  
+
+  it("should generate messages with the same rules as for regular matchers when this.report() is not called", function() {
+    var spec;
+    var suite = env.describe('some suite', function() {
+      spec = env.it('spec with an expectation').runs(function () {
+        this.addMatchers({
+          toBeTrue: function() {
+            return this.actual === true;
+          }
+        });
+        this.expect(true).toBeTrue();
+        this.expect(false).toBeTrue();
+      });
+    });
+
+    suite.execute();
+    var passResult = new jasmine.ExpectationResult({passed: true, matcherName: 'toBeTrue',
+      actual: true, expected: jasmine.undefined, message: "Passed." });
+    var failResult = new jasmine.ExpectationResult({passed: false, matcherName: 'toBeTrue',
+      actual: false, expected: jasmine.undefined, message: "Expected false to be true." });
+    failResult.trace = jasmine.any(Object);
+    expect(spec.results().getItems()).toEqual([passResult, failResult]);
+  });
+
+  it("should pass args", function() {
+    var matcherCallArgs = [];
+    var spec;
+    var suite = env.describe('some suite', function() {
+      spec = env.it('spec with an expectation').runs(function () {
+        this.addMatchers({
+          toBeTrue: function() {
+            matcherCallArgs.push(jasmine.util.argsToArray(arguments));
+            return this.actual === true;
+          }
+        });
+        this.expect(true).toBeTrue();
+        this.expect(false).toBeTrue('arg');
+        this.expect(true).toBeTrue('arg1', 'arg2');
+      });
+    });
+
+    suite.execute();
+    var results = spec.results().getItems();
+    expect(results[0].expected).toEqual(jasmine.undefined);
+    expect(results[1].expected).toEqual('arg');
+    expect(results[2].expected).toEqual(['arg1', 'arg2']);
+
+    expect(matcherCallArgs).toEqual([[], ['arg'], ['arg1', 'arg2']]);
+  });
+
+  describe("in the old style", function() {
+    it("should report deprecation a warning", function() {
+      var spec;
+      var suite = env.describe('some suite', function() {
+        spec = env.it('spec with an expectation').runs(function () {
+          this.addMatchers({
+            toBeTrue: function() {
+              this.report(this.actual === true, this.actual + " was not true.", "details");
+            }
+          });
+          this.expect(true).toBeTrue();
+          this.expect(false).toBeTrue();
+        });
+      });
+
+      suite.execute();
+      var passResult = new jasmine.ExpectationResult({passed: true, message: "Passed.", details: "details"});
+      var failResult = new jasmine.ExpectationResult({passed: false, message: "false was not true.", details: "details"});
+      failResult.trace = jasmine.any(Object);
+      expect(spec.results().getItems()).toEqual([passResult, failResult]);
+    });
+  });
+
 });