[prev in list] [next in list] [prev in thread] [next in thread] 

List:       maven-user
Subject:    Re: misleading docmentation
From:       Arnaud_Héritier <aheritier () apache ! org>
Date:       2017-10-26 21:24:19
Message-ID: CAFNCU-9MEPhDr4g1C_xsujLAHhFwN=h25Zz70XMbMPzZ__KM-w () mail ! gmail ! com
[Download RAW message or body]

[Attachment #2 (multipart/alternative)]


Hi Nir

  Thanks for your feedback.
  I admit that I really hate when the property name is different than the
configuration parameter but it seems properly defined in the doc :

*allowTimestampedSnapshots:*
Whether to allow timestamped SNAPSHOT dependencies. Default is to fail when
finding any SNAPSHOT.

   - *Type*: boolean
   - *Since*: 2.0-beta-7
   - *Required*: No
   - *User Property*: ignoreSnapshots
   - *Default*: false


http://maven.apache.org/maven-release/maven-release-plugin/prepare-mojo.html#allowTimestampedSnapshots


You have to use
<allowTimestampedSnapshots>true</allowTimestampedSnapshots> in the plugin
configuration but -DignoreSnapshots=true in command line in that case


Regards

PS : I moved the discussion to the user dev mailing list where you receive
more help than directly from few commiters




On Thu, Oct 26, 2017 at 11:02 PM, Nir Bar-on <lukass77@gmail.com> wrote:

> Hi all,
> I found misleading documentation in maven release plugin.
> it took me hours find it ..and to solve my issue because documentation was
> wrong .. i was about to drop the use of the plugin and start to think on
> another way to do "release.."
> 
> the issue is that on documentation for the goal release:prepare, the
> parameter name is *"allowTimestampedSnapshots"*
> but it doesn't have any effect in case you have snapshot dependency.
> because on the source code of the plugin the value of the parameter name is
> 
> * "ignoreSnapshots"*
> 
> the fix can be changing the documentation ..or changing the parameter
> name in the code
> 
> 
> [image: Inline image 1]
> resouces
> https://stackoverflow.com/questions/245932/how-to-release-a-
> project-which-depends-on-a-3rd-party-snapshot-project-in-
> maven/3959507#3959507
> 
> 
> <https://stackoverflow.com/questions/245932/how-to-release-a-project-which-depends-on-a-3rd-party-snapshot-project-in-maven/3959507#3959507>
>  http://svn.apache.org/viewvc/maven/release/tags/maven-
> release-2.5.3/maven-release-plugin/src/main/java/org/
> apache/maven/plugins/release/PrepareReleaseMojo.java?view=markup
> 
> <https://stackoverflow.com/questions/245932/how-to-release-a-project-which-depends-on-a-3rd-party-snapshot-project-in-maven/3959507#3959507>
>  
> 
> <https://stackoverflow.com/questions/245932/how-to-release-a-project-which-depends-on-a-3rd-party-snapshot-project-in-maven/3959507#3959507>
>  
> Please confirm that this will be fixed ...
> Thanks!
> Nir
> 
> 
> <https://stackoverflow.com/questions/245932/how-to-release-a-project-which-depends-on-a-3rd-party-snapshot-project-in-maven/3959507#3959507>
>  
> 
> <https://stackoverflow.com/questions/245932/how-to-release-a-project-which-depends-on-a-3rd-party-snapshot-project-in-maven/3959507#3959507>
>  
> 
> <https://stackoverflow.com/questions/245932/how-to-release-a-project-which-depends-on-a-3rd-party-snapshot-project-in-maven/3959507#3959507>
>  
> 
> <https://stackoverflow.com/questions/245932/how-to-release-a-project-which-depends-on-a-3rd-party-snapshot-project-in-maven/3959507#3959507>
>  
> 


-- 

Arnaud


[Attachment #5 (text/html)]

<div dir="ltr">Hi Nir<div><br></div><div>   Thanks for your feedback.</div><div>   I \
admit that I really hate when the property name is different than the configuration \
parameter but it seems properly defined in the doc :</div><div><br></div><div><p \
style="margin:0px 7px 10px;color:rgb(51,51,51);font-family:&quot;Helvetica \
Neue&quot;,Helvetica,Arial,sans-serif;font-size:14px"><b><a \
name="allowTimestampedSnapshots" \
style="color:rgb(0,136,204)">allowTimestampedSnapshots</a>:</b></p><div \
style="color:rgb(51,51,51);font-family:&quot;Helvetica \
Neue&quot;,Helvetica,Arial,sans-serif;font-size:14px">Whether to allow timestamped \
SNAPSHOT dependencies. Default is to fail when finding any SNAPSHOT.</div><ul \
style="padding:0px;margin:0px 0px 10px \
25px;color:rgb(51,51,51);font-family:&quot;Helvetica \
Neue&quot;,Helvetica,Arial,sans-serif;font-size:14px"><li \
style="line-height:20px;color:rgb(64,64,64)"><b>Type</b>:  <tt \
style="font-family:Monaco,&quot;Andale Mono&quot;,&quot;Courier \
New&quot;,monospace;font-size:0.8em;border-radius:3px;background-color:rgb(254,233,204);color:rgba(0,0,0,0.75);padding:1px \
3px">boolean</tt></li><li style="line-height:20px;color:rgb(64,64,64)"><b>Since</b>:  \
<tt style="font-family:Monaco,&quot;Andale Mono&quot;,&quot;Courier \
New&quot;,monospace;font-size:0.8em;border-radius:3px;background-color:rgb(254,233,204);color:rgba(0,0,0,0.75);padding:1px \
3px">2.0-beta-7</tt></li><li \
style="line-height:20px;color:rgb(64,64,64)"><b>Required</b>:  <tt \
style="font-family:Monaco,&quot;Andale Mono&quot;,&quot;Courier \
New&quot;,monospace;font-size:0.8em;border-radius:3px;background-color:rgb(254,233,204);color:rgba(0,0,0,0.75);padding:1px \
3px">No</tt></li><li style="line-height:20px;color:rgb(64,64,64)"><b>User \
Property</b>:  <tt style="font-family:Monaco,&quot;Andale Mono&quot;,&quot;Courier \
New&quot;,monospace;font-size:0.8em;border-radius:3px;background-color:rgb(254,233,204);color:rgba(0,0,0,0.75);padding:1px \
3px">ignoreSnapshots</tt></li><li \
style="line-height:20px;color:rgb(64,64,64)"><b>Default</b>:  <tt \
style="font-family:Monaco,&quot;Andale Mono&quot;,&quot;Courier \
New&quot;,monospace;font-size:0.8em;border-radius:3px;background-color:rgb(254,233,204);color:rgba(0,0,0,0.75);padding:1px \
3px">false</tt></li></ul></div><div><br></div><div><a \
href="http://maven.apache.org/maven-release/maven-release-plugin/prepare-mojo.html#all \
owTimestampedSnapshots">http://maven.apache.org/maven-release/maven-release-plugin/prepare-mojo.html#allowTimestampedSnapshots</a><br></div><div><br></div><div>You \
have to use &lt;allowTimestampedSnapshots&gt;true&lt;/allowTimestampedSnapshots&gt;  \
in the plugin configuration but -DignoreSnapshots=true in command line in that \
case</div><div><br></div><div><br></div><div>Regards</div><div><br></div><div>PS : I \
moved the discussion to the user dev mailing list where you receive more help than \
directly from few commiters</div><div><br></div><div><br></div><div><br></div></div><div \
class="gmail_extra"><br><div class="gmail_quote">On Thu, Oct 26, 2017 at 11:02 PM, \
Nir Bar-on <span dir="ltr">&lt;<a href="mailto:lukass77@gmail.com" \
target="_blank">lukass77@gmail.com</a>&gt;</span> wrote:<br><blockquote \
class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc \
solid;padding-left:1ex"><div dir="ltr"><div><div><div><div><div>Hi all,<br>I found \
misleading documentation in maven release plugin.<br></div>it took me hours find it \
..and to solve my issue because documentation was wrong .. i was about to drop the \
use of the plugin and start to think on another way to do &quot;release..&quot; \
<br><br></div>the issue is that on documentation for the goal release:prepare, the \
parameter name is <b>&quot;<code>allowTimestampedSnapshots</code>&quot;</b><br></div>but \
it doesn&#39;t have any effect in case you have snapshot dependency.<br></div>because \
on the source code of the plugin the value of the parameter name is<b> &quot;<span \
class="m_-4098181212405651475gmail-m_5004482939450902376gmail-pygments-s">ignoreSnapshots&quot;<br><br></span></b></div><b><span \
class="m_-4098181212405651475gmail-m_5004482939450902376gmail-pygments-s"><br></span></b><div><div><div><div><div> \
the fix can be changing the documentation ..or changing the parameter name in the \
code <br></div><div><br></div><div><br></div><div><img src="cid:ii_15f5a72cc89f3b90" \
alt="Inline image 1" height="109" width="517">  </div><div>resouces <br></div><div><a \
href="https://stackoverflow.com/questions/245932/how-to-release-a-project-which-depends-on-a-3rd-party-snapshot-project-in-maven/3959507#3959507" \
target="_blank">https://stackoverflow.com/ques<wbr>tions/245932/how-to-release-a-<wbr> \
project-which-depends-on-a-<wbr>3rd-party-snapshot-project-in-<wbr>maven/3959507#3959507</a></div><div><a \
href="https://stackoverflow.com/questions/245932/how-to-release-a-project-which-depends-on-a-3rd-party-snapshot-project-in-maven/3959507#3959507" \
target="_blank"><br></a></div><div><a \
href="https://stackoverflow.com/questions/245932/how-to-release-a-project-which-depends-on-a-3rd-party-snapshot-project-in-maven/3959507#3959507" \
target="_blank">http://svn.apache.org/viewvc/<wbr>maven/release/tags/maven-<wbr>releas \
e-2.5.3/maven-release-<wbr>plugin/src/main/java/org/<wbr>apache/maven/plugins/release/<wbr>PrepareReleaseMojo.java?view=<wbr>markup<br></a></div><div><a \
href="https://stackoverflow.com/questions/245932/how-to-release-a-project-which-depends-on-a-3rd-party-snapshot-project-in-maven/3959507#3959507" \
target="_blank"><br></a></div><div><br></div><div>Please confirm that this will be \
fixed ...</div><div>Thanks!</div><span class="HOEnZb"><font \
color="#888888"><div>Nir<br></div><div><a \
href="https://stackoverflow.com/questions/245932/how-to-release-a-project-which-depends-on-a-3rd-party-snapshot-project-in-maven/3959507#3959507" \
target="_blank"><br></a></div><div><a \
href="https://stackoverflow.com/questions/245932/how-to-release-a-project-which-depends-on-a-3rd-party-snapshot-project-in-maven/3959507#3959507" \
target="_blank"><br></a></div><div><a \
href="https://stackoverflow.com/questions/245932/how-to-release-a-project-which-depends-on-a-3rd-party-snapshot-project-in-maven/3959507#3959507" \
target="_blank"><br></a></div><div><a \
href="https://stackoverflow.com/questions/245932/how-to-release-a-project-which-depends-on-a-3rd-party-snapshot-project-in-maven/3959507#3959507" \
target="_blank"><br></a></div><div><br></div></font></span></div></div></div></div></div>
 </blockquote></div><br><br clear="all"><div><br></div>-- <br><div \
class="gmail_signature" \
data-smartmail="gmail_signature"><br><div>Arnaud</div><div><br></div></div> </div>

--94eb2c18fd22c78039055c79cc4a--



[prev in list] [next in list] [prev in thread] [next in thread] 

Configure | About | News | Add a list | Sponsored by KoreLogic