Changes between Version 9 and Version 10 of FAQ/Using YAM

Timestamp:

May 11, 2012 3:10:51 PM (13 months ago)

Author:

damato

Comment:

--

FAQ/Using YAM

@@ -92 +92 @@
 We are looking forward to receive your translations.
 
+== Mail reading ==
 
+=== Why are some mails displayed without any text content which got displayed properly some weeks ago? ===
+Mails may contain several "streams", like the normal text and attachments. The text however may also exist in more than just one variant. The standard allows plain text and HTML text to coexist within one mail, but in this case both parts must contain the same text, even if they are displayed differently.
+
+Now some very smart companies, but this also applies for spam mails, decide to fill only the HTML part with their message and leave the alternative text part empty. Most mail clients on other systems prefer to display HTML text this goes unnoticed by the masses and nobody complains. Since YAM still prefers plain text over other alternatives and hence will display a mail with no body at all.
+
+However, this can be worked around. Open the config window, go to the "Read" page and activate the options "Display all texts" and "Show alternative parts". This will let YAM display the alternative HTML part as an attachment and additionally will show this HTML part converted to text.
+
+=== When displaying an email with embedded soft-styles such as bold/italic, etc. the mail will be displayed with the style markers '*' as well, why? ===
+In versions previous to YAM 2.5+, email messages were displayed with the soft style markers in a mail. However, this cause severe trouble in case a style marker was incorrectly recognized so that text was mixed up. Especially for formatted text like stylished ASCII-art signatures or documentations this ended up in a completly mixed up display of the email. In addition, other mainstream email programs also didn't strip the soft-style markers for the very same reasons.
+
+Example:
+Considering that an author of an email wrote a short ASCII-art documentation in an email to e.g. explain a bit mask that he used and where he wanted to highlight the first bit as important in bold:
+
+{{{
+0      1 0 1 1
+|      | | | |
+|      | | | bit5
+*bit1* | | bit4
+       | bit3
+       bit2
+}}}
+
+Due to the used '*' bold-style characters this may have ended up looking like the following in YAM < 2.5 because the '*' chars were completly replaced by the bold style only:
+
+{{{
+0      1 0 1 1
+|      | | | |
+|      | | | bit5
+bit1 | | bit4
+       | bit3
+       bit2
+}}}
+
+As can be seen in that example, the ASCII-art here is completly mixed up due to the removed "*" bold-style characters.
+
+However, now with YAM 2.5+ these kind of problems were fixed by keeping those soft-style characters in the showed mail text so that the above example now perfectly ends up being display correctly with the bold style and its markers:
+
+{{{
+0      1 0 1 1
+|      | | | |
+|      | | | bit5
+*bit1* | | bit4
+       | bit3
+       bit2
+}}}
+
+In addition to that fix, it is now more easily possible to spot which character can be used to start writing a word in bold style rather than having to always use the corresponding toolbar button.
+