Update dependency build doc to improve understanding (#5379)

Signed-off-by: Martin Hickey <martin.hickey@ie.ibm.com>

cmd/helm/dependency_build.go

@@ -29,11 +29,11 @@ const dependencyBuildDesc = `
 Build out the charts/ directory from the requirements.lock file.
 
 Build is used to reconstruct a chart's dependencies to the state specified in
-the lock file. This will not re-negotiate dependencies, as 'helm dependency update'
+the lock file.
-does.
 
-If no lock file is found, 'helm dependency build' will mirror the behavior
+If no lock file is found, 'helm dependency build' will mirror the behavior of
-of 'helm dependency update'.
+the 'helm dependency update' command. This means it will update the on-disk
+dependencies to mirror the requirements.yaml file and generate a lock file.
 `
 
 type dependencyBuildCmd struct {

docs/helm/helm_dependency_build.md

@@ -8,12 +8,11 @@ rebuild the charts/ directory based on the requirements.lock file
 Build out the charts/ directory from the requirements.lock file.
 
 Build is used to reconstruct a chart's dependencies to the state specified in
-the lock file. This will not re-negotiate dependencies, as 'helm dependency update'
+the lock file.
-does.
-
-If no lock file is found, 'helm dependency build' will mirror the behavior
-of 'helm dependency update'.
 
+If no lock file is found, 'helm dependency build' will mirror the behavior of
+the 'helm dependency update' command. This means it will update the on-disk
+dependencies to mirror the requirements.yaml file and generate a lock file.
 
 ```
 helm dependency build [flags] CHART

docs/man/man1/helm_dependency_build.1

@@ -19,13 +19,12 @@ Build out the charts/ directory from the requirements.lock file.
 
 .PP
 Build is used to reconstruct a chart's dependencies to the state specified in
-the lock file. This will not re\-negotiate dependencies, as 'helm dependency update'
+the lock file.
-does.
 
 .PP
-If no lock file is found, 'helm dependency build' will mirror the behavior
+If no lock file is found, 'helm dependency build' will mirror the behavior of
-of 'helm dependency update'.
+the 'helm dependency update' command. This means it will update the on-disk
-
+dependencies to mirror the requirements.yaml file and generate a lock file.
 
 .SH OPTIONS
 .PP