wiki:FAQ/Using YAM

Version 13 (modified by damato, 3 years ago) (diff)

--

FAQ Contents

    Error: No page matching Installing YAM found
    Error: No page matching Using YAM found
    Error: No page matching ARexx scripting found

Using YAM

  1. User Interface
    1. Why does the "Colored text" gadget in the Read configuration looks …
    2. Menu shortcuts don't work while context sensitive menus are enabled, why?
    3. The gauge in the mail transfer window looks wrong, why?
    4. Why is keyboard selection of multiple mails not working?
    5. I use AmigaOS 3.9 and activated the AISS theme. Unfortunately some of …
    6. The graphical attachment list is displayed truncated and does not …
    7. Why is the mail preselection/transfer window sometimes active by …
    8. The menu of the write window contains strange "ramiga X", "ramiga C" …
    9. I changed the shortcut definition of TextEditor.mcc to use a …
    10. The attachment icon sometimes suddenly disappears in main mail …
    11. When I use the up/down arrows keys, the scrollbar of the main mail …
    12. Redrawing of the folder listtree is so slow that I can see every …
    13. Can I permanently save the position and size of a window?
    14. Why are some columns of the mail listview always resizing automatically?
    15. The toolbar buttons and other graphics are displayed in wrong colors. Why?
    16. The toolbar buttons don't fit in the window, the rightmost buttons …
    17. The layout of the prefs window doesn't adapt properly when reducing …
    18. Printing doesn't seem to work. What's wrong?
  2. Language Support
    1. There seems to be no translation available for my language?
  3. Mail reading
    1. Why are some mails displayed without any text content which got …
    2. When displaying an email with embedded soft-styles such as …
    3. Doubleclicking an URL doesn't seem to popup my favourite webbrowser?
    4. YAM shows the default icon for attachments rather than the one I …
  4. Mail replying/forwarding
    1. I can't put my initials into or change the quoting string used on …

User Interface

Why does the "Colored text" gadget in the Read configuration looks wrong the first time I open this sheet?

This is a bug in MUI 3.8 and can't unfortunately be worked around in any form. However, it is already fixed in MUI versions >= 3.9. So please update your MUI installation, if possible.

Unfortunatly, the context menus for the folder & message lists may get in your way and prevent you from using the usual menu item shortcuts unless you move the pointer outside the list. Unfortunately this is a bug in MUI <=3.8, which can only worked around by disabling the context menus themselves or upgrading MUI to at least 3.9.

The gauge in the mail transfer window looks wrong, why?

Due to a bug in MUI 3.8, the gauge in the mail transfer window may "overflow" its container when representing very high values, typically around 8 MB and beyond. This bug is harmless, but an updated MUI (3.9 or better) is necessary to properly address this problem. No such update are available for m68k Amigas at the time of writing this article.

Why is keyboard selection of multiple mails not working?

According to the documentation and the configuration GUI of the NList.mcc class (which is used in YAM for displaying the mail list) one should be able to select multiple entries in a Listview by using the CTRL+Up/Down keys. However, when I use these keys the listview scrolls to the beginning or end rather than allowing to select multiple entries. The reason for this problem is, that the default keybindings of NList.mcc and the default keybindings of MUI itself clash. So when you use CTRL+Up/Down the default MUI keybindings will have preference over the NList settings and thus won't trigger the correct functions in NList itself. The solution is to either upgrade to NList release 0.108 or later as the default keybinding have been changed to use ALT+Up/Down rather than CTRL. Just make sure that you reset the keybinding settings in the MUI configuration pane of the NList classes after you have installed 0.108+ of the NList classes. Another solution (for older NList versions) would be to manually change the keybinding settings in the MUI configuration to use the ALT key rather than CTRL key (see all the "Select XXX" entries in the example screenshot below).

Example of NList keyboard config

I use AmigaOS 3.9 and activated the AISS theme. Unfortunately some of the icons display an ugly black background. Why?

The AISS icons are PNG icons which use alpha channels. With AmigaOS 3.9 the transparency can not be displayed correctly because of some incompatibilities between the datatypes.library.

The graphical attachment list is displayed truncated and does not reflect all available attachments. Anything to prevent that?

For mails with lots of single attachments, the graphical display of attachments in a read window might be displayed truncated. This happens in case the attachment list object cannot enlarge itself to the required size (e.g. because the window is to small). Unfortunately it is even not possible to display/use a scrollbar for those cases due to technical reasons.

