From 2ef3e420679b981f2e1f24278b00c83b082a2497 Mon Sep 17 00:00:00 2001
From: Akinori MUSHA <knu@idaemons.org>
Date: Fri, 12 Apr 2013 01:19:03 +0900
Subject: [PATCH] Add a note about the for_domain flag in the rdoc for
 CookieJar#add().

---
 lib/http/cookie_jar.rb | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/lib/http/cookie_jar.rb b/lib/http/cookie_jar.rb
index c30db5d..5ca066b 100644
--- a/lib/http/cookie_jar.rb
+++ b/lib/http/cookie_jar.rb
@@ -49,6 +49,10 @@ class HTTP::CookieJar
   # any case.  A given cookie must have domain and path attributes
   # set, or ArgumentError is raised.
   #
+  # Whether a cookie with the `for_domain` flag on overwrites another
+  # with the flag off or vice versa depends on the store used.  See
+  # individual store classes for that matter.
+  #
   # ### Compatibility Note for Mechanize::Cookie users
   #
   # In HTTP::Cookie, each cookie object can store its origin URI