diff --git a/Library/Homebrew/formula.rb b/Library/Homebrew/formula.rb
index c604687669..2ef9d62987 100644
--- a/Library/Homebrew/formula.rb
+++ b/Library/Homebrew/formula.rb
@@ -53,7 +53,7 @@ class Formula
 
   # The currently active SoftwareSpec.
   # Defaults to stable unless `--devel` or `--HEAD` is passed.
-  # @private
+  # @api private
   attr_reader :active_spec
 
   # The {PkgVersion} for this formula with version and {#revision} information.
@@ -329,7 +329,7 @@ class Formula
   end
 
   # yields self with current working directory set to the uncompressed tarball
-  # @private
+  # @api private
   def brew
     validate_attributes :name, :version