From dave at vhost.badgers-in-foil.co.uk Sat Aug 6 16:58:10 2005 From: dave at vhost.badgers-in-foil.co.uk (David Holroyd) Date: Sun Aug 7 09:25:16 2005 Subject: [as2api-dev] [CVS trunk] Help search engines, by marking pages which contain no interesting content. Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050806/ad41b913/attachment.htm From dave at badgers-in-foil.co.uk Sun Aug 7 16:38:31 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sun Aug 7 16:38:39 2005 Subject: [as2api-dev] [CVS trunk] Very early support for documenting the changes between two API versions. Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050807/3322b174/attachment.html From dave at badgers-in-foil.co.uk Sun Aug 7 17:31:32 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sun Aug 7 17:31:35 2005 Subject: [as2api-dev] [CVS trunk] Improve formatting on index page Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050807/5a04ce6a/attachment.htm From dave at badgers-in-foil.co.uk Sun Aug 7 22:29:10 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sun Aug 7 22:29:15 2005 Subject: [as2api-dev] [CVS trunk] Fix invalid xhtml generation Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050807/e66a868d/attachment.html From dave at badgers-in-foil.co.uk Sun Aug 7 22:42:54 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sun Aug 7 22:42:56 2005 Subject: [as2api-dev] [CVS trunk] Strike some TODO items off the list Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050807/edaf3903/attachment.htm From dave at badgers-in-foil.co.uk Sat Aug 13 12:30:09 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sat Aug 13 12:30:14 2005 Subject: [as2api-dev] [CVS trunk] Command line reference documentation Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050813/6daf5118/attachment.html From dave at badgers-in-foil.co.uk Sat Aug 13 16:56:27 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sat Aug 13 16:56:34 2005 Subject: [as2api-dev] [CVS trunk] Target to build as2api man page Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050813/20099ae1/attachment.htm From dave at badgers-in-foil.co.uk Sat Aug 13 17:04:29 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sat Aug 13 17:04:30 2005 Subject: [as2api-dev] [CVS trunk] Remove some dead wood Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050813/3712a1f4/attachment.html From dave at badgers-in-foil.co.uk Sat Aug 13 17:05:22 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sat Aug 13 17:05:26 2005 Subject: [as2api-dev] [CVS trunk] Fix indentation Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050813/d51083ca/attachment.htm From dave at badgers-in-foil.co.uk Sat Aug 13 17:28:51 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sat Aug 13 17:28:53 2005 Subject: [as2api-dev] [CVS trunk] Promote a bunch of util functions to instance methods of the appropriate class Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050813/f0af26a6/attachment.html From dave at badgers-in-foil.co.uk Sat Aug 13 17:44:39 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sat Aug 13 17:44:41 2005 Subject: [as2api-dev] [CVS trunk] Support documentation of variable length argument lists Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050813/dc3ba909/attachment.htm From dave at badgers-in-foil.co.uk Sat Aug 13 21:49:59 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sat Aug 13 21:50:11 2005 Subject: [as2api-dev] [CVS trunk] Support @exception as a synonym for @throws Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050813/892dcf01/attachment.html From dave at badgers-in-foil.co.uk Sat Aug 13 22:56:51 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sat Aug 13 22:56:59 2005 Subject: [as2api-dev] [CVS trunk] Reformat lines in literal layouts for a shorter line length Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050813/f0629ad8/attachment.htm From dave at badgers-in-foil.co.uk Sat Aug 13 23:04:21 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sat Aug 13 23:04:23 2005 Subject: [as2api-dev] [CVS trunk] Fix out-of-date descriptions of the binaries available for download Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050813/a41e3707/attachment.html From dave at badgers-in-foil.co.uk Sat Aug 13 23:23:57 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sat Aug 13 23:24:00 2005 Subject: [as2api-dev] [CVS trunk] Replace useless 'Installing and running the software' with the cmdline reference Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050813/7e15a6aa/attachment.htm From dave at badgers-in-foil.co.uk Sat Aug 13 23:53:25 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sat Aug 13 23:53:30 2005 Subject: [as2api-dev] [CVS trunk] Shorten section title Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050813/c891817d/attachment.html From dave at badgers-in-foil.co.uk Sun Aug 14 00:47:15 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sun Aug 14 00:47:18 2005 Subject: [as2api-dev] [CVS trunk] Improve documentation for the {@code} tag. Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050814/785d454a/attachment.htm From dave at badgers-in-foil.co.uk Mon Aug 15 07:36:49 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Mon Aug 15 07:36:54 2005 Subject: [as2api-dev] [CVS trunk] Support documentation of variable length argument lists In-Reply-To: <04a74c577d8d51ded88a553733ee91a4@dotgeek.org> References: <04a74c577d8d51ded88a553733ee91a4@dotgeek.org> Message-ID: <20050815073649.GA25970@badgers-in-foil.co.uk> On Sun, Aug 14, 2005 at 05:52:11PM +0200, erixtekila wrote: > >Support documentation of variable length argument lists > >(methods that access the 'arguments' array) > > Hi David, > > How do you achieve that in comments in mean ? > Is there a new tag ? You just need to give the magic parameter name '...': @param ... description of argument list You can still document any formal arguments as normal. (I think both are possible at once?) I spotted something like that in some AS source code I saw somewhere, and thought I'd steal the idea :) dave From dave at badgers-in-foil.co.uk Wed Aug 17 23:14:16 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Wed Aug 17 23:14:19 2005 Subject: [as2api-dev] [CVS trunk] Further documentation Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050817/92e340c4/attachment.html From mastakaneda at gmail.com Thu Aug 25 20:15:06 2005 From: mastakaneda at gmail.com (martin heidegger) Date: Fri Aug 26 14:42:28 2005 Subject: [as2api-dev] as2lib to as2api Message-ID: Hi there, we from the as2lib are just discussing about changing from visdoc to as2api because its rather problematic to argue with some developers: go get a mac to work with us, and there are some questions open: * Is it possible to integrate overloading or a different kind of eventhandling (would be some kind of important)? * How is the current state for a different output template. How complex is it to write such or template or are you planning to update your template. We would invest some time for this... * How fast is the generation of the as2lib documentation with as2api (i know i could find that out for myself, but i thought you've already done that) yours Martin. From dave at badgers-in-foil.co.uk Sat Aug 27 11:22:56 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sat Aug 27 11:23:05 2005 Subject: [as2api-dev] as2lib to as2api In-Reply-To: References: Message-ID: <20050827112256.GA14072@badgers-in-foil.co.uk> Hi there, On Thu, Aug 25, 2005 at 10:15:06PM +0200, martin heidegger wrote: > we from the as2lib are just discussing about changing from visdoc to > as2api because its rather problematic to argue with some developers: > go get a mac to work with us, and there are some questions open: > > * Is it possible to integrate overloading or a different kind of > eventhandling (would be some kind of important)? I've not put any real thought into overloading support. How should the @overload tag (that I can see used in as2lib source) be presented in the documentation? What are you referring to by "a different kind of event handling"? > * How is the current state for a different output template. How > complex is it to write such or template or are you planning to update > your template. We would invest some time for this... The HTML produced by the current templates should be very amenable to control by CSS. If there are aspects of the formatting which it's difficult or impossible to change by supplying custom CSS, then I'd consider that a bug which needs fixing. If you need to actually change the content which the templates produce, some minor refactoring of as2api's internals would be required to simplify the process of plugging in your custom code. Roughly, what changes are you considering? > * How fast is the generation of the as2lib documentation with as2api > (i know i could find that out for myself, but i thought you've already > done that) On the 1.6GHz IBM ThinkPad R51 I'm using (because my little HP died last week), the simplest resonable set of options gives... time ./as2api.rb --classpath \ eg/as2lib_0.9.2_with_dependencies/src:eg/flash_mx_2004_7.2/Classes \ org.as2lib.* main ... real 0m32.930s user 0m22.994s sys 0m1.841s Adding in the --draw-diagrams and --sources options pushes that from just over 30 seconds to just under 60. dave -- http://david.holroyd.me.uk/ From mastakaneda at gmail.com Sat Aug 27 12:58:27 2005 From: mastakaneda at gmail.com (martin heidegger) Date: Sat Aug 27 19:30:13 2005 Subject: [as2api-dev] as2lib to as2api In-Reply-To: <20050827112256.GA14072@badgers-in-foil.co.uk> References: <20050827112256.GA14072@badgers-in-foil.co.uk> Message-ID: > On Thu, Aug 25, 2005 at 10:15:06PM +0200, martin heidegger wrote: > > we from the as2lib are just discussing about changing from visdoc to > > as2api because its rather problematic to argue with some developers: > > go get a mac to work with us, and there are some questions open: > > > > * Is it possible to integrate overloading or a different kind of > > eventhandling (would be some kind of important)? > > I've not put any real thought into overloading support. How should the > @overload tag (that I can see used in as2lib source) be presented in the > documentation? What are you referring to by "a different kind of event > handling"? Visdoc implemented overloading like a box of links, nothing special @ all... but it could perhaps be implemented in a better way. @overload #methodSpecial in #method marks that if you use arguments like for #methodSpecial then #method will redirect the arguments to #methodSpecial, or lets say: It will act like #methodSpecial. > > * How is the current state for a different output template. How > > complex is it to write such or template or are you planning to update > > your template. We would invest some time for this... > > The HTML produced by the current templates should be very amenable to > control by CSS. If there are aspects of the formatting which it's > difficult or impossible to change by supplying custom CSS, then I'd > consider that a bug which needs fixing. > > If you need to actually change the content which the templates produce, > some minor refactoring of as2api's internals would be required to > simplify the process of plugging in your custom code. > > Roughly, what changes are you considering? Two frame - frameset and a dhtml tree, that is based on xhtml ... > > * How fast is the generation of the as2lib documentation with as2api > > (i know i could find that out for myself, but i thought you've already > > done that) > > On the 1.6GHz IBM ThinkPad R51 I'm using (because my little HP died last > week), the simplest resonable set of options gives... > > time ./as2api.rb --classpath \ > eg/as2lib_0.9.2_with_dependencies/src:eg/flash_mx_2004_7.2/Classes \ > org.as2lib.* main > ... > real 0m32.930s > user 0m22.994s > sys 0m1.841s > > Adding in the --draw-diagrams and --sources options pushes that from > just over 30 seconds to just under 60. Sounds really great! ... Visdoc takes awful much time ... uncomparable ... From dave at badgers-in-foil.co.uk Tue Aug 30 22:36:06 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Tue Aug 30 22:36:17 2005 Subject: [as2api-dev] [CVS trunk] Transform the make_page_list() function into a PageListBuilder class Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20050830/bf53063d/attachment.htm From dave at badgers-in-foil.co.uk Wed Aug 31 20:44:29 2005 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Wed Aug 31 20:44:32 2005 Subject: [as2api-dev] Subversion access Message-ID: <20050831204429.GA18985@badgers-in-foil.co.uk> After a round of software upgrades, anonymous Subversion access to the as2api repository is now available. To get the latest sources using the command line svn, run, svn co http://svn.badgers-in-foil.co.uk/as2api/trunk/as2api/ [ViewCVS access is gone for the moment, though] ta, dave -- http://david.holroyd.me.uk/ From rostislav.hristov at gmail.com Wed Aug 31 21:21:03 2005 From: rostislav.hristov at gmail.com (Rostislav Hristov) Date: Wed Aug 31 21:21:10 2005 Subject: [as2api-dev] Subversion access In-Reply-To: <20050831204429.GA18985@badgers-in-foil.co.uk> References: <20050831204429.GA18985@badgers-in-foil.co.uk> Message-ID: <435de1430508311421a9bf8@mail.gmail.com> This is something useful ;) Cheers, Rostislav -- EnFlash - It's all about features... http://www.asual.com/enflash/