Merge Trac notification documentation

[Ryan J Ollos]

The following documentation was removed from the TracNotification page in this change. The Option documentation will be updated using this info.

• smtp_enabled: Enable email notification.
• smtp_from: Email address to use for Sender-headers in notification emails.
• smtp_from_name: Sender name to use for Sender-headers in notification emails.
• smtp_from_author: (since 1.0) Use the author of a change (the reporter of a new ticket, or the author of a comment) as the From: header value in notification e-mails (default: false). If the author hasn't set an e-mail address, smtp_from and smtp_from_name are used instead.
• smtp_replyto: Email address to use for Reply-To-headers in notification emails.
• smtp_default_domain: (since 0.10) Append the specified domain to addresses that do not contain one. Fully qualified addresses are not modified. The default domain is appended to all username/login for which an email address cannot be found from the user settings.
• smtp_always_cc: List of email addresses to always send notifications to. Typically used to post ticket changes to a dedicated mailing list.
• smtp_always_bcc: (since 0.10) List of email addresses to always send notifications to, but keeps addresses not visible from other recipients of the notification email
• smtp_subject_prefix: (since 0.10.1) Text that is inserted before the subject of the email. Set to "__default__" by default, to mean a prefix like [project_name].
• always_notify_reporter: Always send notifications to any address in the reporter field (default: false).
• always_notify_owner: (since 0.9) Always send notifications to the address in the owner field (default: false).
• always_notify_updater: (since 0.10) Always send notifications to the person who causes the ticket property change and to any previous updater of that ticket (default: true).
• use_public_cc: (since 0.10) Addresses in To: (owner, reporter) and Cc: lists are visible by all recipients (default is Bcc: - hidden copy).
• use_short_addr: (since 0.10) Enable delivery of notifications to addresses that do not contain a domain (i.e. do not end with @<domain.com>).This option is useful for intranets, where the SMTP server can handle local addresses and map the username/login to a local mailbox. See also smtp_default_domain. Do not use this option with a public SMTP server.
• ignore_domains: (since 0.11) Comma-separated list of domains that should not be considered part of email addresses (for usernames with Kerberos domains).
• admit_domains: (since 0.11) Comma-separated list of domains that should be considered as valid for email addresses (such as localdomain).
• mime_encoding: (since 0.10) This option allows selecting the MIME encoding scheme. Supported values:
  • none: default value, uses 7bit encoding if the text is plain ASCII, or 8bit otherwise.
  • base64: works with any kind of content. May cause some issues with touchy anti-spam/anti-virus engines.
  • qp or quoted-printable: best for european languages (more compact than base64) if 8bit encoding cannot be used.
• ambiguous_char_width: (since 0.12.2) Which width of ambiguous characters (e.g. 'single' or 'double') should be used in the table of notification mail. If 'single', the same width as characters in US-ASCII. This is expected by most users. If 'double', twice the width of US-ASCII characters. This is expected by CJK users.
• ticket_subject_template: (since 0.11) A ​Genshi text template snippet used to get the notification subject.
• batch_subject_template: (since 1.0) Like ticket_subject_template but for batch modifications.
• email_sender: (since 0.12) Name of the component implementing IEmailSender. This component is used by the notification system to send emails. Trac currently provides the following components:
  • SmtpEmailSender: connects to an SMTP server (default).
  • SendmailEmailSender: runs a sendmail-compatible executable.

Either smtp_from or smtp_replyto (or both) must be set, otherwise Trac refuses to send notification mails.

The following options are specific to email delivery through SMTP.

• smtp_server: SMTP server used for notification messages.
• smtp_port: (since 0.9) Port used to contact the SMTP server.
• smtp_user: (since 0.9) User name for authentication SMTP account.
• smtp_password: (since 0.9) Password for authentication SMTP account.
• use_tls: (since 0.10) Toggle to send notifications via a SMTP server using ​TLS, such as GMail.

The following option is specific to email delivery through a sendmail-compatible executable.

• sendmail_path: (since 0.12) Path to the sendmail executable. The sendmail program must accept the -i and -f options.

[Ryan J Ollos]

I was motivated by this edit. I can't see any reason to keep the same documentation in multiple places.

[Ryan J Ollos]

Proposed changes in log:rjollos.git:t11658.

[Ryan J Ollos]

Committed to trunk in [12958].