Merge pull request #47452 from nextcloud/fix/issue-47447-mail-provider-documentation

fix: correct documentation for mail provider
This commit is contained in:
Sebastian Krupinski 2024-08-23 12:34:19 -04:00 committed by GitHub
commit e5e795c935
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
4 changed files with 21 additions and 21 deletions

View file

@ -43,7 +43,7 @@ interface IMessage {
*
* @since 30.0.0
*
* @param IAddress|null sender's mail address object
* @return IAddress|null sender's mail address object
*/
public function getFrom(): IAddress | null;
@ -63,7 +63,7 @@ interface IMessage {
*
* @since 30.0.0
*
* @param IAddress|null sender's reply to mail address object
* @return IAddress|null sender's reply to mail address object
*/
public function getReplyTo(): IAddress | null;
@ -83,7 +83,7 @@ interface IMessage {
*
* @since 30.0.0
*
* @param array<int,IAddress> collection of all recipient mail address objects
* @return array<int,IAddress> collection of all recipient mail address objects
*/
public function getTo(): array;
@ -103,7 +103,7 @@ interface IMessage {
*
* @since 30.0.0
*
* @param array<int,IAddress> collection of all copied recipient mail address objects
* @return array<int,IAddress> collection of all copied recipient mail address objects
*/
public function getCc(): array;
@ -123,7 +123,7 @@ interface IMessage {
*
* @since 30.0.0
*
* @param array<int,IAddress> collection of all blind copied recipient mail address objects
* @return array<int,IAddress> collection of all blind copied recipient mail address objects
*/
public function getBcc(): array;
@ -143,7 +143,7 @@ interface IMessage {
*
* @since 30.0.0
*
* @param string|null subject of message or null if one is not set
* @return string|null subject of message or null if one is not set
*/
public function getSubject(): string | null;
@ -166,7 +166,7 @@ interface IMessage {
*
* @since 30.0.0
*
* @param string|null html/plain body of this message or null if one is not set
* @return string|null html/plain body of this message or null if one is not set
*/
public function getBody(): string | null;
@ -186,7 +186,7 @@ interface IMessage {
*
* @since 30.0.0
*
* @param string|null html body of this message or null if one is not set
* @return string|null html body of this message or null if one is not set
*/
public function getBodyHtml(): string | null;
@ -206,7 +206,7 @@ interface IMessage {
*
* @since 30.0.0
*
* @param string|null plain text body of this message or null if one is not set
* @return string|null plain text body of this message or null if one is not set
*/
public function getBodyPlain(): string | null;

View file

@ -28,6 +28,6 @@ interface IMessageSend {
*
* @throws \OCP\Mail\Provider\Exception\SendException on failure, check message for reason
*/
public function sendMessage(IMessage $message, array $option = []): void;
public function sendMessage(IMessage $message, array $options = []): void;
}

View file

@ -30,7 +30,7 @@ interface IService {
/**
* checks if a service is able of performing an specific action
*
* @since 4.0.0
* @since 30.0.0
*
* @param string $value required ability e.g. 'MessageSend'
*
@ -41,7 +41,7 @@ interface IService {
/**
* retrieves a collection of what actions a service can perfrom
*
* @since 4.0.0
* @since 30.0.0
*
* @return array collection of abilities otherwise empty collection
*/

View file

@ -63,7 +63,7 @@ class Message implements \OCP\Mail\Provider\IMessage {
*
* @since 30.0.0
*
* @param IAddress|null sender's mail address object
* @return IAddress|null sender's mail address object
*/
public function getFrom(): IAddress | null {
// evaluate if data store field exists and return value(s) or null otherwise
@ -91,7 +91,7 @@ class Message implements \OCP\Mail\Provider\IMessage {
*
* @since 30.0.0
*
* @param IAddress|null sender's reply to mail address object
* @return IAddress|null sender's reply to mail address object
*/
public function getReplyTo(): IAddress | null {
// evaluate if data store field exists and return value(s) or null otherwise
@ -119,7 +119,7 @@ class Message implements \OCP\Mail\Provider\IMessage {
*
* @since 30.0.0
*
* @param array<int,IAddress> collection of all recipient mail address objects
* @return array<int,IAddress> collection of all recipient mail address objects
*/
public function getTo(): array {
// evaluate if data store field exists and return value(s) or empty collection
@ -147,7 +147,7 @@ class Message implements \OCP\Mail\Provider\IMessage {
*
* @since 30.0.0
*
* @param array<int,IAddress> collection of all copied recipient mail address objects
* @return array<int,IAddress> collection of all copied recipient mail address objects
*/
public function getCc(): array {
// evaluate if data store field exists and return value(s) or empty collection
@ -175,7 +175,7 @@ class Message implements \OCP\Mail\Provider\IMessage {
*
* @since 30.0.0
*
* @param array<int,IAddress> collection of all blind copied recipient mail address objects
* @return array<int,IAddress> collection of all blind copied recipient mail address objects
*/
public function getBcc(): array {
// evaluate if data store field exists and return value(s) or empty collection
@ -203,7 +203,7 @@ class Message implements \OCP\Mail\Provider\IMessage {
*
* @since 30.0.0
*
* @param string|null subject of message or null if one is not set
* @return string|null subject of message or null if one is not set
*/
public function getSubject(): string | null {
// evaluate if data store field exists and return value(s) or null otherwise
@ -238,7 +238,7 @@ class Message implements \OCP\Mail\Provider\IMessage {
*
* @since 30.0.0
*
* @param string|null html/plain body of this message or null if one is not set
* @return string|null html/plain body of this message or null if one is not set
*/
public function getBody(): string | null {
// evaluate if data store field(s) exists and return value
@ -272,7 +272,7 @@ class Message implements \OCP\Mail\Provider\IMessage {
*
* @since 30.0.0
*
* @param string|null html body of this message or null if one is not set
* @return string|null html body of this message or null if one is not set
*/
public function getBodyHtml(): string | null {
// evaluate if data store field exists and return value(s) or null otherwise
@ -300,7 +300,7 @@ class Message implements \OCP\Mail\Provider\IMessage {
*
* @since 30.0.0
*
* @param string|null plain text body of this message or null if one is not set
* @return string|null plain text body of this message or null if one is not set
*/
public function getBodyPlain(): string | null {
// evaluate if data store field exists and return value(s) or null otherwise