JDK-8186788 : Release Note: Deployment.properties file example is incorrect
  • Type: Sub-task
  • Component: deploy
  • Affected Version: 8u161
  • Priority: P4
  • Status: Closed
  • Resolution: Not an Issue
  • Submitted: 2017-08-25
  • Updated: 2017-12-14
  • Resolved: 2017-09-13
Description
The *Java Platform, Standard Edition Deployment Guide,* [section 21](http://docs.oracle.com/javase/8/docs/technotes/guides/deploy/properties.html#CHDDDEHJ) has an issue in the following text from paragraph 21.1.2:

"The deployment.system.config property is the URL to the system (enterprise-wide) deployment.properties file. This property can be used by system administrators to centrally administer or "lock-down" user-specific configuration settings. For local files, use the file protocol in the URL, for example, `file:///C:/Windows/Sun/Java/Deployment/deployment.properties.`"

Specifically, the issue is with the "example" ext. The following notation does not work:

  'deployment.system.config=file:///C:/Windows/Sun/Java/Deployment/deployment.properties'

Instead of the notation in the example, the following syntax must be used, or else the contents of the deployment.config and consequently, the `deployment.properties` file are essentially ignored (the `.config` and `.properties` files may as well not exist): 

  'deployment.system.config=file\:\\C\:\\Windows\\Sun\\Java\\Deployment\\deployment.properties'

Note the change from forward slashes to backslashes, as well as the required "escaping" done by the double-backslash. 
Comments
I think we have to keep using URL notation for ���deployment.system.config��� property in documentation, because it is enterprise-wide option and may point to some location in net.
13-09-2017

Moved the version out to match the change in the parent release label.
05-09-2017

Both notation work properly for me on 8u151. I am sorry, but it seems redundant to update the release notes.
30-08-2017

Please review and let me know if this is now correct and ready to be included in our release notes.
28-08-2017