But as the attachment list is virtual group object you should be able to use the virtual scrolling capabilities of MUI for that case. Please consult the MUI configuration for setting the scroll action hotkey/mouse button. But per default, MUI should allow you to hold down the middle mouse button while moving your mouse. This should then allow you to scroll the attachment list and view the other attachments that are normally hided. Another way for displaying all attachments of a mail is, of course to use the respective toolbar buttons (Display, Print, etc.) which will present you a full list of the attachments.

Why is the mail preselection/transfer window sometimes active by default and sometimes not?

YAM can be configured to show the preselection/transfer window for downloading new mails only if certain conditions are met, for example always, never or only if very large mails are to be downloaded. Since mails can be fetched in the background while you continue your work with YAM it would be very inconvenient if the preselection window would steal the focus from the currently active window (i.e. a write window to compose a new mail). Just imagine that you press "C" in that very moment the preselection window opens. This would immediately cancel the transfer, even if you were just going to type in the word "Commodore"...

To avoid such unwanted abortions YAM will open the preselection/transfer window in inactive state for automatically initiated mail transfers (i.e. timed mail fetch or mail transfers initiated by an ARexx script). For all user initiated transfers (import, export, get/send mail) the window will be activated, because this is an action that was explicitly triggered by the user and not some automechanism triggered by YAM itself.

The menu of the write window contains strange "ramiga X", "ramiga C" shortcut definitions. Why is the typical Amiga image not used instead?

The reason for this shortage has already been adressed in version 2.5 of YAM. However, please find explainations for earlier versions and why there the menuitems couldn't use the typical 'Amiga' images to signal the shortcut: The point is, that the configuration of these shortcuts was up to the user. In fact, TextEditor.mcc provided a configuration management where a user could specify himself which key shortcuts he want to use. The "ramiga X" display was just a placeholder for that - it even was't a real shortcut definition. It should have only pointed out which default key combinations are normally used for these operations. So it was more cosmetical. But as said, in YAM 2.5 the behaviour changed and now the typical Amiga image should be used as expected.

I changed the shortcut definition of TextEditor.mcc to use a non-default shortcut for the Cut&Paste operations. However, YAM still shows e.g. "Amiga+C" in the window.

Since YAM 2.5, the behaviour for the shortcuts of the default Edit actions like Copy&Paste have been changed. This means, that like explained in the previous FAQ item, YAM now always uses the standard shortcuts according to common StlyeGuides. E.g. a Copy operation will always be mapped to "Amiga+C" whereas the Paste operation will be mapped to "Amiga+V" no matter what you have configured in the TextEditor.mcc configuration itself.

For YAM versions prior to 2.5, the situation is slightly different. There, the shortcut which is configured in TextEditor.mcc will always be used and the shown e.g. "ramiga X" placeholder in a window menu is just to show the default if you have TextEditor.mcc set to the default.

The attachment icon sometimes suddenly disappears in main mail listview, why?

In the main mail listview where all your mails in a folder are listed, the Attachment status icon (normally a paper-clip icon) is sometimes shown, but suddenly disappears as soon as you click on that mail for viewing its content. Even if that may look a bit strange and may lead to the impression that attachments are being lost when viewing the mail, this behaviour is normal and correct.

The reason why this is happening is that unfortunately some broken (old) mail clients tend to send out emails where the main content-type is set to "multipart/mixed" or "multipart/related" even if that email just contains one main mail text part without a real attachment. This is clearly incorrect according to the RFC s and can be considered a bug in those email programs. However, the reason why YAM is first showing the attachment status icon is that it just analyzes the main mail header due to performance reasons and as soon as you click on the message a depper (more time consuming) analyze is performed where it automatically recognizes that the mail doesn't really contain any binary or text attachment, but just the main normal mail text.

So the behaviour of YAM is fully correct and in line what the RFC s suggests.

When I use the up/down arrows keys, the scrollbar of the main mail list moves instead of the highlighted mail to be changed. Why?

The cause for this behaviour might be, that you have selected the main mail list via the "Tab" key gadget activation feature of MUI. MUI has a so-called CycleChain feature which allows to cycle through all existing gadgets in a window via the Tab key. In such a case, the main mail list of YAM can be activated via a numerous amount of Tab-key uses.

And as the NList-based main mail list changes it behaviour when it is directly activated via the CycleChain, this is the reason why the scrollbar scrolls when you use the up/down arrows. If an NList class is activated in such a way it will scroll down instead of changing the selection.

However, there is an easy way of solving such a situation. You just have to press "Ctrl+Tab" to signal MUI to unselect all currently active gadget and as such you will find yourself back being able to change the selection in the mail list via the Up/Down arrow keys.

Redrawing of the folder listtree is so slow that I can see every single folder getting redrawn separately. Why?

The reason for the problem you are facing in YAM is, that YAM uses the NListtree.mcc class for rendering the folder list. This class is a subclass of the NList classes and highly depends on the internals of the NList.mcc class itself.

