search

asciidoctor / asciidoclet

:clipboard: A Javadoc Doclet based on Asciidoctor that lets you write Javadoc in the AsciiDoc syntax.
https://github.com/asciidoctor/asciidoclet
Apache License 2.0
133 stars 40 forks source link

allow multiple source location in gradle #67

Open tbee opened 6 years ago

tbee commented 6 years ago

I use asciidoctlet in JFXtras and am very pleased with it. Recently Maven central required all jars to be accompanied with a source jar and javadoc jar. Beside the component jars, JFXtras also releases an all-in-one jar, which now requires a source and javadoc jar. I'm not very fluent in Gradle, but apparently asciidoctor cannot use multiple source locations so to generate one big javadoc. Is this easily added?

johncarl81 commented 6 years ago

I believe we're deploying the source and javadoc jars. For example: https://bintray.com/asciidoctor/maven/asciidoclet#files/org%2Fasciidoctor%2Fasciidoclet%2F1.5.6

tbee commented 6 years ago

The operative word here being "multiple".

msgilligan commented 6 years ago

Look at the ConsensusJ project (in gradle/javadoc.gradle) for an example...

johncarl81 commented 6 years ago

Correct me if I'm wrong @msgilligan... here's the configuration @tbee to collect all your project source javadocs together: https://github.com/ConsensusJ/consensusj/blob/master/gradle/javadoc.gradle#L49-L50

This is less of a doclet issue than a Javadoc thing.

msgilligan commented 6 years ago

Yes, @johncarl81 it's a Gradle and Javadoc configuration issue, but ConsensusJ shows one way of doing it.

BTW, it's really cool to hear that https://github.com/JFXtras is using Asciidoclet!

johncarl81 commented 6 years ago

@tbee, does this give you enough to go on?