On Mon, Oct 31, 2016 at 7:46 PM, Martin Karlgren marty@roxen.com wrote:
New proposal: MIME.decode_words_text_remapped is the single most obvious way to decode a Subject header (among others), but that's really not obvious from the docs. Can we somehow make that more discoverable? I ended up implementing my own version of that (tediously and buggily [1]), then wanting to fold that into core so other people don't.
Copy+paste of Marcus Comstedt’s reply in LysKOM:
"It would probably make sense to link to decode_words_text and decode_words_tokenized from the entries for MIME.parse_headers and MIME.Message->headers. The various specializations (including _mapped) are then cross-linked from there.”
Good plan. I've added some copy to those exact places. Also, have mentioned RFC 2047 alongside RFC 1522; when I did my research, it was 2047 that I found (since it's the current standard), and searching the docs for that number came up blank. (2047 is the current standard; 1522 is when these were first introduced. Like 2822 vs 822.)
ChrisA