Bug 292643 - The documentation for KIO slave mailto is unsatisfactory
Summary: The documentation for KIO slave mailto is unsatisfactory
Status: RESOLVED FIXED
Alias: None
Product: docs.kde.org
Classification: Websites
Component: general (show other bugs)
Version: unspecified
Platform: openSUSE Linux
: NOR wishlist
Target Milestone: ---
Assignee: Documentation Editorial Team
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2012-01-28 01:14 UTC by Christopher Yeleighton
Modified: 2012-01-28 11:14 UTC (History)
0 users

See Also:
Latest Commit:
Version Fixed In:
Sentry Crash Report:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Christopher Yeleighton 2012-01-28 01:14:16 UTC
Version:           unspecified (using KDE 4.7.2) 
OS:                Linux

The documentation for KIO slave mailto is unsatisfactory.  Moreover, it refers to the mailto utility, which is unlikely to be used with KDE.

Reproducible: Always

Steps to Reproduce:
  1. Read the documentation for KIO slave mailto [1].

Actual Results:  
  1.
The mailto kioslave is used when you click on a mailto link in an HTML page. Konqueror will open the preferred mail client you have configured, with a composer window. Any information supplied in the URL will be filled in for you.

See the manual: mailto.

Expected Results:  
  1.
The KIO slave mailto is responsible for launching the mail composer of your choice when you open a URL in the mailto scheme (RFC6068).

== Syntax ==
The syntax of a mailto URL follows the following pattern:

 mailto:recipients?query

where recipients form a list of restricted SMTP address specifications, and the query part may contain one or more of the following parameters:

&to=recipients
    Specifies additional recipients

&cc=recipients
    Specifies additional recipients of carbon copies

&bcc=recipient
    Specifies additional recipients of blind carbon copies.  These recipients will not know about the other recipients.

&body=text
   Specifies the text of the message.  This text should not be long, as there may be hard limits on how long an URL may be.

== Example ==
    mailto:info@kde.org?cc=kde@kde.org&body=Thanks!%20KDE%20rocks!%20How%20can%20I%20help%3F

== Configuration ==
Choose the application to handle mailto locators in Component Chooser.  



___
[1] <URL: http://docs.kde.org/stable/en/kdelibs/kioslave/mailto/index.html >
Comment 1 Christopher Yeleighton 2012-01-28 10:42:50 UTC
&subject=text
  Specifies the subject of the message.

== Example ==
   
mailto:info@kde.org?cc=kde@kde.org&subject=Thank%20you!&body=KDE%20rocks!%20How%20can%20I%20help%3F
Comment 2 Burkhard Lück 2012-01-28 10:59:59 UTC
Git commit 9e9a7e08e3ea3e3de5fb3b13194438973050f8b2 by Burkhard Lück.
Committed on 28/01/2012 at 11:59.
Pushed by lueck into branch 'KDE/4.8'.

kioslave mailto documentation provided by Christopher Yeleighton, thanks a lot

M  +66   -8    doc/kioslave/mailto/index.docbook

http://commits.kde.org/kdelibs/9e9a7e08e3ea3e3de5fb3b13194438973050f8b2
Comment 3 Burkhard Lück 2012-01-28 11:14:35 UTC
Added with http://commits.kde.org/kdelibs/6cedf636e30caadcdb093472e515d2a4b7e68603

Thanks.