From a6d90e094d4e2a84d18859cf2005d10c2020e2d4 Mon Sep 17 00:00:00 2001 From: Jeremy Harris Date: Sat, 11 Mar 2023 17:48:28 +0000 Subject: Header-wrap expansion. Bug 2843 --- doc/doc-docbook/spec.xfpt | 18 ++++++++++++++++++ doc/doc-txt/NewStuff | 2 ++ 2 files changed, 20 insertions(+) (limited to 'doc') diff --git a/doc/doc-docbook/spec.xfpt b/doc/doc-docbook/spec.xfpt index 1367cc6f2..8e2e1d142 100644 --- a/doc/doc-docbook/spec.xfpt +++ b/doc/doc-docbook/spec.xfpt @@ -11060,6 +11060,24 @@ abbreviation &%h%& can be used when &%hash%& is used as an operator. +.new +.vitem &*${headerwrap_*&<&'cols'&>&*_*&<&'limit'&>&*:*&<&'string'&>&*}*& +.cindex header "wrapping operator" +.cindex expansion "header wrapping" +This operator line-wraps its argument in a way useful for headers. +The &'cols'& value gives the column number to wrap after, +the &'limit'& gives a limit number of result characters to truncate at. +Either just the &'limit'& and the preceding underbar, or both, can be omitted; +the defaults are 80 and 998. +Wrapping will be inserted at a space if possible before the +column number is reached. +Whitespace at a chosen wrap point is removed. +A line-wrap consists of a newline followed by a tab, +and the tab is counted as 8 columns. +.wen + + + .vitem &*${hex2b64:*&<&'hexstring'&>&*}*& .cindex "base64 encoding" "conversion from hex" .cindex "expansion" "hex to base64" diff --git a/doc/doc-txt/NewStuff b/doc/doc-txt/NewStuff index 3143e4766..ba204c040 100644 --- a/doc/doc-txt/NewStuff +++ b/doc/doc-txt/NewStuff @@ -25,6 +25,8 @@ Version 4.97 8. New utility exim_msgdate converts message-ids to human readable format. + 9. An expansion operator for wrapping long header lines. + Version 4.96 ------------ -- cgit v1.2.1