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