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>@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>@PathParam("id")</code>.
*/
String value();