Skip to content
Snippets Groups Projects
Commit c516e6b2 authored by Jennifer Hodgdon's avatar Jennifer Hodgdon
Browse files

Issue #1629994 by oadaeh, Aron Novak, yurtboy: Reference correct RFC in mail...

Issue #1629994 by oadaeh, Aron Novak, yurtboy: Reference correct RFC in mail functions documentation
parent 609a3352
No related branches found
No related tags found
No related merge requests found
...@@ -991,7 +991,7 @@ function t($string, $args = array(), $langcode = NULL) { ...@@ -991,7 +991,7 @@ function t($string, $args = array(), $langcode = NULL) {
/** /**
* Verifies the syntax of the given e-mail address. * Verifies the syntax of the given e-mail address.
* *
* See RFC 2822 for details. * See @link http://tools.ietf.org/html/rfc5322 RFC 5322 @endlink for details.
* *
* @param $mail * @param $mail
* A string containing an e-mail address. * A string containing an e-mail address.
......
...@@ -59,11 +59,13 @@ ...@@ -59,11 +59,13 @@
* will be {$module}_{$key}. * will be {$module}_{$key}.
* @param $to * @param $to
* The e-mail address or addresses where the message will be sent to. The * The e-mail address or addresses where the message will be sent to. The
* formatting of this string must comply with RFC 2822. Some examples are: * formatting of this string must comply with
* user@example.com * @link http://tools.ietf.org/html/rfc5322 RFC 5322 @endlink.
* user@example.com, anotheruser@example.com * Some examples are:
* User <user@example.com> * - user@example.com
* User <user@example.com>, Another User <anotheruser@example.com> * - user@example.com, anotheruser@example.com
* - User <user@example.com>
* - User <user@example.com>, Another User <anotheruser@example.com>
* @param $language * @param $language
* Language object to use to compose the e-mail. * Language object to use to compose the e-mail.
* @param $params * @param $params
...@@ -72,6 +74,7 @@ ...@@ -72,6 +74,7 @@
* Sets From to this value, if given. * Sets From to this value, if given.
* @param $send * @param $send
* Send the message directly, without calling drupal_mail_send() manually. * Send the message directly, without calling drupal_mail_send() manually.
*
* @return * @return
* The $message array structure containing all details of the * The $message array structure containing all details of the
* message. If already sent ($send = TRUE), then the 'result' element * message. If already sent ($send = TRUE), then the 'result' element
...@@ -145,26 +148,24 @@ function drupal_mail($module, $key, $to, $language, $params = array(), $from = N ...@@ -145,26 +148,24 @@ function drupal_mail($module, $key, $to, $language, $params = array(), $from = N
* how $message is composed. * how $message is composed.
* *
* @param $message * @param $message
* Message array with at least the following elements: * Message array with at least the following elements:
* - id * - id: A unique identifier of the e-mail type. Examples:
* A unique identifier of the e-mail type. Examples: 'contact_user_copy', * 'contact_user_copy', 'user_password_reset'.
* 'user_password_reset'. * - to: The mail address or addresses where the message will be sent to. The
* - to * formatting of this string must comply with
* The mail address or addresses where the message will be sent to. The * @link http://tools.ietf.org/html/rfc5322 RFC 5322 @endlink.
* formatting of this string must comply with RFC 2822. Some examples are: * Some examples are:
* user@example.com * - user@example.com
* user@example.com, anotheruser@example.com * - user@example.com, anotheruser@example.com
* User <user@example.com> * - User <user@example.com>
* User <user@example.com>, Another User <anotheruser@example.com> * - User <user@example.com>, Another User <anotheruser@example.com>
* - subject * - subject: Subject of the e-mail to be sent. This must not contain any
* Subject of the e-mail to be sent. This must not contain any newline * newline characters, or the mail may not be sent properly.
* characters, or the mail may not be sent properly. * - body: Message to be sent. Accepts both CRLF and LF line-endings.
* - body * E-mail bodies must be wrapped. You can use drupal_wrap_mail() for
* Message to be sent. Accepts both CRLF and LF line-endings. * smart plain text wrapping.
* E-mail bodies must be wrapped. You can use drupal_wrap_mail() for * - headers: Associative array containing all mail headers.
* smart plain text wrapping. *
* - headers
* Associative array containing all mail headers.
* @return * @return
* Returns TRUE if the mail was successfully accepted for delivery, * Returns TRUE if the mail was successfully accepted for delivery,
* FALSE otherwise. * FALSE otherwise.
...@@ -254,6 +255,7 @@ function drupal_wrap_mail($text, $indent = '') { ...@@ -254,6 +255,7 @@ function drupal_wrap_mail($text, $indent = '') {
* @param $allowed_tags (optional) * @param $allowed_tags (optional)
* If supplied, a list of tags that will be transformed. If omitted, all * If supplied, a list of tags that will be transformed. If omitted, all
* all supported tags are transformed. * all supported tags are transformed.
*
* @return * @return
* The transformed string. * The transformed string.
*/ */
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment