From dave at badgers-in-foil.co.uk Thu Feb 2 23:25:36 2006 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Thu Feb 2 23:25:55 2006 Subject: [as2api-dev] [CVS trunk] The path for my CSS changed. Add DTD internal subset hacks to make links work in Moz. Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060202/f780b300/attachment.html From dave at badgers-in-foil.co.uk Thu Feb 2 23:33:22 2006 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Thu Feb 2 23:33:28 2006 Subject: [as2api-dev] [CVS trunk] include lisense in dist; rule to muild HTML docs for website Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060202/be0ab312/attachment.html From dave at badgers-in-foil.co.uk Thu Feb 2 23:36:08 2006 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Thu Feb 2 23:36:25 2006 Subject: [as2api-dev] [CVS trunk] Fix method redefinition warning Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060202/6354b20f/attachment.htm From dave at badgers-in-foil.co.uk Fri Feb 3 00:43:57 2006 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Fri Feb 3 00:44:29 2006 Subject: [as2api-dev] Call for OSX help Message-ID: <20060203004356.GA1672@badgers-in-foil.co.uk> Is anyone able to help me by building the rubyscript2exe-compiled version of as2api for OSX? thanks, dave -- http://david.holroyd.me.uk/ From dave at badgers-in-foil.co.uk Fri Feb 3 00:46:11 2006 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Fri Feb 3 00:46:27 2006 Subject: [as2api-dev] [CVS trunk] The story so far (or since release 0.3, at least) Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060203/303c3df1/attachment.html From dave at badgers-in-foil.co.uk Sun Feb 5 19:06:48 2006 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sun Feb 5 19:07:41 2006 Subject: [as2api-dev] [CVS trunk] Tweak to prevent AS type names clashing with keywords in Graphviz syntax Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060205/7dd1b5da/attachment.htm From dave at badgers-in-foil.co.uk Sun Feb 5 22:19:50 2006 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sun Feb 5 22:20:40 2006 Subject: [as2api-dev] [ANN] as2api version 0.4 released Message-ID: <20060205221949.GA11071@badgers-in-foil.co.uk> I've uploaded release 0.4 to the project page. See there for the details of what's changed between this release and the last. http://www.badgers-in-foil.co.uk/projects/as2api/ Note that there's currently no pre-compiled version for OSX available, though I hope to get one up at some point. ta, dave -- http://david.holroyd.me.uk/ From osflash at badgers-in-foil.co.uk Tue Feb 7 16:39:08 2006 From: osflash at badgers-in-foil.co.uk (David Holroyd) Date: Tue Feb 7 16:43:07 2006 Subject: [as2api-dev] Re: [osflash] [ANN] as2api 0.4 released In-Reply-To: <8B8C727AA88DE84DB318EB9F827AF4D304FE1135@affsvr02.affsys.com> References: <20060206105639.GE10652@badgers-in-foil.co.uk> <8B8C727AA88DE84DB318EB9F827AF4D304FE1135@affsvr02.affsys.com> Message-ID: <20060207163908.GE19506@badgers-in-foil.co.uk> On Tue, Feb 07, 2006 at 08:38:01AM -0500, Scott Hyndman wrote: > On a side note, I'm hoping to see the @author tag implemented soon. Care to elaborate? I ask because I try to discourage the use of @author in (Java) code we produce at work, reasons being: - Although it initially indicates the best person to question about a particular bit of code, other people will change the file later, and likely will fail to update the tag - Staff turnover will make the information irrelevant - The authorship of each file is accurately and automatically recorded by the version control system, anyway - It can discourage people from taking ownership of the code, when needed, because it 'belongs' to someone else On the plus side though, people *should* be proud of the code they write and want to put their name to it. I'd suggest that such (commendable [1]) hubris should be displayed at a higher level though, e.g. in the package or app/library as a whole. So, Would some kind of global option for specifying authorship suit your needs? This could additionally be used to define Dublin Core 'creator' metadata in the generated HTML, which would be a nice bonus. your thoughts are appreciated! dave [1] http://www.hhhh.org/wiml/virtues.html -- http://david.holroyd.me.uk/ From phil at produxion.net Tue Feb 7 17:12:21 2006 From: phil at produxion.net (Phil Powell) Date: Tue Feb 7 17:12:51 2006 Subject: [as2api-dev] Call for OSX help In-Reply-To: <20060203004356.GA1672@badgers-in-foil.co.uk> References: <20060203004356.GA1672@badgers-in-foil.co.uk> Message-ID: Dave, I've got a darwin compiled version ready for you to distribute (neat little bit of code that rubyscript2exe - all I had to do was set up an init.rb). Will forward to you in a separate mail. -Phil On 3 Feb 2006, at 00:43, David Holroyd wrote: > Is anyone able to help me by building the rubyscript2exe-compiled > version of as2api for OSX? > > > thanks, > dave > > -- > http://david.holroyd.me.uk/ > > _______________________________________________ > as2api-dev mailing list > as2api-dev@lists.badgers-in-foil.co.uk > http://lists.badgers-in-foil.co.uk/mailman/listinfo/as2api-dev From dave at badgers-in-foil.co.uk Wed Feb 8 00:02:29 2006 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Wed Feb 8 00:02:40 2006 Subject: [as2api-dev] Call for OSX help In-Reply-To: References: <20060203004356.GA1672@badgers-in-foil.co.uk> Message-ID: <20060208000229.GA26432@badgers-in-foil.co.uk> On Tue, Feb 07, 2006 at 05:12:21PM +0000, Phil Powell wrote: > I've got a darwin compiled version ready for you to distribute (neat > little bit of code that rubyscript2exe - all I had to do was set up > an init.rb). Sir, you rock! I've uploaded the .sit, http://www.badgers-in-foil.co.uk/projects/as2api/ Want to double check? ta, dave -- http://david.holroyd.me.uk/ From dave at badgers-in-foil.co.uk Wed Feb 8 18:04:57 2006 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Wed Feb 8 18:05:41 2006 Subject: [as2api-dev] Re: russian support of as2api In-Reply-To: <1666574984.20060208162421@design.ru> References: <1666574984.20060208162421@design.ru> Message-ID: <20060208180456.GC4594@badgers-in-foil.co.uk> Hi there, On Wed, Feb 08, 2006 at 04:24:21PM +0300, Ivan Dembicki wrote: > Hello, > > This letter is sent to you on behalf of some of the russian flash > community leaders. > > Recently we examined a lot of tools for documenting ActionScript. > We've found your as2api to be the most suitable for easy and frequent > use, so, we would like to support your project in russian. This should > include translation of the manual, writing of some additional help > files, creating of use samples etc. > > To make this happen, we require one slight addition to as2api > features. Namely, we would highly appreciate if you add support of > @lang tag, that will delimit document context help for different > languages. As we see it, a perfect tool should be able to understand > @lang tag and generate different html files (in different folders) for > the designated languages. > > The workflow of the tool, as we see it: > > - default language is english (or russian. hehe :) ) > - multiple @lang tags may be present in the document > - when parser encounters @lang tag, it assumes, that the comment text > that follows, should be treated as designated language until next > @lang tag is found > - html files are placed in the folders named by the language name that > is set in the @lang tag > - if multiple languages are used in @lang tags, there should be > switches for language versions in resulting html files > > Command line: > - there should be "--language" parameter, that will specify for what > language you want to generate doc files (default - all languages) > > That is how we see it. > > Please, contact me if your are interested in further discussion and if > you are willing to implement some new features in your as2api project. This is a really interesting idea, and an area I hadn't given any thought to before. Translation of the text within as2api (HTML headers, etc.) is already a long term goal, but supporting the content itself in multiple languages is new idea to me. My initial thought is that I would not put the translations into the original source files. Rather, the source should be documented with the author's primary language, and translations should be pulled in from an external file. I think that maintaining all the translations within the original source would become increasingly difficult the number of target languages increases. By placing the translations outside the source, adding a translation to a new language doesn't require modification to the original sources, which seems desirable to me. Searching around, I think that something like XLIFF could be an appropriate format for external translation data: http://www.oasis-open.org/committees/xliff/documents/xliff-specification.htm There are even GUI tools that can help you to create resources in this format (they may be commercial -- I didn't really look into this). The default workflow could then be: - default comment language is english, russian, etc. - as2api is run against the source in a special mode that generates a new XLIFF file with an empty slot for each bit of translatable text (plus, presumably, a copy of the same text in the original language, as read from the source comments) - the translator works though this file to create the content for the target language - as3api is run against the original source with a --language parameter which causes it to look in the XLIFF file for the text to include against each API element (instead of using the text in the doc comments) What do you think of this? dave -- http://david.holroyd.me.uk/ From phil at produxion.net Thu Feb 9 09:54:53 2006 From: phil at produxion.net (Phil Powell) Date: Thu Feb 9 09:55:50 2006 Subject: [as2api-dev] Call for OSX help In-Reply-To: <20060208000229.GA26432@badgers-in-foil.co.uk> References: <20060203004356.GA1672@badgers-in-foil.co.uk> <20060208000229.GA26432@badgers-in-foil.co.uk> Message-ID: <4F4B8786-CB1E-4B3A-A6CA-36111526E827@produxion.net> Woks for me, but ought o have mentioned that I'm working on Tiger, so could do with testing on Panther at least. -Phil On 8 Feb 2006, at 00:02, David Holroyd wrote: > On Tue, Feb 07, 2006 at 05:12:21PM +0000, Phil Powell wrote: >> I've got a darwin compiled version ready for you to distribute (neat >> little bit of code that rubyscript2exe - all I had to do was set up >> an init.rb). > > Sir, you rock! > > I've uploaded the .sit, > > http://www.badgers-in-foil.co.uk/projects/as2api/ > > Want to double check? > > > ta, > dave > > -- > http://david.holroyd.me.uk/ > > _______________________________________________ > as2api-dev mailing list > as2api-dev@lists.badgers-in-foil.co.uk > http://lists.badgers-in-foil.co.uk/mailman/listinfo/as2api-dev From iiley.chen at gmail.com Thu Feb 9 15:27:00 2006 From: iiley.chen at gmail.com (iiley) Date: Thu Feb 9 17:28:04 2006 Subject: [as2api-dev] Re: [osflash] [ANN] as2api 0.4 released In-Reply-To: <20060209143743.GB18158@badgers-in-foil.co.uk> References: <003601c62c80$6e093110$6a00a8c0@px1.pointx.be> <5bf7c03035946d00037e094ba0efbbc1@gmail.com> <20060209143743.GB18158@badgers-in-foil.co.uk> Message-ID: Sorry that the file is not in CVS, are moving CVS from sourceforge to OSFlash, so it'll be moved to new SVN of OSFlash soon. I'll let you know when it moved. Thanks very much for reply. :) keep up the great works. 2006/2/9, David Holroyd : > > On Thu, Feb 09, 2006 at 09:30:15PM +0800, iiley wrote: > > Hi David, > > > > as2api seem has problem to generate link to this: > > > > /** > > * @see FocusManager#setDefaultFocusTraversalPolicy() > > * @see FocusManager#getDefaultFocusTraversalPolicy() > > */ > > > > But @Container#someMethod() generated fined. (FocusManager is at the > same > > package) > > > > And do i need to fill full class name for this type link: > > @see AClass(AClass is at the same package of current documented class) > > I usually filled the full class name like @see org.aswing.AClass > > Type resolution for @see and {@link} is supposed to follow the same > pattern as for other type-references from ActionScript code within the > same file (i.e. type names must be fully quallified unless in they are > imported or in the same package as the current type, IIRC). > > Any deviation from that could well be a bug in as2api. > > I've just checked-out the trunk of AsWing from SF CVS. Where can I look > for an example of your problem? > > > dave > > -- > http://david.holroyd.me.uk/ > > _______________________________________________ > osflash mailing list > osflash@osflash.org > http://osflash.org/mailman/listinfo/osflash_osflash.org > -- iiley AsWing http://www.aswing.org Blog http://spaces.msn.com/members/iiley/ -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060209/266855a0/attachment.html From dave at badgers-in-foil.co.uk Thu Feb 9 17:42:42 2006 From: dave at badgers-in-foil.co.uk (dave@badgers-in-foil.co.uk) Date: Thu Feb 9 17:43:08 2006 Subject: [as2api-dev] [CVS trunk] Copyright/license messages added to (hopefully) every code file Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060209/1f95dc1b/attachment.htm From osflash at badgers-in-foil.co.uk Wed Feb 15 11:31:45 2006 From: osflash at badgers-in-foil.co.uk (David Holroyd) Date: Wed Feb 15 11:37:33 2006 Subject: [as2api-dev] Re: [osflash] [ANN] as2api 0.4 released In-Reply-To: References: <003601c62c80$6e093110$6a00a8c0@px1.pointx.be> <5bf7c03035946d00037e094ba0efbbc1@gmail.com> Message-ID: <20060215113144.GA1842@badgers-in-foil.co.uk> Hi again, On Thu, Feb 09, 2006 at 09:30:15PM +0800, iiley wrote: > as2api seem has problem to generate link to this: > > /** > * @see FocusManager#setDefaultFocusTraversalPolicy() > * @see FocusManager#getDefaultFocusTraversalPolicy() > */ > > But @Container#someMethod() generated fined. (FocusManager is at the > same package) I grabbed the source from svn, and the significant parts of the file in question are: ----8<---- ... import org.aswing.Component; import org.aswing.Container; import org.aswing.JWindow; /** ... * @see Container#isFocusTraversalPolicyProvider() * @see FocusManager#setDefaultFocusTraversalPolicy() * @see FocusManager#getDefaultFocusTraversalPolicy() ... */ interface org.aswing.FocusTraversalPolicy { ... ---->8---- The generated documentation doesn't include the expected links to FocusManager methods, while the links to methods of Container are fine. This is because (contradicting my earlier statement ;) types in the same package as the current type are *not* automatically in scope. i.e., in order for as2api to know what type 'FocusManager' refers to in the comment, you need to either 'import' it, or use the fully-qualified name 'org.aswing.FocusManager'. (I would suggest you go with the latter option.) hope that helps, dave -- http://david.holroyd.me.uk/ From iiley.chen at gmail.com Wed Feb 15 12:02:39 2006 From: iiley.chen at gmail.com (iiley) Date: Wed Feb 15 12:09:10 2006 Subject: [as2api-dev] Re: [osflash] [ANN] as2api 0.4 released In-Reply-To: <20060215113144.GA1842@badgers-in-foil.co.uk> References: <003601c62c80$6e093110$6a00a8c0@px1.pointx.be> <5bf7c03035946d00037e094ba0efbbc1@gmail.com> <20060215113144.GA1842@badgers-in-foil.co.uk> Message-ID: It's very clear now, thanks very much, David. :) 2006/2/15, David Holroyd : > > Hi again, > > On Thu, Feb 09, 2006 at 09:30:15PM +0800, iiley wrote: > > as2api seem has problem to generate link to this: > > > > /** > > * @see FocusManager#setDefaultFocusTraversalPolicy() > > * @see FocusManager#getDefaultFocusTraversalPolicy() > > */ > > > > But @Container#someMethod() generated fined. (FocusManager is at the > > same package) > > I grabbed the source from svn, and the significant parts of the file in > question are: > > > ----8<---- > ... > > import org.aswing.Component; > import org.aswing.Container; > import org.aswing.JWindow; > > /** > ... > * @see Container#isFocusTraversalPolicyProvider() > * @see FocusManager#setDefaultFocusTraversalPolicy() > * @see FocusManager#getDefaultFocusTraversalPolicy() > ... > */ > interface org.aswing.FocusTraversalPolicy { > ... > ---->8---- > > The generated documentation doesn't include the expected links to > FocusManager methods, while the links to methods of Container are fine. > This is because (contradicting my earlier statement ;) types in the same > package as the current type are *not* automatically in scope. > > i.e., in order for as2api to know what type 'FocusManager' refers to in > the comment, you need to either 'import' it, or use the fully-qualified > name 'org.aswing.FocusManager'. > > (I would suggest you go with the latter option.) > > > hope that helps, > dave > > -- > http://david.holroyd.me.uk/ > > _______________________________________________ > osflash mailing list > osflash@osflash.org > http://osflash.org/mailman/listinfo/osflash_osflash.org > -- iiley AsWing http://www.aswing.org Blog http://spaces.msn.com/members/iiley/ -------------- next part -------------- An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060215/4f669cd5/attachment.html From dave at badgers-in-foil.co.uk Fri Feb 24 00:16:21 2006 From: dave at badgers-in-foil.co.uk (dave@badgers-in-foil.co.uk) Date: Fri Feb 24 00:26:43 2006 Subject: [as2api-dev] [CVS trunk] Initial attempt at i18n Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060224/156f291c/attachment.html From dave at badgers-in-foil.co.uk Fri Feb 24 00:32:49 2006 From: dave at badgers-in-foil.co.uk (dave@badgers-in-foil.co.uk) Date: Fri Feb 24 00:33:00 2006 Subject: [as2api-dev] [CVS trunk] Catch up with some pre-0.4-release changes, and add in i18n support bits Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060224/216a462f/attachment.htm From dave at badgers-in-foil.co.uk Fri Feb 24 00:40:40 2006 From: dave at badgers-in-foil.co.uk (dave@badgers-in-foil.co.uk) Date: Fri Feb 24 00:42:47 2006 Subject: [as2api-dev] [CVS trunk] Last-minute changes running up to release 0.4 which I forgot to commit at the time Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060224/8098b5e7/attachment.html From dave at badgers-in-foil.co.uk Sat Feb 25 10:24:09 2006 From: dave at badgers-in-foil.co.uk (dave@badgers-in-foil.co.uk) Date: Sat Feb 25 10:24:24 2006 Subject: [as2api-dev] [CVS trunk] Fix gettext usage Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060225/e4a8b679/attachment.htm From dave at badgers-in-foil.co.uk Sat Feb 25 12:51:57 2006 From: dave at badgers-in-foil.co.uk (dave@badgers-in-foil.co.uk) Date: Sat Feb 25 12:52:16 2006 Subject: [as2api-dev] [CVS trunk] Make the required dir Message-ID: An HTML attachment was scrubbed... URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060225/15e883c6/attachment.html From dave at badgers-in-foil.co.uk Sat Feb 25 13:35:43 2006 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sat Feb 25 13:35:59 2006 Subject: [as2api-dev] Re: russian support of as2api In-Reply-To: <20060208180456.GC4594@badgers-in-foil.co.uk> References: <1666574984.20060208162421@design.ru> <20060208180456.GC4594@badgers-in-foil.co.uk> Message-ID: <20060225133543.GB5233@badgers-in-foil.co.uk> On Wed, Feb 08, 2006 at 06:04:57PM +0000, David Holroyd wrote: > On Wed, Feb 08, 2006 at 04:24:21PM +0300, Ivan Dembicki wrote: > > Recently we examined a lot of tools for documenting ActionScript. > > We've found your as2api to be the most suitable for easy and frequent > > use, so, we would like to support your project in russian. This should > > include translation of the manual, writing of some additional help > > files, creating of use samples etc. > > > > To make this happen, we require one slight addition to as2api > > features. Namely, we would highly appreciate if you add support of > > @lang tag, that will delimit document context help for different > > languages. As we see it, a perfect tool should be able to understand > > @lang tag and generate different html files (in different folders) for > > the designated languages. > This is a really interesting idea, and an area I hadn't given any > thought to before. Translation of the text within as2api (HTML headers, > etc.) is already a long term goal, but supporting the content itself in > multiple languages is new idea to me. > > My initial thought is that I would not put the translations into the > original source files. Rather, the source should be documented with the > author's primary language, and translations should be pulled in from an > external file. > > I think that maintaining all the translations within the original source > would become increasingly difficult the number of target languages > increases. By placing the translations outside the source, adding > a translation to a new language doesn't require modification to the > original sources, which seems desirable to me. > > Searching around, I think that something like XLIFF could be an > appropriate format for external translation data: > > http://www.oasis-open.org/committees/xliff/documents/xliff-specification.htm I've started working on XLIFF import / export. It can currently handle very simple substitutions of one section of comment-text for another, but doesn't yet handle inline tags (e.g. the '{@link ..}' tag) or some other important details like multiple '@see' blocks. I also found a couple of free GUI tools for working with XLIFF data: 'Transolution' is implemented in Python and GTK, http://transolution.python-hosting.com/ 'Open Language Tools' provide a XLIFF editor implemented in Java, https://open-language-tools.dev.java.net/ Both worked, but seemed a little bit 'quirky' (could just be that I didn't understand how to use them properly). ---- In addition I've just committed support for using gettext to localise text generated by as2api. This will allow messages printed on the command line, and things like section headings in the generated HTML to be translated into other languages. I'm hoping to be able to use the Launchpad 'Rosetta' service to allow people to contribute translations of as2api. I've just uploaded the translatable data, but this must be allowed though a moderation queue before it will appear on the site. ta, dave -- http://david.holroyd.me.uk/ From dave at badgers-in-foil.co.uk Sat Feb 25 22:04:32 2006 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sat Feb 25 22:04:44 2006 Subject: [as2api-dev] Launchpad Message-ID: <20060225220431.GA21217@badgers-in-foil.co.uk> I am thinking of using Launchpad to support some as2api related stuff: https://launchpad.net/products/as2api I'm especially interested in the Rosetta translation system, as previously mentioned; but since it includes a bug tracker, I thought I'd give that a whirl too. Get those bug reports and feature requests in there! ;) ta, dave -- http://david.holroyd.me.uk/ From simon_wacker at gmx.de Sun Feb 26 12:00:20 2006 From: simon_wacker at gmx.de (Simon Wacker) Date: Sun Feb 26 12:02:20 2006 Subject: [as2api-dev] Custom non-javadoc tag: @overload Message-ID: <44019854.2050601@gmx.de> Hi, I'd like to know whether you might add a custom tag, that is not javadoc: @overload #myMethod It should work similar to @link and add the following to the generated html: Overloading: myMethod1(arg:String):Number myMethod2(arg:Number, arg2:String):String Take a look at the following docu for an example: http://api.as2lib.org/0.9.3/org_as2lib_env_reflect_ClassInfo.html#getMethod Cheers, Simon -- Simon Wacker www.simonwacker.com www.as2lib.org www.hq-heilbronn.de www.flik-flak.de From simon_wacker at gmx.de Sun Feb 26 12:08:38 2006 From: simon_wacker at gmx.de (Simon Wacker) Date: Sun Feb 26 12:09:40 2006 Subject: [as2api-dev] White space before {@code} Message-ID: <44019A46.2080100@gmx.de> Hi, as2api adds a white-space before any {@code} inline-tag. For example "{@code ClassInfo}" generates " ClassInfo". Is this wanted? Greetings, Simon -- Simon Wacker www.simonwacker.com www.as2lib.org www.hq-heilbronn.de www.flik-flak.de From dave at badgers-in-foil.co.uk Sun Feb 26 12:59:13 2006 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sun Feb 26 12:59:29 2006 Subject: [as2api-dev] Custom non-javadoc tag: @overload In-Reply-To: <44019854.2050601@gmx.de> References: <44019854.2050601@gmx.de> Message-ID: <20060226125912.GA30549@badgers-in-foil.co.uk> Hi there, On Sun, Feb 26, 2006 at 01:00:20PM +0100, Simon Wacker wrote: > I'd like to know whether you might add a custom tag, that is not > javadoc: @overload #myMethod > It should work similar to @link and add the following to the generated html: > > Overloading: > myMethod1(arg:String):Number > myMethod2(arg:Number, arg2:String):String > > Take a look at the following docu for an example: > http://api.as2lib.org/0.9.3/org_as2lib_env_reflect_ClassInfo.html#getMethod This has been mentioned before, I think. I've written up some thoughts here, https://launchpad.net/products/as2api/+spec/overload-tag ...basically, I think @overload support should be added; though for the next as2api release, I'm concentrating on i18n / L10n features. dave -- http://david.holroyd.me.uk/ From dave at badgers-in-foil.co.uk Sun Feb 26 13:11:07 2006 From: dave at badgers-in-foil.co.uk (David Holroyd) Date: Sun Feb 26 13:11:15 2006 Subject: [as2api-dev] White space before {@code} In-Reply-To: <44019A46.2080100@gmx.de> References: <44019A46.2080100@gmx.de> Message-ID: <20060226131106.GB30549@badgers-in-foil.co.uk> On Sun, Feb 26, 2006 at 01:08:38PM +0100, Simon Wacker wrote: > as2api adds a white-space before any {@code} inline-tag. For example > "{@code ClassInfo}" generates " ClassInfo". Is this wanted? It's not so much adding a space, as preserving the one that's there immidiately after the "{@code" part. I didn't think that it would matter much to the resulting formatting, and since {@code} tags which cover multiple lines additionally get wrapped in a 
, leading space might sometimes be significant.

I guess the thing to do would be to strip whitespace off te ends of the
string if it's all on a single line anyway...


dave

-- 
http://david.holroyd.me.uk/

From dave at badgers-in-foil.co.uk  Sun Feb 26 13:15:14 2006
From: dave at badgers-in-foil.co.uk (dave@badgers-in-foil.co.uk)
Date: Sun Feb 26 13:15:33 2006
Subject: [as2api-dev] [CVS trunk] We always see leading whitespace from
 within the {@code ..} tag, so strip it off
Message-ID: 

An HTML attachment was scrubbed...
URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060226/85e722a4/attachment.htm
From dave at badgers-in-foil.co.uk  Sun Feb 26 15:59:35 2006
From: dave at badgers-in-foil.co.uk (dave@badgers-in-foil.co.uk)
Date: Sun Feb 26 15:59:52 2006
Subject: [as2api-dev] [CVS trunk] Wasn't outputting {@link} text (still
 doesn't in some cases!)
Message-ID: 

An HTML attachment was scrubbed...
URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060226/5c95ad9b/attachment.html
From dave at badgers-in-foil.co.uk  Sun Feb 26 16:07:32 2006
From: dave at badgers-in-foil.co.uk (dave@badgers-in-foil.co.uk)
Date: Sun Feb 26 16:07:40 2006
Subject: [as2api-dev] [CVS trunk] refactor that bad-boy!
Message-ID: 

An HTML attachment was scrubbed...
URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060226/7e1f7870/attachment.htm
From dave at badgers-in-foil.co.uk  Mon Feb 27 13:59:59 2006
From: dave at badgers-in-foil.co.uk (dave@badgers-in-foil.co.uk)
Date: Mon Feb 27 14:00:47 2006
Subject: [as2api-dev] [CVS trunk] Initial (slightly hairy) cut at XLIFF
 import / export
 system for localising the human-readable portions of the API description
Message-ID: 

An HTML attachment was scrubbed...
URL: http://lists.badgers-in-foil.co.uk/pipermail/as2api-dev/attachments/20060227/3208f520/attachment-0001.html
From simon_wacker at gmx.de  Mon Feb 27 15:13:58 2006
From: simon_wacker at gmx.de (Simon Wacker)
Date: Mon Feb 27 15:15:21 2006
Subject: [as2api-dev] As2ant 1.0 with as2api support!
Message-ID: <44031736.7010609@gmx.de>

As2ant 1.0 has just been released! Best new features are the new As2api 
task and the custom-arguments support for the Mtasc task.

Donwload: 
http://sourceforge.net/project/showfiles.php?group_id=94206&package_id=164902

Full list of changes:

[+] org.as2lib.ant.As2api
Added support for HTML API documentation generation via As2api.
[!] org.as2lib.ant.Mtasc
Fixed bug with package-argument: Use relative paths!
[+] org.as2lib.ant.Mtasc
Added support for custom arguments:
[~] org.as2lib.ant.Mtasc
Ignore classes in source xml files that cannot be found.
[+] org.as2lib.ant.Mtasc
Added support for source xml files with 'type' as attribute.
[+] org.as2lib.ant.Mtasc
Improved commandline output by adding locations to all exceptions.
[~] org.as2lib.ant.Mtasc
Compile all source files in split-mode, even when one raises a compile 
error.

If you find any bugs please report them!


Cheers,
Simon

-- 
Simon Wacker
www.simonwacker.com
www.as2lib.org
www.hq-heilbronn.de
www.flik-flak.de


From erixtekila at gmail.com  Mon Feb 27 16:20:20 2006
From: erixtekila at gmail.com (erixtekila)
Date: Mon Feb 27 16:21:26 2006
Subject: [as2api-dev] As2ant 1.0 with as2api support!
In-Reply-To: <44031736.7010609@gmx.de>
References: <44031736.7010609@gmx.de>
Message-ID: 


> As2ant 1.0 has just been released! Best new features are the new 
> As2api task and the custom-arguments support for the Mtasc task.

The long awaited !
Cool.


Adding as2api is really a nice addon.


BTW, what is Pazkage ? Class As2api.Pazkage in the docs ?
I'll give feedback.


You've make my day.
-----------
erixtekila
http://blog.v-i-a.net/