doclet not substituting {@docRoot} in some cases

In package-summary files, {@docRoot} is sometimes not being replaced.
tidy is reporting the following:


build/linux-x86_64-normal-server-release/docs.tidy/api/org/xml/sax/helpers/compact3-package-summary.html.tidy:line 169 column 8 - Warning: <a> attribute "target" has invalid value "{@docRoot}/org/xml/sax/helpers/'_top'"
build/linux-x86_64-normal-server-release/docs.tidy/api/org/xml/sax/helpers/compact2-package-summary.html.tidy:line 169 column 8 - Warning: <a> attribute "target" has invalid value "{@docRoot}/org/xml/sax/helpers/'_top'"
build/linux-x86_64-normal-server-release/docs.tidy/api/org/xml/sax/compact3-package-summary.html.tidy:line 234 column 8 - Warning: <a> attribute "target" has invalid value "{@docRoot}/org/xml/sax/'_top'"
build/linux-x86_64-normal-server-release/docs.tidy/api/org/xml/sax/ext/compact3-package-summary.html.tidy:line 169 column 8 - Warning: <a> attribute "target" has invalid value "{@docRoot}/org/xml/sax/ext/'_top'"
build/linux-x86_64-normal-server-release/docs.tidy/api/org/xml/sax/ext/compact2-package-summary.html.tidy:line 169 column 8 - Warning: <a> attribute "target" has invalid value "{@docRoot}/org/xml/sax/ext/'_top'"
build/linux-x86_64-normal-server-release/docs.tidy/api/org/xml/sax/compact2-package-summary.html.tidy:line 234 column 8 - Warning: <a> attribute "target" has invalid value "{@docRoot}/org/xml/sax/'_top'"
jjg@scaaa042:/w/jjg/work/tl$