Re: tapdoc progress
So, you're running the commandline version or the ant task? In both, there is a way to define multiple javadoc urls like the example @ http://tacos.sourceforge.net/tacos4.1/tapdoc/tapdoc/ant.html On Feb 11, 2008 5:40 PM, Tomek [EMAIL PROTECTED] wrote: Hi, a question again, di I understand it correctly, that I need to write tapestry-javadom.xml manually to get correct links to my javadoc files? Thanks Tomek Tomek Sniadach schrieb: Thanks Igor, unfortunately I'm not using maven :( and this configuration doesn't support code sample. Tomek Igor Drobiazko schrieb: If you want to generate it via maven you just need to add something like: reporting outputDirectory../outputDirectory plugins plugin groupIdcom.erinors.tapestry/groupId artifactIdtapdoc-maven-plugin/artifactId configuration libraries param/net/sf/tacos/Tacos.library/param param/net/sf/tacos/Dojo.library/param /libraries /configuration /plugin /plugins /reporting There result will be like this: http://tacos.sourceforge.net/tacos4.1/tacos-core/tapdocs/index.html On Feb 8, 2008 3:12 PM, Tomek [EMAIL PROTECTED] wrote: Hi, I'm interested on TapDoc. I've made my first component docs, but I have trouble with the tapdoc.xml. I couldn't find a dtd, so I had to search in source code to find allowed tags. Especially I don't know to make the samle code for the components (like on the tapestry site). I'm using version 0.7.0, is there a newer version or some documentation (dtd would be enough) Greetings Tomek - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- Andreas Andreou - [EMAIL PROTECTED] - http://blog.andyhot.gr Tapestry / Tacos developer Open Source / JEE Consulting - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: tapdoc progress
Hi, a question again, di I understand it correctly, that I need to write tapestry-javadom.xml manually to get correct links to my javadoc files? Thanks Tomek Tomek Sniadach schrieb: Thanks Igor, unfortunately I'm not using maven :( and this configuration doesn't support code sample. Tomek Igor Drobiazko schrieb: If you want to generate it via maven you just need to add something like: reporting outputDirectory../outputDirectory plugins plugin groupIdcom.erinors.tapestry/groupId artifactIdtapdoc-maven-plugin/artifactId configuration libraries param/net/sf/tacos/Tacos.library/param param/net/sf/tacos/Dojo.library/param /libraries /configuration /plugin /plugins /reporting There result will be like this: http://tacos.sourceforge.net/tacos4.1/tacos-core/tapdocs/index.html On Feb 8, 2008 3:12 PM, Tomek [EMAIL PROTECTED] wrote: Hi, I'm interested on TapDoc. I've made my first component docs, but I have trouble with the tapdoc.xml. I couldn't find a dtd, so I had to search in source code to find allowed tags. Especially I don't know to make the samle code for the components (like on the tapestry site). I'm using version 0.7.0, is there a newer version or some documentation (dtd would be enough) Greetings Tomek - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: tapdoc progress
Hi, a question again, di I understand it correctly, that I need to write tapestry-javadom.xml manually to get correct links to my javadoc files? Thanks Tomek Tomek Sniadach schrieb: Thanks Igor, unfortunately I'm not using maven :( and this configuration doesn't support code sample. Tomek Igor Drobiazko schrieb: If you want to generate it via maven you just need to add something like: reporting outputDirectory../outputDirectory plugins plugin groupIdcom.erinors.tapestry/groupId artifactIdtapdoc-maven-plugin/artifactId configuration libraries param/net/sf/tacos/Tacos.library/param param/net/sf/tacos/Dojo.library/param /libraries /configuration /plugin /plugins /reporting There result will be like this: http://tacos.sourceforge.net/tacos4.1/tacos-core/tapdocs/index.html On Feb 8, 2008 3:12 PM, Tomek [EMAIL PROTECTED] wrote: Hi, I'm interested on TapDoc. I've made my first component docs, but I have trouble with the tapdoc.xml. I couldn't find a dtd, so I had to search in source code to find allowed tags. Especially I don't know to make the samle code for the components (like on the tapestry site). I'm using version 0.7.0, is there a newer version or some documentation (dtd would be enough) Greetings Tomek - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: tapdoc progress
If you want to generate it via maven you just need to add something like: reporting outputDirectory../outputDirectory plugins plugin groupIdcom.erinors.tapestry/groupId artifactIdtapdoc-maven-plugin/artifactId configuration libraries param/net/sf/tacos/Tacos.library/param param/net/sf/tacos/Dojo.library/param /libraries /configuration /plugin /plugins /reporting There result will be like this: http://tacos.sourceforge.net/tacos4.1/tacos-core/tapdocs/index.html On Feb 8, 2008 3:12 PM, Tomek [EMAIL PROTECTED] wrote: Hi, I'm interested on TapDoc. I've made my first component docs, but I have trouble with the tapdoc.xml. I couldn't find a dtd, so I had to search in source code to find allowed tags. Especially I don't know to make the samle code for the components (like on the tapestry site). I'm using version 0.7.0, is there a newer version or some documentation (dtd would be enough) Greetings Tomek - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- Best regards, Igor Drobiazko
Re: Re: tapdoc progress
Thanks Igor, unfortunately I'm not using maven :( and this configuration doesn't support code sample. Tomek Igor Drobiazko schrieb: If you want to generate it via maven you just need to add something like: reporting outputDirectory../outputDirectory plugins plugin groupIdcom.erinors.tapestry/groupId artifactIdtapdoc-maven-plugin/artifactId configuration libraries param/net/sf/tacos/Tacos.library/param param/net/sf/tacos/Dojo.library/param /libraries /configuration /plugin /plugins /reporting There result will be like this: http://tacos.sourceforge.net/tacos4.1/tacos-core/tapdocs/index.html On Feb 8, 2008 3:12 PM, Tomek [EMAIL PROTECTED] wrote: Hi, I'm interested on TapDoc. I've made my first component docs, but I have trouble with the tapdoc.xml. I couldn't find a dtd, so I had to search in source code to find allowed tags. Especially I don't know to make the samle code for the components (like on the tapestry site). I'm using version 0.7.0, is there a newer version or some documentation (dtd would be enough) Greetings Tomek - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: tapdoc execution
yes, but I have this message /conf/tapdoc/build.xml:12: org.apache.hivemind.ApplicationRuntimeException: Could not parse specification classpath:/org/jfly/web/components/JFly.library but src/main/java/org/jfly/web/components/JFly.library is present the output message is: /home/kiuma/nbjfly/trunk/JFlyWebComponents/src/conf/tapdoc/build.xml:12: org.apache.hivemind.ApplicationRuntimeException: Could not parse specification classpath:/org/jfly/web/components/JFly.library. [classpath:/org/jfly/web/components/JFly.library] On 4/23/07, Andreas Andreou [EMAIL PROTECTED] wrote: http://tacos.svn.sourceforge.net/viewvc/tacos/tacos-4.1/trunk/tacos-core/pom.xml?view=markup in that way, mvn executes the related ant task On 4/23/07, Andrea Chiumenti [EMAIL PROTECTED] wrote: Hello, how can I use tapdoc ? mvn thx, kiuma -- Andreas Andreou - [EMAIL PROTECTED] - http://andyhot.di.uoa.gr Tapestry / Tacos developer Open Source / JEE Consulting
Re: tapdoc execution
this is a snippet of my pom: executions execution idtapdoc/id phasesite/phase configuration tasks ant antfile=src/main/conf/tapdoc/build.xml inheritRefs=true property name=libraries value=/org/jfly/web/components/JFly.library / property name=target.dir value=../target/site/JFlyWebComponents / property name=conf.dir value=src/main/conf/tapdoc / property name=tapdoc.links value= http://java.sun.com/j2se/1.5.0/docs/api/,http://java.sun.com/j2ee/1.4/docs/api/,http://tapestry.apache.org/tapestry4.1/tapestry-framework/apidocs/,http://tacos.sourceforge.net/tacos4.1/tacos-core/apidocs/ / target name=build / /ant /tasks /configuration goals goalrun/goal /goals /execution /executions the build.xml is placed into src/main/conf/tapdoc On 4/23/07, Andrea Chiumenti [EMAIL PROTECTED] wrote: yes, but I have this message /conf/tapdoc/build.xml:12: org.apache.hivemind.ApplicationRuntimeException: Could not parse specification classpath:/org/jfly/web/components/JFly.library but src/main/java/org/jfly/web/components/JFly.library is present the output message is: /home/kiuma/nbjfly/trunk/JFlyWebComponents/src/conf/tapdoc/build.xml:12: org.apache.hivemind.ApplicationRuntimeException: Could not parse specification classpath:/org/jfly/web/components/JFly.library. [classpath:/org/jfly/web/components/JFly.library] On 4/23/07, Andreas Andreou [EMAIL PROTECTED] wrote: http://tacos.svn.sourceforge.net/viewvc/tacos/tacos-4.1/trunk/tacos-core/pom.xml?view=markup in that way, mvn executes the related ant task On 4/23/07, Andrea Chiumenti [EMAIL PROTECTED] wrote: Hello, how can I use tapdoc ? mvn thx, kiuma -- Andreas Andreou - [EMAIL PROTECTED] - http://andyhot.di.uoa.gr Tapestry / Tacos developer Open Source / JEE Consulting
Re: tapdoc
I think it's not... If I remember well then when the components of a library are enumerated, only those components are listed which have an explicit component-type / declaration in the .library file. Pure Java components are not, so they won't be included in the documentation by default. Pure Java components should be explicitly declared as part of the library in an XML file named LibraryName.library.tapdoc. Similar possibility is given for components, in a ComponentName.jwc.tapdoc file one could define additional component information, like visual sample, example codes, etc. I haven't documented the format of these XML files yet, but I would... :) But of course annotations are supported and parameter descriptions are extracted from the .java file (if available) using a custom javadoc doclet. Regards, Norbi andyhot wrote: Henri Dupre wrote: Oh this looks very nice! Does tapdoc take into account also components with annotations that have no .jwc? It does... I think it uses a custom doclet to extract javadocs from those 'annotation-only' components On 8/15/06, Norbert Sándor [EMAIL PROTECTED] wrote: Hello, I have converted Tapdoc to Maven2, so it now has a standard website at: http://www.erinors.com/developer/project/tapdoc/ The jar and the source code is available from our maven2 repository. You can download a Maven2-based demo application from the website as well. (Please note: - the Maven2 integration is partial, currently the ant-plugin is used to integrate tapdoc to maven-based projects - the source code needs further cleanup) Regards, Norbert Sándor - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: tapdoc
OK, I would. andyhot wrote: thx Norbert! Just saw that we're not currently generating javadocs for contib (why???) at http://tapestry.apache.org/tapestry4.1/tapestry-contrib/apidocs/index.html but I guess you could already include this link in TapDocTask.java (for the external javadoc references) Norbert Sándor wrote: Hello, I have converted Tapdoc to Maven2, so it now has a standard website at: http://www.erinors.com/developer/project/tapdoc/ The jar and the source code is available from our maven2 repository. You can download a Maven2-based demo application from the website as well. (Please note: - the Maven2 integration is partial, currently the ant-plugin is used to integrate tapdoc to maven-based projects - the source code needs further cleanup) Regards, Norbert Sándor - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: tapdoc
thx Norbert! Just saw that we're not currently generating javadocs for contib (why???) at http://tapestry.apache.org/tapestry4.1/tapestry-contrib/apidocs/index.html but I guess you could already include this link in TapDocTask.java (for the external javadoc references) Norbert Sándor wrote: Hello, I have converted Tapdoc to Maven2, so it now has a standard website at: http://www.erinors.com/developer/project/tapdoc/ The jar and the source code is available from our maven2 repository. You can download a Maven2-based demo application from the website as well. (Please note: - the Maven2 integration is partial, currently the ant-plugin is used to integrate tapdoc to maven-based projects - the source code needs further cleanup) Regards, Norbert Sándor - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- Andreas Andreou - [EMAIL PROTECTED] - http://andyhot.di.uoa.gr Tapestry / Tacos developer Open Source / J2EE Consulting - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: tapdoc
Henri Dupre wrote: Oh this looks very nice! Does tapdoc take into account also components with annotations that have no .jwc? It does... I think it uses a custom doclet to extract javadocs from those 'annotation-only' components On 8/15/06, Norbert Sándor [EMAIL PROTECTED] wrote: Hello, I have converted Tapdoc to Maven2, so it now has a standard website at: http://www.erinors.com/developer/project/tapdoc/ The jar and the source code is available from our maven2 repository. You can download a Maven2-based demo application from the website as well. (Please note: - the Maven2 integration is partial, currently the ant-plugin is used to integrate tapdoc to maven-based projects - the source code needs further cleanup) Regards, Norbert Sándor - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- Andreas Andreou - [EMAIL PROTECTED] - http://andyhot.di.uoa.gr Tapestry / Tacos developer Open Source / J2EE Consulting - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: tapdoc
Oh this looks very nice! Does tapdoc take into account also components with annotations that have no .jwc? On 8/15/06, Norbert Sándor [EMAIL PROTECTED] wrote: Hello, I have converted Tapdoc to Maven2, so it now has a standard website at: http://www.erinors.com/developer/project/tapdoc/ The jar and the source code is available from our maven2 repository. You can download a Maven2-based demo application from the website as well. (Please note: - the Maven2 integration is partial, currently the ant-plugin is used to integrate tapdoc to maven-based projects - the source code needs further cleanup) Regards, Norbert Sándor - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- Henri Dupre Actualis Center
Re: tapdoc
Hey, thanks. looks great. is there some docs on the ant plugin at all? i want to use it to generate docs to include with the maven site. On Tue, 2006-08-15 at 15:56 +0200, Norbert Sándor wrote: Hello, I have converted Tapdoc to Maven2, so it now has a standard website at: http://www.erinors.com/developer/project/tapdoc/ The jar and the source code is available from our maven2 repository. You can download a Maven2-based demo application from the website as well. (Please note: - the Maven2 integration is partial, currently the ant-plugin is used to integrate tapdoc to maven-based projects - the source code needs further cleanup) Regards, Norbert Sándor - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] -- Dan Adams Senior Software Engineer Interactive Factory 617.235.5857 - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: tapdoc
Download the demo project, its pom.xml contains a sample configuration of the ant task. Regards, Norbi Dan Adams wrote: Hey, thanks. looks great. is there some docs on the ant plugin at all? i want to use it to generate docs to include with the maven site. On Tue, 2006-08-15 at 15:56 +0200, Norbert Sándor wrote: Hello, I have converted Tapdoc to Maven2, so it now has a standard website at: http://www.erinors.com/developer/project/tapdoc/ The jar and the source code is available from our maven2 repository. You can download a Maven2-based demo application from the website as well. (Please note: - the Maven2 integration is partial, currently the ant-plugin is used to integrate tapdoc to maven-based projects - the source code needs further cleanup) Regards, Norbert Sándor - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]