Return-Path: 
 <callback-dev-return-10307-apmail-incubator-callback-dev-archive=incubator.apache.org@incubator.apache.org>
X-Original-To: apmail-incubator-callback-dev-archive@minotaur.apache.org
Delivered-To: apmail-incubator-callback-dev-archive@minotaur.apache.org
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by minotaur.apache.org (Postfix) with SMTP id 7D6A9D6E6
	for <apmail-incubator-callback-dev-archive@minotaur.apache.org>;
 Wed, 18 Jul 2012 21:43:35 +0000 (UTC)
Received: (qmail 77629 invoked by uid 500); 18 Jul 2012 21:43:35 -0000
Delivered-To: apmail-incubator-callback-dev-archive@incubator.apache.org
Received: (qmail 77587 invoked by uid 500); 18 Jul 2012 21:43:35 -0000
Mailing-List: contact callback-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:callback-dev-help@incubator.apache.org>
List-Unsubscribe: <mailto:callback-dev-unsubscribe@incubator.apache.org>
List-Post: <mailto:callback-dev@incubator.apache.org>
List-Id: <callback-dev.incubator.apache.org>
Reply-To: callback-dev@incubator.apache.org
Delivered-To: mailing list callback-dev@incubator.apache.org
Received: (qmail 77577 invoked by uid 99); 18 Jul 2012 21:43:35 -0000
Received: from issues-vm.apache.org (HELO issues-vm) (140.211.11.160)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 18 Jul 2012 21:43:35 +0000
Received: from isssues-vm.apache.org (localhost [127.0.0.1])
	by issues-vm (Postfix) with ESMTP id 10B21140541
	for <callback-dev@incubator.apache.org>;
 Wed, 18 Jul 2012 21:43:35 +0000 (UTC)
Date: Wed, 18 Jul 2012 21:43:34 +0000 (UTC)
From: "Filip Maj (JIRA)" <jira@apache.org>
To: callback-dev@incubator.apache.org
Message-ID: <901088217.71944.1342647815070.JavaMail.jiratomcat@issues-vm>
In-Reply-To: <577385377.36701.1338850522918.JavaMail.jiratomcat@issues-vm>
Subject: [jira] [Commented] (CB-862) Document Plugin Authoring
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit
X-JIRA-FingerPrint: 30527f35849b9dde25b450d4833f0394


    [ https://issues.apache.org/jira/browse/CB-862?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13417714#comment-13417714 ] 

Filip Maj commented on CB-862:
------------------------------

The top-level article has been updated to add the JavaScript interface for the echo plugin, as well as a JavaScript overview.
                
> Document Plugin Authoring
> -------------------------
>
>                 Key: CB-862
>                 URL: https://issues.apache.org/jira/browse/CB-862
>             Project: Apache Cordova
>          Issue Type: Improvement
>          Components: Docs
>            Reporter: Filip Maj
>            Assignee: Filip Maj
>             Fix For: 2.0.0
>
>
> Parent task for creating a set of guides for plugin authoring.
> Will need a bunch of sub-tasks for each native platform's plugin authoring guide. Also a JS guide.
> *Question:*
> One open question: how to handle versioning in this case? I.e. a 1.7 plugin authoring guide vs. a 2.0 guide.
> *Plugin Name:*
> Cordova Echo
> *JavaScript Interface:*
> {{window.echo(<string>, <callback>);}}
> *Usage Example:*
> {noformat}
> window.echo("Hello...hello...hello...hello...", function(value) {
>     // `value` is "Hello...hello...hello...hello..."
>     alert(value);
> });
> {noformat}
> *Inner Working Details:*
> - The string to echo should be passed through exec and into the native implementation.
> - The native code should then call the success callback.
> - If an empty string is provided, the native code should call the error callback.
> - The plugin should define a default error callback with the argument "Nothing to echo."
> - The JavaScript error callback should then invoke the success callback with the error value.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira