Skip to content

Commit c03d604

Browse files
cpovirkGoogle Java Core Libraries
authored andcommitted
Use @linkplain instead of <a href="...">.
On the one hand, I suppose it was kind of cool to advertise the "[https://guava.dev/CacheBuilder](guava.dev/CacheBuilder)" style of link. On the other hand, we normally use `@link` and `@linkplain` when we can: They keep you within the current version of Javadoc (including keeping you looking at local files in your IDE if you're doing that). (They also prevent the Javadoc tool from generating a little "This is an external link" icon (new sometime between Java 11 and Java 21) in its output. That's how I noticed these surprisingly "external" links.) RELNOTES=n/a PiperOrigin-RevId: 711799401
1 parent 7ac7965 commit c03d604

File tree

4 files changed

+6
-6
lines changed

4 files changed

+6
-6
lines changed

android/guava/src/com/google/common/cache/package-info.java

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
*/
1414

1515
/**
16-
* <a href="https://guava.dev/CacheBuilder">Discouraged</a> (in favor of <a
16+
* {@linkplain CacheBuilder Discouraged} (in favor of <a
1717
* href="https://github.com/ben-manes/caffeine/wiki">Caffeine</a>) caching utilities.
1818
*
1919
* <p>The core interface used to represent caches is {@link Cache}. In-memory caches can be

android/guava/src/com/google/common/eventbus/package-info.java

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,8 @@
1313
*/
1414

1515
/**
16-
* <a href="https://guava.dev/EventBus">Discouraged</a> in favor of dependency injection and
17-
* concurrency frameworks, EventBus allows publish-subscribe-style communication.
16+
* {@linkplain EventBus Discouraged} in favor of dependency injection and concurrency frameworks,
17+
* EventBus allows publish-subscribe-style communication.
1818
*
1919
* <p>See the Guava User Guide article on <a
2020
* href="https://github.com/google/guava/wiki/EventBusExplained">{@code EventBus}</a>.

guava/src/com/google/common/cache/package-info.java

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@
1313
*/
1414

1515
/**
16-
* <a href="https://guava.dev/CacheBuilder">Discouraged</a> (in favor of <a
16+
* {@linkplain CacheBuilder Discouraged} (in favor of <a
1717
* href="https://github.com/ben-manes/caffeine/wiki">Caffeine</a>) caching utilities.
1818
*
1919
* <p>The core interface used to represent caches is {@link Cache}. In-memory caches can be

guava/src/com/google/common/eventbus/package-info.java

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,8 +13,8 @@
1313
*/
1414

1515
/**
16-
* <a href="https://guava.dev/EventBus">Discouraged</a> in favor of dependency injection and
17-
* concurrency frameworks, EventBus allows publish-subscribe-style communication.
16+
* {@linkplain EventBus Discouraged} in favor of dependency injection and concurrency frameworks,
17+
* EventBus allows publish-subscribe-style communication.
1818
*
1919
* <p>See the Guava User Guide article on <a
2020
* href="https://github.com/google/guava/wiki/EventBusExplained">{@code EventBus}</a>.

0 commit comments

Comments
 (0)