Skip Menu |

This queue is for tickets about the WWW-Scripter-Plugin-JavaScript CPAN distribution.

Report information
The Basics
Id: 50464
Status: resolved
Priority: 0/
Queue: WWW-Scripter-Plugin-JavaScript

People
Owner: Nobody in particular
Requestors: MARKSTOS [...] cpan.org
Cc:
AdminCc:

Bug Information
Severity: Wishlist
Broken in: (no value)
Fixed in: 0.003



Subject: wish: document how to trigger events
Often times JavaScript is triggered from an event, like clicking on something. It would be great if there was clearer documentation how to trigger events. I search the docs for "event" and "click" and couldn't find documentation which seemed to cover this. Mark
On Tue Oct 13 16:19:25 2009, MARKSTOS wrote: Show quoted text
> Often times JavaScript is triggered from an event, like clicking on > something. It would be great if there was clearer documentation how to > trigger events. I search the docs for "event" and "click" and couldn't > find documentation which seemed to cover this.
Thank you for your suggestion. Events are not specific to JavaScript. You could theoretically have multiple scripting languages registering event handlers, in which case you would want them all to run. The documentation could go in WWW::Scripter. Considering all that, do you still think it would be useful to add it to the JS plugin’s docs? If we add it to WWW::Scripter (we could put it in both), where do you think it should go? The man page is getting long and is starting to become incoherent. (I’m not very good at managing large docs.) Maybe we need some kind of tutorial, but I know the innards too well to write it in a manner understandable to others. What do you think?
Subject: Re: [rt.cpan.org #50464] wish: document how to trigger events
Date: Mon, 19 Oct 2009 10:24:56 -0400
To: bug-WWW-Scripter-Plugin-JavaScript [...] rt.cpan.org
From: Mark Stosberg <mark [...] summersault.com>
Show quoted text
> Thank you for your suggestion. Events are not specific to JavaScript. You could theoretically > have multiple scripting languages registering event handlers, in which case you would want > them all to run. The documentation could go in WWW::Scripter.
Sounds good. Show quoted text
> Considering all that, do you still think it would be useful to add it to the JS plugin’s docs?
Either location would work for me. Show quoted text
> If we add it to WWW::Scripter (we could put it in both), where do you think it should go?
Perhaps in or near the "SCRIPT HANDLERS" section: http://search.cpan.org/~sprout/WWW-Scripter-0.008/lib/WWW/Scripter.pod#SCRIPT_HANDLERS Show quoted text
> The > man page is getting long and is starting to become incoherent. (I’m not very good at > managing large docs.) Maybe we need some kind of tutorial, but I know the innards too well > to write it in a manner understandable to others. > > What do you think?
So far I found the docs to be OK. Mark
On Mon Oct 19 10:25:56 2009, mark@summersault.com wrote: Show quoted text
>
> > If we add it to WWW::Scripter (we could put it in both), where do
> you think it should go? > > Perhaps in or near the "SCRIPT HANDLERS" section:
I’ve added a new section to WWW::Scripter 0.009.