Clarify and emphasize signed_at/max_age (elixir-plug#49)

Author: chrismccord

lib/plug/crypto.ex

@@ -175,9 +175,9 @@ defmodule Plug.Crypto do
       when generating the encryption and signing keys. Defaults to 32
     * `:key_digest` - option passed to `Plug.Crypto.KeyGenerator`
       when generating the encryption and signing keys. Defaults to `:sha256`
-    * `:signed_at` - set the timestamp of the token in seconds.
-      Defaults to `System.os_time(:millisecond)`
-    * `:max_age` - the default maximum age of the token. Defaults to
+    * `:signed_at` - set the timestamp of the token in **seconds**.
+      If no value is provided, it will be set to the current time.
+    * `:max_age` - the default maximum age in **seconds** of the token. Defaults to
       `86400` seconds (1 day) and it may be overridden on `verify/4`.
 
   """
@@ -203,9 +203,9 @@ defmodule Plug.Crypto do
       when generating the encryption and signing keys. Defaults to 32
     * `:key_digest` - option passed to `Plug.Crypto.KeyGenerator`
       when generating the encryption and signing keys. Defaults to `:sha256`
-    * `:signed_at` - set the timestamp of the token in seconds.
-      Defaults to `System.os_time(:millisecond)`
-    * `:max_age` - the default maximum age of the token. Defaults to
+    * `:signed_at` - set the timestamp of the token in **seconds**.
+      If no value is provided, it will be set to the current time.
+    * `:max_age` - the default maximum age in **seconds** of the token. Defaults to
       `86400` seconds (1 day) and it may be overridden on `decrypt/4`.
 
   """
@@ -264,7 +264,7 @@ defmodule Plug.Crypto do
   ## Options
 
     * `:max_age` - verifies the token only if it has been generated
-      "max age" ago in seconds. Defaults to the max age signed in the
+      "max age" ago in **seconds**. Defaults to the max age signed in the
       token (86400)
     * `:key_iterations` - option passed to `Plug.Crypto.KeyGenerator`
       when generating the encryption and signing keys. Defaults to 1000
@@ -296,7 +296,7 @@ defmodule Plug.Crypto do
   ## Options
 
     * `:max_age` - verifies the token only if it has been generated
-      "max age" ago in seconds. A reasonable value is 1 day (86400
+      "max age" ago in **seconds**. A reasonable value is 1 day (86400
       seconds)
     * `:key_iterations` - option passed to `Plug.Crypto.KeyGenerator`
       when generating the encryption and signing keys. Defaults to 1000