Author: khmarbaise Date: Sat Mar 22 14:32:49 2014 New Revision: 1580215 URL: http://svn.apache.org/r1580215 Log: [MNGSITE-159] - Added explanation for usage of passwords with special characters on different platforms.
Modified: maven/site/trunk/content/apt/guides/mini/guide-encryption.apt Modified: maven/site/trunk/content/apt/guides/mini/guide-encryption.apt URL: http://svn.apache.org/viewvc/maven/site/trunk/content/apt/guides/mini/guide-encryption.apt?rev=1580215&r1=1580214&r2=1580215&view=diff ============================================================================== --- maven/site/trunk/content/apt/guides/mini/guide-encryption.apt (original) +++ maven/site/trunk/content/apt/guides/mini/guide-encryption.apt Sat Mar 22 14:32:49 2014 @@ -216,3 +216,24 @@ jSMOWnoPFgsHVpMvz5VrIt5kRbzGpI8u+{EF1iFQ and settings security file. Keep this file secure (or stored separately) if you expect the possibility that the <<<settings.xml>>> file may be retrieved. +** Password Escaping on different platforms + + On some platforms it might be neccessary to quote your password based on the content of your + password in particular having special characters like <<<%>>>, <<<!>>>, <<<$>>> etc. in there. + For example on Windows you have to be carefull about things like the following: + + The following example will not work on Windows: + ++----+ +mvn.bat --encrypt-master-password a!$%^b ++----+ + + whereas the following will work on Windows: + ++----+ +mvn.bat --encrypt-master-password "a!$%^b" ++----+ + + If you are on a linux/unix platform you should use single quotes for the above + master password otherwise you will be astonished that the usage of the master-password + will not work (caused by the dollar sign and furthermore the exclamation mark).