Skip Menu |

This queue is for tickets about the MailTools CPAN distribution.

Report information
The Basics
Id: 129633
Status: resolved
Priority: 0/
Queue: MailTools

People
Owner: MARKOV [...] cpan.org
Requestors: sven-perl [...] sven.de
Cc:
AdminCc:

Bug Information
Severity: Unimportant
Broken in: 2.20
Fixed in: (no value)



Subject: Documentation bug in Mail::Send
The documentation states: METHODS Constructors Mail::Send->new(PAIRS) A list of header fields (provided as key-value PAIRS) can be used to initialize the object. However, passing a key-value pair such as "Reply-To" => "user@example.com" will fail with the error "no such method reply-to" because the documentation is wrong. You can only pass names of existing methods ("subject", "bcc", "cc" and "to"). Idealls you would add code that allows extra headers to be set (as per my example) or you change the documentation to reflect the current situation.
CC: ;
Subject: Re: [rt.cpan.org #129633] Documentation bug in Mail::Send
Date: Tue, 21 May 2019 16:31:36 +0200
To: Sven Neuhaus via RT <bug-MailTools [...] rt.cpan.org>
From: Mark Overmeer <mark [...] nluug.nl>
Hi Sven, I totally agree with you that the docs need improvement. I have extended the text. Just released it to CPAN. It is useless to add more convenience methods, because the list of headers which a modern message may need is huge. Simply use add() (better use the Email::* or Mail::Box email frameworks) Thanks, MarkOv * Sven Neuhaus via RT (bug-MailTools@rt.cpan.org) [190521 12:50]: Show quoted text
> Tue May 21 08:49:23 2019: Request 129633 was acted upon. > Transaction: Ticket created by sven-github@sven.de > Queue: MailTools > Subject: Documentation bug in Mail::Send > Ticket <URL: https://rt.cpan.org/Ticket/Display.html?id=129633 > > > The documentation states: > > METHODS > Constructors > Mail::Send->new(PAIRS) > A list of header fields (provided as key-value PAIRS) can be > used to initialize the object. > > However, passing a key-value pair such as "Reply-To" => > "user@example.com" will fail with the error "no such method reply-to" > because the documentation is wrong. You can only pass names of existing > methods ("subject", "bcc", "cc" and "to").
------------------------------------------------------------------------ drs Mark A.C.J. Overmeer MARKOV Solutions Mark@Overmeer.net solutions@overmeer.net http://Mark.Overmeer.net http://solutions.overmeer.net
Documentation improvements were included in 2.21