diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index df511c3d896..f2e468e4a60 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -3720,10 +3720,10 @@ makes @code{modeline} an alias for the @code{mode-line} face.
 @end example
 
 @defmac define-obsolete-face-alias obsolete-face current-face when
-This macro defines @code{obsolete-face} as an alias for
+This macro defines @var{obsolete-face} as an alias for
 @var{current-face}, and also marks it as obsolete, indicating that it
-may be removed in future.  @var{when} should be a string indicating
-when @code{obsolete-face} was made obsolete (usually a version number
+may be removed in the future.  @var{when} should be a string indicating
+when @var{obsolete-face} was made obsolete (usually a version number
 string).
 @end defmac