Skip to content

Remove code style from deprecated message #6753

New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

Merged
merged 2 commits into from
Mar 10, 2025
Merged

Remove code style from deprecated message #6753

merged 2 commits into from
Mar 10, 2025

Conversation

mrober
Copy link
Contributor

@mrober mrober commented Mar 10, 2025

Remove code style from deprecated message since it does not render properly. I could not find any syntax that rendered properly in both the IDE and in the generated html. I found many examples of deprecated messages that just don't add any code style to method or class names, see https://source.corp.google.com/search?q=%22@Deprecated(message%22. The Kotlin doc for @Deprecated does not mention any style, see https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-deprecated/.

@mrober mrober requested a review from rachelsaunders March 10, 2025 16:56
Copy link
Contributor

github-actions bot commented Mar 10, 2025

Javadoc Changes:
--- /home/runner/diff/original/firebase-kotlindoc/android/com/google/firebase/crashlytics/KeyValueBuilder.html	2025-03-10 17:32:37.743727610 +0000
+++ /home/runner/diff/modified/firebase-kotlindoc/android/com/google/firebase/crashlytics/KeyValueBuilder.html	2025-03-10 17:30:04.300571136 +0000
@@ -96,7 +96,7 @@
       <div class="api-item"><a name="KeyValueBuilder-com.google.firebase.crashlytics.FirebaseCrashlytics-"></a><a name="keyvaluebuilder"></a>
         <h3 class="api-name" id="KeyValueBuilder(com.google.firebase.crashlytics.FirebaseCrashlytics)">KeyValueBuilder</h3>
         <pre class="api-signature no-pretty-print">public&nbsp;<span><del><a href="/docs/reference/android/com/google/firebase/crashlytics/KeyValueBuilder.html#KeyValueBuilder(com.google.firebase.crashlytics.FirebaseCrashlytics)">KeyValueBuilder</a></del></span>(@<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/crashlytics/FirebaseCrashlytics.html">FirebaseCrashlytics</a>&nbsp;crashlytics)</pre>
-        <aside class="caution"><strong>This method is deprecated.</strong><br>Do not construct this directly. Use [setCustomKeys] instead. To be removed in the next major release.</aside>
+        <aside class="caution"><strong>This method is deprecated.</strong><br>Do not construct this directly. Use `setCustomKeys` instead. To be removed in the next major release.</aside>
       </div>
     </div>
     <div class="list">
--- /home/runner/diff/original/firebase-kotlindoc/kotlin/com/google/firebase/crashlytics/KeyValueBuilder.html	2025-03-10 17:32:37.741727597 +0000
+++ /home/runner/diff/modified/firebase-kotlindoc/kotlin/com/google/firebase/crashlytics/KeyValueBuilder.html	2025-03-10 17:30:04.294571089 +0000
@@ -96,7 +96,7 @@
       <div class="api-item"><a name="KeyValueBuilder-com.google.firebase.crashlytics.FirebaseCrashlytics-"></a><a name="keyvaluebuilder"></a>
         <h3 class="api-name" id="KeyValueBuilder(com.google.firebase.crashlytics.FirebaseCrashlytics)">KeyValueBuilder</h3>
         <pre class="api-signature no-pretty-print"><span><del><a href="/docs/reference/kotlin/com/google/firebase/crashlytics/KeyValueBuilder.html#KeyValueBuilder(com.google.firebase.crashlytics.FirebaseCrashlytics)">KeyValueBuilder</a></del></span>(crashlytics:&nbsp;<a href="/docs/reference/kotlin/com/google/firebase/crashlytics/FirebaseCrashlytics.html">FirebaseCrashlytics</a>)</pre>
-        <aside class="caution"><strong>This function is deprecated.</strong><br>Do not construct this directly. Use [setCustomKeys] instead. To be removed in the next major release.</aside>
+        <aside class="caution"><strong>This function is deprecated.</strong><br>Do not construct this directly. Use `setCustomKeys` instead. To be removed in the next major release.</aside>
       </div>
     </div>
     <div class="list">

@google-oss-bot
Copy link
Contributor

google-oss-bot commented Mar 10, 2025

@rachelsaunders
Copy link
Contributor

I assume you tried backticks? Did they just render as backticks? If they did (or if they made the string render as code font), can we add those?

If they caused something to error or look funky, then we can just leave this as you have it in this PR.

Copy link
Contributor

github-actions bot commented Mar 10, 2025

Test Results

 8 files   - 6   8 suites   - 6   20s ⏱️ +8s
22 tests  - 1  22 ✅  - 1  0 💤 ±0  0 ❌ ±0 
44 runs   - 2  44 ✅  - 2  0 💤 ±0  0 ❌ ±0 

Results for commit 1c8f219. ± Comparison against base commit a232b6d.

This pull request removes 23 and adds 22 tests. Note that renamed tests count towards both.
com.google.firebase.functions.AppCheckLimitedUseTest ‑ FirebaseFunctions#getHttpsCallable should build callable with FAC settings (when false)
com.google.firebase.functions.AppCheckLimitedUseTest ‑ FirebaseFunctions#getHttpsCallable should build callable with FAC settings (when true)
com.google.firebase.functions.AppCheckLimitedUseTest ‑ FirebaseFunctions#getHttpsCallable should not use limited-use tokens by default
com.google.firebase.functions.AppCheckLimitedUseTest ‑ FirebaseFunctions#getHttpsCallableFromUrl callable with FAC settings (when false)
com.google.firebase.functions.AppCheckLimitedUseTest ‑ FirebaseFunctions#getHttpsCallableFromUrl callable with FAC settings (when true)
com.google.firebase.functions.AppCheckLimitedUseTest ‑ FirebaseFunctions#getHttpsCallableFromUrl should not use limited-use tokens by default
com.google.firebase.functions.FunctionsRegistrarTest ‑ getComponents_publishesLibVersionComponent
com.google.firebase.functions.FunctionsTests ‑ Firebase#functions should delegate to FirebaseFunctions#getInstance(FirebaseApp, region)
com.google.firebase.functions.FunctionsTests ‑ Firebase#functions should delegate to FirebaseFunctions#getInstance(region)
com.google.firebase.functions.FunctionsTests ‑ FirebaseApp#functions should delegate to FirebaseFunctions#getInstance(FirebaseApp)
…
com.google.firebase.crashlytics.internal.common.CrashlyticsControllerRobolectricTest ‑ testDoCloseSession_disabledAnrs_doesNotPersistsAppExitInfo
com.google.firebase.crashlytics.internal.common.CrashlyticsControllerRobolectricTest ‑ testDoCloseSession_enabledAnrs_doesNotPersistsAppExitInfoIfItDoesntExist
com.google.firebase.crashlytics.internal.common.CrashlyticsControllerRobolectricTest ‑ testDoCloseSession_enabledAnrs_persistsAppExitInfoIfItExists
com.google.firebase.crashlytics.internal.common.DataCollectionArbiterRobolectricTest ‑ testDefaultDataCollection_usedWhenNoOverrideOrManifestSetting
com.google.firebase.crashlytics.internal.common.DataCollectionArbiterRobolectricTest ‑ testManifestMetadata_respectedWhenNoOverride
com.google.firebase.crashlytics.internal.common.DataCollectionArbiterRobolectricTest ‑ testSetCrashlyticsDataCollectionEnabled_overridesOtherSettings
com.google.firebase.crashlytics.internal.common.SessionReportingCoordinatorRobolectricTest ‑ testAppExitInfoEvent_notPersistIfAnrBeforeSession
com.google.firebase.crashlytics.internal.common.SessionReportingCoordinatorRobolectricTest ‑ testAppExitInfoEvent_notPersistIfAppExitInfoNotAnrButWithinSession
com.google.firebase.crashlytics.internal.common.SessionReportingCoordinatorRobolectricTest ‑ testAppExitInfoEvent_persistIfAnrWithinSession
com.google.firebase.crashlytics.internal.common.SessionReportingCoordinatorRobolectricTest ‑ testAppExitInfoEvent_persistIfAnrWithinSession_multipleAppExitInfo
…

♻️ This comment has been updated with latest results.

@google-oss-bot
Copy link
Contributor

google-oss-bot commented Mar 10, 2025

@mrober
Copy link
Contributor Author

mrober commented Mar 10, 2025

I assume you tried backticks? Did they just render as backticks? If they did (or if they made the string render as code font), can we add those?

If they caused something to error or look funky, then we can just leave this as you have it in this PR.

I changed it back to backticks, they will render as backticks, not code font, but it doesn't look bad.

@mrober mrober merged commit aa2bab8 into main Mar 10, 2025
42 of 43 checks passed
@mrober mrober deleted the mrober/kdocfix branch March 10, 2025 17:48
@firebase firebase locked and limited conversation to collaborators Apr 10, 2025
# for free to subscribe to this conversation on GitHub. Already have an account? #.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants