mirror of
https://github.com/mailscope/kumomta.git
synced 2026-08-19 19:08:17 +00:00
Wez Furlong
67bf14ca20
Augment the docs to clarify that msg:append_header and msg:prepend_header do no modification of the value by default. Adjust the wrapping used by Header:new_unstructured so that it hard wraps before the SMTP line length limit. Add optional encode parameter to msg:append_header and msg:prepend_header so that those methods can opt-in to the Header:new_unstructured formatting. Add HeaderMap:append method to mirror the existing HeaderMap:prepend method. Add unit tests that demonstrate the effect of wrapping/encoding for both the "dumb" msg:append_header and msg:prepend_header functions, and the "smarter" HeaderMap:prepend and HeaderMap:append methods that always encode their parameters. Update the docs for the headermap flavor of these methods to indicate that they will always encode the value.
22 lines
485 B
Markdown
22 lines
485 B
Markdown
# prepend
|
|
|
|
```lua
|
|
headers:prepend(NAME, VALUE)
|
|
```
|
|
|
|
{{since('2025.10.06-5ec871ab')}}
|
|
|
|
Constructs a new header with `NAME` and `VALUE` and prepends it to the header map.
|
|
|
|
If the header value is ascii then it will be soft wrapped at whitespace around
|
|
75 columns, and hard-wrapped regardless of whitespace at 900 columns.
|
|
|
|
If the header value is non-ascii then it will be quoted printable encoded using
|
|
RFC 2047 header encoding.
|
|
|
|
```lua
|
|
headers:prepend('X-Something', 'Some value')
|
|
```
|
|
|
|
|