Add xref to syntax of template param, tidy up description.

svn path=/trunk/; revision=493
diff --git a/src/jsr311-api/src/javax/ws/rs/PathParam.java b/src/jsr311-api/src/javax/ws/rs/PathParam.java
index 14829aa..81dfb08 100644
--- a/src/jsr311-api/src/javax/ws/rs/PathParam.java
+++ b/src/jsr311-api/src/javax/ws/rs/PathParam.java
@@ -70,12 +70,13 @@
 @Retention(RetentionPolicy.RUNTIME)
 public @interface PathParam {
     /**
-     * Defines the name of the URI template parameter who value will be used
+     * Defines the name of the URI template parameter whose value will be used
      * to initialize the value of the annotated method parameter, class field or
-     * property.
+     * property. See {@link Path#value()} for a description of the syntax of
+     * template parameters.
      * 
      * <p>E.g. a class annotated with: <code>&#64;Path("widgets/{id}")</code>
-     * can have methods annotated with a HTTP method annotation whose arguments are annotated
+     * can have methods annotated whose arguments are annotated
      * with <code>&#64;PathParam("id")</code>.
      */
     String value();