Changes between Initial Version and Version 1 of Documentation/Quickstart


Ignore:
Timestamp:
Aug 15, 2012, 12:56:17 PM (2 years ago)
Author:
damato
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/Quickstart

    v1 v1  
     1= Quickstart
     2
     3This chapter is meant to be a step-by-step guide to the way YAM
     4works.  It is assumed that you already have YAM installed on your
     5system and that you're using Miami as your TCP/IP software.
     6
     7If you have used YAM before, you probably can skip this chapter.
     8
     9 1. Get the following information from your Internet provider:
     10    [[BR]]
     11      Your e-mail address[[BR]]
     12      The Internet address of the mail server (so called POP- or SMTP server)[[BR]]
     13      Your password, required to log in on the mail server
     14    As an example here's the setup for a fictitious user named 'John
     15    Doe' living in Britain.  His e-mail address is 'jdoe\@example.com'
     16    and the address of his mail server is 'mail.example.com'.  His
     17    password is 'nguz56'.
     18
     19 2. Start YAM by double-clicking its icon.  After the copyright window
     20    has closed, the main window should open with two listings (folder
     21    list & message list) and a row of buttons.
     22
     23 3. The program must be configured before you can do anything else.
     24    Choose 'Configuration' from the 'Settings' menu or simply click
     25    the button with the question mark to open the configuration
     26    window.  The sheet which then appears is called 'First  Steps',
     27    and this is where you must enter the information needed for data
     28    transfer.  Following our example this is:
     29    [[BR]]
     30      Real Name:     John Doe[[BR]]
     31      Email address: jdoe@example.com[[BR]]
     32      Mail server:   mail.example.com[[BR]]
     33      Password:      nguz56[[BR]]
     34      Time zone:     GMT
     35    For security reasons the password textfield only shows stars, one
     36    for each character you type.  If daylight saving time applies to
     37    you at the time of installation, switch on the adjustment for it
     38    (right beneath the time zone).
     39
     40 4. YAM allows you to define a text passage which will be appended to
     41    all of your e-mail as a complimentary closing phrase.  To define it
     42    you have to click on 'Write' in the list on the left hand side of
     43    the configuration window.  On the page appearing now select the
     44    text field 'Welcome phrase', delete the original text by hitting
     45    RAmiga-X and insert something such as:
     46    [[BR]]
     47      Kind regards,\n  Joe
     48    The control string \n forces a new line after the word
     49    'regards'.
     50
     51 5. Save the settings now by clicking on [Save].  YAM now has sufficient
     52    data to allow you to write your first message.
     53
     54 6. After saving the settings you're back in the main window.  Click
     55    the button 'Write' (sixth button from the left) or choose 'New'
     56    from the 'Message' menu.  The editor window will open.  Insert
     57    the e-mail address of the recipient into the 'To' textfield (e.g.
     58    'jdoe\@example.com').  Normally of course you would put someone
     59    else's address, but right now you want to test the system, so put
     60    your own address instead.  Insert two or three words to indicate
     61    the subject into the 'Subject' text field ('test' will do nicely
     62    for this one!).  Now click in the large blank area and type the
     63    actual message.
     64
     65    If you were using YAM in a normal way, and wished to send copies
     66    (including hidden copies) to anyone, this could be done by clicking
     67    on 'Options', thus activating the third of the three sheets
     68    (Message, Attachments, Options) in the Write window.
     69
     70 7. Assuming you are not currently online (Miami is not running),
     71    click on [Send later].  This sends the message to the 'Outgoing'
     72    folder as opposed to transmitting the message right away [Send
     73    now].
     74
     75 8. Now start Miami and connect to the Internet.  Open the 'Outgoing'
     76    folder by clicking on 'Outgoing' in the folder list contained in
     77    the main window.  Send the message by clicking the 'Send' button
     78    (fifth button from the right hand  side).  The transfer status
     79    window will appear and report progress as YAM logs in on the
     80    mail server and sends the message.
     81
     82 9. As you've probably noticed the mail has vanished from the
     83    'Outgoing' folder.  Don't panic!  It has been moved to the 'Sent'
     84    folder.  The letter symbol in the list has a little stamp on it
     85    now, which means that the message has been sent successfully.
     86
     8710. When you double-click the message, the read window will open.
     88    You should be able to recognize the text written by you. The lines
     89    in the upper part of the message have been inserted by YAM and
     90    contain data needed for mail transfer (the so-called "headers").
     91
     9211. Since you've written the mail to yourself you should start looking
     93    for new mail now.  Click the read window to the background or close
     94    it, then click on the 'Get' button (sixth button from the right
     95    hand side).
     96
     9712. The transfer status window you saw before opens again and you can
     98    watch how YAM downloads your mail from the mail server.  Provided
     99    that everything runs as it should, a requester will open up with
     100    the message that you  have received new mail.  You can read the
     101    mail in the 'Incoming' folder.
     102
     103If you've made it this far without major problems, you now know the
     104essential functions of YAM.  For further explanations and more detailed
     105information on single topics, please read the following chapters.
     106