put the rdoc for should, should_not, and expect where yard can pick i…

…t up

lib/rspec/expectations/syntax.rb

@@ -6,33 +6,41 @@ module Expectations
     module Syntax
       extend self
 
+      # @method should
+      # Passes if `matcher` returns true.  Available on every `Object`.
+      # @example
+      #   actual.should eq expected
+      #   actual.should match /expression/
+      # @param [Matcher]
+      #   matcher
+      # @param [String] message optional message to display when the expectation fails
+      # @return [Boolean] true if the expectation succeeds (else raises)
+      # @see RSpec::Matchers
+
+      # @method should_not
+      # Passes if `matcher` returns false.  Available on every `Object`.
+      # @example
+      #   actual.should_not eq expected
+      # @param [Matcher]
+      #   matcher
+      # @param [String] message optional message to display when the expectation fails
+      # @return [Boolean] false if the negative expectation succeeds (else raises)
+      # @see RSpec::Matchers
+
+      # @method expect
+      # Wraps `target` in an `ExpectationTarget`
+      # @return [ExpectationTarget]
+
       # @api private
       # Enables the `should` syntax.
       def enable_should(syntax_host = ::Kernel)
         return if should_enabled?(syntax_host)
 
         syntax_host.module_eval do
-          # Passes if +matcher+ returns true.  Available on every +Object+.
-          # @example
-          #   actual.should eq(expected)
-          #   actual.should be > 4
-          # @param [Matcher]
-          #   matcher
-          # @param [String] message optional message to display when the expectation fails
-          # @return [Boolean] true if the expectation succeeds (else raises)
-          # @see RSpec::Matchers
           def should(matcher=nil, message=nil, &block)
             RSpec::Expectations::PositiveExpectationHandler.handle_matcher(self, matcher, message, &block)
           end
 
-          # Passes if +matcher+ returns false.  Available on every +Object+.
-          # @example
-          #   actual.should_not eq(expected)
-          # @param [Matcher]
-          #   matcher
-          # @param [String] message optional message to display when the expectation fails
-          # @return [Boolean] false if the negative expectation succeeds (else raises)
-          # @see RSpec::Matchers
           def should_not(matcher=nil, message=nil, &block)
             RSpec::Expectations::NegativeExpectationHandler.handle_matcher(self, matcher, message, &block)
           end
@@ -88,4 +96,3 @@ def expect_enabled?(syntax_host = ::RSpec::Matchers)
     end
   end
 end
-