diff --git a/lib/bcrypt/password.rb b/lib/bcrypt/password.rb
index 4a2c140..3160c9b 100644
--- a/lib/bcrypt/password.rb
+++ b/lib/bcrypt/password.rb
@@ -73,6 +73,8 @@ def initialize(raw_hash)
     #    @password == @password.to_s      # => False
     #    @password.to_s == @password      # => True
     #    @password.to_s == @password.to_s # => True
+    #
+    #    secret == @password              # => probably False, because the secret is not a BCrypt::Password instance.
     def ==(secret)
       super(BCrypt::Engine.hash_secret(secret, @salt))
     end