diff --git a/Library/Homebrew/tap.rb b/Library/Homebrew/tap.rb
index f973836341fcae7611c01ba5642aab99edc28005..436ff89ccb8c86ea26899d18d12c5cfb3b859f6e 100644
--- a/Library/Homebrew/tap.rb
+++ b/Library/Homebrew/tap.rb
@@ -149,15 +149,19 @@ class Tap
     @command_files ||= Pathname.glob("#{path}/cmd/brew-*").select(&:executable?)
   end
 
+  # path to the pin record for this {Tap}.
+  # @private
   def pinned_symlink_path
     HOMEBREW_LIBRARY/"PinnedTaps/#{@name}"
   end
 
+  # True if this {Tap} has been pinned.
   def pinned?
     return @pinned if instance_variable_defined?(:@pinned)
     @pinned = pinned_symlink_path.directory?
   end
 
+  # pin this {Tap}.
   def pin
     raise TapUnavailableError, name unless installed?
     raise TapPinStatusError.new(name, true) if pinned?
@@ -165,6 +169,7 @@ class Tap
     @pinned = true
   end
 
+  # unpin this {Tap}.
   def unpin
     raise TapUnavailableError, name unless installed?
     raise TapPinStatusError.new(name, false) unless pinned?