[kde-doc-english] [Bug 292643] New: The documentation for KIO slave mailto is unsatisfactory

[Christopher Yeleighton]

https://bugs.kde.org/show_bug.cgi?id=292643

           Summary: The documentation for KIO slave mailto is
                    unsatisfactory
           Product: docs
           Version: unspecified
          Platform: openSUSE RPMs
        OS/Version: Linux
            Status: UNCONFIRMED
          Severity: wishlist
          Priority: NOR
         Component: general
        AssignedTo: kde-doc-english at kde.org
        ReportedBy: giecrilj at stegny.2a.pl


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 at kde.org?cc=kde at 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 >

-- 
Configure bugmail: https://bugs.kde.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.