diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi
index 3a3dd1d4461..bebf410f919 100644
--- a/doc/emacs/building.texi
+++ b/doc/emacs/building.texi
@@ -316,7 +316,8 @@ to parse output from a @code{grep} command (@pxref{Grep Searching}).
   Sometimes @code{compilation-error-regexp-alist} doesn't correctly
 determine the filename that is the source of the error.  Use user option
 @code{compilation-transform-file-match-alist} to make any necessary
-adjustments, such as adding or changing a directory component.
+adjustments, such as adding or changing a directory component, or even
+considering certain compiler messages not error messages at all.
 
 @findex compilation-next-error
 @findex compilation-previous-error