svn commit: r1817358 - /ofbiz/ofbiz-framework/trunk/README.md

[ta...@apache.org]

Author: taher
Date: Thu Dec  7 11:31:05 2017
New Revision: 1817358

URL: http://svn.apache.org/viewvc?rev=1817358&view=rev
Log:
Improved: moved the gradle internet flag documentation to a separate section

Add a small note at the top to refer to the section and expand the explanation
of that flag in a separate section to reduce the clutter around the quick-start
documentation

Modified:
    ofbiz/ofbiz-framework/trunk/README.md

Modified: ofbiz/ofbiz-framework/trunk/README.md
URL: http://svn.apache.org/viewvc/ofbiz/ofbiz-framework/trunk/README.md?rev=1817358&r1=1817357&r2=1817358&view=diff
==============================================================================
--- ofbiz/ofbiz-framework/trunk/README.md (original)
+++ ofbiz/ofbiz-framework/trunk/README.md Thu Dec  7 11:31:05 2017
@@ -36,7 +36,10 @@ section to set it up.
 >_Note_: If you want to use an external database like MySQL or PostgreSQL, read
 the "Setup an external database" section to set it up.
 
-> Note : The directory structure and repositories have changed. For more
+>_Note_: If you want to run OFBiz without an internet connection, read the
+"Running gradle tasks without an internet connection" section.
+
+>_Note_: The directory structure and repositories have changed. For more
 information read the "Repository and directory structure" section.
 
 System requirements
@@ -60,8 +63,6 @@ from the command line at the OFBiz top l
 time for this step to complete if you are using OFBiz for the first time
 as it needs to download all dependencies. So please be patient!
 
->_Note_: Without internet connection, dependency resolution and the build will fail. The `--offline` command line switch tells Gradle to always use dependency modules from the cache, regardless if they are due to be checked again. When running with offline, Gradle will never attempt to access the network to perform dependency resolution. If required modules are not present in the dependency cache, build execution will fail.
-
 MS Windows:
 `gradlew cleanAll loadAll`
 
@@ -661,6 +662,18 @@ To check out a plugin from source contro
 To check out all plugins from source control use the **pullAllPluginsSource**.
 **Beware** this deletes a previously existing plugins directory.
 
+### Running gradle tasks without an internet connection
+
+OFBiz must run with an internet connection the **first time** it is prepared on
+the system because it needs to download all the required dependencies.
+
+After preparing OFBiz the first time correctly, it is possible to run OFBiz
+without an internet connection by using the `--offline` command line switch
+which tells Gradle to fetch its dependencies from the cache.
+
+If any dependencies are missing from the cache and you pass `--offline` switch
+then the build execution will fail.
+
 ### Setup an external database like MySQL, PostgreSQL, etc
 
 To setup an external database instead of the default embedded Apache Derby, you