I don't want to repeat myself, my reply is in the original thread, however,
in addition, you will note that some tasks take a lot of flags, documenting
all flags for each task would make the output of ./gradlew tasks unreadable.

So I recommend not doing that.

On Fri, Mar 17, 2017 at 1:20 PM, Jacques Le Roux <
[email protected]> wrote:

> Because I'm not satisfied with (eg)
>
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------
>
> "gradlew help --task pullPluginSource"
>
> :help
> Detailed task information for pullPluginSource
> Path
>      :pullPluginSource
> Type
>      Task (org.gradle.api.Task)
> Description
>      Download and install a plugin from source control
> Group
>      OFBiz Plugin
>
> ------------------------------------------------------------
> ------------------------------------------------------------
> ------------------------------
>
> In other words, I have to look into the README file each time I don't
> remember the string to pass behind -P , here pluginId
>
> So I'd like to change the description
>         -task pullPluginSource(group: ofbizPlugin, description: 'Download
> and install a plugin from source control') {
>         +task pullPluginSource(group: ofbizPlugin, description: 'Download
> and install a plugin from source control, parameter: pluginId') {
>
> same for all tasks with parameters.
>
> Agreed?
>
> Jacques
>
>
>
> Le 17/03/2017 à 10:43, Taher Alkhateeb a écrit :
>
>> Why are you repeating conversations we already had?
>>
>> https://s.apache.org/E1dE
>>
>> On Fri, Mar 17, 2017 at 12:14 PM, Jacques Le Roux <
>> [email protected]> wrote:
>>
>> Hi,
>>>
>>> There was something very convenient with "Ant -p" "documentation": syntax
>>> examples.
>>>
>>> I believe we miss that, at least found it when using "g help --task
>>> pullPluginSource". You get what it does but not how to do it (syntax).
>>>
>>> Of course you can open the README.md file and look for reference but
>>> that's tedious and counter-intuitive.
>>>
>>> Would you agree to add the syntax in descriptions of tasks with
>>> parameters
>>> ?
>>>
>>> Jacques
>>>
>>>
>>>
>

Reply via email to