Documents the new @AuthenticationPrincipal in more detail.

Fixes gh-3771

web/src/main/java/org/springframework/security/web/bind/annotation/AuthenticationPrincipal.java

@@ -29,8 +29,7 @@ import org.springframework.security.core.Authentication;
  * should be resolved to the current user rather than a user that might be edited on a
  * form.
  *
- * @deprecated Use org.springframework.security.core.annotation.AuthenticationPrincipal
- * instead
+ * @deprecated Use {@link org.springframework.security.core.annotation.AuthenticationPrincipal} instead.
  *
  * @author Rob Winch
  * @since 3.2

web/src/main/java/org/springframework/security/web/bind/support/AuthenticationPrincipalArgumentResolver.java

@@ -77,8 +77,7 @@ import org.springframework.web.method.support.ModelAndViewContainer;
  * }
  * </pre>
  *
- * @deprecated use org.springframework.security.web.method.annotation.
- * AuthenticationPrincipalArgumentResolver
+ * @deprecated Use {@link org.springframework.security.web.method.annotation.AuthenticationPrincipalArgumentResolver} instead.
  *
  * @author Rob Winch
  * @since 3.2