As a matter of fact, the NListtree class is known to be somewhat unoptimized in the fields of redrawing entries. Somehow it seems to massivly redraw items if there is any other window in front of the list it wants to redraw. So, this is a known issue of the NListtree class and will hopefully be adressed in one of the future versions of NListtree.mcc itself.

However, you can perfectly try to avoid that slow redrawing situation by making sure that no other window is in front of the folder listtree in YAM as soon as it requires redrawing.

Can I permanently save the position and size of a window?

Yes, via the normal MUI 'snapshot' feature....

...start the MUI settings interface by selecting 'Settings/MUI'. Select the 'Windows' section and make sure the third of the little system gadget buttons there is activated. After saving the settings every window will have an additional system gadget in the upper right corner. One click on this gadget will snapshot the actual size and position of the window for future sessions. This is a general MUI feature and if you use it on the YAM window you should be able to "snapshot" the window size of YAM permanently.

Why are some columns of the mail listview always resizing automatically?

In fact, this behaviour is very common for NList-based listviews. The 'problem' is, that NList is per default automatically adjusting the size of each column depending on their content width. So if you have a mail with e.g. very long subject lines or if the status column contains a changing amount of status icons, it may happen that NList automatically decided to resize the columns automatically.

While this can be very annoying during normal work, it can also proof quite usefull in some cases. However, there is also the possibility to force NList not to automatically resize a column. For this to happen, you have to drag the vertical separator to the desired size (you actually have to drag it at all) and use the MUI 'snapshot' feature you can normally access via one of the top-right border buttons in the YAM main window.

The toolbar buttons and other graphics are displayed in wrong colors. Why?

This usually happens due to a bug in the 'ilbm.datatype' and only happens if YAM is running on a hicolor or truecolor screen. An update of the ILBM.datatype can be found on Aminet.

The toolbar buttons don't fit in the window, the rightmost buttons can't be accessed. How can I fix this?

Some users think that the graphics are too large, but in fact the button labels are eating so much space. If you're using topaz/8 as the label font, then some of the buttons become invisible on a 640 pixel wide screen. Solution: select 'Settings/MUI' and go to the 'Toolbar' section. Now you can either choose a thinner font (helvetica/9 works well) or switch off the labels completely ('image only' mode).

The layout of the prefs window doesn't adapt properly when reducing its size, any solution available to it?

Yes, we know about it and have already fixed the issues in newer YAM versions. In fact, it was a bug in the layouting of the prefs window of YAM versions <= 2.4p1. Any newer version shouldn't contain that issue anymore.

Printing doesn't seem to work. What's wrong?

The printing engine in YAM is directly using the PRT: device of the operating system you are using. Please make sure you have that device properly configured and verified that you are able to print via PRT:. Besides that, YAM isn't doing anything special on printing.

Language Support

There seems to be no translation available for my language?

Well, as you might know. YAM is open source and as such is highly dependent on on the users (community) - especially when it comes to locale translation. Even if there are organisations like the ATO who are trying to organize a global and free translation service for Amiga applications, we are trying to give individual the chance to contribute their translation.

So if you find that YAM isn't yet fully translated for your language, please have a look at the http://yam.ch/Development/HowToContribute document at our main support site. There you should find information on how to generate your own translation file and also contribute to us.

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.

Doubleclicking an URL doesn't seem to popup my favourite webbrowser?

For automatically popping up your webbrowser upon clicking on an URL in a mail you are view ing in YAM, you require to configure either an external Arexx script to popup the web browser or to install and configure openurl.library and its corresponding tools. Here we are going to discuss both possibilities. However, OpenURL should be considered the default preferred way.

via OpenURL: Before we are going to discuss how to configure OpenURL correctly, please make sure you have the very latest version correctly installed and reachable for YAM. As of writing, the latest version of OpenURL is version 7.2. Please make sure that the following command outputs similar values on you shell:

1> version LIBS:openurl.library full
openurl.library 7.2 (01.12.2005)

In addition, you should have a preferences program 'OpenURL' in you SYS:Prefs drawer. This is the main configuration tool for OpenURL. On a freshly installed OpenURL setup, it contains default settings. However, please note that these defauls do most likely NOT work out-of-the-box. You have to actually change them to your own iternet applications environment. As we are currently only interested in setting up a web browser in OpenURL, we take IBrowse as an example.

So, if you have the preferences application open, you will see different registers for web browsers, mailers and FTP programs you can configure. In 'Browsers' you should find an 'IBrowse' entry with some default settings. Doubleclick on it and make sure the following window shows the similar information:

Example screenshot of OpenURL

