Allow multiple documents in sourceDocumentName property about asciidoctor-gradle-plugin

[mojavelinux]

The proper way to solve this problem is to prefix the name of every include file with an underscore (_) or put the include files in a directory that begins with an underscore. The plugin is configured to skip all files that begin with this character.

If that solution presents a problem, I would suggest adding an include / exclude filter rather than having the sourceDocumentName accept a list of files. The sourceDocumentName is there to be used when you are building a single master and want to be able to communicate that to users of the project. If you are still hoping to be able to list the specific AsciiDoc files to process, then I would suggest introducing a mutually exclusive property sourceDocumentNames.

[aalmiray]

My sentiments exactly. Adding Set<String> sourceDocumentNames may serve to filter out which files should be processed instead of forcing developers to rename files with a leading _ (which or course is an option they can exercise at any time). This new property would have precendence over the single sourceDocumentName, same as backends has precendence over backend. WDYT?

[guylabs]

@mojavelinux Thanks for the solution. But I think the idea of @aalmiray fits better to our needs, because we would then be able to specify which files to process and don't have to rename the files.

[mojavelinux]

Sounds good to me!