diff --git a/lib/capybara/node/actions.rb b/lib/capybara/node/actions.rb
index 713113b6..21c0b5fa 100644
--- a/lib/capybara/node/actions.rb
+++ b/lib/capybara/node/actions.rb
@@ -20,8 +20,7 @@ module Capybara
# alt text inside the link.
#
# @param [String] locator text, id, title or nested image's alt attribute
- # @param options
- # @option options [String, Regexp] :href The value the href attribute must equal
+ # @param options See {Capybara::Node::Finders#find_link}
#
def click_link(locator, options={})
find(:link, locator, options).click
@@ -29,10 +28,13 @@ module Capybara
##
#
- # Finds a button by id, text, value or title and clicks it.
- #
- # @param [String] locator Text, id, value or title of button
+ # Finds a button on the page and clicks it.
+ # This can be any \ element of type submit, reset, image, button or it can be a
+ # \