HADOOP-19696. improve docs.

Author: steveloughran

BUILDING.txt

@@ -391,16 +391,18 @@ Note that the site needs to be built in a second pass after other artifacts.
 ----------------------------------------------------------------------------------
 Including Cloud Connector Dependencies in Distributions:
 
-Hadoop distributions include the hadoop modules to work with data and services
+Hadoop distributions include the hadoop modules need to work with data and services
 on cloud infrastructure
 
 However, dependencies are omitted for all cloud connectors except hadoop-azure
 (abfs:// and wasb://) and possibly hadoop-gcp (gs://) and hadoop-tos (tos://).
 For the latter two modules, it depends on shading options.
 
-For hadoop-aws the AWS SDK bundle.jar omitted, but everything else is included.
+For hadoop-aws the AWS SDK bundle.jar is omitted, but everything else is included.
 
-* This keeps binary release size below the limit of apache distributions
+
+Excluding the extra binaries:
+* Keeps release artifact size below the limit of the ASF distribution network
 * Reduces download and size overhead in docker usage.
 * Reduces the CVE attack surface
 * Reduces the risk of classpath conflict.
@@ -425,13 +427,18 @@ Available package profiles:
 To build a complete distribution then with all cloud dependencies included:
 
 mvn package -Pdist -DskipTests -Dtar -Dmaven.javadoc.skip=true \
- -Dhadoop-aliyun-package -Dhadoop-aws-package -Dhadoop-azure-datalake-package\
- -Dhadoop-cos-package -Dhadoop-gcp-package -Dhadoop-tos-package
+ -Dhadoop-aliyun-package \
+ -Dhadoop-aws-package \
+ -Dhadoop-azure-datalake-package \
+ -Dhadoop-cos-package \
+ -Dhadoop-gcp-package \
+ -Dhadoop-huaweicloud-package \
+ -Dhadoop-tos-package
 
 The resulting tar file will be too large to be distributable through ASF infrastructure.
 
-The hadoop-gcp and hadoop-tos artifacts include their dependencies unless the distribution
-is built with -DskipShade.
+The hadoop-gcp and hadoop-tos artifacts include their dependencies as shaded
+artifacts unless the distribution is built with -DskipShade.
 
 ----------------------------------------------------------------------------------
 Installing Hadoop

hadoop-cloud-storage-project/hadoop-cloud-storage-dist/pom.xml

@@ -61,9 +61,16 @@
     hadoop-huaweicloud-package
     hadoop-tos-package
 
- To build a complete distribution then
- mvn package -Pdist -DskipTests -Phadoop-aliyun-package,hadoop-aws-package,hadoop-azure-datalake-package\
-   -Phadoop-cos-package,hadoop-gcp-package,hadoop-tos-package
+ To build a complete distribution then:
+
+mvn package -Pdist -DskipTests -Dtar -Dmaven.javadoc.skip=true \
+ -Dhadoop-aliyun-package \
+ -Dhadoop-aws-package \
+ -Dhadoop-azure-datalake-package \
+ -Dhadoop-cos-package \
+ -Dhadoop-gcp-package \
+ -Dhadoop-huaweicloud-package \
+ -Dhadoop-tos-package
 
   -->
   <properties>