Please note, that especially the "Path" setting definitly requires a change, as you are supposed to put in the correct directory/file path to the IBrowse executable. However, make sure that the "%u" part at the very end of the string remains.

Next, make sure that in the main configuration window, the 'Misc' register contains the following settings:

Example screenshot of OpenURL

Now, if you have everything correctly configured and setup according to the above explainations, you should be able to open an URL even from the command line via the C:OpenURL executable that was also supplied with the default OpenURL installation:

1> openurl http://www.yam.ch/

This should, if correctly configured, fire up IBrowse in case it was configured to be the web browser with the highest priority in OpenURL. So please check your OpenURL configuration that e.g. IBrowse is at the top of your configured web browser list. In addition, if the above openurl command didn't succeed with automatically launching your web browser, try to use tools like SnoopDOS or Snoopy for tracking what OpenURL is trying to do when you execute the C:OpenURL command.

If this worked as expected, you can now try to doubleclick on an URL in a mail mesage in YAM (after having restarted YAM). If this still doesn't fire up IBrowse as the C:OpenURL did, then please have a look at the "Scripts" configuration tab in YAM. There, you have to make sure that you have NOT configured any arexx script for handling the doubleclicks on URLs. ("When double-clicking a URL" have to be empty)

via Arexx: If, for whatever reason it might be, you want to use a plain Arexx script for firing up the correct web browser, all you have to do is - go to the 'Scripts' configuration tab in YAM. There, make sure that you have the 'GotoURL.yam' script configured for the doubleclick actions on URLs. In addition, you have to make sure that - if you have YAM 2.5+ running - the script command string contains an %p qualifier at the end, like:

For YAM 2.5+:

YAM:Rexx/GotoURL.yam %p

For older YAM versions:

YAM:Rexx/GotoURL.yam

However, please note again, that the preferred way of configuring a doublick action on URLs is, to use OpenURL instead of the limited Arexx script possibility.

YAM shows the default icon for attachments rather than the one I configured in DefIcons. Why?

YAM 2.5+ introduced a new so-called AttachmentGroup which shows all attachments of a mail in an icon/image bar at the bottom of the mail read window. For each attachment, it will show a seperate icon/image depending on the file type of the attachment. For archieving this, it uses the DefIcon system of the operating system it is runing on. This system allows (through SYS:Prefs/DefIcons) to configure seperate icons for various types of files. Unfortunately, it is limited and especially the way third-party applications like YAM can query the icon/image for a certain file isn't perfect at all. In addition, the way DefIcon identifies a file type is based on certain rules a user can configure in SYS:Prefs/DefIcons where some rules do actually try to analyze the binary content of the file in question and therefore require the actual file to exist.

Now, when YAM is going to show the user the AttachmentGroup, it hasn't decoded all different MIME parts due to performance reasons. This means, that at the time YAM tries to show the user the icon/image for an attachment, it just knows the filename, description and size of the attachment, but it hasn't actually written the binary data of it to disk. So, at the time YAM is going to ask the DefIcons system for the actual icon/image of the file it can't supply the decoded binary and therefore will only show/query for the default type based on the MIME type of the attachment.

However, as soon as the attachment was decoded either because it was viewed/printed/saved from within YAM, the AttachmentGroup will show the correct icon/image based on what DefIcons supplies.

Mail replying/forwarding

I can't put my initials into or change the quoting string used on reply! Why?

In YAM 2.5 we removed the possibility to add your own initials to the quoting string '>' that is normally put in front of every line when you reply to a mail. This was done to conform to common netiquettes and the so-called Son-Of-RFC 1036 and its successors.

The point is, that there are some kind of common rules when creating an email. And one of those rules is the way a text/mail should be quoted. Borrowed from the way quoting was common in Usenet, emails use the same '>' quotation character that is put in front of every replied line in a mail. Previous versions of YAM allowed to put your own initials in that quoting string so that a string like 'JD>' was added on all mails that were quoted by the user John Doe. While this seemed to be a nice and neat way of getting more order into the quoting history, it more or less ends up in more obfuscation of mails, especially in large threads. Another point why such initial quotation strings shouldn't be used is, that there is only a very few amount of mail clients that are able to identify these strings as actual quotations and strip or highlight them accordingly on a reply.

Therefore, we generally removed the possibility to add your own initials to the quote string as well as the graphical elements to change the quotation string in the YAM configuration window. We really believe that compatibility to common rules and RFC s is most important.

For further readings on the pros and cons and how a mail should be properly quoted please have a look at http://learn.to/quote. Keep especially an eye on the 'Quotationsmarks' section that pretty much sums the issue up.

Attachments (3)

Download all attachments as: .zip