Improve cf push examples

Previously, the examples in this repository for pushing applications
read as `cf push -b https://github.com/cloudfoundry/java-
buildpack.git`.  While this would work in cases where there was a
manifest for the application, it lead to confusion among users.

This change makes the examples more verbose, but much more clear and,
we hope, reduce the amount of confusion.

see: https://groups.google.com/a/cloudfoundry.org/d/topic/vcap-dev/ROJfb0SJ5PA/discussion

[#68430712]

Author: nebhale

README.md

@@ -10,7 +10,7 @@ The `java-buildpack` is a [Cloud Foundry][] buildpack for running JVM-based appl
 To use this buildpack specify the URI of the repository when pushing an application to Cloud Foundry:
 
 ```bash
-cf push -b https://github.com/cloudfoundry/java-buildpack
+cf push <APP-NAME> -p <ARTIFACT> -b https://github.com/cloudfoundry/java-buildpack.git
 ```
 
 ## Examples

docs/example-grails.md

@@ -5,7 +5,7 @@ The Java Buildpack treats Grails applications as normal Servlet applications bui
 
 ```bash
 $ ./grailsw war
-$ cf push -m 768M -p target/grails-application-0.1.war -b https://github.com/cloudfoundry/java-buildpack.git
+$ cf push grails-application -m 768M -p target/grails-application-0.1.war -b https://github.com/cloudfoundry/java-buildpack.git
 -----> Downloading Open Jdk JRE 1.7.0_51 from http://.../openjdk/lucid/x86_64/openjdk-1.7.0_51.tar.gz (0.0s)
        Expanding Open Jdk JRE to .java-buildpack/open_jdk_jre (1.1s)
 -----> Downloading Spring Auto Reconfiguration 0.8.7 from http://.../auto-reconfiguration/auto-reconfiguration-0.8.7.jar (0.0s)

docs/example-groovy.md

@@ -5,7 +5,7 @@ The Java Buildpack can run Groovy applications written with the [Ratpack framewo
 The following example shows how deploy the sample application located in the [Java Test Applications][j].
 
 ```bash
-$ cf push -b https://github.com/cloudfoundry/java-buildpack.git
+$ cf push groovy-application -b https://github.com/cloudfoundry/java-buildpack.git
 -----> Downloading Open Jdk JRE 1.7.0_51 from http://.../openjdk/lucid/x86_64/openjdk-1.7.0_51.tar.gz (0.0s)
        Expanding Open Jdk JRE to .java-buildpack/open_jdk_jre (1.3s)
 -----> Downloading Spring Auto Reconfiguration 0.8.7 from http://.../auto-reconfiguration/auto-reconfiguration-0.8.7.jar (0.0s)

docs/example-java_main.md

@@ -6,7 +6,7 @@ The following example shows how deploy the sample application located in the [Ja
 
 ```bash
 $ gradle build
-$ cf push -p build/libs/java-main-application-1.0.0.BUILD-SNAPSHOT.jar -b https://github.com/cloudfoundry/java-buildpack.git
+$ cf push java-main-application -p build/libs/java-main-application-1.0.0.BUILD-SNAPSHOT.jar -b https://github.com/cloudfoundry/java-buildpack.git
 
 -----> Downloading Open Jdk JRE 1.7.0_51 from http://.../openjdk/lucid/x86_64/openjdk-1.7.0_51.tar.gz (0.0s)
        Expanding Open Jdk JRE to .java-buildpack/open_jdk_jre (1.2s)
@@ -22,7 +22,7 @@ The following example shows how deploy the sample application located in the [Ja
 
 ```bash
 $ mvn package
-$ cf push -p target/java-main-application-1.0.0.BUILD-SNAPSHOT.jar -b https://github.com/cloudfoundry/java-buildpack.git
+$ cf push java-main-application -p target/java-main-application-1.0.0.BUILD-SNAPSHOT.jar -b https://github.com/cloudfoundry/java-buildpack.git
 
 -----> Downloading Open Jdk JRE 1.7.0_51 from http://.../openjdk/lucid/x86_64/openjdk-1.7.0_51.tar.gz (0.0s)
        Expanding Open Jdk JRE to .java-buildpack/open_jdk_jre (1.2s)

docs/example-play_framework.md

@@ -6,7 +6,7 @@ The following example shows how deploy the sample application located in the [Ja
 
 ```bash
 $ play dist
-$ cf push -p target/universal/play-application-1.0-SNAPSHOT.zip -b https://github.com/cloudfoundry/java-buildpack.git
+$ cf push play-application -p target/universal/play-application-1.0-SNAPSHOT.zip -b https://github.com/cloudfoundry/java-buildpack.git
 
 -----> Downloading Open Jdk JRE 1.7.0_51 from http://.../openjdk/lucid/x86_64/openjdk-1.7.0_51.tar.gz (0.0s)
        Expanding Open Jdk JRE to .java-buildpack/open_jdk_jre (1.2s)
@@ -23,7 +23,7 @@ The following example shows how deploy the sample application located in the [Ja
 
 ```bash
 $ play stage
-$ cf push -p target/universal/stage -b https://github.com/cloudfoundry/java-buildpack.git
+$ cf push play-application -p target/universal/stage -b https://github.com/cloudfoundry/java-buildpack.git
 
 -----> Downloading Open Jdk JRE 1.7.0_51 from http://.../openjdk/lucid/x86_64/openjdk-1.7.0_51.tar.gz (0.0s)
        Expanding Open Jdk JRE to .java-buildpack/open_jdk_jre (1.2s)

docs/example-servlet.md

@@ -6,7 +6,7 @@ The following example shows how deploy the sample application located in the [Ja
 
 ```bash
 $ gradle build
-$ cf push -p build/libs/web-servlet-2-application-1.0.0.BUILD-SNAPSHOT.war -b https://github.com/cloudfoundry/java-buildpack.git
+$ cf push web-servlet-2-application -p build/libs/web-servlet-2-application-1.0.0.BUILD-SNAPSHOT.war -b https://github.com/cloudfoundry/java-buildpack.git
 
 -----> Downloading Open Jdk JRE 1.7.0_51 from http://.../openjdk/lucid/x86_64/openjdk-1.7.0_51.tar.gz (0.0s)
        Expanding Open Jdk JRE to .java-buildpack/open_jdk_jre (1.1s)
@@ -26,7 +26,7 @@ The following example shows how deploy the sample application located in the [Ja
 
 ```bash
 $ mvn package
-$ cf push -p cf push -p target/web-servlet-2-application-1.0.0.BUILD-SNAPSHOT.war -b https://github.com/cloudfoundry/java-buildpack.git -b https://github.com/cloudfoundry/java-buildpack.git
+$ cf push web-servlet-2-application -p target/web-servlet-2-application-1.0.0.BUILD-SNAPSHOT.war -b https://github.com/cloudfoundry/java-buildpack.git -b https://github.com/cloudfoundry/java-buildpack.git
 
 -----> Downloading Open Jdk JRE 1.7.0_51 from http://.../openjdk/lucid/x86_64/openjdk-1.7.0_51.tar.gz (0.0s)
        Expanding Open Jdk JRE to .java-buildpack/open_jdk_jre (1.1s)

docs/example-spring_boot_cli.md

@@ -6,7 +6,7 @@ The following example shows how deploy the sample application located in the [Ja
 
 ```bash
 $ spring grab *.groovy
-$ $ cf push -b https://github.com/cloudfoundry/java-buildpack.git
+$ $ cf push spring-boot-cli-application -b https://github.com/cloudfoundry/java-buildpack.git
 
 -----> Downloading Open Jdk JRE 1.7.0_51 from http://.../openjdk/lucid/x86_64/openjdk-1.7.0_51.tar.gz (0.0s)
        Expanding Open Jdk JRE to .java-buildpack/open_jdk_jre (1.2s)
@@ -24,7 +24,7 @@ The following example shows how deploy the sample application located in the [Ja
 
 ```bash
 $ spring jar spring-boot-cli-application-1.0.0.BUILD-SNAPSHOT.jar *.groovy
-$ cf push -p spring-boot-cli-application-1.0.0.BUILD-SNAPSHOT.jar -b https://github.com/cloudfoundry/java-buildpack.git
+$ cf push spring-boot-cli-application -p spring-boot-cli-application-1.0.0.BUILD-SNAPSHOT.jar -b https://github.com/cloudfoundry/java-buildpack.git
 
 -----> Downloading Open Jdk JRE 1.7.0_51 from http://.../openjdk/lucid/x86_64/openjdk-1.7.0_51.tar.gz (0.0s)
        Expanding Open Jdk JRE to .java-buildpack/open_jdk_jre (1.2s)