Migrate to ktfmt 0.50 and remove our custom @sample hack
BUG: 344907236
TESTED: Downloaded the new ktfmt JAR and ran:
find ./ -type f -name '*.kt' | xargs -n 1000 java -jar ~/Downloads/ktfmt-0.50-jar-with-dependencies.jar --kotlinlang-style
and it did not change any of the files that we formatted via our KtFormat task
Change-Id: Id989c4933f8e6a8a7b19ede125e92d825ea57e25
Merged-In: I398062bb613de41e62d7af06481fa7ce0ebf59c4
diff --git a/activity/activity-compose/src/main/java/androidx/activity/compose/ActivityResultRegistry.kt b/activity/activity-compose/src/main/java/androidx/activity/compose/ActivityResultRegistry.kt
index ee8c3f5..aca0f9f 100644
--- a/activity/activity-compose/src/main/java/androidx/activity/compose/ActivityResultRegistry.kt
+++ b/activity/activity-compose/src/main/java/androidx/activity/compose/ActivityResultRegistry.kt
@@ -72,7 +72,6 @@
* [ActivityResultLauncher]. Attempting to do so will result in an [IllegalStateException].
*
* @sample androidx.activity.compose.samples.RememberLauncherForActivityResult
- *
* @param contract the contract, specifying conversions to/from [Intent]s
* @param onResult the callback to be called on the main thread when activity result is available
* @return the launcher that can be used to start the activity.
diff --git a/activity/activity-compose/src/main/java/androidx/activity/compose/BackHandler.kt b/activity/activity-compose/src/main/java/androidx/activity/compose/BackHandler.kt
index f66d478..162c0b7c 100644
--- a/activity/activity-compose/src/main/java/androidx/activity/compose/BackHandler.kt
+++ b/activity/activity-compose/src/main/java/androidx/activity/compose/BackHandler.kt
@@ -74,7 +74,6 @@
* an enabled BackHandler.
*
* @sample androidx.activity.compose.samples.BackHandler
- *
* @param enabled if this BackHandler should be enabled
* @param onBack the action invoked by pressing the system back
*/
diff --git a/activity/activity-compose/src/main/java/androidx/activity/compose/PredictiveBackHandler.kt b/activity/activity-compose/src/main/java/androidx/activity/compose/PredictiveBackHandler.kt
index f7c4e53..462ebe47 100644
--- a/activity/activity-compose/src/main/java/androidx/activity/compose/PredictiveBackHandler.kt
+++ b/activity/activity-compose/src/main/java/androidx/activity/compose/PredictiveBackHandler.kt
@@ -63,7 +63,6 @@
* an enabled BackHandler.
*
* @sample androidx.activity.compose.samples.PredictiveBack
- *
* @param enabled if this BackHandler should be enabled, true by default
* @param onBack the action invoked by back gesture
*/
diff --git a/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/Class2BiometricAuthExtensions.kt b/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/Class2BiometricAuthExtensions.kt
index 9dd6d7d..d105928 100755
--- a/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/Class2BiometricAuthExtensions.kt
+++ b/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/Class2BiometricAuthExtensions.kt
@@ -29,9 +29,8 @@
* @throws AuthPromptErrorException when an unrecoverable error has been encountered and
* authentication has stopped.
* @throws AuthPromptFailureException when an authentication attempt by the user has been rejected.
- * @see Class2BiometricAuthPrompt.authenticate(AuthPromptHost, AuthPromptCallback)
- *
* @sample androidx.biometric.samples.auth.class2BiometricAuth
+ * @see Class2BiometricAuthPrompt.authenticate(AuthPromptHost, AuthPromptCallback)
*/
public suspend fun Class2BiometricAuthPrompt.authenticate(
host: AuthPromptHost,
diff --git a/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/Class2BiometricOrCredentialAuthExtensions.kt b/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/Class2BiometricOrCredentialAuthExtensions.kt
index e9fa8b9..996cc32 100755
--- a/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/Class2BiometricOrCredentialAuthExtensions.kt
+++ b/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/Class2BiometricOrCredentialAuthExtensions.kt
@@ -29,9 +29,8 @@
* @throws AuthPromptErrorException when an unrecoverable error has been encountered and
* authentication has stopped.
* @throws AuthPromptFailureException when an authentication attempt by the user has been rejected.
- * @see Class2BiometricOrCredentialAuthPrompt.authenticate( AuthPromptHost, AuthPromptCallback )
- *
* @sample androidx.biometric.samples.auth.class2BiometricOrCredentialAuth
+ * @see Class2BiometricOrCredentialAuthPrompt.authenticate( AuthPromptHost, AuthPromptCallback )
*/
public suspend fun Class2BiometricOrCredentialAuthPrompt.authenticate(
host: AuthPromptHost,
diff --git a/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/Class3BiometricAuthExtensions.kt b/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/Class3BiometricAuthExtensions.kt
index f30a57e..a26b017 100755
--- a/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/Class3BiometricAuthExtensions.kt
+++ b/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/Class3BiometricAuthExtensions.kt
@@ -31,9 +31,8 @@
* @throws AuthPromptErrorException when an unrecoverable error has been encountered and
* authentication has stopped.
* @throws AuthPromptFailureException when an authentication attempt by the user has been rejected.
- * @see Class3BiometricAuthPrompt.authenticate(AuthPromptHost, AuthPromptCallback)
- *
* @sample androidx.biometric.samples.auth.class3BiometricAuth
+ * @see Class3BiometricAuthPrompt.authenticate(AuthPromptHost, AuthPromptCallback)
*/
public suspend fun Class3BiometricAuthPrompt.authenticate(
host: AuthPromptHost,
diff --git a/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/Class3BiometricOrCredentialAuthExtensions.kt b/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/Class3BiometricOrCredentialAuthExtensions.kt
index e6d8d6a..036c350 100755
--- a/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/Class3BiometricOrCredentialAuthExtensions.kt
+++ b/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/Class3BiometricOrCredentialAuthExtensions.kt
@@ -33,9 +33,8 @@
* @throws AuthPromptErrorException when an unrecoverable error has been encountered and
* authentication has stopped.
* @throws AuthPromptFailureException when an authentication attempt by the user has been rejected.
- * @see Class3BiometricOrCredentialAuthPrompt.authenticate( AuthPromptHost, AuthPromptCallback )
- *
* @sample androidx.biometric.samples.auth.class3BiometricOrCredentialAuth
+ * @see Class3BiometricOrCredentialAuthPrompt.authenticate( AuthPromptHost, AuthPromptCallback )
*/
@RequiresApi(Build.VERSION_CODES.R)
public suspend fun Class3BiometricOrCredentialAuthPrompt.authenticate(
diff --git a/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/CredentialAuthExtensions.kt b/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/CredentialAuthExtensions.kt
index 2ff2a23..e5fdf5b 100755
--- a/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/CredentialAuthExtensions.kt
+++ b/biometric/biometric-ktx/src/main/java/androidx/biometric/auth/CredentialAuthExtensions.kt
@@ -33,10 +33,9 @@
* @throws AuthPromptErrorException when an unrecoverable error has been encountered and
* authentication has stopped.
* @throws AuthPromptFailureException when an authentication attempt by the user has been rejected.
+ * @sample androidx.biometric.samples.auth.credentialAuth
* @see CredentialAuthPrompt.authenticate( AuthPromptHost host, BiometricPrompt.CryptoObject,
* AuthPromptCallback )
- *
- * @sample androidx.biometric.samples.auth.credentialAuth
*/
@RequiresApi(Build.VERSION_CODES.R)
public suspend fun CredentialAuthPrompt.authenticate(
diff --git a/buildSrc/private/src/main/kotlin/androidx/build/Ktfmt.kt b/buildSrc/private/src/main/kotlin/androidx/build/Ktfmt.kt
index 2456bd1..85bcb24 100644
--- a/buildSrc/private/src/main/kotlin/androidx/build/Ktfmt.kt
+++ b/buildSrc/private/src/main/kotlin/androidx/build/Ktfmt.kt
@@ -146,33 +146,16 @@
/** Run ktfmt on the [input] file. */
private fun processFile(input: File): KtfmtResult {
- // To hack around https://github.com/facebook/ktfmt/issues/406 we rewrite all the
- // @sample tags to ####### so that ktfmt would not move them around. We then
- // rewrite it back when returning the formatted code.
- // We also want to ensure the class name is always on the same line as the @sample tag, as
- // otherwise, the class won't be linked to the tag, so make the class name shorter. For now,
- // we only have to do this for the NavigationSuiteScaffold.kt class
- val originCode =
- input
- .readText()
- .replace(SAMPLE, PLACEHOLDER)
- .replace(
- "$PLACEHOLDER androidx.compose.material3.adaptive.navigationsuite.samples.",
- "$PLACEHOLDER material3.adaptive.navigationsuite.samples."
- )
+ val originCode = input.readText()
val formattedCode = format(Formatter.KOTLINLANG_FORMAT, originCode)
return KtfmtResult(
input = input,
isCorrectlyFormatted = originCode == formattedCode,
- formattedCode = formattedCode.replace(PLACEHOLDER, SAMPLE)
+ formattedCode = formattedCode
)
}
}
-// Keep two of them the same length to make sure line wrapping works as expected
-private const val SAMPLE = "@sample"
-private const val PLACEHOLDER = "#######"
-
internal data class KtfmtResult(
val input: File,
val isCorrectlyFormatted: Boolean,
diff --git a/camera/camera-lifecycle/src/main/java/androidx/camera/lifecycle/ProcessCameraProvider.kt b/camera/camera-lifecycle/src/main/java/androidx/camera/lifecycle/ProcessCameraProvider.kt
index b4fe167..a910d3e 100644
--- a/camera/camera-lifecycle/src/main/java/androidx/camera/lifecycle/ProcessCameraProvider.kt
+++ b/camera/camera-lifecycle/src/main/java/androidx/camera/lifecycle/ProcessCameraProvider.kt
@@ -624,7 +624,6 @@
* preview [UseCase], this function could be used with [bindToLifecycle].
*
* @sample androidx.camera.lifecycle.samples.bindConcurrentCameraSample
- *
* @return List of combinations of [CameraInfo].
*/
get() {
diff --git a/camera/camera-viewfinder-core/src/main/java/androidx/camera/viewfinder/core/ZoomGestureDetector.kt b/camera/camera-viewfinder-core/src/main/java/androidx/camera/viewfinder/core/ZoomGestureDetector.kt
index c78c9a4..ea2ccb4 100644
--- a/camera/camera-viewfinder-core/src/main/java/androidx/camera/viewfinder/core/ZoomGestureDetector.kt
+++ b/camera/camera-viewfinder-core/src/main/java/androidx/camera/viewfinder/core/ZoomGestureDetector.kt
@@ -50,10 +50,8 @@
* @param minSpan The distance in pixels between touches that must be reached for a gesture to be
* interpreted as zooming.
* @param listener The listener to receive the callback.
- *
- * @sample androidx.camera.viewfinder.core.samples.onTouchEventSample
- *
* @constructor Creates a ZoomGestureDetector for detecting zooming gesture.
+ * @sample androidx.camera.viewfinder.core.samples.onTouchEventSample
*/
class ZoomGestureDetector
@SuppressLint("ExecutorRegistration")
diff --git a/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/Animatable.kt b/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/Animatable.kt
index 9e7a5c7..2972e55 100644
--- a/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/Animatable.kt
+++ b/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/Animatable.kt
@@ -37,7 +37,6 @@
* animation will be canceled via a [CancellationException].
*
* @sample androidx.compose.animation.core.samples.AnimatableAnimateToGenericsType
- *
* @param initialValue initial value of the animatable value holder
* @param typeConverter A two-way converter that converts the given type [T] from and to
* [AnimationVector]
@@ -423,7 +422,6 @@
* will be cancelled.
*
* @sample androidx.compose.animation.core.samples.AnimatableFadeIn
- *
* @param initialValue initial value of the animatable value holder
* @param visibilityThreshold Threshold at which the animation may round off to its target value.
* [Spring.DefaultDisplacementThreshold] by default.
diff --git a/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/AnimateAsState.kt b/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/AnimateAsState.kt
index 86b5104..250187a 100644
--- a/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/AnimateAsState.kt
+++ b/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/AnimateAsState.kt
@@ -49,7 +49,6 @@
* from the tree. See [Animatable] for cancelable animations.
*
* @sample androidx.compose.animation.core.samples.AlphaAnimationSample
- *
* @param targetValue Target value of the animation
* @param animationSpec The animation that will be used to change the value through time. [spring]
* will be used by default.
@@ -97,7 +96,6 @@
* from the tree. See [Animatable] for cancelable animations.
*
* @sample androidx.compose.animation.core.samples.DpAnimationSample
- *
* @param targetValue Target value of the animation
* @param animationSpec The animation that will be used to change the value through time. Physics
* animation will be used by default.
@@ -178,7 +176,6 @@
* from the tree. See [Animatable] for cancelable animations.
*
* @sample androidx.compose.animation.core.samples.AnimateOffsetSample
- *
* @param targetValue Target value of the animation
* @param animationSpec The animation that will be used to change the value through time. Physics
* animation will be used by default.
@@ -297,7 +294,6 @@
* function from the tree. See [Animatable] for cancelable animations.
*
* @sample androidx.compose.animation.core.samples.AnimateOffsetSample
- *
* @param targetValue Target value of the animation
* @param animationSpec The animation that will be used to change the value through time. Physics
* animation will be used by default.
@@ -376,7 +372,7 @@
*
* @sample androidx.compose.animation.core.samples.ArbitraryValueTypeTransitionSample
*
- * data class MySize(val width: Dp, val height: Dp)
+ * data class MySize(val width: Dp, val height: Dp)
*
* @param targetValue Target value of the animation
* @param animationSpec The animation that will be used to change the value through time. Physics
diff --git a/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/AnimationSpec.kt b/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/AnimationSpec.kt
index 9ff3c19..4a4b87e 100644
--- a/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/AnimationSpec.kt
+++ b/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/AnimationSpec.kt
@@ -193,10 +193,9 @@
* @param durationMillis Duration of the animation. [DefaultDurationMillis] by default.
* @param delayMillis Time the animation waits before starting. 0 by default.
* @param easing [Easing] applied on the animation curve. [FastOutSlowInEasing] by default.
+ * @sample androidx.compose.animation.core.samples.OffsetArcAnimationSpec
* @see ArcMode
* @see keyframes
- *
- * @sample androidx.compose.animation.core.samples.OffsetArcAnimationSpec
*/
@ExperimentalAnimationSpecApi
@Immutable
@@ -373,7 +372,6 @@
* in the [animation] (if any) will be repeated. By default, the amount of offset is 0.
*
* @sample androidx.compose.animation.core.samples.InfiniteProgressIndicator
- *
* @param animation the [AnimationSpec] to be repeated
* @param repeatMode whether animation should repeat by starting from the beginning (i.e.
* [RepeatMode.Restart]) or from the end (i.e. [RepeatMode.Reverse])
@@ -477,7 +475,6 @@
* Adds a keyframe so that animation value will be [this] at time: [timeStamp]. For example:
*
* @sample androidx.compose.animation.core.samples.floatAtSample
- *
* @param timeStamp The time in the during when animation should reach value: [this], with a
* minimum value of `0`.
* @return an instance of [E] so a custom [Easing] can be added by the [using] method.
@@ -495,7 +492,6 @@
* calling [atFraction]. For example:
*
* @sample androidx.compose.animation.core.samples.floatAtFractionSample
- *
* @param fraction The fraction when the animation should reach specified value.
* @return an instance of [E] so a custom [Easing] can be added by the [using] method
*/
@@ -509,7 +505,6 @@
* at 50 using LinearEasing
*
* @sample androidx.compose.animation.core.samples.KeyframesBuilderWithEasing
- *
* @param easing [Easing] to be used for the next interval.
* @return the same [E] instance so that other implementations can expand on the builder pattern
*/
@@ -554,7 +549,6 @@
* [KeyframesSpecConfig] can be used to create a [KeyframesSpec].
*
* @sample androidx.compose.animation.core.samples.KeyframesBuilderForPosition
- *
* @see keyframes
*/
class KeyframesSpecConfig<T> : KeyframesSpecBaseConfig<T, KeyframeEntity<T>>() {
@@ -597,7 +591,6 @@
* 0f at 50 with LinearEasing
*
* @sample androidx.compose.animation.core.samples.KeyframesBuilderWithEasing
- *
* @param easing [Easing] to be used for the next interval.
* @return the same [KeyframeEntity] instance so that other implementations can expand on
* the builder pattern
@@ -715,11 +708,9 @@
* - 1f: Modifies only the final velocity to match the starting velocity
* - 0.5f: Modifies both velocities equally, picking the average between the two
*
- * @see keyframesWithSpline
- *
* @sample androidx.compose.animation.core.samples.KeyframesBuilderForIntOffsetWithSplines
- *
* @sample androidx.compose.animation.core.samples.KeyframesBuilderForDpOffsetWithSplines
+ * @see keyframesWithSpline
*/
@ExperimentalAnimationSpecApi
@Immutable
@@ -822,7 +813,6 @@
* [ArcMode]:
*
* @sample androidx.compose.animation.core.samples.OffsetKeyframesWithArcsBuilder
- *
* @param init Initialization function for the [KeyframesSpec] animation
* @see KeyframesSpec.KeyframesSpecConfig
*/
@@ -835,13 +825,10 @@
* Creates a [KeyframesWithSplineSpec] animation, initialized with [init]. For example:
*
* @sample androidx.compose.animation.core.samples.KeyframesBuilderForOffsetWithSplines
- *
* @param init Initialization function for the [KeyframesWithSplineSpec] animation
- * @see KeyframesWithSplineSpec.KeyframesWithSplineSpecConfig
- *
* @sample androidx.compose.animation.core.samples.KeyframesBuilderForIntOffsetWithSplines
- *
* @sample androidx.compose.animation.core.samples.KeyframesBuilderForDpOffsetWithSplines
+ * @see KeyframesWithSplineSpec.KeyframesWithSplineSpecConfig
*/
@ExperimentalAnimationSpecApi
fun <T> keyframesWithSpline(
@@ -935,7 +922,6 @@
* in the [animation] (if any) will be repeated. By default, the amount of offset is 0.
*
* @sample androidx.compose.animation.core.samples.InfiniteProgressIndicator
- *
* @param animation animation that will be repeated
* @param repeatMode whether animation should repeat by starting from the beginning (i.e.
* [RepeatMode.Restart]) or from the end (i.e. [RepeatMode.Reverse])
diff --git a/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/InfiniteTransition.kt b/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/InfiniteTransition.kt
index d5f3266..43c85ba 100644
--- a/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/InfiniteTransition.kt
+++ b/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/InfiniteTransition.kt
@@ -39,7 +39,6 @@
* from the composition.
*
* @param label A label for differentiating this animation from others in android studio.
- *
* @sample androidx.compose.animation.core.samples.InfiniteTransitionSample
*/
@Composable
@@ -57,7 +56,6 @@
* from the composition.
*
* @param label A label for differentiating this animation from others in android studio.
- *
* @sample androidx.compose.animation.core.samples.InfiniteTransitionSample
*/
class InfiniteTransition internal constructor(val label: String) {
@@ -235,7 +233,6 @@
* A [label] for differentiating this animation from others in android studio.
*
* @sample androidx.compose.animation.core.samples.InfiniteTransitionAnimateValueSample
- *
* @see [InfiniteTransition.animateFloat]
* @see [androidx.compose.animation.animateColor]
*/
@@ -287,7 +284,6 @@
* A [label] for differentiating this animation from others in android studio.
*
* @sample androidx.compose.animation.core.samples.InfiniteTransitionSample
- *
* @see [InfiniteTransition.animateValue]
* @see [androidx.compose.animation.animateColor]
*/
diff --git a/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/PathEasing.kt b/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/PathEasing.kt
index c9b471f..85b9aab 100644
--- a/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/PathEasing.kt
+++ b/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/PathEasing.kt
@@ -47,7 +47,6 @@
* Note: a [PathEasing] instance can be used from any thread, but not concurrently.
*
* @sample androidx.compose.animation.core.samples.PathEasingSample
- *
* @param path The [Path] to use to make the curve representing the easing curve.
*/
@Immutable
diff --git a/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/SuspendAnimation.kt b/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/SuspendAnimation.kt
index cc9b205..7b365b6 100644
--- a/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/SuspendAnimation.kt
+++ b/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/SuspendAnimation.kt
@@ -35,9 +35,7 @@
* @param animationSpec The animation configuration that will be used. [spring] by default.
* @param block Will be invoked on every frame with the current value and velocity of the animation
* for that frame.
- *
* @sample androidx.compose.animation.core.samples.suspendAnimateFloatVariant
- *
* @see AnimationState.animateTo
*/
suspend fun animate(
@@ -131,7 +129,6 @@
* call [AnimationScope.cancelAnimation]. After [AnimationScope.cancelAnimation] is called,
* [block] will not be invoked again. The animation loop will exit after the [block] returns. All
* the animation related info can be accessed via [AnimationScope].
- *
* @sample androidx.compose.animation.core.samples.animateToOnAnimationState
*/
suspend fun <T, V : AnimationVector> AnimationState<T, V>.animateTo(
diff --git a/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/Transition.kt b/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/Transition.kt
index 4502dc2..53bff93 100644
--- a/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/Transition.kt
+++ b/compose/animation/animation-core/src/commonMain/kotlin/androidx/compose/animation/core/Transition.kt
@@ -75,7 +75,6 @@
* enters composition.) 2) can be recreated to intentionally trigger a re-start of the transition.
*
* @sample androidx.compose.animation.core.samples.GestureAnimationSample
- *
* @return a [Transition] object, to which animations can be added.
* @see Transition
* @see Transition.animateFloat
@@ -152,7 +151,6 @@
* [rememberTransition]. Both [currentState] and [targetState] are backed by a [State] object.
*
* @sample androidx.compose.animation.core.samples.InitialStateSample
- *
* @see rememberTransition
*/
class MutableTransitionState<S>(initialState: S) : TransitionState<S>() {
@@ -424,7 +422,6 @@
* to [targetState] without any further seeking allowed.
*
* @sample androidx.compose.animation.core.samples.SnapToSample
- *
* @see animateTo
*/
suspend fun snapTo(targetState: S) {
@@ -472,7 +469,6 @@
* Instead, it instantly moves all values to those at the new [targetState].
*
* @sample androidx.compose.animation.core.samples.SeekToSample
- *
* @see animateTo
*/
suspend fun seekTo(
@@ -867,7 +863,6 @@
* values).
*
* @sample androidx.compose.animation.core.samples.GestureAnimationSample
- *
* @see rememberTransition
* @see Transition.animateFloat
* @see Transition.animateValue
diff --git a/compose/animation/animation-graphics/src/androidMain/kotlin/androidx/compose/animation/graphics/res/AnimatedVectorPainterResources.android.kt b/compose/animation/animation-graphics/src/androidMain/kotlin/androidx/compose/animation/graphics/res/AnimatedVectorPainterResources.android.kt
index a86cc63..d598db5 100644
--- a/compose/animation/animation-graphics/src/androidMain/kotlin/androidx/compose/animation/graphics/res/AnimatedVectorPainterResources.android.kt
+++ b/compose/animation/animation-graphics/src/androidMain/kotlin/androidx/compose/animation/graphics/res/AnimatedVectorPainterResources.android.kt
@@ -36,7 +36,6 @@
* animated.
*
* @param atEnd Whether the animated vector should be rendered at the end of all its animations.
- *
* @sample androidx.compose.animation.graphics.samples.AnimatedVectorSample
*/
@ExperimentalAnimationGraphicsApi
diff --git a/compose/animation/animation-graphics/src/androidMain/kotlin/androidx/compose/animation/graphics/res/AnimatedVectorResources.android.kt b/compose/animation/animation-graphics/src/androidMain/kotlin/androidx/compose/animation/graphics/res/AnimatedVectorResources.android.kt
index c4c24cb..e928d13 100644
--- a/compose/animation/animation-graphics/src/androidMain/kotlin/androidx/compose/animation/graphics/res/AnimatedVectorResources.android.kt
+++ b/compose/animation/animation-graphics/src/androidMain/kotlin/androidx/compose/animation/graphics/res/AnimatedVectorResources.android.kt
@@ -33,7 +33,6 @@
*
* @param id the resource identifier
* @return an animated vector drawable resource.
- *
* @sample androidx.compose.animation.graphics.samples.AnimatedVectorSample
*/
@ExperimentalAnimationGraphicsApi
diff --git a/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/AnimatedContent.kt b/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/AnimatedContent.kt
index 20a68d3..c5732f6 100644
--- a/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/AnimatedContent.kt
+++ b/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/AnimatedContent.kt
@@ -120,7 +120,6 @@
* content for different states:
*
* @sample androidx.compose.animation.samples.AnimateIncrementDecrementSample
- *
* @see ContentTransform
* @see AnimatedContentScope
*/
@@ -177,7 +176,6 @@
* different [SizeTransform]. If no size animation is desired, [sizeTransform] can be set to `null`.
*
* @sample androidx.compose.animation.samples.AnimatedContentTransitionSpecSample
- *
* @see SizeTransform
* @see EnterTransition
* @see ExitTransition
@@ -329,7 +327,6 @@
* [animationSpec] defines the animation that will be used to animate the slide-in.
*
* @sample androidx.compose.animation.samples.SlideIntoContainerSample
- *
* @see AnimatedContent
* @see slideInHorizontally
* @see slideInVertically
@@ -357,7 +354,6 @@
* [animationSpec] defines the animation that will be used to animate the slide-out.
*
* @sample androidx.compose.animation.samples.SlideIntoContainerSample
- *
* @see AnimatedContent
* @see slideOutHorizontally
* @see slideOutVertically
@@ -431,7 +427,6 @@
* [animationSpec] defines the animation that will be used to animate the slide-in.
*
* @sample androidx.compose.animation.samples.SlideIntoContainerSample
- *
* @see AnimatedContent
* @see slideInHorizontally
* @see slideInVertically
@@ -502,7 +497,6 @@
* [animationSpec] defines the animation that will be used to animate the slide-out.
*
* @sample androidx.compose.animation.samples.SlideIntoContainerSample
- *
* @see AnimatedContent
* @see slideOutHorizontally
* @see slideOutVertically
@@ -681,7 +675,6 @@
* enter/exit animations will be triggered as the content enters/leaves the container.
*
* @sample androidx.compose.animation.samples.TransitionExtensionAnimatedContentSample
- *
* @see ContentTransform
* @see AnimatedContentScope
*/
diff --git a/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/AnimatedVisibility.kt b/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/AnimatedVisibility.kt
index bf673b2..4938063 100644
--- a/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/AnimatedVisibility.kt
+++ b/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/AnimatedVisibility.kt
@@ -104,7 +104,6 @@
* object (i.e. Transition<EnterExitState>) from [AnimatedVisibilityScope].
*
* @sample androidx.compose.animation.samples.AnimatedVisibilityWithBooleanVisibleParamNoReceiver
- *
* @param visible defines whether the content should be visible
* @param modifier modifier for the [Layout] created to contain the [content]
* @param enter EnterTransition(s) used for the appearing animation, fading in while expanding by
@@ -176,7 +175,6 @@
* Here's an example of using [RowScope.AnimatedVisibility] in a [Row]:
*
* @sample androidx.compose.animation.samples.AnimatedFloatingActionButton
- *
* @param visible defines whether the content should be visible
* @param modifier modifier for the [Layout] created to contain the [content]
* @param enter EnterTransition(s) used for the appearing animation, fading in while expanding
@@ -250,7 +248,6 @@
* Here's an example of using [ColumnScope.AnimatedVisibility] in a [Column]:
*
* @sample androidx.compose.animation.samples.ColumnAnimatedVisibilitySample
- *
* @param visible defines whether the content should be visible
* @param modifier modifier for the [Layout] created to contain the [content]
* @param enter EnterTransition(s) used for the appearing animation, fading in while expanding
@@ -290,7 +287,6 @@
* `Transition<EnterExitState>` (i.e. [AnimatedVisibilityScope.transition]):
*
* @sample androidx.compose.animation.samples.AnimatedVisibilityWithBooleanVisibleParamNoReceiver
- *
* @see AnimatedVisibility
*/
enum class EnterExitState {
@@ -349,7 +345,6 @@
* [ColumnScope.AnimatedVisibility] for details.
*
* @sample androidx.compose.animation.samples.AnimatedVisibilityLazyColumnSample
- *
* @param visibleState defines whether the content should be visible
* @param modifier modifier for the [Layout] created to contain the [content]
* @param enter EnterTransition(s) used for the appearing animation, fading in while expanding by
@@ -494,7 +489,6 @@
* tree, and disposed. Both `currentState` and `targetState` will be `false` for [visibleState].
*
* @sample androidx.compose.animation.samples.AVColumnScopeWithMutableTransitionState
- *
* @param visibleState defines whether the content should be visible
* @param modifier modifier for the [Layout] created to contain the [content]
* @param enter EnterTransition(s) used for the appearing animation, fading in while expanding
@@ -567,7 +561,6 @@
* animate the parent and siblings if they rely on the size of appearing/disappearing content.
*
* @sample androidx.compose.animation.samples.AddAnimatedVisibilityToGenericTransitionSample
- *
* @param visible defines whether the content should be visible based on transition state T
* @param modifier modifier for the [Layout] created to contain the [content]
* @param enter EnterTransition(s) used for the appearing animation, fading in while expanding
diff --git a/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/AnimationModifier.kt b/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/AnimationModifier.kt
index 43469a7..bbfd272 100644
--- a/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/AnimationModifier.kt
+++ b/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/AnimationModifier.kt
@@ -61,7 +61,6 @@
* y dimensions).
*
* @sample androidx.compose.animation.samples.AnimateContent
- *
* @param animationSpec a finite animation that will be used to animate size change, [spring] by
* default
* @param finishedListener an optional listener to be called when the content change animation is
@@ -94,7 +93,6 @@
* y dimensions).
*
* @sample androidx.compose.animation.samples.AnimateContent
- *
* @param animationSpec a finite animation that will be used to animate size change, [spring] by
* default
* @param alignment sets the alignment of the content during the animation. [Alignment.TopStart] by
diff --git a/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/Crossfade.kt b/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/Crossfade.kt
index 959edd2..9470862 100644
--- a/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/Crossfade.kt
+++ b/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/Crossfade.kt
@@ -37,7 +37,6 @@
* [Crossfade] allows to switch between two layouts with a crossfade animation.
*
* @sample androidx.compose.animation.samples.CrossfadeSample
- *
* @param targetState is a key representing your target layout state. Every time you change a key
* the animation will be triggered. The [content] called with the old key will be faded out while
* the [content] called with the new key will be faded in.
diff --git a/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/EnterExitTransition.kt b/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/EnterExitTransition.kt
index 387aeeb..dd4d391 100644
--- a/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/EnterExitTransition.kt
+++ b/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/EnterExitTransition.kt
@@ -100,7 +100,6 @@
* expand, then slide.
*
* @sample androidx.compose.animation.samples.FullyLoadedTransition
- *
* @param enter another [EnterTransition] to be combined
*/
@Stable
@@ -192,7 +191,6 @@
* expand, then slide.
*
* @sample androidx.compose.animation.samples.FullyLoadedTransition
- *
* @param exit another [ExitTransition] to be combined.
*/
@Stable
@@ -289,7 +287,6 @@
* [spring] is used by default.
*
* @sample androidx.compose.animation.samples.FadeTransition
- *
* @param animationSpec the [FiniteAnimationSpec] for this animation, [spring] by default
* @param initialAlpha the starting alpha of the enter transition, 0f by default
*/
@@ -308,7 +305,6 @@
* default.
*
* @sample androidx.compose.animation.samples.FadeTransition
- *
* @param animationSpec the [FiniteAnimationSpec] for this animation, [spring] by default
* @param targetAlpha the target alpha of the exit transition, 0f by default
*/
@@ -334,7 +330,6 @@
* allows the offset to be defined proportional to the full size, or as an absolute value.
*
* @sample androidx.compose.animation.samples.SlideInOutSample
- *
* @param animationSpec the animation used for the slide-in, [spring] by default.
* @param initialOffset a lambda that takes the full size of the content and returns the initial
* offset for the slide-in
@@ -365,7 +360,6 @@
* allows the offset to be defined proportional to the full size, or as an absolute value.
*
* @sample androidx.compose.animation.samples.SlideInOutSample
- *
* @param animationSpec the animation used for the slide-out, [spring] by default.
* @param targetOffset a lambda that takes the full size of the content and returns the target
* offset for the slide-out
@@ -396,7 +390,6 @@
* layout size change while scaling. For example:
*
* @sample androidx.compose.animation.samples.ScaledEnterExit
- *
* @param animationSpec the animation used for the scale-out, [spring] by default.
* @param initialScale the initial scale for the enter transition, 0 by default.
* @param transformOrigin the pivot point in terms of fraction of the overall size. By default it's
@@ -427,7 +420,6 @@
* coordinated layout size change animation. For example:
*
* @sample androidx.compose.animation.samples.ScaledEnterExit
- *
* @param animationSpec the animation used for the slide-out, [spring] by default.
* @param targetScale the target scale for the exit transition, 0 by default.
* @param transformOrigin the pivot point in terms of fraction of the overall size. By default it's
@@ -464,7 +456,6 @@
* For expanding only horizontally or vertically, consider [expandHorizontally], [expandVertically].
*
* @sample androidx.compose.animation.samples.ExpandInShrinkOutSample
- *
* @param animationSpec the animation used for the expanding animation, [spring] by default.
* @param expandFrom the starting point of the expanding bounds, [Alignment.BottomEnd] by default.
* @param clip whether the content outside of the animated bounds should be clipped, true by default
@@ -505,7 +496,6 @@
* For shrinking only horizontally or vertically, consider [shrinkHorizontally], [shrinkVertically].
*
* @sample androidx.compose.animation.samples.ExpandInShrinkOutSample
- *
* @param animationSpec the animation used for the shrinking animation, [spring] by default.
* @param shrinkTowards the ending point of the shrinking bounds, [Alignment.BottomEnd] by default.
* @param clip whether the content outside of the animated bounds should be clipped, true by default
@@ -544,7 +534,6 @@
* clip is set to true, which only shows content in the animated bounds.
*
* @sample androidx.compose.animation.samples.HorizontalTransitionSample
- *
* @param animationSpec the animation used for the expanding animation, [spring] by default.
* @param expandFrom the starting point of the expanding bounds, [Alignment.End] by default.
* @param clip whether the content outside of the animated bounds should be clipped, true by default
@@ -583,7 +572,6 @@
* clip is set to true, which only shows content in the animated bounds.
*
* @sample androidx.compose.animation.samples.ExpandShrinkVerticallySample
- *
* @param animationSpec the animation used for the expanding animation, [spring] by default.
* @param expandFrom the starting point of the expanding bounds, [Alignment.Bottom] by default.
* @param clip whether the content outside of the animated bounds should be clipped, true by default
@@ -622,7 +610,6 @@
* clip is set to true, which only shows content in the animated bounds.
*
* @sample androidx.compose.animation.samples.HorizontalTransitionSample
- *
* @param animationSpec the animation used for the shrinking animation, [spring] by default.
* @param shrinkTowards the ending point of the shrinking bounds, [Alignment.End] by default.
* @param clip whether the content outside of the animated bounds should be clipped, true by default
@@ -662,7 +649,6 @@
* clip is set to true, which only shows content in the animated bounds.
*
* @sample androidx.compose.animation.samples.ExpandShrinkVerticallySample
- *
* @param animationSpec the animation used for the shrinking animation, [spring] by default.
* @param shrinkTowards the ending point of the shrinking bounds, [Alignment.Bottom] by default.
* @param clip whether the content outside of the animated bounds should be clipped, true by default
@@ -697,7 +683,6 @@
* of its width, and slide towards the right.
*
* @sample androidx.compose.animation.samples.SlideTransition
- *
* @param animationSpec the animation used for the slide-in, [spring] by default.
* @param initialOffsetX a lambda that takes the full width of the content in pixels and returns the
* initial offset for the slide-in, by default it returns `-fullWidth/2`
@@ -728,7 +713,6 @@
* of its Height, and slide down.
*
* @sample androidx.compose.animation.samples.FullyLoadedTransition
- *
* @param animationSpec the animation used for the slide-in, [spring] by default.
* @param initialOffsetY a lambda that takes the full Height of the content and returns the initial
* offset for the slide-in, by default it returns `-fullHeight/2`
@@ -759,7 +743,6 @@
* its width.
*
* @sample androidx.compose.animation.samples.SlideTransition
- *
* @param animationSpec the animation used for the slide-out, [spring] by default.
* @param targetOffsetX a lambda that takes the full width of the content and returns the initial
* offset for the slide-in, by default it returns `fullWidth/2`
diff --git a/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/SharedTransitionScope.kt b/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/SharedTransitionScope.kt
index 1eeead7f..3e37a71 100644
--- a/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/SharedTransitionScope.kt
+++ b/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/SharedTransitionScope.kt
@@ -449,7 +449,6 @@
* layout to accommodate the animated size of the shared elements.
*
* @sample androidx.compose.animation.samples.SharedElementInAnimatedContentSample
- *
* @see [sharedBounds]
*/
@OptIn(ExperimentalAnimationApi::class)
@@ -530,7 +529,6 @@
* complex example with nested shared bounds/elements.
*
* @sample androidx.compose.animation.samples.NestedSharedBoundsSample
- *
* @see [sharedBounds]
*/
@OptIn(ExperimentalAnimationApi::class)
diff --git a/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/SingleValueAnimation.kt b/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/SingleValueAnimation.kt
index 6d1e48d..3f8b204 100644
--- a/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/SingleValueAnimation.kt
+++ b/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/SingleValueAnimation.kt
@@ -46,7 +46,6 @@
* from the tree. See [Animatable][androidx.compose.animation.Animatable] for cancelable animations.
*
* @sample androidx.compose.animation.samples.ColorAnimationSample
- *
* @param targetValue Target value of the animation
* @param animationSpec The animation that will be used to change the value through time, [spring]
* by default
@@ -103,7 +102,6 @@
* types. See [androidx.compose.animation.core.Animatable] for other variants.
*
* @sample androidx.compose.animation.samples.AnimatableColor
- *
* @param initialValue initial value of the [Animatable]
*/
fun Animatable(initialValue: Color): Animatable<Color, AnimationVector4D> =
diff --git a/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/Transition.kt b/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/Transition.kt
index 7acc04e..e76e066 100644
--- a/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/Transition.kt
+++ b/compose/animation/animation/src/commonMain/kotlin/androidx/compose/animation/Transition.kt
@@ -52,9 +52,7 @@
* [label] is used to differentiate from other animations in the same transition in Android Studio.
*
* @return A [State] object, the value of which is updated by animation
- *
* @sample androidx.compose.animation.samples.GestureAnimationSample
- *
* @see Transition.animateValue
* @see androidx.compose.animation.core.Transition
* @see androidx.compose.animation.core.updateTransition
@@ -88,7 +86,6 @@
* A [label] for differentiating this animation from others in android studio.
*
* @sample androidx.compose.animation.samples.InfiniteTransitionSample
- *
* @see InfiniteTransition.animateValue
* @see InfiniteRepeatableSpec
*/
diff --git a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/AlignmentLine.kt b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/AlignmentLine.kt
index 2d4fadd4..bd52f55 100644
--- a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/AlignmentLine.kt
+++ b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/AlignmentLine.kt
@@ -52,7 +52,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.PaddingFromSample
- *
* @param alignmentLine the alignment line relative to which the padding is defined
* @param before the distance between the container's top edge and the horizontal alignment line, or
* the container's start edge and the vertical alignment line
@@ -97,7 +96,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.PaddingFromSample
- *
* @param alignmentLine the alignment line relative to which the padding is defined
* @param before the distance between the container's top edge and the horizontal alignment line, or
* the container's start edge and the vertical alignment line
@@ -138,7 +136,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.PaddingFromBaselineSampleDp
- *
* @see paddingFrom
*/
@Stable
@@ -171,7 +168,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.PaddingFromBaselineSampleTextUnit
- *
* @see paddingFrom
*/
@Stable
diff --git a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/AspectRatio.kt b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/AspectRatio.kt
index e4e42e4..514f2ed 100644
--- a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/AspectRatio.kt
+++ b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/AspectRatio.kt
@@ -49,7 +49,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.SimpleAspectRatio
- *
* @param ratio the desired width/height positive ratio
*/
@Stable
diff --git a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Box.kt b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Box.kt
index 6cfbf58..9aff562 100644
--- a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Box.kt
+++ b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Box.kt
@@ -55,7 +55,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.SimpleBox
- *
* @param modifier The modifier to be applied to the layout.
* @param contentAlignment The default alignment inside the Box.
* @param propagateMinConstraints Whether the incoming min constraints should be passed to content.
@@ -230,7 +229,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.SimpleBox
- *
* @param modifier The modifier to be applied to the layout.
*/
@Composable
diff --git a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Column.kt b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Column.kt
index d9b985a..39633da 100644
--- a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Column.kt
+++ b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Column.kt
@@ -69,7 +69,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.SimpleColumn
- *
* @param modifier The modifier to be applied to the Column.
* @param verticalArrangement The vertical arrangement of the layout's children.
* @param horizontalAlignment The horizontal alignment of the layout's children.
@@ -301,7 +300,6 @@
* @param weight The proportional height to give to this element, as related to the total of all
* weighted siblings. Must be positive.
* @param fill When `true`, the element will occupy the whole height allocated.
- *
* @sample androidx.compose.foundation.layout.samples.SimpleColumn
*/
@Stable
diff --git a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/ContextualFlowLayout.kt b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/ContextualFlowLayout.kt
index 1326399..b8793bd 100644
--- a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/ContextualFlowLayout.kt
+++ b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/ContextualFlowLayout.kt
@@ -47,7 +47,6 @@
* Example:
*
* @sample androidx.compose.foundation.layout.samples.ContextualFlowRowMaxLineDynamicSeeMore
- *
* @param modifier The modifier to be applied to the Row.
* @param horizontalArrangement The horizontal arrangement of the layout's children.
* @param verticalArrangement The vertical arrangement of the layout's virtual rows.
@@ -119,7 +118,6 @@
* Example:
*
* @sample androidx.compose.foundation.layout.samples.ContextualFlowColMaxLineDynamicSeeMore
- *
* @param modifier The modifier to be applied to the Row.
* @param horizontalArrangement The horizontal arrangement of the layout's children.
* @param verticalArrangement The vertical arrangement of the layout's virtual column.
@@ -188,7 +186,6 @@
* Example:
*
* @sample androidx.compose.foundation.layout.samples.ContextualFlowRow_ItemPosition
- *
* @sample androidx.compose.foundation.layout.samples.ContextualFlowColumn_ItemPosition
*/
val lineIndex: Int
@@ -204,7 +201,6 @@
* Example:
*
* @sample androidx.compose.foundation.layout.samples.ContextualFlowRow_ItemPosition
- *
* @sample androidx.compose.foundation.layout.samples.ContextualFlowColumn_ItemPosition
*/
val indexInLine: Int
@@ -253,7 +249,6 @@
* Example:
*
* @sample androidx.compose.foundation.layout.samples.ContextualFlowRow_ItemPosition
- *
* @sample androidx.compose.foundation.layout.samples.ContextualFlowColumn_ItemPosition
*/
val lineIndex: Int
@@ -269,7 +264,6 @@
* Example:
*
* @sample androidx.compose.foundation.layout.samples.ContextualFlowRow_ItemPosition
- *
* @sample androidx.compose.foundation.layout.samples.ContextualFlowColumn_ItemPosition
*/
val indexInLine: Int
diff --git a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/FlowLayoutOverflow.kt b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/FlowLayoutOverflow.kt
index fd6eaf2..ae9d963 100644
--- a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/FlowLayoutOverflow.kt
+++ b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/FlowLayoutOverflow.kt
@@ -93,7 +93,6 @@
* other composable element that indicates the presence of additional items.
*
* @sample androidx.compose.foundation.layout.samples.SimpleFlowRowMaxLinesWithSeeMore
- *
* @param content composable that visually indicates more items can be loaded.
*/
@ExperimentalLayoutApi
@@ -120,7 +119,6 @@
* the [expandIndicator] or the [collapseIndicator] is rendered.
*
* @sample androidx.compose.foundation.layout.samples.SimpleFlowRowMaxLinesDynamicSeeMore
- *
* @param minRowsToShowCollapse Specifies the minimum number of rows that should be visible
* before showing the collapse option. This parameter is useful when the number of rows is
* too small to be reduced further.
@@ -228,7 +226,6 @@
* other composable element that indicates the presence of additional items.
*
* @sample androidx.compose.foundation.layout.samples.SimpleFlowColumnMaxLinesWithSeeMore
- *
* @param content composable that visually indicates more items can be loaded.
*/
@ExperimentalLayoutApi
@@ -257,7 +254,6 @@
* the [expandIndicator] or the [collapseIndicator] is rendered.
*
* @sample androidx.compose.foundation.layout.samples.SimpleFlowColumnMaxLinesDynamicSeeMore
- *
* @param minColumnsToShowCollapse Specifies the minimum number of columns that should be
* visible before showing the collapse option. This parameter is useful when the number of
* columns is too small to be reduced further.
@@ -397,7 +393,6 @@
* the [expandIndicator] or the [collapseIndicator] is rendered.
*
* @sample androidx.compose.foundation.layout.samples.ContextualFlowRowMaxLineDynamicSeeMore
- *
* @param minRowsToShowCollapse Specifies the minimum number of rows that should be visible
* before showing the collapse option. This parameter is useful when the number of rows is
* too small to be reduced further.
@@ -537,7 +532,6 @@
* the [expandIndicator] or the [collapseIndicator] is rendered.
*
* @sample androidx.compose.foundation.layout.samples.ContextualFlowColMaxLineDynamicSeeMore
- *
* @param minColumnsToShowCollapse Specifies the minimum number of columns that should be
* visible before showing the collapse option. This parameter is useful when the number of
* columns is too small to be reduced further.
diff --git a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Offset.kt b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Offset.kt
index b4fde0e..f700b45 100644
--- a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Offset.kt
+++ b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Offset.kt
@@ -44,7 +44,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.OffsetModifier
- *
* @see absoluteOffset
*/
@Stable
@@ -73,7 +72,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.AbsoluteOffsetModifier
- *
* @see offset
*/
@Stable
@@ -107,7 +105,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.OffsetPxModifier
- *
* @see [absoluteOffset]
*/
fun Modifier.offset(offset: Density.() -> IntOffset) =
@@ -137,7 +134,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.AbsoluteOffsetPxModifier
- *
* @see offset
*/
fun Modifier.absoluteOffset(offset: Density.() -> IntOffset) =
diff --git a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Row.kt b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Row.kt
index 8b27c92..430f09c 100644
--- a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Row.kt
+++ b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Row.kt
@@ -81,7 +81,6 @@
* See example of using Texts inside the Row:
*
* @sample androidx.compose.foundation.layout.samples.SimpleAlignByInRow
- *
* @param modifier The modifier to be applied to the Row.
* @param horizontalArrangement The horizontal arrangement of the layout's children.
* @param verticalAlignment The vertical alignment of the layout's children.
@@ -342,7 +341,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.SimpleAlignByInRow
- *
* @see alignByBaseline
*/
@Stable fun Modifier.alignBy(alignmentLine: HorizontalAlignmentLine): Modifier
@@ -356,7 +354,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.SimpleAlignByInRow
- *
* @see alignBy
*/
@Stable fun Modifier.alignByBaseline(): Modifier
diff --git a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Size.kt b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Size.kt
index 8879056..409675d 100644
--- a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Size.kt
+++ b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Size.kt
@@ -467,7 +467,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.SimpleFillWidthModifier
- *
* @sample androidx.compose.foundation.layout.samples.FillHalfWidthModifier
*/
@Stable
@@ -489,7 +488,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.SimpleFillHeightModifier
- *
* @sample androidx.compose.foundation.layout.samples.FillHalfHeightModifier
*/
@Stable
@@ -514,7 +512,6 @@
* Example usage:
*
* @sample androidx.compose.foundation.layout.samples.SimpleFillModifier
- *
* @sample androidx.compose.foundation.layout.samples.FillHalfSizeModifier
*/
@Stable
diff --git a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Spacer.kt b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Spacer.kt
index 0f9c428..05779a0 100644
--- a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Spacer.kt
+++ b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/Spacer.kt
@@ -31,7 +31,6 @@
* [Modifier.width], [Modifier.height] and [Modifier.size] modifiers.
*
* @sample androidx.compose.foundation.layout.samples.SpacerExample
- *
* @param modifier modifiers to set to this spacer
*/
@Composable
diff --git a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/WindowInsetsPadding.kt b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/WindowInsetsPadding.kt
index 18bb568..070aaa0 100644
--- a/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/WindowInsetsPadding.kt
+++ b/compose/foundation/foundation-layout/src/commonMain/kotlin/androidx/compose/foundation/layout/WindowInsetsPadding.kt
@@ -50,7 +50,6 @@
* will not be padded again by this modifier.
*
* @sample androidx.compose.foundation.layout.samples.insetsPaddingSample
- *
* @see WindowInsets
*/
@Stable
diff --git a/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/AndroidExternalSurface.android.kt b/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/AndroidExternalSurface.android.kt
index aa8115a..178364f 100644
--- a/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/AndroidExternalSurface.android.kt
+++ b/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/AndroidExternalSurface.android.kt
@@ -62,10 +62,9 @@
* scope that also provides access to a [SurfaceScope] environment which can itself be used to
* handle other [Surface] lifecycle events.
*
+ * @sample androidx.compose.foundation.samples.AndroidExternalSurfaceColors
* @see SurfaceScope
* @see AndroidExternalSurfaceScope
- *
- * @sample androidx.compose.foundation.samples.AndroidExternalSurfaceColors
*/
interface SurfaceCoroutineScope : SurfaceScope, CoroutineScope
@@ -264,7 +263,6 @@
* @param onInit Lambda invoked on first composition. This lambda can be used to declare a
* [AndroidExternalSurfaceScope.onSurface] callback that will be invoked when a surface is
* available.
- *
* @sample androidx.compose.foundation.samples.AndroidExternalSurfaceColors
*/
@Composable
@@ -424,7 +422,6 @@
* @param onInit Lambda invoked on first composition. This lambda can be used to declare a
* [AndroidExternalSurfaceScope.onSurface] callback that will be invoked when a surface is
* available.
- *
* @sample androidx.compose.foundation.samples.AndroidEmbeddedExternalSurfaceColors
*/
@Composable
diff --git a/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/DarkTheme.android.kt b/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/DarkTheme.android.kt
index 5bbf00e..693ecbf 100644
--- a/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/DarkTheme.android.kt
+++ b/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/DarkTheme.android.kt
@@ -39,7 +39,6 @@
* theme:
*
* @sample androidx.compose.foundation.samples.DarkThemeSample
- *
* @return `true` if the system is considered to be in 'dark theme'.
*/
@Composable
diff --git a/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/Magnifier.android.kt b/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/Magnifier.android.kt
index 6c9ce43..d8c9e95 100644
--- a/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/Magnifier.android.kt
+++ b/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/Magnifier.android.kt
@@ -72,7 +72,6 @@
* since the magnifier widget does not support constraining to the bounds of composables.
*
* @sample androidx.compose.foundation.samples.MagnifierSample
- *
* @param sourceCenter The offset of the center of the magnified content. Measured in pixels from
* the top-left of the layout node this modifier is applied to. This offset is passed to
* [Magnifier.show].
diff --git a/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/content/TransferableContent.android.kt b/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/content/TransferableContent.android.kt
index f695a31..5cbc858 100644
--- a/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/content/TransferableContent.android.kt
+++ b/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/content/TransferableContent.android.kt
@@ -61,7 +61,6 @@
* easily separate remaining parts from incoming [TransferableContent].
*
* @sample androidx.compose.foundation.samples.ReceiveContentBasicSample
- *
* @param predicate Decides whether to consume or leave the given item out. Return true to indicate
* that this particular item was processed here, it shouldn't be passed further down the content
* receiver chain. Return false to keep it in the returned [TransferableContent].
diff --git a/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/draganddrop/AndroidDragAndDropSource.android.kt b/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/draganddrop/AndroidDragAndDropSource.android.kt
index 60ed642..edfc27a 100644
--- a/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/draganddrop/AndroidDragAndDropSource.android.kt
+++ b/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/draganddrop/AndroidDragAndDropSource.android.kt
@@ -38,7 +38,6 @@
* Learn how to use [Modifier.dragAndDropSource]:
*
* @sample androidx.compose.foundation.samples.TextDragAndDropSourceSample
- *
* @param block A lambda with a [DragAndDropSourceScope] as a receiver which provides a
* [PointerInputScope] to detect the drag gesture, after which a drag and drop gesture can be
* started with [DragAndDropSourceScope.startTransfer].
diff --git a/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/text/handwriting/HandwritingDetector.android.kt b/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/text/handwriting/HandwritingDetector.android.kt
index 31952bd..1c3bf10 100644
--- a/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/text/handwriting/HandwritingDetector.android.kt
+++ b/compose/foundation/foundation/src/androidMain/kotlin/androidx/compose/foundation/text/handwriting/HandwritingDetector.android.kt
@@ -49,7 +49,6 @@
* is not supported.
*
* @param callback a callback which will be triggered when stylus handwriting is detected
- *
* @sample androidx.compose.foundation.samples.HandwritingDetectorSample
*/
fun Modifier.handwritingDetector(callback: () -> Unit) =
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Background.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Background.kt
index 60f09d9..a7a3274 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Background.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Background.kt
@@ -40,7 +40,6 @@
* Draws [shape] with a solid [color] behind the content.
*
* @sample androidx.compose.foundation.samples.DrawBackgroundColor
- *
* @param color color to paint background with
* @param shape desired shape of the background
*/
@@ -67,7 +66,6 @@
* Draws [shape] with [brush] behind the content.
*
* @sample androidx.compose.foundation.samples.DrawBackgroundShapedBrush
- *
* @param brush brush to paint background with
* @param shape desired shape of the background
* @param alpha Opacity to be applied to the [brush], with `0` being completely transparent and `1`
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/BasicMarquee.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/BasicMarquee.kt
index ef09a14..aea1f51 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/BasicMarquee.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/BasicMarquee.kt
@@ -116,11 +116,8 @@
* your own by placing modifiers before this one.
*
* @sample androidx.compose.foundation.samples.BasicMarqueeSample
- *
* @sample androidx.compose.foundation.samples.BasicMarqueeWithFadedEdgesSample
- *
* @sample androidx.compose.foundation.samples.BasicFocusableMarqueeSample
- *
* @param iterations The number of times to repeat the animation. `Int.MAX_VALUE` will repeat
* forever, and 0 will disable animation.
* @param animationMode Whether the marquee should start animating [Immediately] or only
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Border.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Border.kt
index 98926f6..5bf7d994 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Border.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Border.kt
@@ -60,7 +60,6 @@
* Modify element to add border with appearance specified with a [border] and a [shape] and clip it.
*
* @sample androidx.compose.foundation.samples.BorderSample()
- *
* @param border [BorderStroke] class that specifies border appearance, such as size and color
* @param shape shape of the border
*/
@@ -73,7 +72,6 @@
* and clip it.
*
* @sample androidx.compose.foundation.samples.BorderSampleWithDataClass()
- *
* @param width width of the border. Use [Dp.Hairline] for a hairline border.
* @param color color to paint the border with
* @param shape shape of the border
@@ -87,9 +85,7 @@
* and clip it.
*
* @sample androidx.compose.foundation.samples.BorderSampleWithBrush()
- *
* @sample androidx.compose.foundation.samples.BorderSampleWithDynamicData()
- *
* @param width width of the border. Use [Dp.Hairline] for a hairline border.
* @param brush brush to paint the border with
* @param shape shape of the border
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Canvas.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Canvas.kt
index de58dbc..8ca82c2 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Canvas.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Canvas.kt
@@ -32,7 +32,6 @@
* this child, only exact sizes must be specified.
*
* @sample androidx.compose.foundation.samples.CanvasSample
- *
* @param modifier mandatory modifier to specify size strategy for this composable
* @param onDraw lambda that will be called to perform drawing. Note that this lambda will be called
* during draw stage, you have no access to composition scope, meaning that [Composable] function
@@ -48,7 +47,6 @@
* this child, only exact sizes must be specified.
*
* @sample androidx.compose.foundation.samples.CanvasPieChartSample
- *
* @param modifier mandatory modifier to specify size strategy for this composable
* @param contentDescription text used by accessibility services to describe what this canvas
* represents. This should be provided unless the canvas is used for decorative purposes or as
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Clickable.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Clickable.kt
index e2c326c..5193840 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Clickable.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Clickable.kt
@@ -91,7 +91,6 @@
* snapshot state system.)
*
* @sample androidx.compose.foundation.samples.ClickableSample
- *
* @param enabled Controls the enabled state. When `false`, [onClick], and this modifier will appear
* disabled for accessibility services
* @param onClickLabel semantic / accessibility label for the [onClick] action
@@ -164,7 +163,6 @@
* snapshot state system.)
*
* @sample androidx.compose.foundation.samples.ClickableSample
- *
* @param interactionSource [MutableInteractionSource] that will be used to dispatch
* [PressInteraction.Press] when this clickable is pressed. If `null`, an internal
* [MutableInteractionSource] will be created if needed.
@@ -225,7 +223,6 @@
* snapshot state system.)
*
* @sample androidx.compose.foundation.samples.ClickableSample
- *
* @param enabled Controls the enabled state. When `false`, [onClick], [onLongClick] or
* [onDoubleClick] won't be invoked
* @param onClickLabel semantic / accessibility label for the [onClick] action
@@ -318,7 +315,6 @@
* snapshot state system.)
*
* @sample androidx.compose.foundation.samples.ClickableSample
- *
* @param interactionSource [MutableInteractionSource] that will be used to emit
* [PressInteraction.Press] when this clickable is pressed. If `null`, an internal
* [MutableInteractionSource] will be created if needed.
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/DarkTheme.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/DarkTheme.kt
index bde0b39..6bd2501 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/DarkTheme.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/DarkTheme.kt
@@ -33,7 +33,6 @@
* theme:
*
* @sample androidx.compose.foundation.samples.DarkThemeSample
- *
* @return `true` if the system is considered to be in 'dark theme'.
*/
@Composable @ReadOnlyComposable fun isSystemInDarkTheme() = _isSystemInDarkTheme()
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Focusable.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Focusable.kt
index dd7958f..3dc2f26 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Focusable.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Focusable.kt
@@ -61,7 +61,6 @@
* Add this modifier to the element to make it focusable within its bounds.
*
* @sample androidx.compose.foundation.samples.FocusableSample
- *
* @param enabled Controls the enabled state. When `false`, element won't participate in the focus
* @param interactionSource [MutableInteractionSource] that will be used to emit
* [FocusInteraction.Focus] when this element is being focused.
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Hoverable.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Hoverable.kt
index 6fb303a..d194ce4 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Hoverable.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Hoverable.kt
@@ -33,7 +33,6 @@
* Configure component to be hoverable via pointer enter/exit events.
*
* @sample androidx.compose.foundation.samples.HoverableSample
- *
* @param interactionSource [MutableInteractionSource] that will be used to emit
* [HoverInteraction.Enter] when this element is being hovered.
* @param enabled Controls the enabled state. When `false`, hover events will be ignored.
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Image.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Image.kt
index 189a066..55764f0 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Image.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Image.kt
@@ -56,7 +56,6 @@
* overload that consumes a [Painter] parameter shown in this sample
*
* @sample androidx.compose.foundation.samples.BitmapPainterSubsectionSample
- *
* @param bitmap The [ImageBitmap] to draw
* @param contentDescription text used by accessibility services to describe what this image
* represents. This should always be provided unless this image is used for decorative purposes,
@@ -126,7 +125,6 @@
* overload that consumes a [Painter] parameter shown in this sample
*
* @sample androidx.compose.foundation.samples.BitmapPainterSubsectionSample
- *
* @param bitmap The [ImageBitmap] to draw
* @param contentDescription text used by accessibility services to describe what this image
* represents. This should always be provided unless this image is used for decorative purposes,
@@ -223,7 +221,6 @@
* fill the bounds like [ColorPainter]
*
* @sample androidx.compose.foundation.samples.BitmapPainterSample
- *
* @param painter to draw
* @param contentDescription text used by accessibility services to describe what this image
* represents. This should always be provided unless this image is used for decorative purposes,
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Indication.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Indication.kt
index 38a3115..87cde39 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Indication.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Indication.kt
@@ -159,7 +159,6 @@
* Draws visual effects for this component when interactions occur.
*
* @sample androidx.compose.foundation.samples.IndicationSample
- *
* @param interactionSource [InteractionSource] that will be used by [indication] to draw visual
* effects - this [InteractionSource] represents the stream of [Interaction]s for this component.
* @param indication [Indication] used to draw visual effects. If `null`, no visual effects will be
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/MutatorMutex.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/MutatorMutex.kt
index 7177007..8b177f3 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/MutatorMutex.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/MutatorMutex.kt
@@ -151,7 +151,6 @@
* For example:
*
* @sample androidx.compose.foundation.samples.mutatorMutexStateObjectWithReceiver
- *
* @param receiver the receiver `this` that [block] will be called with
* @param priority the priority of this mutation; [MutatePriority.Default] by default. Higher
* priority mutations will interrupt lower priority mutations.
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Overscroll.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Overscroll.kt
index c20203e..abcb738 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Overscroll.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Overscroll.kt
@@ -74,7 +74,6 @@
* correctly reset after any animations, when the gesture has stopped.
*
* @sample androidx.compose.foundation.samples.OverscrollWithDraggable_After
- *
* @param delta total scroll delta available
* @param source the source of the delta
* @param performScroll the scroll action that the overscroll is applied to. The [Offset]
@@ -108,7 +107,6 @@
* the velocity provided by onDragStopped.
*
* @sample androidx.compose.foundation.samples.OverscrollWithDraggable_After
- *
* @param velocity total [Velocity] available
* @param performFling the [Velocity] consuming lambda that the overscroll is applied to. The
* [Velocity] parameter represents how much [Velocity] is available, and the return value is
@@ -142,7 +140,6 @@
* to render the visual part of an OverscrollEffect as a modifier.
*
* @sample androidx.compose.foundation.samples.OverscrollSample
- *
* @param overscrollEffect the [OverscrollEffect] to render
*/
@ExperimentalFoundationApi
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/ProgressSemantics.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/ProgressSemantics.kt
index 912afbd..aaefe31 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/ProgressSemantics.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/ProgressSemantics.kt
@@ -29,7 +29,6 @@
* coerced into this range.
*
* @sample androidx.compose.foundation.samples.DeterminateProgressSemanticsSample
- *
* @param value current value of the ProgressIndicator/Slider. If outside of [valueRange] provided,
* value will be coerced to this range. Must not be NaN.
* @param valueRange range of values that value can take. Passed [value] will be coerced to this
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Scroll.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Scroll.kt
index e416780..0b5b1a5 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Scroll.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/Scroll.kt
@@ -65,7 +65,6 @@
* Learn how to control the state of [Modifier.verticalScroll] or [Modifier.horizontalScroll]:
*
* @sample androidx.compose.foundation.samples.ControlledScrollableRowSample
- *
* @param initial initial scroller position to start with
*/
@Composable
@@ -84,7 +83,6 @@
* Learn how to control the state of [Modifier.verticalScroll] or [Modifier.horizontalScroll]:
*
* @sample androidx.compose.foundation.samples.ControlledScrollableRowSample
- *
* @param initial value of the scroll
*/
@Stable
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/content/ReceiveContent.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/content/ReceiveContent.kt
index f8a5c0c..200ab48 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/content/ReceiveContent.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/content/ReceiveContent.kt
@@ -46,10 +46,9 @@
* @param receiveContentListener Listener to respond to the receive event. This interface also
* includes a set of callbacks for certain Drag-and-Drop state changes. Please checkout
* [ReceiveContentListener] docs for an explanation of each callback.
+ * @sample androidx.compose.foundation.samples.ReceiveContentFullSample
* @see TransferableContent
* @see hasMediaType
- *
- * @sample androidx.compose.foundation.samples.ReceiveContentFullSample
*/
@Suppress("ExecutorRegistration")
@ExperimentalFoundationApi
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/draganddrop/DragAndDropSource.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/draganddrop/DragAndDropSource.kt
index bbb3d68..a215dc0 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/draganddrop/DragAndDropSource.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/draganddrop/DragAndDropSource.kt
@@ -50,7 +50,6 @@
* Learn how to use [Modifier.dragAndDropSource] while providing a custom drag shadow:
*
* @sample androidx.compose.foundation.samples.DragAndDropSourceWithColoredDragShadowSample
- *
* @param drawDragDecoration provides the visual representation of the item dragged during the drag
* and drop gesture.
* @param block A lambda with a [DragAndDropSourceScope] as a receiver which provides a
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/draganddrop/DragAndDropTarget.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/draganddrop/DragAndDropTarget.kt
index 757d30a..ff398f1 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/draganddrop/DragAndDropTarget.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/draganddrop/DragAndDropTarget.kt
@@ -32,7 +32,6 @@
* app or from other apps:
*
* @sample androidx.compose.foundation.samples.TextDragAndDropTargetSample
- *
* @param shouldStartDragAndDrop Allows the Composable to decide if it wants to receive from a given
* drag and drop session by inspecting the [DragAndDropEvent] that started the session.
* @param target The [DragAndDropTarget] that will receive events for a given drag and drop session.
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/DragGestureDetector.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/DragGestureDetector.kt
index 4b44d70..a0c19a9 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/DragGestureDetector.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/DragGestureDetector.kt
@@ -68,7 +68,6 @@
* Example Usage:
*
* @sample androidx.compose.foundation.samples.AwaitDragOrCancellationSample
- *
* @see awaitHorizontalTouchSlopOrCancellation
* @see awaitVerticalTouchSlopOrCancellation
*/
@@ -95,7 +94,6 @@
* Example Usage:
*
* @sample androidx.compose.foundation.samples.DragSample
- *
* @see awaitTouchSlopOrCancellation
* @see awaitDragOrCancellation
* @see horizontalDrag
@@ -130,7 +128,6 @@
* Example Usage:
*
* @sample androidx.compose.foundation.samples.AwaitDragOrCancellationSample
- *
* @see awaitVerticalDragOrCancellation
* @see awaitHorizontalDragOrCancellation
* @see drag
@@ -163,7 +160,6 @@
* Example Usage:
*
* @sample androidx.compose.foundation.samples.DetectDragGesturesSample
- *
* @see detectVerticalDragGestures
* @see detectHorizontalDragGestures
* @see detectDragGesturesAfterLongPress to detect gestures after long press
@@ -222,7 +218,6 @@
* Example Usage:
*
* @sample androidx.compose.foundation.samples.DetectDragGesturesSample
- *
* @see detectVerticalDragGestures
* @see detectHorizontalDragGestures
* @see detectDragGesturesAfterLongPress to detect gestures after long press
@@ -302,7 +297,6 @@
* Example Usage:
*
* @sample androidx.compose.foundation.samples.DetectDragWithLongPressGesturesSample
- *
* @see detectVerticalDragGestures
* @see detectHorizontalDragGestures
* @see detectDragGestures
@@ -360,7 +354,6 @@
* Example Usage:
*
* @sample androidx.compose.foundation.samples.AwaitVerticalDragOrCancellationSample
- *
* @see awaitHorizontalTouchSlopOrCancellation
* @see awaitTouchSlopOrCancellation
*/
@@ -398,7 +391,6 @@
* Example Usage:
*
* @sample androidx.compose.foundation.samples.VerticalDragSample
- *
* @see awaitVerticalTouchSlopOrCancellation
* @see awaitVerticalDragOrCancellation
* @see horizontalDrag
@@ -427,7 +419,6 @@
* Example Usage:
*
* @sample androidx.compose.foundation.samples.AwaitVerticalDragOrCancellationSample
- *
* @see awaitHorizontalDragOrCancellation
* @see awaitDragOrCancellation
* @see verticalDrag
@@ -464,7 +455,6 @@
* Example Usage:
*
* @sample androidx.compose.foundation.samples.DetectVerticalDragGesturesSample
- *
* @see detectDragGestures
* @see detectHorizontalDragGestures
*/
@@ -518,7 +508,6 @@
* Example Usage:
*
* @sample androidx.compose.foundation.samples.AwaitHorizontalDragOrCancellationSample
- *
* @see awaitVerticalTouchSlopOrCancellation
* @see awaitTouchSlopOrCancellation
*/
@@ -553,7 +542,6 @@
* Example Usage:
*
* @sample androidx.compose.foundation.samples.HorizontalDragSample
- *
* @see awaitHorizontalTouchSlopOrCancellation
* @see awaitDragOrCancellation
* @see verticalDrag
@@ -582,7 +570,6 @@
* Example Usage:
*
* @sample androidx.compose.foundation.samples.AwaitHorizontalDragOrCancellationSample
- *
* @see horizontalDrag
* @see awaitVerticalDragOrCancellation
* @see awaitDragOrCancellation
@@ -619,7 +606,6 @@
* Example Usage:
*
* @sample androidx.compose.foundation.samples.DetectHorizontalDragGesturesSample
- *
* @see detectVerticalDragGestures
* @see detectDragGestures
*/
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/Draggable.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/Draggable.kt
index bb458c8..68632dc 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/Draggable.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/Draggable.kt
@@ -147,7 +147,6 @@
* If you are implementing scroll/fling behavior, consider using [scrollable].
*
* @sample androidx.compose.foundation.samples.DraggableSample
- *
* @param state [DraggableState] state of the draggable. Defines how drag events will be interpreted
* by the user land logic.
* @param orientation orientation of the drag
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/Draggable2D.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/Draggable2D.kt
index fa79ef8..b5f5da7 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/Draggable2D.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/Draggable2D.kt
@@ -120,7 +120,6 @@
* If you are implementing dragging in a single orientation, consider using [draggable].
*
* @sample androidx.compose.foundation.samples.Draggable2DSample
- *
* @param state [Draggable2DState] state of the draggable2D. Defines how drag events will be
* interpreted by the user land logic.
* @param enabled whether or not drag is enabled
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/Scrollable.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/Scrollable.kt
index cbdf670..8570920 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/Scrollable.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/Scrollable.kt
@@ -96,7 +96,6 @@
* draggable, consider using [draggable].
*
* @sample androidx.compose.foundation.samples.ScrollableSample
- *
* @param state [ScrollableState] state of the scrollable. Defines how scroll events will be
* interpreted by the user land logic and contains useful information about on-going events.
* @param orientation orientation of the scrolling
@@ -143,7 +142,6 @@
* look-and-feel.
*
* @sample androidx.compose.foundation.samples.ScrollableSample
- *
* @param state [ScrollableState] state of the scrollable. Defines how scroll events will be
* interpreted by the user land logic and contains useful information about on-going events.
* @param orientation orientation of the scrolling
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/Transformable.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/Transformable.kt
index cb9ba66..2b591c4 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/Transformable.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/Transformable.kt
@@ -49,7 +49,6 @@
* reflect their own state in UI when using this component.
*
* @sample androidx.compose.foundation.samples.TransformableSample
- *
* @param state [TransformableState] of the transformable. Defines how transformation events will be
* interpreted by the user land logic, contains useful information about on-going events and
* provides animation capabilities.
@@ -78,7 +77,6 @@
* transformable modifiers to work well within the scrollable container. See example:
*
* @sample androidx.compose.foundation.samples.TransformableSampleInsideScroll
- *
* @param state [TransformableState] of the transformable. Defines how transformation events will be
* interpreted by the user land logic, contains useful information about on-going events and
* provides animation capabilities.
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/snapping/SnapFlingBehavior.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/snapping/SnapFlingBehavior.kt
index 078cf53..0dfb635 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/snapping/SnapFlingBehavior.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/snapping/SnapFlingBehavior.kt
@@ -57,9 +57,7 @@
* Please refer to the sample to learn how to use this API.
*
* @sample androidx.compose.foundation.samples.SnapFlingBehaviorSimpleSample
- *
* @sample androidx.compose.foundation.samples.SnapFlingBehaviorCustomizedSample
- *
* @param snapLayoutInfoProvider The information about the layout being snapped.
* @param decayAnimationSpec The animation spec used to approach the target offset when the fling
* velocity is large enough. Large enough means large enough to naturally decay.
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/snapping/SnapPosition.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/snapping/SnapPosition.kt
index c1e7d0ba..ee658fd 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/snapping/SnapPosition.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/gestures/snapping/SnapPosition.kt
@@ -35,7 +35,6 @@
* padding)
*
* @sample androidx.compose.foundation.samples.SnapFlingBehaviorSnapPosition
- *
* @param layoutSize The main axis layout size within which an item can be positioned.
* @param itemSize The main axis size for the item being positioned within this snapping layout.
* @param beforeContentPadding The content padding in pixels applied before this Layout's
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/LazyDsl.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/LazyDsl.kt
index e1877c4..efa21df 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/LazyDsl.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/LazyDsl.kt
@@ -98,7 +98,6 @@
* will remain pinned until the next header will take its place.
*
* @sample androidx.compose.foundation.samples.StickyHeaderSample
- *
* @param key a stable and unique key representing the item. Using the same key for multiple
* items in the list is not allowed. Type of the key should be saveable via Bundle on Android.
* If null is passed the position in the list will represent the key. When you specify the key
@@ -273,7 +272,6 @@
* items.
*
* @sample androidx.compose.foundation.samples.LazyRowSample
- *
* @param modifier the modifier to apply to this layout
* @param state the state object to be used to control or observe the list's state
* @param contentPadding a padding around the whole content. This will add padding for the content
@@ -328,7 +326,6 @@
* items.
*
* @sample androidx.compose.foundation.samples.LazyColumnSample
- *
* @param modifier the modifier to apply to this layout.
* @param state the state object to be used to control or observe the list's state.
* @param contentPadding a padding around the whole content. This will add padding for the. content
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/LazyItemScope.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/LazyItemScope.kt
index 3d5a1ae..62531cd 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/LazyItemScope.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/LazyItemScope.kt
@@ -83,7 +83,6 @@
* modifier to enable animations.
*
* @sample androidx.compose.foundation.samples.AnimateItemSample
- *
* @param fadeInSpec an animation specs to use for animating the item appearance. When null is
* provided the item will be appearing without animations.
* @param placementSpec an animation specs that will be used to animate the item placement.
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/grid/LazyGridDsl.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/grid/LazyGridDsl.kt
index 84f0084..dd07ff2 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/grid/LazyGridDsl.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/grid/LazyGridDsl.kt
@@ -42,7 +42,6 @@
* Sample with custom item spans:
*
* @sample androidx.compose.foundation.samples.LazyVerticalGridSpanSample
- *
* @param columns describes the count and the size of the grid's columns, see [GridCells] doc for
* more information
* @param modifier the modifier to apply to this layout
@@ -99,7 +98,6 @@
* Sample with custom item spans:
*
* @sample androidx.compose.foundation.samples.LazyHorizontalGridSpanSample
- *
* @param rows a class describing how cells form rows, see [GridCells] doc for more information
* @param modifier the modifier to apply to this layout
* @param state the state object to be used to control or observe the list's state
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/grid/LazyGridItemScope.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/grid/LazyGridItemScope.kt
index e2b7dad..42a4ee8 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/grid/LazyGridItemScope.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/grid/LazyGridItemScope.kt
@@ -37,7 +37,6 @@
* modifier to enable animations.
*
* @sample androidx.compose.foundation.samples.GridAnimateItemSample
- *
* @param fadeInSpec an animation specs to use for animating the item appearance. When null is
* provided the item will be appearing without animations.
* @param placementSpec an animation specs that will be used to animate the item placement.
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/staggeredgrid/LazyStaggeredGridDsl.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/staggeredgrid/LazyStaggeredGridDsl.kt
index 7c397b5..9606d9e 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/staggeredgrid/LazyStaggeredGridDsl.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/staggeredgrid/LazyStaggeredGridDsl.kt
@@ -42,7 +42,6 @@
* Sample with custom item spans:
*
* @sample androidx.compose.foundation.samples.LazyVerticalStaggeredGridSpanSample
- *
* @param columns description of the size and number of staggered grid columns.
* @param modifier modifier to apply to the layout.
* @param state state object that can be used to control and observe staggered grid state.
@@ -134,7 +133,6 @@
* Sample with custom item spans:
*
* @sample androidx.compose.foundation.samples.LazyHorizontalStaggeredGridSpanSample
- *
* @param rows description of the size and number of staggered grid columns.
* @param modifier modifier to apply to the layout.
* @param state state object that can be used to control and observe staggered grid state.
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/staggeredgrid/LazyStaggeredGridItemScope.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/staggeredgrid/LazyStaggeredGridItemScope.kt
index 5eb6fdb..8c01597 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/staggeredgrid/LazyStaggeredGridItemScope.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/lazy/staggeredgrid/LazyStaggeredGridItemScope.kt
@@ -38,7 +38,6 @@
* [LazyStaggeredGridScope.items] for this modifier to enable animations.
*
* @sample androidx.compose.foundation.samples.StaggeredGridAnimateItemSample
- *
* @param fadeInSpec an animation specs to use for animating the item appearance. When null is
* provided the item will be appearing without animations.
* @param placementSpec an animation specs that will be used to animate the item placement.
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/pager/Pager.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/pager/Pager.kt
index a6cb982..bec29c5 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/pager/Pager.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/pager/Pager.kt
@@ -96,14 +96,12 @@
* in the layout (e.g. if the snap position is the start of the layout, then currentPage will be
* the page closest to that).
* @param pageContent This Pager's page Composable.
+ * @sample androidx.compose.foundation.samples.SimpleHorizontalPagerSample
+ * @sample androidx.compose.foundation.samples.HorizontalPagerWithScrollableContent
* @see androidx.compose.foundation.gestures.snapping.SnapLayoutInfoProvider for the implementation
* of a [SnapLayoutInfoProvider] that uses [androidx.compose.foundation.lazy.LazyListState].
*
* Please refer to the samples to learn how to use this API.
- *
- * @sample androidx.compose.foundation.samples.SimpleHorizontalPagerSample
- *
- * @sample androidx.compose.foundation.samples.HorizontalPagerWithScrollableContent
*/
@Composable
fun HorizontalPager(
@@ -186,12 +184,11 @@
* in the layout (e.g. if the snap position is the start of the layout, then currentPage will be
* the page closest to that).
* @param pageContent This Pager's page Composable.
+ * @sample androidx.compose.foundation.samples.SimpleVerticalPagerSample
* @see androidx.compose.foundation.gestures.snapping.SnapLayoutInfoProvider for the implementation
* of a [SnapLayoutInfoProvider] that uses [androidx.compose.foundation.lazy.LazyListState].
*
* Please refer to the sample to learn how to use this API.
- *
- * @sample androidx.compose.foundation.samples.SimpleVerticalPagerSample
*/
@Composable
fun VerticalPager(
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/pager/PagerState.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/pager/PagerState.kt
index d172d58..28fca85 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/pager/PagerState.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/pager/PagerState.kt
@@ -73,7 +73,6 @@
* Please refer to the sample to learn how to use this API.
*
* @sample androidx.compose.foundation.samples.PagerWithStateSample
- *
* @param initialPage The pager that should be shown first.
* @param initialPageOffsetFraction The offset of the initial page as a fraction of the page size.
* This should vary between -0.5 and 0.5 and indicates how to offset the initial page from the
@@ -98,7 +97,6 @@
* Please refer to the sample to learn how to use this API.
*
* @sample androidx.compose.foundation.samples.PagerWithStateSample
- *
* @param currentPage The pager that should be shown first.
* @param currentPageOffsetFraction The offset of the initial page as a fraction of the page size.
* This should vary between -0.5 and 0.5 and indicates how to offset the initial page from the
@@ -466,7 +464,6 @@
* Please refer to the sample to learn how to use this API.
*
* @sample androidx.compose.foundation.samples.ScrollToPageSample
- *
* @param page The destination page to scroll to
* @param pageOffsetFraction A fraction of the page size that indicates the offset the
* destination page will be offset from its snapped position.
@@ -493,7 +490,6 @@
* Please refer to the sample to learn how to use this API.
*
* @sample androidx.compose.foundation.samples.PagerCustomAnimateScrollToPage
- *
* @param page The destination page to scroll to
* @param pageOffsetFraction A fraction of the page size that indicates the offset the
* destination page will be offset from its snapped position.
@@ -567,7 +563,6 @@
* Please refer to the sample to learn how to use this API.
*
* @sample androidx.compose.foundation.samples.AnimateScrollPageSample
- *
* @param page The destination page to scroll to
* @param pageOffsetFraction A fraction of the page size that indicates the offset the
* destination page will be offset from its snapped position.
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/relocation/BringIntoViewRequester.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/relocation/BringIntoViewRequester.kt
index 279b2cd..85246e3 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/relocation/BringIntoViewRequester.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/relocation/BringIntoViewRequester.kt
@@ -37,7 +37,6 @@
* it.
*
* @sample androidx.compose.foundation.samples.BringIntoViewSample
- *
* @sample androidx.compose.foundation.samples.BringPartOfComposableIntoViewSample
*/
@ExperimentalFoundationApi
@@ -53,9 +52,7 @@
* don't specify the coordinates, the coordinates of the
* [Modifier.bringIntoViewRequester()][bringIntoViewRequester] associated with this
* [BringIntoViewRequester] will be used.
- *
* @sample androidx.compose.foundation.samples.BringIntoViewSample
- *
* @sample androidx.compose.foundation.samples.BringPartOfComposableIntoViewSample
*/
suspend fun bringIntoView(rect: Rect? = null)
@@ -92,7 +89,6 @@
* using this modifier is brought into the bounds of all its parents.
*
* @sample androidx.compose.foundation.samples.BringIntoViewSample
- *
* @param bringIntoViewRequester An instance of [BringIntoViewRequester]. This hoisted object can be
* used to send [scrollIntoView][BringIntoViewRequester.scrollIntoView] requests to parents of the
* current composable.
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/relocation/BringIntoViewResponder.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/relocation/BringIntoViewResponder.kt
index 619ec6f..271ef11 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/relocation/BringIntoViewResponder.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/relocation/BringIntoViewResponder.kt
@@ -52,7 +52,6 @@
* Here is a sample where a part of a composable is brought into view:
*
* @sample androidx.compose.foundation.samples.BringPartOfComposableIntoViewSample
- *
* @see BringIntoViewRequester
*
* Note: this API is experimental while we optimise the performance and find the right API shape for
@@ -99,7 +98,6 @@
* mechanism works.
*
* @sample androidx.compose.foundation.samples.BringIntoViewSample
- *
* @see BringIntoViewRequester
*
* Note: this API is experimental while we optimise the performance and find the right API shape for
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/relocation/ScrollIntoViewRequester.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/relocation/ScrollIntoViewRequester.kt
index c8e4492..14efa18 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/relocation/ScrollIntoViewRequester.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/relocation/ScrollIntoViewRequester.kt
@@ -36,9 +36,7 @@
* specify the coordinates, the coordinates of the
* [Modifier.bringIntoViewRequester()][bringIntoViewRequester] associated with this
* [BringIntoViewRequester] will be used.
- *
* @sample androidx.compose.foundation.samples.BringIntoViewSample
- *
* @sample androidx.compose.foundation.samples.BringPartOfComposableIntoViewSample
*/
// TODO(b/333421581) Make public.
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/selection/Selectable.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/selection/Selectable.kt
index c1e3eae..5b6e702 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/selection/Selectable.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/selection/Selectable.kt
@@ -51,7 +51,6 @@
* information see the documentation on the other overload.
*
* @sample androidx.compose.foundation.samples.SelectableSample
- *
* @param selected whether or not this item is selected in a mutually exclusion set
* @param enabled whether or not this [selectable] will handle input events and appear enabled from
* a semantics perspective
@@ -119,7 +118,6 @@
* cannot be lazily created inside selectable.
*
* @sample androidx.compose.foundation.samples.SelectableSample
- *
* @param selected whether or not this item is selected in a mutually exclusion set
* @param interactionSource [MutableInteractionSource] that will be used to dispatch
* PressInteraction.Press when this selectable is pressed. If `null`, an internal
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/selection/Toggleable.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/selection/Toggleable.kt
index 2edfc83..e306a54 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/selection/Toggleable.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/selection/Toggleable.kt
@@ -47,7 +47,6 @@
* information see the documentation on the other overload.
*
* @sample androidx.compose.foundation.samples.ToggleableSample
- *
* @param value whether Toggleable is on or off
* @param enabled whether or not this [toggleable] will handle input events and appear enabled for
* semantics purposes
@@ -111,7 +110,6 @@
* cannot be lazily created inside toggleable.
*
* @sample androidx.compose.foundation.samples.ToggleableSample
- *
* @param value whether Toggleable is on or off
* @param interactionSource [MutableInteractionSource] that will be used to dispatch
* [PressInteraction.Press] when this toggleable is pressed. If `null`, an internal
@@ -284,7 +282,6 @@
* more information see the documentation on the other overload.
*
* @sample androidx.compose.foundation.samples.TriStateToggleableSample
- *
* @param state current value for the component
* @param enabled whether or not this [triStateToggleable] will handle input events and appear
* enabled for semantics purposes
@@ -352,7 +349,6 @@
* cannot be lazily created inside triStateToggleable.
*
* @sample androidx.compose.foundation.samples.TriStateToggleableSample
- *
* @param state current value for the component
* @param interactionSource [MutableInteractionSource] that will be used to dispatch
* [PressInteraction.Press] when this triStateToggleable is pressed. If `null`, an internal
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/BasicTextField.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/BasicTextField.kt
index 553688a9..e92a7e2 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/BasicTextField.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/BasicTextField.kt
@@ -157,11 +157,8 @@
* @param scrollState Scroll state that manages either horizontal or vertical scroll of TextField.
* If [lineLimits] is [SingleLine], this text field is treated as single line with horizontal
* scroll behavior. In other cases the text field becomes vertically scrollable.
- *
* @sample androidx.compose.foundation.samples.BasicTextFieldDecoratorSample
- *
* @sample androidx.compose.foundation.samples.BasicTextFieldCustomInputTransformationSample
- *
* @sample androidx.compose.foundation.samples.BasicTextFieldWithValueOnValueChangeSample
*/
// This takes a composable lambda, but it is not primarily a container.
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/ClickableText.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/ClickableText.kt
index efb2a7a..242a969 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/ClickableText.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/ClickableText.kt
@@ -43,7 +43,6 @@
* For other gestures, e.g. long press, dragging, follow sample code.
*
* @sample androidx.compose.foundation.samples.LongClickableText
- *
* @param text The text to be displayed.
* @param modifier Modifier to apply to this layout node.
* @param style Style configuration for the text such as color, font, line height etc.
@@ -115,7 +114,6 @@
* For other gestures, e.g. long press, dragging, follow sample code.
*
* @sample androidx.compose.foundation.samples.LongClickableText
- *
* @param text The text to be displayed.
* @param modifier Modifier to apply to this layout node.
* @param style Style configuration for the text such as color, font, line height etc.
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/InlineTextContent.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/InlineTextContent.kt
index 090ba3e..c4c4ee8 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/InlineTextContent.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/InlineTextContent.kt
@@ -35,7 +35,6 @@
* [id], and it will use the [InlineTextContent.children] to replace this range of text.
*
* @sample androidx.compose.foundation.samples.InlineTextContentSample
- *
* @param id The id used to look up the [InlineTextContent], it is referred by the inlineContent
* parameter of [BasicText] to replace the [alternateText] to the corresponding composable.
* @param alternateText The text to be replaced by the inline content. It's displayed when the
@@ -65,7 +64,6 @@
* through [androidx.compose.ui.layout.Layout].
*
* @sample androidx.compose.foundation.samples.InlineTextContentSample
- *
* @see BasicText
* @see Placeholder
*/
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/input/InputTransformation.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/input/InputTransformation.kt
index 19e893a..7fc64b1 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/input/InputTransformation.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/input/InputTransformation.kt
@@ -92,7 +92,6 @@
* the options from this transformation.
*
* @sample androidx.compose.foundation.samples.BasicTextFieldInputTransformationChainingSample
- *
* @param next The [InputTransformation] that will be ran after this one.
*/
@Stable
@@ -109,7 +108,6 @@
* [InputTransformation] directly.
*
* @sample androidx.compose.foundation.samples.BasicTextFieldInputTransformationByValueChooseSample
- *
* @sample androidx.compose.foundation.samples.BasicTextFieldInputTransformationByValueReplaceSample
*/
@Stable
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/input/TextFieldBuffer.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/input/TextFieldBuffer.kt
index 6c947fe..16f3f31 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/input/TextFieldBuffer.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/input/TextFieldBuffer.kt
@@ -85,7 +85,6 @@
* this value at any given time, even those made after reading this property.
*
* @sample androidx.compose.foundation.samples.BasicTextFieldChangeIterationSample
- *
* @sample androidx.compose.foundation.samples.BasicTextFieldChangeReverseIterationSample
*/
@ExperimentalFoundationApi
@@ -424,7 +423,6 @@
* [forEachChangeReversed].
*
* @sample androidx.compose.foundation.samples.BasicTextFieldChangeIterationSample
- *
* @see forEachChangeReversed
*/
@ExperimentalFoundationApi
@@ -445,7 +443,6 @@
* safely, such changes will not be visited.
*
* @sample androidx.compose.foundation.samples.BasicTextFieldChangeReverseIterationSample
- *
* @see forEachChange
*/
@ExperimentalFoundationApi
diff --git a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/input/TextFieldState.kt b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/input/TextFieldState.kt
index 6ae7f10..2bd4b5a 100644
--- a/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/input/TextFieldState.kt
+++ b/compose/foundation/foundation/src/commonMain/kotlin/androidx/compose/foundation/text/input/TextFieldState.kt
@@ -105,7 +105,6 @@
* composable function) will cause the function to restart when the text field's value changes.
*
* @sample androidx.compose.foundation.samples.BasicTextFieldTextDerivedStateSample
- *
* @see edit
*/
internal var value: TextFieldCharSequence by
@@ -121,7 +120,6 @@
* }`.
*
* @sample androidx.compose.foundation.samples.BasicTextFieldTextValuesSample
- *
* @see edit
* @see snapshotFlow
*/
@@ -166,7 +164,6 @@
* [IllegalStateException].
*
* @sample androidx.compose.foundation.samples.BasicTextFieldStateEditSample
- *
* @see setTextAndPlaceCursorAtEnd
* @see setTextAndSelectAll
*/
diff --git a/compose/foundation/foundation/src/desktopMain/kotlin/androidx/compose/foundation/DarkTheme.desktop.kt b/compose/foundation/foundation/src/desktopMain/kotlin/androidx/compose/foundation/DarkTheme.desktop.kt
index 481ab1f..7021d2e 100644
--- a/compose/foundation/foundation/src/desktopMain/kotlin/androidx/compose/foundation/DarkTheme.desktop.kt
+++ b/compose/foundation/foundation/src/desktopMain/kotlin/androidx/compose/foundation/DarkTheme.desktop.kt
@@ -39,7 +39,6 @@
* theme:
*
* @sample androidx.compose.foundation.samples.DarkThemeSample
- *
* @return `true` if the system is considered to be in 'dark theme'.
*/
@Composable
diff --git a/compose/material/material/src/androidMain/kotlin/androidx/compose/material/ExposedDropdownMenu.android.kt b/compose/material/material/src/androidMain/kotlin/androidx/compose/material/ExposedDropdownMenu.android.kt
index ecd73db..cf017e2 100644
--- a/compose/material/material/src/androidMain/kotlin/androidx/compose/material/ExposedDropdownMenu.android.kt
+++ b/compose/material/material/src/androidMain/kotlin/androidx/compose/material/ExposedDropdownMenu.android.kt
@@ -81,7 +81,6 @@
* An example of editable Exposed Dropdown Menu:
*
* @sample androidx.compose.material.samples.EditableExposedDropdownMenuSample
- *
* @param expanded Whether Dropdown Menu should be expanded or not.
* @param onExpandedChange Executes when the user clicks on the ExposedDropdownMenuBox.
* @param modifier The modifier to apply to this layout
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/AlertDialog.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/AlertDialog.kt
index 5be1006..625bee6 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/AlertDialog.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/AlertDialog.kt
@@ -62,7 +62,6 @@
* Sample of dialog:
*
* @sample androidx.compose.material.samples.AlertDialogSample
- *
* @param onDismissRequest Executes when the user tries to dismiss the Dialog by clicking outside or
* pressing the back button. This is not called when the dismiss button is clicked.
* @param confirmButton A button which is meant to confirm a proposed action, thus resolving what
@@ -107,7 +106,6 @@
* This function can be used to fully customize the button area, e.g. with:
*
* @sample androidx.compose.material.samples.CustomAlertDialogSample
- *
* @param onDismissRequest Executes when the user tries to dismiss the Dialog by clicking outside or
* pressing the back button. This is not called when the dismiss button is clicked.
* @param buttons Function that emits the layout with the buttons.
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/AppBar.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/AppBar.kt
index 4fe3a9f..22c4431 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/AppBar.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/AppBar.kt
@@ -67,7 +67,6 @@
* title, use the other TopAppBar overload for a generic TopAppBar with no restriction on content.
*
* @sample androidx.compose.material.samples.SimpleTopAppBar
- *
* @param title The title to be displayed in the center of the TopAppBar
* @param windowInsets a window insets that app bar will respect.
* @param modifier The [Modifier] to be applied to this TopAppBar
@@ -147,7 +146,6 @@
* title, use the other TopAppBar overload for a generic TopAppBar with no restriction on content.
*
* @sample androidx.compose.material.samples.SimpleTopAppBar
- *
* @param title The title to be displayed in the center of the TopAppBar
* @param modifier The [Modifier] to be applied to this TopAppBar
* @param navigationIcon The navigation icon displayed at the start of the TopAppBar. This should
@@ -315,7 +313,6 @@
* Also see [BottomNavigation].
*
* @sample androidx.compose.material.samples.SimpleBottomAppBar
- *
* @param windowInsets a window insets that app bar will respect.
* @param modifier The [Modifier] to be applied to this BottomAppBar
* @param backgroundColor The background color for the BottomAppBar. Use [Color.Transparent] to have
@@ -388,7 +385,6 @@
* Also see [BottomNavigation].
*
* @sample androidx.compose.material.samples.SimpleBottomAppBar
- *
* @param modifier The [Modifier] to be applied to this BottomAppBar
* @param backgroundColor The background color for the BottomAppBar. Use [Color.Transparent] to have
* no color.
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/BackdropScaffold.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/BackdropScaffold.kt
index 5a09525..ae9557c 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/BackdropScaffold.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/BackdropScaffold.kt
@@ -311,7 +311,6 @@
* A simple example of a backdrop scaffold looks like this:
*
* @sample androidx.compose.material.samples.BackdropScaffoldSample
- *
* @param appBar App bar for the back layer. Make sure that the [peekHeight] is equal to the height
* of the app bar, so that the app bar is fully visible. Consider using [TopAppBar] but set the
* elevation to 0dp and background color to transparent as a surface is already provided.
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Badge.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Badge.kt
index 9d42989..9aa296f 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Badge.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Badge.kt
@@ -50,7 +50,6 @@
* A simple icon with badge example looks like:
*
* @sample androidx.compose.material.samples.BottomNavigationItemWithBadge
- *
* @param badge the badge to be displayed - typically a [Badge]
* @param modifier optional [Modifier] for this item
* @param content the anchor to which this badge will be positioned
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/BottomSheetScaffold.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/BottomSheetScaffold.kt
index a2747e5..f9134e1 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/BottomSheetScaffold.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/BottomSheetScaffold.kt
@@ -291,7 +291,6 @@
* A simple example of a bottom sheet scaffold looks like this:
*
* @sample androidx.compose.material.samples.BottomSheetScaffoldSample
- *
* @param sheetContent The content of the bottom sheet.
* @param modifier An optional [Modifier] for the root of the scaffold.
* @param scaffoldState The state of the scaffold.
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Button.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Button.kt
index 34ba75e..257d35e 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Button.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Button.kt
@@ -72,7 +72,6 @@
* text:
*
* @sample androidx.compose.material.samples.ButtonWithIconSample
- *
* @param onClick Will be called when the user clicks the button
* @param modifier Modifier to be applied to the button
* @param enabled Controls the enabled state of the button. When `false`, this button will not be
@@ -149,7 +148,6 @@
* The default text style for internal [Text] components will be set to [Typography.button].
*
* @sample androidx.compose.material.samples.OutlinedButtonSample
- *
* @param onClick Will be called when the user clicks the button
* @param modifier Modifier to be applied to the button
* @param enabled Controls the enabled state of the button. When `false`, this button will not be
@@ -207,7 +205,6 @@
* The default text style for internal [Text] components will be set to [Typography.button].
*
* @sample androidx.compose.material.samples.TextButtonSample
- *
* @param onClick Will be called when the user clicks the button
* @param modifier Modifier to be applied to the button
* @param enabled Controls the enabled state of the button. When `false`, this button will not be
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Card.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Card.kt
index fb6bc1c..68a2d389 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Card.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Card.kt
@@ -40,7 +40,6 @@
* that accepts `onClick` as a parameter.
*
* @sample androidx.compose.material.samples.CardSample
- *
* @param modifier Modifier to be applied to the layout of the card.
* @param shape Defines the card's shape as well its shadow. A shadow is only displayed if the
* [elevation] is greater than zero.
@@ -81,7 +80,6 @@
* consider using another overload.
*
* @sample androidx.compose.material.samples.ClickableCardSample
- *
* @param onClick callback to be called when the card is clicked
* @param modifier Modifier to be applied to the layout of the card.
* @param enabled Controls the enabled state of the card. When `false`, this card will not be
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Checkbox.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Checkbox.kt
index 7bfde1f..21498b6 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Checkbox.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Checkbox.kt
@@ -66,7 +66,6 @@
* image](https://developer.android.com/images/reference/androidx/compose/material/checkboxes.png)
*
* @sample androidx.compose.material.samples.CheckboxSample
- *
* @param checked whether Checkbox is checked or unchecked
* @param onCheckedChange callback to be invoked when checkbox is being clicked, therefore the
* change of checked state in requested. If null, then this is passive and relies entirely on a
@@ -117,7 +116,6 @@
* image](https://developer.android.com/images/reference/androidx/compose/material/checkboxes.png)
*
* @sample androidx.compose.material.samples.TriStateCheckboxSample
- *
* @param state whether TriStateCheckbox is checked, unchecked or in indeterminate state
* @param onClick callback to be invoked when checkbox is being clicked, therefore the change of
* ToggleableState state is requested. If null, then this is passive and relies entirely on a
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Chip.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Chip.kt
index daf72ea..5e1ef76 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Chip.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Chip.kt
@@ -72,7 +72,6 @@
* Alternatively, use [androidx.compose.foundation.layout.FlowRow] to wrap chips to a new line.
*
* @sample androidx.compose.material.samples.ChipGroupReflowSample
- *
* @param onClick called when the chip is clicked.
* @param modifier Modifier to be applied to the chip
* @param enabled When disabled, chip will not respond to user input. It will also appear visually
@@ -159,7 +158,6 @@
* [ChipDefaults.outlinedFilterChipColors] and [ChipDefaults.outlinedBorder]
*
* @sample androidx.compose.material.samples.OutlinedFilterChipSample
- *
* @param selected boolean state for this chip: either it is selected or not
* @param onClick will be called when the user clicks the chip
* @param modifier Modifier to be applied to the chip
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Drawer.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Drawer.kt
index eda49d5f..ffb693f 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Drawer.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Drawer.kt
@@ -434,7 +434,6 @@
* navigation.
*
* @sample androidx.compose.material.samples.ModalDrawerSample
- *
* @param drawerContent composable that represents content inside the drawer
* @param modifier optional modifier for the drawer
* @param drawerState state of the drawer
@@ -561,7 +560,6 @@
* See [ModalDrawer] for a layout that introduces a classic from-the-side drawer.
*
* @sample androidx.compose.material.samples.BottomDrawerSample
- *
* @param drawerContent composable that represents content inside the drawer
* @param modifier optional [Modifier] for the entire component
* @param drawerState state of the drawer
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/FloatingActionButton.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/FloatingActionButton.kt
index 39cc6f1..955827f 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/FloatingActionButton.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/FloatingActionButton.kt
@@ -132,7 +132,6 @@
* example to fill the whole available width you can do:
*
* @sample androidx.compose.material.samples.FluidExtendedFab
- *
* @param text Text label displayed inside this FAB
* @param onClick callback invoked when this FAB is clicked
* @param modifier [Modifier] to be applied to this FAB
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/IconButton.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/IconButton.kt
index 0c3ee6f..90471f7 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/IconButton.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/IconButton.kt
@@ -41,7 +41,6 @@
* the internal icon is 24 x 24 dp.
*
* @sample androidx.compose.material.samples.IconButtonSample
- *
* @param onClick the lambda to be invoked when this icon is pressed
* @param modifier optional [Modifier] for this IconButton
* @param enabled whether or not this IconButton will handle input events and appear enabled for
@@ -84,7 +83,6 @@
* icon, or a navigation icon that opens a drawer.
*
* @sample androidx.compose.material.samples.IconToggleButtonSample
- *
* @param checked whether this IconToggleButton is currently checked
* @param onCheckedChange callback to be invoked when this icon is selected
* @param modifier optional [Modifier] for this IconToggleButton
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/ListItem.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/ListItem.kt
index c345415..9a7d402 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/ListItem.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/ListItem.kt
@@ -68,7 +68,6 @@
* You can combine this component with a checkbox or switch as in the following examples:
*
* @sample androidx.compose.material.samples.ClickableListItems
- *
* @param modifier Modifier to be applied to the list item
* @param icon The leading supporting visual of the list item
* @param secondaryText The secondary text of the list item
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/MaterialTheme.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/MaterialTheme.kt
index 2923d89..976ca50 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/MaterialTheme.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/MaterialTheme.kt
@@ -50,7 +50,6 @@
* overriding only the parts of the theme definition that need to change.
*
* @sample androidx.compose.material.samples.MaterialThemeSample
- *
* @param colors A complete definition of the Material Color theme for this hierarchy
* @param typography A set of text styles to be used as this hierarchy's typography system
* @param shapes A set of shapes to be used by the components in this hierarchy
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Menu.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Menu.kt
index eaa34ea..4b67c94 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Menu.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Menu.kt
@@ -98,7 +98,6 @@
* Example usage with a [ScrollState] to control the menu items scroll position:
*
* @sample androidx.compose.material.samples.MenuWithScrollStateSample
- *
* @param expanded whether the menu is expanded or not
* @param onDismissRequest called when the user requests to dismiss the menu, such as by tapping
* outside the menu's bounds
@@ -127,7 +126,6 @@
* Example usage:
*
* @sample androidx.compose.material.samples.MenuSample
- *
* @param onClick Called when the menu item was clicked
* @param modifier The modifier to be applied to the menu item
* @param enabled Controls the enabled state of the menu item - when `false`, the menu item will not
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/ModalBottomSheet.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/ModalBottomSheet.kt
index 3dfde8d..e421ecf 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/ModalBottomSheet.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/ModalBottomSheet.kt
@@ -319,7 +319,6 @@
* A simple example of a modal bottom sheet looks like this:
*
* @sample androidx.compose.material.samples.ModalBottomSheetSample
- *
* @param sheetContent The content of the bottom sheet.
* @param modifier Optional [Modifier] for the entire component.
* @param sheetState The state of the bottom sheet.
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/ProgressIndicator.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/ProgressIndicator.kt
index b4b1268..2738bcec 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/ProgressIndicator.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/ProgressIndicator.kt
@@ -91,7 +91,6 @@
* animating progress, such as in the following example:
*
* @sample androidx.compose.material.samples.LinearProgressIndicatorSample
- *
* @param progress The progress of this progress indicator, where 0.0 represents no progress and 1.0
* represents full progress. Values outside of this range are coerced into the range.
* @param modifier the [Modifier] to be applied to this progress indicator
@@ -320,7 +319,6 @@
* animating progress, such as in the following example:
*
* @sample androidx.compose.material.samples.CircularProgressIndicatorSample
- *
* @param progress The progress of this progress indicator, where 0.0 represents no progress and 1.0
* represents full progress. Values outside of this range are coerced into the range.
* @param modifier the [Modifier] to be applied to this progress indicator
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/RadioButton.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/RadioButton.kt
index 4a8a098..f355028 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/RadioButton.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/RadioButton.kt
@@ -57,7 +57,6 @@
* [Row]) to achieve radio group-like behaviour, where the entire layout is selectable:
*
* @sample androidx.compose.material.samples.RadioGroupSample
- *
* @param selected whether this radio button is selected or not
* @param onClick callback to be invoked when the RadioButton is clicked. If null, then this
* RadioButton will not handle input events, and only act as a visual indicator of [selected]
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Scaffold.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Scaffold.kt
index 189a8b7..3db57d2 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Scaffold.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Scaffold.kt
@@ -131,7 +131,6 @@
* [ScaffoldState.snackbarHostState] when created
*
* @sample androidx.compose.material.samples.ScaffoldWithSimpleSnackbar
- *
* @param contentWindowInsets window insets to be passed to [content] slot via [PaddingValues]
* params. Scaffold will take the insets into account from the top/bottom only if the [topBar]/
* [bottomBar] are not present, as the scaffold expect [topBar]/[bottomBar] to handle insets
@@ -264,7 +263,6 @@
* [ScaffoldState.snackbarHostState] when created
*
* @sample androidx.compose.material.samples.ScaffoldWithSimpleSnackbar
- *
* @param modifier optional Modifier for the root of the [Scaffold]
* @param scaffoldState state of this scaffold widget. It contains the state of the screen, e.g.
* variables to provide manual control over the drawer behavior, sizes of components, etc
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Slider.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Slider.kt
index 19c55e1..d6572c7 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Slider.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Slider.kt
@@ -126,7 +126,6 @@
* of steps between min and max values:
*
* @sample androidx.compose.material.samples.StepsSliderSample
- *
* @param value current value of the Slider. If outside of [valueRange] provided, value will be
* coerced to this range.
* @param onValueChange lambda in which value should be updated
@@ -278,7 +277,6 @@
* of steps between min and max values:
*
* @sample androidx.compose.material.samples.StepRangeSliderSample
- *
* @param value current values of the RangeSlider. If either value is outside of [valueRange]
* provided, it will be coerced to this range.
* @param onValueChange lambda in which values should be updated
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Snackbar.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Snackbar.kt
index 3550dcf..9cd1a6f 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Snackbar.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Snackbar.kt
@@ -66,7 +66,6 @@
* of the [SnackbarHost] to the [Scaffold]:
*
* @sample androidx.compose.material.samples.ScaffoldWithCustomSnackbar
- *
* @param modifier modifiers for the Snackbar layout
* @param action action / button component to add as an action to the snackbar. Consider using
* [SnackbarDefaults.primaryActionColor] as the color for the action, if you do not have a
@@ -143,7 +142,6 @@
* of the [SnackbarHost] to the [Scaffold]:
*
* @sample androidx.compose.material.samples.ScaffoldWithCustomSnackbar
- *
* @param snackbarData data about the current snackbar showing via [SnackbarHostState]
* @param modifier modifiers for the Snackbar layout
* @param actionOnNewLine whether or not action should be put on the separate line. Recommended for
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/SnackbarHost.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/SnackbarHost.kt
index a22e53b..2cd1bdf 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/SnackbarHost.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/SnackbarHost.kt
@@ -142,7 +142,6 @@
* of the [SnackbarHost] to the [Scaffold]:
*
* @sample androidx.compose.material.samples.ScaffoldWithCustomSnackbar
- *
* @param hostState state of this component to read and show [Snackbar]s accordingly
* @param modifier optional modifier for this component
* @param snackbar the instance of the [Snackbar] to be shown at the appropriate time with
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/SwipeToDismiss.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/SwipeToDismiss.kt
index acd74fe..3b8c5a1 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/SwipeToDismiss.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/SwipeToDismiss.kt
@@ -143,7 +143,6 @@
* A composable that can be dismissed by swiping left or right.
*
* @sample androidx.compose.material.samples.SwipeToDismissListItems
- *
* @param state The state of this component.
* @param modifier Optional [Modifier] for this component.
* @param directions The set of directions in which the component can be dismissed.
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Swipeable.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Swipeable.kt
index 6891439..54281d8 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Swipeable.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Swipeable.kt
@@ -538,7 +538,6 @@
* For an example of a [swipeable] with three states, see:
*
* @sample androidx.compose.material.samples.SwipeableSample
- *
* @param T The type of the state.
* @param state The state of the [swipeable].
* @param anchors Pairs of anchors and states, used to map anchors to states and vice versa.
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Switch.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Switch.kt
index 518c3d5..81acb81 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Switch.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Switch.kt
@@ -76,7 +76,6 @@
* image](https://developer.android.com/images/reference/androidx/compose/material/switches.png)
*
* @sample androidx.compose.material.samples.SwitchSample
- *
* @param checked whether or not this component is checked
* @param onCheckedChange callback to be invoked when Switch is being clicked, therefore the change
* of checked state is requested. If null, then this is passive and relies entirely on a
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Tab.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Tab.kt
index ee13aa4..884e42d 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Tab.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Tab.kt
@@ -206,7 +206,6 @@
* A custom tab using this API may look like:
*
* @sample androidx.compose.material.samples.FancyTab
- *
* @param selected whether this tab is selected or not
* @param onClick the callback to be invoked when this tab is selected
* @param modifier optional [Modifier] for this tab
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/TabRow.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/TabRow.kt
index 211681f..8d216fb1 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/TabRow.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/TabRow.kt
@@ -112,7 +112,6 @@
* We can now just pass this indicator directly to TabRow:
*
* @sample androidx.compose.material.samples.FancyIndicatorContainerTabs
- *
* @param selectedTabIndex the index of the currently selected tab
* @param modifier optional [Modifier] for this TabRow
* @param backgroundColor The background color for the TabRow. Use [Color.Transparent] to have no
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Text.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Text.kt
index a3c32e4..1e168ec 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Text.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/Text.kt
@@ -227,7 +227,6 @@
* See an example of displaying text with links where links apply the styling from the theme:
*
* @sample androidx.compose.material.samples.TextWithLinks
- *
* @param text The text to be displayed.
* @param modifier [Modifier] to apply to this layout node.
* @param color [Color] to apply to the text. If [Color.Unspecified], and [style] has no color set,
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/TextFieldDefaults.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/TextFieldDefaults.kt
index 82f8ab8..2584f6f 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/TextFieldDefaults.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/TextFieldDefaults.kt
@@ -498,9 +498,7 @@
*
* See example of using [TextFieldDecorationBox] to build your own custom text field
*
- * @sample androidx.compose.material.samples.CustomTextFieldBasedOnDecorationBox
- * C
- *
+ * @sample androidx.compose.material.samples.CustomTextFieldBasedOnDecorationBox C
* @param value the input [String] shown by the text field
* @param innerTextField input text field that this decoration box wraps. You will pass here a
* framework-controlled composable parameter "innerTextField" from the decorationBox lambda of
@@ -601,7 +599,6 @@
* Example of custom text field based on [OutlinedTextFieldDecorationBox]:
*
* @sample androidx.compose.material.samples.CustomOutlinedTextFieldBasedOnDecorationBox
- *
* @param value the input [String] shown by the text field
* @param innerTextField input text field that this decoration box wraps. You will pass here a
* framework-controlled composable parameter "innerTextField" from the decorationBox lambda of
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/pullrefresh/PullRefresh.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/pullrefresh/PullRefresh.kt
index 49e02e7..0e9e980 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/pullrefresh/PullRefresh.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/pullrefresh/PullRefresh.kt
@@ -31,7 +31,6 @@
* order to receive scroll events. For example:
*
* @sample androidx.compose.material.samples.PullRefreshSample
- *
* @param state The [PullRefreshState] associated with this pull-to-refresh component. The state
* will be updated by this modifier.
* @param enabled If not enabled, all scroll delta and fling velocity will be ignored.
@@ -49,7 +48,6 @@
* order to receive scroll events. For example:
*
* @sample androidx.compose.material.samples.CustomPullRefreshSample
- *
* @param onPull Callback for dispatching vertical scroll delta, takes float pullDelta as argument.
* Positive delta (pulling down) is dispatched only if the child does not consume it (i.e. pulling
* down despite being at the top of a scrollable component), whereas negative delta (swiping up)
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/pullrefresh/PullRefreshIndicator.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/pullrefresh/PullRefreshIndicator.kt
index 8f48a2c..c29cac7 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/pullrefresh/PullRefreshIndicator.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/pullrefresh/PullRefreshIndicator.kt
@@ -61,7 +61,6 @@
* The default indicator for Compose pull-to-refresh, based on Android's SwipeRefreshLayout.
*
* @sample androidx.compose.material.samples.PullRefreshSample
- *
* @param refreshing A boolean representing whether a refresh is occurring.
* @param state The [PullRefreshState] which controls where and how the indicator will be drawn.
* @param modifier Modifiers for the indicator.
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/pullrefresh/PullRefreshIndicatorTransform.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/pullrefresh/PullRefreshIndicatorTransform.kt
index a2f5502..dff62cd 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/pullrefresh/PullRefreshIndicatorTransform.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/pullrefresh/PullRefreshIndicatorTransform.kt
@@ -29,7 +29,6 @@
* on the given [PullRefreshState].
*
* @sample androidx.compose.material.samples.PullRefreshIndicatorTransformSample
- *
* @param state The [PullRefreshState] which determines the position of the indicator.
* @param scale A boolean controlling whether the indicator's size scales with pull progress or not.
*/
diff --git a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/pullrefresh/PullRefreshState.kt b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/pullrefresh/PullRefreshState.kt
index 0e1c03e..6d244f3 100644
--- a/compose/material/material/src/commonMain/kotlin/androidx/compose/material/pullrefresh/PullRefreshState.kt
+++ b/compose/material/material/src/commonMain/kotlin/androidx/compose/material/pullrefresh/PullRefreshState.kt
@@ -45,7 +45,6 @@
* Changes to [refreshing] will result in [PullRefreshState] being updated.
*
* @sample androidx.compose.material.samples.PullRefreshSample
- *
* @param refreshing A boolean representing whether a refresh is currently occurring.
* @param onRefresh The function to be called to trigger a refresh.
* @param refreshThreshold The threshold below which, if a release occurs, [onRefresh] will be
diff --git a/compose/material/material/src/desktopMain/kotlin/androidx/compose/material/DesktopMenu.desktop.kt b/compose/material/material/src/desktopMain/kotlin/androidx/compose/material/DesktopMenu.desktop.kt
index b21e279..547ef4b 100644
--- a/compose/material/material/src/desktopMain/kotlin/androidx/compose/material/DesktopMenu.desktop.kt
+++ b/compose/material/material/src/desktopMain/kotlin/androidx/compose/material/DesktopMenu.desktop.kt
@@ -74,7 +74,6 @@
* Example usage:
*
* @sample androidx.compose.material.samples.MenuSample
- *
* @param expanded Whether the menu is currently open and visible to the user
* @param onDismissRequest Called when the user requests to dismiss the menu, such as by tapping
* outside the menu's bounds
@@ -144,7 +143,6 @@
* Example usage with a [ScrollState] to control the menu items scroll position:
*
* @sample androidx.compose.material.samples.MenuWithScrollStateSample
- *
* @param expanded Whether the menu is currently open and visible to the user
* @param onDismissRequest Called when the user requests to dismiss the menu, such as by tapping
* outside the menu's bounds
@@ -243,7 +241,6 @@
* Example usage with a [ScrollState] to control the menu items scroll position:
*
* @sample androidx.compose.material.samples.MenuWithScrollStateSample
- *
* @param state The open/closed state of the menu
* @param onDismissRequest Called when the user requests to dismiss the menu, such as by tapping
* outside the menu's bounds
diff --git a/compose/material3/adaptive/adaptive-layout/src/commonMain/kotlin/androidx/compose/material3/adaptive/layout/ListDetailPaneScaffold.kt b/compose/material3/adaptive/adaptive-layout/src/commonMain/kotlin/androidx/compose/material3/adaptive/layout/ListDetailPaneScaffold.kt
index 3f8be83..0294dba 100644
--- a/compose/material3/adaptive/adaptive-layout/src/commonMain/kotlin/androidx/compose/material3/adaptive/layout/ListDetailPaneScaffold.kt
+++ b/compose/material3/adaptive/adaptive-layout/src/commonMain/kotlin/androidx/compose/material3/adaptive/layout/ListDetailPaneScaffold.kt
@@ -28,11 +28,8 @@
* See usage samples at:
*
* @sample androidx.compose.material3.adaptive.samples.ListDetailPaneScaffoldSample
- *
* @sample androidx.compose.material3.adaptive.samples.ListDetailPaneScaffoldSampleWithExtraPane
- *
* @sample androidx.compose.material3.adaptive.samples.ListDetailPaneScaffoldWithNavigationSample
- *
* @param directive The top-level directives about how the scaffold should arrange its panes.
* @param value The current adapted value of the scaffold, which indicates how each pane of the
* scaffold is adapted.
diff --git a/compose/material3/adaptive/adaptive-layout/src/commonMain/kotlin/androidx/compose/material3/adaptive/layout/Pane.kt b/compose/material3/adaptive/adaptive-layout/src/commonMain/kotlin/androidx/compose/material3/adaptive/layout/Pane.kt
index 8b16638..ea17ef7 100644
--- a/compose/material3/adaptive/adaptive-layout/src/commonMain/kotlin/androidx/compose/material3/adaptive/layout/Pane.kt
+++ b/compose/material3/adaptive/adaptive-layout/src/commonMain/kotlin/androidx/compose/material3/adaptive/layout/Pane.kt
@@ -35,7 +35,6 @@
* See usage samples at:
*
* @sample androidx.compose.material3.adaptive.samples.ListDetailPaneScaffoldSample
- *
* @sample androidx.compose.material3.adaptive.samples.ListDetailPaneScaffoldSampleWithExtraPane
*/
@ExperimentalMaterial3AdaptiveApi
diff --git a/compose/material3/material3-adaptive-navigation-suite/src/commonMain/kotlin/androidx/compose/material3/adaptive/navigationsuite/NavigationSuiteScaffold.kt b/compose/material3/material3-adaptive-navigation-suite/src/commonMain/kotlin/androidx/compose/material3/adaptive/navigationsuite/NavigationSuiteScaffold.kt
index 5693ecb..de80399 100644
--- a/compose/material3/material3-adaptive-navigation-suite/src/commonMain/kotlin/androidx/compose/material3/adaptive/navigationsuite/NavigationSuiteScaffold.kt
+++ b/compose/material3/material3-adaptive-navigation-suite/src/commonMain/kotlin/androidx/compose/material3/adaptive/navigationsuite/NavigationSuiteScaffold.kt
@@ -70,10 +70,8 @@
* Example default usage:
*
* @sample androidx.compose.material3.adaptive.navigationsuite.samples.NavigationSuiteScaffoldSample
- * Example custom configuration usage:
- *
+ * Example custom configuration usage:
* @sample androidx.compose.material3.adaptive.navigationsuite.samples.NavigationSuiteScaffoldCustomConfigSample
- *
* @param navigationSuiteItems the navigation items to be displayed
* @param modifier the [Modifier] to be applied to the navigation suite scaffold
* @param layoutType the current [NavigationSuiteType]. Defaults to
@@ -137,7 +135,6 @@
* the use of [NavigationSuiteScaffold]. Example usage:
*
* @sample androidx.compose.material3.adaptive.navigationsuite.samples.NavigationSuiteScaffoldCustomNavigationRail
- *
* @param navigationSuite the navigation component to be displayed, typically [NavigationSuite]
* @param layoutType the current [NavigationSuiteType]. Defaults to
* [NavigationSuiteScaffoldDefaults.calculateFromAdaptiveInfo]
diff --git a/compose/material3/material3-common/src/commonMain/kotlin/androidx/compose/material3/common/Icon.kt b/compose/material3/material3-common/src/commonMain/kotlin/androidx/compose/material3/common/Icon.kt
index 6cdaa93..44b3ce7 100644
--- a/compose/material3/material3-common/src/commonMain/kotlin/androidx/compose/material3/common/Icon.kt
+++ b/compose/material3/material3-common/src/commonMain/kotlin/androidx/compose/material3/common/Icon.kt
@@ -61,7 +61,6 @@
* @param modifier the [Modifier] to be applied to this icon
* @param tint tint to be applied to [imageVector]. If [Color.Unspecified] is provided, then no tint
* is applied.
- *
* @sample androidx.compose.material3.common.samples.IconSample
*/
@Composable
diff --git a/compose/material3/material3/src/androidMain/kotlin/androidx/compose/material3/DatePickerDialog.android.kt b/compose/material3/material3/src/androidMain/kotlin/androidx/compose/material3/DatePickerDialog.android.kt
index 99ed50a..877e4de 100644
--- a/compose/material3/material3/src/androidMain/kotlin/androidx/compose/material3/DatePickerDialog.android.kt
+++ b/compose/material3/material3/src/androidMain/kotlin/androidx/compose/material3/DatePickerDialog.android.kt
@@ -45,7 +45,6 @@
* A sample for displaying a [DatePicker] in a dialog:
*
* @sample androidx.compose.material3.samples.DatePickerDialogSample
- *
* @param onDismissRequest called when the user tries to dismiss the Dialog by clicking outside or
* pressing the back button. This is not called when the dismiss button is clicked.
* @param confirmButton button which is meant to confirm a proposed action, thus resolving what
diff --git a/compose/material3/material3/src/androidMain/kotlin/androidx/compose/material3/ExposedDropdownMenu.android.kt b/compose/material3/material3/src/androidMain/kotlin/androidx/compose/material3/ExposedDropdownMenu.android.kt
index 43bd4d3..a84ebd2 100644
--- a/compose/material3/material3/src/androidMain/kotlin/androidx/compose/material3/ExposedDropdownMenu.android.kt
+++ b/compose/material3/material3/src/androidMain/kotlin/androidx/compose/material3/ExposedDropdownMenu.android.kt
@@ -122,7 +122,6 @@
* An example of an editable Exposed Dropdown Menu:
*
* @sample androidx.compose.material3.samples.EditableExposedDropdownMenuSample
- *
* @param expanded whether the menu is expanded or not
* @param onExpandedChange called when the exposed dropdown menu is clicked and the expansion state
* changes.
diff --git a/compose/material3/material3/src/androidMain/kotlin/androidx/compose/material3/ModalBottomSheet.android.kt b/compose/material3/material3/src/androidMain/kotlin/androidx/compose/material3/ModalBottomSheet.android.kt
index 0699da5..bc590c2 100644
--- a/compose/material3/material3/src/androidMain/kotlin/androidx/compose/material3/ModalBottomSheet.android.kt
+++ b/compose/material3/material3/src/androidMain/kotlin/androidx/compose/material3/ModalBottomSheet.android.kt
@@ -183,7 +183,6 @@
* A simple example of a modal bottom sheet looks like this:
*
* @sample androidx.compose.material3.samples.ModalBottomSheetSample
- *
* @param onDismissRequest Executes when the user clicks outside of the bottom sheet, after sheet
* animates to [Hidden].
* @param modifier Optional [Modifier] for the bottom sheet.
diff --git a/compose/material3/material3/src/androidMain/kotlin/androidx/compose/material3/SearchBar.android.kt b/compose/material3/material3/src/androidMain/kotlin/androidx/compose/material3/SearchBar.android.kt
index 6ae99a5..aa2a781 100644
--- a/compose/material3/material3/src/androidMain/kotlin/androidx/compose/material3/SearchBar.android.kt
+++ b/compose/material3/material3/src/androidMain/kotlin/androidx/compose/material3/SearchBar.android.kt
@@ -143,7 +143,6 @@
* An example looks like:
*
* @sample androidx.compose.material3.samples.SearchBarSample
- *
* @param inputField the input field of this search bar that allows entering a query, typically a
* [SearchBarDefaults.InputField].
* @param expanded whether this search bar is expanded and showing search results.
@@ -261,7 +260,6 @@
* An example looks like:
*
* @sample androidx.compose.material3.samples.DockedSearchBarSample
- *
* @param inputField the input field of this search bar that allows entering a query, typically a
* [SearchBarDefaults.InputField].
* @param expanded whether this search bar is expanded and showing search results.
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/AlertDialog.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/AlertDialog.kt
index d727e44..6d6a123 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/AlertDialog.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/AlertDialog.kt
@@ -65,7 +65,6 @@
* Usage with a "Hero" icon:
*
* @sample androidx.compose.material3.samples.AlertDialogWithIconSample
- *
* @param onDismissRequest called when the user tries to dismiss the Dialog by clicking outside or
* pressing the back button. This is not called when the dismiss button is clicked.
* @param confirmButton button which is meant to confirm a proposed action, thus resolving what
@@ -129,7 +128,6 @@
* Basic alert dialog usage with custom content:
*
* @sample androidx.compose.material3.samples.BasicAlertDialogSample
- *
* @param onDismissRequest called when the user tries to dismiss the Dialog by clicking outside or
* pressing the back button. This is not called when the dismiss button is clicked.
* @param modifier the [Modifier] to be applied to this dialog's content.
@@ -181,7 +179,6 @@
* Basic alert dialog usage with custom content:
*
* @sample androidx.compose.material3.samples.BasicAlertDialogSample
- *
* @param onDismissRequest called when the user tries to dismiss the Dialog by clicking outside or
* pressing the back button. This is not called when the dismiss button is clicked.
* @param modifier the [Modifier] to be applied to this dialog's content.
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/AppBar.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/AppBar.kt
index a18812e..bbb5dec 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/AppBar.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/AppBar.kt
@@ -107,14 +107,11 @@
*
* A simple top app bar looks like:
*
- * @sample androidx.compose.material3.samples.SimpleTopAppBar
- * A top app bar that uses a [scrollBehavior] to customize its nested scrolling behavior when
- * working in conjunction with a scrolling content looks like:
- *
+ * @sample androidx.compose.material3.samples.SimpleTopAppBar A top app bar that uses a
+ * [scrollBehavior] to customize its nested scrolling behavior when working in conjunction with a
+ * scrolling content looks like:
* @sample androidx.compose.material3.samples.PinnedTopAppBar
- *
* @sample androidx.compose.material3.samples.EnterAlwaysTopAppBar
- *
* @param title the title to be displayed in the top app bar
* @param modifier the [Modifier] to be applied to this top app bar
* @param navigationIcon the navigation icon displayed at the start of the top app bar. This should
@@ -168,14 +165,11 @@
*
* A simple top app bar looks like:
*
- * @sample androidx.compose.material3.samples.SimpleTopAppBar
- * A top app bar that uses a [scrollBehavior] to customize its nested scrolling behavior when
- * working in conjunction with a scrolling content looks like:
- *
+ * @sample androidx.compose.material3.samples.SimpleTopAppBar A top app bar that uses a
+ * [scrollBehavior] to customize its nested scrolling behavior when working in conjunction with a
+ * scrolling content looks like:
* @sample androidx.compose.material3.samples.PinnedTopAppBar
- *
* @sample androidx.compose.material3.samples.EnterAlwaysTopAppBar
- *
* @param title the title to be displayed in the top app bar
* @param modifier the [Modifier] to be applied to this top app bar
* @param navigationIcon the navigation icon displayed at the start of the top app bar. This should
@@ -241,7 +235,6 @@
* behavior when working in conjunction with a scrolling content looks like:
*
* @sample androidx.compose.material3.samples.SimpleCenterAlignedTopAppBar
- *
* @param title the title to be displayed in the top app bar
* @param modifier the [Modifier] to be applied to this top app bar
* @param navigationIcon the navigation icon displayed at the start of the top app bar. This should
@@ -299,7 +292,6 @@
* behavior when working in conjunction with a scrolling content looks like:
*
* @sample androidx.compose.material3.samples.SimpleCenterAlignedTopAppBar
- *
* @param title the title to be displayed in the top app bar
* @param modifier the [Modifier] to be applied to this top app bar
* @param navigationIcon the navigation icon displayed at the start of the top app bar. This should
@@ -364,7 +356,6 @@
* working in conjunction with scrolling content looks like:
*
* @sample androidx.compose.material3.samples.ExitUntilCollapsedMediumTopAppBar
- *
* @param title the title to be displayed in the top app bar. This title will be used in the app
* bar's expanded and collapsed states, although in its collapsed state it will be composed with a
* smaller sized [TextStyle]
@@ -426,7 +417,6 @@
* working in conjunction with scrolling content looks like:
*
* @sample androidx.compose.material3.samples.ExitUntilCollapsedMediumTopAppBar
- *
* @param title the title to be displayed in the top app bar. This title will be used in the app
* bar's expanded and collapsed states, although in its collapsed state it will be composed with a
* smaller sized [TextStyle]
@@ -509,7 +499,6 @@
* working in conjunction with scrolling content looks like:
*
* @sample androidx.compose.material3.samples.ExitUntilCollapsedLargeTopAppBar
- *
* @param title the title to be displayed in the top app bar. This title will be used in the app
* bar's expanded and collapsed states, although in its collapsed state it will be composed with a
* smaller sized [TextStyle]
@@ -571,7 +560,6 @@
* working in conjunction with scrolling content looks like:
*
* @sample androidx.compose.material3.samples.ExitUntilCollapsedLargeTopAppBar
- *
* @param title the title to be displayed in the top app bar. This title will be used in the app
* bar's expanded and collapsed states, although in its collapsed state it will be composed with a
* smaller sized [TextStyle]
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Badge.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Badge.kt
index 89b45e8..07fe812 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Badge.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Badge.kt
@@ -60,7 +60,6 @@
* A simple icon with badge example looks like:
*
* @sample androidx.compose.material3.samples.NavigationBarItemWithBadge
- *
* @param badge the badge to be displayed - typically a [Badge]
* @param modifier the [Modifier] to be applied to this BadgedBox
* @param content the anchor to which this badge will be positioned
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/BottomSheetScaffold.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/BottomSheetScaffold.kt
index d393bef..a8c9b1e 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/BottomSheetScaffold.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/BottomSheetScaffold.kt
@@ -73,7 +73,6 @@
* A simple example of a standard bottom sheet looks like this:
*
* @sample androidx.compose.material3.samples.SimpleBottomSheetScaffoldSample
- *
* @param sheetContent the content of the bottom sheet
* @param modifier the [Modifier] to be applied to this scaffold
* @param scaffoldState the state of the bottom sheet scaffold
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Button.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Button.kt
index be50be9..f19fa1b 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Button.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Button.kt
@@ -72,7 +72,6 @@
* like "Save", "Join now", or "Confirm".
*
* @sample androidx.compose.material3.samples.ButtonSample
- *
* @sample androidx.compose.material3.samples.ButtonWithIconSample
*
* Choose the best button for an action based on the amount of emphasis it needs. The more important
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Card.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Card.kt
index 10cdb88..a68ec5a 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Card.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Card.kt
@@ -65,7 +65,6 @@
* Card sample:
*
* @sample androidx.compose.material3.samples.CardSample
- *
* @param modifier the [Modifier] to be applied to this card
* @param shape defines the shape of this card's container, border (when [border] is not null), and
* shadow (when using [elevation])
@@ -114,7 +113,6 @@
* Clickable card sample:
*
* @sample androidx.compose.material3.samples.ClickableCardSample
- *
* @param onClick called when this card is clicked
* @param modifier the [Modifier] to be applied to this card
* @param enabled controls the enabled state of this card. When `false`, this component will not
@@ -180,7 +178,6 @@
* Elevated card sample:
*
* @sample androidx.compose.material3.samples.ElevatedCardSample
- *
* @param modifier the [Modifier] to be applied to this card
* @param shape defines the shape of this card's container and shadow (when using [elevation])
* @param colors [CardColors] that will be used to resolve the color(s) used for this card in
@@ -223,7 +220,6 @@
* Clickable elevated card sample:
*
* @sample androidx.compose.material3.samples.ClickableElevatedCardSample
- *
* @param onClick called when this card is clicked
* @param modifier the [Modifier] to be applied to this card
* @param enabled controls the enabled state of this card. When `false`, this component will not
@@ -280,7 +276,6 @@
* Outlined card sample:
*
* @sample androidx.compose.material3.samples.OutlinedCardSample
- *
* @param modifier the [Modifier] to be applied to this card
* @param shape defines the shape of this card's container, border (when [border] is not null), and
* shadow (when using [elevation])
@@ -325,7 +320,6 @@
* Clickable outlined card sample:
*
* @sample androidx.compose.material3.samples.ClickableOutlinedCardSample
- *
* @param onClick called when this card is clicked
* @param modifier the [Modifier] to be applied to this card
* @param enabled controls the enabled state of this card. When `false`, this component will not
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Checkbox.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Checkbox.kt
index ffbdf52..6225b59 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Checkbox.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Checkbox.kt
@@ -72,7 +72,6 @@
* Combined Checkbox with Text sample:
*
* @sample androidx.compose.material3.samples.CheckboxWithTextSample
- *
* @param checked whether this checkbox is checked or unchecked
* @param onCheckedChange called when this checkbox is clicked. If `null`, then this checkbox will
* not be interactable, unless something else handles its input events and updates its state.
@@ -125,7 +124,6 @@
* image](https://developer.android.com/images/reference/androidx/compose/material3/indeterminate-checkbox.png)
*
* @sample androidx.compose.material3.samples.TriStateCheckboxSample
- *
* @param state whether this checkbox is checked, unchecked, or in an indeterminate state
* @param onClick called when this checkbox is clicked. If `null`, then this checkbox will not be
* interactable, unless something else handles its input events and updates its [state].
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Chip.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Chip.kt
index 7af3a46..2476954 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Chip.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Chip.kt
@@ -92,7 +92,6 @@
* Example of a flat AssistChip:
*
* @sample androidx.compose.material3.samples.AssistChipSample
- *
* @param onClick called when this chip is clicked
* @param label text label for this chip
* @param modifier the [Modifier] to be applied to this chip
@@ -169,7 +168,6 @@
* Example of a flat AssistChip:
*
* @sample androidx.compose.material3.samples.AssistChipSample
- *
* @param onClick called when this chip is clicked
* @param label text label for this chip
* @param modifier the [Modifier] to be applied to this chip
@@ -256,7 +254,6 @@
* Example of an elevated AssistChip with a trailing icon:
*
* @sample androidx.compose.material3.samples.ElevatedAssistChipSample
- *
* @param onClick called when this chip is clicked
* @param label text label for this chip
* @param modifier the [Modifier] to be applied to this chip
@@ -332,7 +329,6 @@
* Example of an elevated AssistChip with a trailing icon:
*
* @sample androidx.compose.material3.samples.ElevatedAssistChipSample
- *
* @param onClick called when this chip is clicked
* @param label text label for this chip
* @param modifier the [Modifier] to be applied to this chip
@@ -424,7 +420,6 @@
* Example of a FilterChip with both a leading icon and a selected icon:
*
* @sample androidx.compose.material3.samples.FilterChipWithLeadingIconSample
- *
* @param selected whether this chip is selected or not
* @param onClick called when this chip is clicked
* @param label text label for this chip
@@ -508,7 +503,6 @@
* Example of an elevated FilterChip with a trailing icon:
*
* @sample androidx.compose.material3.samples.ElevatedFilterChipSample
- *
* @param selected whether this chip is selected or not
* @param onClick called when this chip is clicked
* @param label text label for this chip
@@ -600,7 +594,6 @@
* Alternatively, use [androidx.compose.foundation.layout.FlowRow] to wrap chips to a new line.
*
* @sample androidx.compose.material3.samples.ChipGroupReflowSample
- *
* @param selected whether this chip is selected or not
* @param onClick called when this chip is clicked
* @param label text label for this chip
@@ -708,7 +701,6 @@
* Example of a flat SuggestionChip with a trailing icon:
*
* @sample androidx.compose.material3.samples.SuggestionChipSample
- *
* @param onClick called when this chip is clicked
* @param label text label for this chip
* @param modifier the [Modifier] to be applied to this chip
@@ -782,7 +774,6 @@
* Example of a flat SuggestionChip with a trailing icon:
*
* @sample androidx.compose.material3.samples.SuggestionChipSample
- *
* @param onClick called when this chip is clicked
* @param label text label for this chip
* @param modifier the [Modifier] to be applied to this chip
@@ -866,7 +857,6 @@
* Example of an elevated SuggestionChip with a trailing icon:
*
* @sample androidx.compose.material3.samples.ElevatedSuggestionChipSample
- *
* @param onClick called when this chip is clicked
* @param label text label for this chip
* @param modifier the [Modifier] to be applied to this chip
@@ -939,7 +929,6 @@
* Example of an elevated SuggestionChip with a trailing icon:
*
* @sample androidx.compose.material3.samples.ElevatedSuggestionChipSample
- *
* @param onClick called when this chip is clicked
* @param label text label for this chip
* @param modifier the [Modifier] to be applied to this chip
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/DatePicker.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/DatePicker.kt
index a86add6..c833694 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/DatePicker.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/DatePicker.kt
@@ -153,7 +153,6 @@
* like:
*
* @sample androidx.compose.material3.samples.DatePickerWithDateSelectableDatesSample
- *
* @param state state of the date picker. See [rememberDatePickerState].
* @param modifier the [Modifier] to be applied to this date picker
* @param dateFormatter a [DatePickerFormatter] that provides formatting skeletons for dates display
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/DateRangePicker.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/DateRangePicker.kt
index 8855357..01bc36c 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/DateRangePicker.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/DateRangePicker.kt
@@ -77,7 +77,6 @@
* A simple DateRangePicker looks like:
*
* @sample androidx.compose.material3.samples.DateRangePickerSample
- *
* @param state state of the date range picker. See [rememberDateRangePickerState].
* @param modifier the [Modifier] to be applied to this date range picker
* @param dateFormatter a [DatePickerFormatter] that provides formatting skeletons for dates display
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/FloatingActionButton.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/FloatingActionButton.kt
index 5b9c780..9fc92ad 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/FloatingActionButton.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/FloatingActionButton.kt
@@ -75,7 +75,6 @@
* [ExtendedFloatingActionButton].
*
* @sample androidx.compose.material3.samples.FloatingActionButtonSample
- *
* @param onClick called when this FAB is clicked
* @param modifier the [Modifier] to be applied to this FAB
* @param shape defines the shape of this FAB's container and shadow (when using [elevation])
@@ -145,7 +144,6 @@
* image](https://developer.android.com/images/reference/androidx/compose/material3/small-fab.png)
*
* @sample androidx.compose.material3.samples.SmallFloatingActionButtonSample
- *
* @param onClick called when this FAB is clicked
* @param modifier the [Modifier] to be applied to this FAB
* @param shape defines the shape of this FAB's container and shadow (when using [elevation])
@@ -201,7 +199,6 @@
* image](https://developer.android.com/images/reference/androidx/compose/material3/large-fab.png)
*
* @sample androidx.compose.material3.samples.LargeFloatingActionButtonSample
- *
* @param onClick called when this FAB is clicked
* @param modifier the [Modifier] to be applied to this FAB
* @param shape defines the shape of this FAB's container and shadow (when using [elevation])
@@ -260,7 +257,6 @@
* The other extended floating action button overload supports a text label and icon.
*
* @sample androidx.compose.material3.samples.ExtendedFloatingActionButtonTextSample
- *
* @param onClick called when this FAB is clicked
* @param modifier the [Modifier] to be applied to this FAB
* @param shape defines the shape of this FAB's container and shadow (when using [elevation])
@@ -326,9 +322,7 @@
* behavior, you can provide your own via [Modifier.semantics].
*
* @sample androidx.compose.material3.samples.ExtendedFloatingActionButtonSample
- *
* @sample androidx.compose.material3.samples.AnimatedExtendedFloatingActionButtonSample
- *
* @param text label displayed inside this FAB
* @param icon optional icon for this FAB, typically an [Icon]
* @param onClick called when this FAB is clicked
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/IconButton.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/IconButton.kt
index e9969ad..876ae34 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/IconButton.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/IconButton.kt
@@ -60,11 +60,8 @@
*
* Simple Usage
*
- * @sample androidx.compose.material3.samples.IconButtonSample
- * IconButton with a color tint
- *
+ * @sample androidx.compose.material3.samples.IconButtonSample IconButton with a color tint
* @sample androidx.compose.material3.samples.TintedIconButtonSample
- *
* @param onClick called when this icon button is clicked
* @param modifier the [Modifier] to be applied to this icon button
* @param enabled controls the enabled state of this icon button. When `false`, this component will
@@ -127,7 +124,6 @@
* an overall minimum touch target size of 48 x 48dp, to meet accessibility guidelines.
*
* @sample androidx.compose.material3.samples.IconToggleButtonSample
- *
* @param checked whether this icon button is toggled on or off
* @param onCheckedChange called when this icon button is clicked
* @param modifier the [Modifier] to be applied to this icon button
@@ -195,7 +191,6 @@
* Filled icon button sample:
*
* @sample androidx.compose.material3.samples.FilledIconButtonSample
- *
* @param onClick called when this icon button is clicked
* @param modifier the [Modifier] to be applied to this icon button
* @param enabled controls the enabled state of this icon button. When `false`, this component will
@@ -262,7 +257,6 @@
* Filled tonal icon button sample:
*
* @sample androidx.compose.material3.samples.FilledTonalIconButtonSample
- *
* @param onClick called when this icon button is clicked
* @param modifier the [Modifier] to be applied to this icon button
* @param enabled controls the enabled state of this icon button. When `false`, this component will
@@ -325,7 +319,6 @@
* Toggleable filled icon button sample:
*
* @sample androidx.compose.material3.samples.FilledIconToggleButtonSample
- *
* @param checked whether this icon button is toggled on or off
* @param onCheckedChange called when this icon button is clicked
* @param modifier the [Modifier] to be applied to this icon button
@@ -396,7 +389,6 @@
* Toggleable filled tonal icon button sample:
*
* @sample androidx.compose.material3.samples.FilledTonalIconToggleButtonSample
- *
* @param checked whether this icon button is toggled on or off
* @param onCheckedChange called when this icon button is clicked
* @param modifier the [Modifier] to be applied to this icon button
@@ -466,7 +458,6 @@
* button has an overall minimum touch target size of 48 x 48dp, to meet accessibility guidelines.
*
* @sample androidx.compose.material3.samples.OutlinedIconButtonSample
- *
* @param onClick called when this icon button is clicked
* @param modifier the [Modifier] to be applied to this icon button
* @param enabled controls the enabled state of this icon button. When `false`, this component will
@@ -528,7 +519,6 @@
* an overall minimum touch target size of 48 x 48dp, to meet accessibility guidelines.
*
* @sample androidx.compose.material3.samples.OutlinedIconToggleButtonSample
- *
* @param checked whether this icon button is toggled on or off
* @param onCheckedChange called when this icon button is clicked
* @param modifier the [Modifier] to be applied to this icon button
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Label.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Label.kt
index 1487bc2..27ac94b 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Label.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Label.kt
@@ -50,7 +50,6 @@
* Label appended to thumbs of RangeSlider:
*
* @sample androidx.compose.material3.samples.RangeSliderWithCustomComponents
- *
* @param label composable that will be appended to [content]
* @param modifier [Modifier] that will be applied to [content]
* @param interactionSource the [MutableInteractionSource] representing the stream of [Interaction]s
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/ListItem.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/ListItem.kt
index 03e5327..a5f8ac9 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/ListItem.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/ListItem.kt
@@ -78,7 +78,6 @@
* - three-line item with extended supporting content
*
* @sample androidx.compose.material3.samples.ThreeLineListItemWithExtendedSupporting
- *
* @param headlineContent the headline content of the list item
* @param modifier [Modifier] to be applied to the list item
* @param overlineContent the content displayed above the headline content
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/MaterialTheme.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/MaterialTheme.kt
index 43c1bfa..7d84cbd 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/MaterialTheme.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/MaterialTheme.kt
@@ -42,7 +42,6 @@
* overriding only the parts of the theme definition that need to change.
*
* @sample androidx.compose.material3.samples.MaterialThemeSample
- *
* @param colorScheme A complete definition of the Material Color theme for this hierarchy
* @param typography A set of text styles to be used as this hierarchy's typography system
* @param shapes A set of corner shapes to be used as this hierarchy's shape system
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Menu.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Menu.kt
index e6b6f61..186a033 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Menu.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Menu.kt
@@ -104,7 +104,6 @@
* Example usage with a [ScrollState] to control the menu items scroll position:
*
* @sample androidx.compose.material3.samples.MenuWithScrollStateSample
- *
* @param expanded whether the menu is expanded or not
* @param onDismissRequest called when the user requests to dismiss the menu, such as by tapping
* outside the menu's bounds
@@ -151,7 +150,6 @@
* Example usage:
*
* @sample androidx.compose.material3.samples.MenuSample
- *
* @param text text of the menu item
* @param onClick called when this menu item is clicked
* @param modifier the [Modifier] to be applied to this menu item
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/ModalBottomSheet.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/ModalBottomSheet.kt
index 539e5c5..79c2f0d 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/ModalBottomSheet.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/ModalBottomSheet.kt
@@ -89,7 +89,6 @@
* A simple example of a modal bottom sheet looks like this:
*
* @sample androidx.compose.material3.samples.ModalBottomSheetSample
- *
* @param onDismissRequest Executes when the user clicks outside of the bottom sheet, after sheet
* animates to [Hidden].
* @param modifier Optional [Modifier] for the bottom sheet.
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/NavigationDrawer.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/NavigationDrawer.kt
index 5dfbe49..8cd11f2 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/NavigationDrawer.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/NavigationDrawer.kt
@@ -302,7 +302,6 @@
* image](https://developer.android.com/images/reference/androidx/compose/material3/navigation-drawer.png)
*
* @sample androidx.compose.material3.samples.ModalNavigationDrawerSample
- *
* @param drawerContent content inside this drawer
* @param modifier the [Modifier] to be applied to this drawer
* @param drawerState state of the drawer
@@ -421,7 +420,6 @@
* visible navigation menu icon to open and close the drawer.
*
* @sample androidx.compose.material3.samples.DismissibleNavigationDrawerSample
- *
* @param drawerContent content inside this drawer
* @param modifier the [Modifier] to be applied to this drawer
* @param drawerState state of the drawer
@@ -519,7 +517,6 @@
* destinations. On mobile screens, use [ModalNavigationDrawer] instead.
*
* @sample androidx.compose.material3.samples.PermanentNavigationDrawerSample
- *
* @param drawerContent content inside this drawer
* @param modifier the [Modifier] to be applied to this drawer
* @param content content of the rest of the UI
@@ -901,7 +898,6 @@
* [PermanentNavigationDrawer] or [DismissibleNavigationDrawer].
*
* @sample androidx.compose.material3.samples.ModalNavigationDrawerSample
- *
* @param label text label for this item
* @param selected whether this item is selected
* @param onClick called when this item is clicked
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/ProgressIndicator.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/ProgressIndicator.kt
index e93ebb20..7e8e904 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/ProgressIndicator.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/ProgressIndicator.kt
@@ -69,7 +69,6 @@
* animating progress, such as in the following example:
*
* @sample androidx.compose.material3.samples.LinearProgressIndicatorSample
- *
* @param progress the progress of this progress indicator, where 0.0 represents no progress and 1.0
* represents full progress. Values outside of this range are coerced into the range.
* @param modifier the [Modifier] to be applied to this progress indicator
@@ -122,7 +121,6 @@
* animating progress, such as in the following example:
*
* @sample androidx.compose.material3.samples.LinearProgressIndicatorSample
- *
* @param progress the progress of this progress indicator, where 0.0 represents no progress and 1.0
* represents full progress. Values outside of this range are coerced into the range.
* @param modifier the [Modifier] to be applied to this progress indicator
@@ -193,7 +191,6 @@
* image](https://firebasestorage.googleapis.com/v0/b/design-spec/o/projects%2Fgoogle-material-3%2Fimages%2Flqdiyyvh-1P-progress-indicator-configurations.png?alt=media)
*
* @sample androidx.compose.material3.samples.IndeterminateLinearProgressIndicatorSample
- *
* @param modifier the [Modifier] to be applied to this progress indicator
* @param color color of this progress indicator
* @param trackColor color of the track behind the indicator, visible when the progress has not
@@ -235,7 +232,6 @@
* image](https://firebasestorage.googleapis.com/v0/b/design-spec/o/projects%2Fgoogle-material-3%2Fimages%2Flqdiyyvh-1P-progress-indicator-configurations.png?alt=media)
*
* @sample androidx.compose.material3.samples.IndeterminateLinearProgressIndicatorSample
- *
* @param modifier the [Modifier] to be applied to this progress indicator
* @param color color of this progress indicator
* @param trackColor color of the track behind the indicator, visible when the progress has not
@@ -501,7 +497,6 @@
* animating progress, such as in the following example:
*
* @sample androidx.compose.material3.samples.CircularProgressIndicatorSample
- *
* @param progress the progress of this progress indicator, where 0.0 represents no progress and 1.0
* represents full progress. Values outside of this range are coerced into the range.
* @param modifier the [Modifier] to be applied to this progress indicator
@@ -557,7 +552,6 @@
* animating progress, such as in the following example:
*
* @sample androidx.compose.material3.samples.CircularProgressIndicatorSample
- *
* @param progress the progress of this progress indicator, where 0.0 represents no progress and 1.0
* represents full progress. Values outside of this range are coerced into the range.
* @param modifier the [Modifier] to be applied to this progress indicator
@@ -620,7 +614,6 @@
* image](https://firebasestorage.googleapis.com/v0/b/design-spec/o/projects%2Fgoogle-material-3%2Fimages%2Flqdiyyvh-1P-progress-indicator-configurations.png?alt=media)
*
* @sample androidx.compose.material3.samples.IndeterminateCircularProgressIndicatorSample
- *
* @param modifier the [Modifier] to be applied to this progress indicator
* @param color color of this progress indicator
* @param strokeWidth stroke width of this progress indicator
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/RadioButton.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/RadioButton.kt
index faf9bad..350de4b 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/RadioButton.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/RadioButton.kt
@@ -57,7 +57,6 @@
* [Row]) to achieve radio group-like behaviour, where the entire layout is selectable:
*
* @sample androidx.compose.material3.samples.RadioGroupSample
- *
* @param selected whether this radio button is selected or not
* @param onClick called when this radio button is clicked. If `null`, then this radio button will
* not be interactable, unless something else handles its input events and updates its state.
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Scaffold.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Scaffold.kt
index b5e55a3..f204d33 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Scaffold.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Scaffold.kt
@@ -57,7 +57,6 @@
* To show a [Snackbar], use [SnackbarHostState.showSnackbar].
*
* @sample androidx.compose.material3.samples.ScaffoldWithSimpleSnackbar
- *
* @param modifier the [Modifier] to be applied to this scaffold
* @param topBar top app bar of the screen, typically a [SmallTopAppBar]
* @param bottomBar bottom bar of the screen, typically a [NavigationBar]
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/SegmentedButton.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/SegmentedButton.kt
index 7df16c6..178a5b7 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/SegmentedButton.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/SegmentedButton.kt
@@ -104,7 +104,6 @@
* For a sample showing Segmented button with only checked icons see:
*
* @sample androidx.compose.material3.samples.SegmentedButtonMultiSelectSample
- *
* @param checked whether this button is checked or not
* @param onCheckedChange callback to be invoked when the button is clicked. therefore the change of
* checked state in requested.
@@ -182,7 +181,6 @@
* For a sample showing Segmented button with only checked icons see:
*
* @sample androidx.compose.material3.samples.SegmentedButtonSingleSelectSample
- *
* @param selected whether this button is selected or not
* @param onClick callback to be invoked when the button is clicked. therefore the change of checked
* state in requested.
@@ -254,7 +252,6 @@
* is used when the selection only allows one value, for correct semantics.
*
* @sample androidx.compose.material3.samples.SegmentedButtonSingleSelectSample
- *
* @param modifier the [Modifier] to be applied to this row
* @param space the dimension of the overlap between buttons. Should be equal to the stroke width
* used on the items.
@@ -292,7 +289,6 @@
* semantics.
*
* @sample androidx.compose.material3.samples.SegmentedButtonMultiSelectSample
- *
* @param modifier the [Modifier] to be applied to this row
* @param space the dimension of the overlap between buttons. Should be equal to the stroke width
* used on the items.
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Slider.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Slider.kt
index 03e903e..02fe5f1 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Slider.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Slider.kt
@@ -132,7 +132,6 @@
* of steps between min and max values:
*
* @sample androidx.compose.material3.samples.StepsSliderSample
- *
* @param value current value of the slider. If outside of [valueRange] provided, value will be
* coerced to this range.
* @param onValueChange callback in which value should be updated
@@ -219,7 +218,6 @@
* Slider using custom track and thumb:
*
* @sample androidx.compose.material3.samples.SliderWithCustomTrackAndThumb
- *
* @param value current value of the slider. If outside of [valueRange] provided, value will be
* coerced to this range.
* @param onValueChange callback in which value should be updated
@@ -314,7 +312,6 @@
* Slider using custom track and thumb:
*
* @sample androidx.compose.material3.samples.SliderWithCustomTrackAndThumb
- *
* @param state [SliderState] which contains the slider's current value.
* @param modifier the [Modifier] to be applied to this slider
* @param enabled controls the enabled state of this slider. When `false`, this component will not
@@ -378,7 +375,6 @@
* of steps between min and max values:
*
* @sample androidx.compose.material3.samples.StepRangeSliderSample
- *
* @param value current values of the RangeSlider. If either value is outside of [valueRange]
* provided, it will be coerced to this range.
* @param onValueChange lambda in which values should be updated
@@ -470,7 +466,6 @@
* A custom start/end thumb and track can be provided:
*
* @sample androidx.compose.material3.samples.RangeSliderWithCustomComponents
- *
* @param value current values of the RangeSlider. If either value is outside of [valueRange]
* provided, it will be coerced to this range.
* @param onValueChange lambda in which values should be updated
@@ -588,7 +583,6 @@
* A custom start/end thumb and track can be provided:
*
* @sample androidx.compose.material3.samples.RangeSliderWithCustomComponents
- *
* @param state [RangeSliderState] which contains the current values of the RangeSlider.
* @param modifier modifiers for the Range Slider layout
* @param enabled whether or not component is enabled and can we interacted with or not
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Snackbar.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Snackbar.kt
index 31f5a6c..06b06b7 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Snackbar.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Snackbar.kt
@@ -78,7 +78,6 @@
* For a multiline sample following the Material recommended spec of a maximum of 2 lines, see:
*
* @sample androidx.compose.material3.samples.ScaffoldWithMultilineSnackbar
- *
* @param modifier the [Modifier] to be applied to this snackbar
* @param action action / button component to add as an action to the snackbar. Consider using
* [ColorScheme.inversePrimary] as the color for the action, if you do not have a predefined color
@@ -183,7 +182,6 @@
* [SnackbarVisuals.withDismissAction]:
*
* @sample androidx.compose.material3.samples.ScaffoldWithIndefiniteSnackbar
- *
* @param snackbarData data about the current snackbar showing via [SnackbarHostState]
* @param modifier the [Modifier] to be applied to this snackbar
* @param actionOnNewLine whether or not action should be put on a separate line. Recommended for
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/SnackbarHost.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/SnackbarHost.kt
index 6d75627..2025643 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/SnackbarHost.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/SnackbarHost.kt
@@ -117,7 +117,6 @@
* All of this allows for granular control over the snackbar queue from within:
*
* @sample androidx.compose.material3.samples.ScaffoldWithCustomSnackbar
- *
* @param visuals [SnackbarVisuals] that are used to create a Snackbar
* @return [SnackbarResult.ActionPerformed] if option action has been clicked or
* [SnackbarResult.Dismissed] if snackbar has been dismissed via timeout or by the user
@@ -208,7 +207,6 @@
* of the [SnackbarHost] to the [Scaffold]:
*
* @sample androidx.compose.material3.samples.ScaffoldWithCustomSnackbar
- *
* @param hostState state of this component to read and show [Snackbar]s accordingly
* @param modifier the [Modifier] to be applied to this component
* @param snackbar the instance of the [Snackbar] to be shown at the appropriate time with
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Surface.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Surface.kt
index 9e3addf..ecb9e9fd 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Surface.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Surface.kt
@@ -74,7 +74,6 @@
* Surface sample:
*
* @sample androidx.compose.material3.samples.SurfaceSample
- *
* @param modifier Modifier to be applied to the layout corresponding to the surface
* @param shape Defines the surface's shape as well its shadow.
* @param color The background color. Use [Color.Transparent] to have no color.
@@ -166,7 +165,6 @@
* Clickable surface sample:
*
* @sample androidx.compose.material3.samples.ClickableSurfaceSample
- *
* @param onClick callback to be called when the surface is clicked
* @param modifier Modifier to be applied to the layout corresponding to the surface
* @param enabled Controls the enabled state of the surface. When `false`, this surface will not be
@@ -267,7 +265,6 @@
* Selectable surface sample:
*
* @sample androidx.compose.material3.samples.SelectableSurfaceSample
- *
* @param selected whether or not this Surface is selected
* @param onClick callback to be called when the surface is clicked
* @param modifier Modifier to be applied to the layout corresponding to the surface
@@ -371,7 +368,6 @@
* Toggleable surface sample:
*
* @sample androidx.compose.material3.samples.ToggleableSurfaceSample
- *
* @param checked whether or not this Surface is toggled on or off
* @param onCheckedChange callback to be invoked when the toggleable Surface is clicked
* @param modifier Modifier to be applied to the layout corresponding to the surface
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/SwipeToDismissBox.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/SwipeToDismissBox.kt
index 95bbbee..87406b4 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/SwipeToDismissBox.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/SwipeToDismissBox.kt
@@ -202,7 +202,6 @@
* A composable that can be dismissed by swiping left or right.
*
* @sample androidx.compose.material3.samples.SwipeToDismissListItems
- *
* @param state The state of this component.
* @param backgroundContent A composable that is stacked behind the [content] and is exposed when
* the content is swiped. You can/should use the [state] to have different backgrounds on each
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Switch.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Switch.kt
index 33fca06..756fc5d 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Switch.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Switch.kt
@@ -70,7 +70,6 @@
* Switch can be used with a custom icon via [thumbContent] parameter
*
* @sample androidx.compose.material3.samples.SwitchWithThumbIconSample
- *
* @param checked whether or not this switch is checked
* @param onCheckedChange called when this switch is clicked. If `null`, then this switch will not
* be interactable, unless something else handles its input events and updates its state.
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Tab.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Tab.kt
index 3e7de14..05eb5ad 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Tab.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Tab.kt
@@ -214,7 +214,6 @@
* A custom tab using this API may look like:
*
* @sample androidx.compose.material3.samples.FancyTab
- *
* @param selected whether this tab is selected or not
* @param onClick called when this tab is clicked
* @param modifier the [Modifier] to be applied to this tab
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/TabRow.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/TabRow.kt
index 70aca2d..f6b5f03 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/TabRow.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/TabRow.kt
@@ -130,7 +130,6 @@
* We can now just pass this indicator directly to TabRow:
*
* @sample androidx.compose.material3.samples.FancyIndicatorContainerTabs
- *
* @param selectedTabIndex the index of the currently selected tab
* @param modifier the [Modifier] to be applied to this tab row
* @param containerColor the color used for the background of this tab row. Use [Color.Transparent]
@@ -182,7 +181,6 @@
* A simple example with text tabs looks like:
*
* @sample androidx.compose.material3.samples.SecondaryTextTabs
- *
* @param selectedTabIndex the index of the currently selected tab
* @param modifier the [Modifier] to be applied to this tab row
* @param containerColor the color used for the background of this tab row. Use [Color.Transparent]
@@ -277,7 +275,6 @@
* We can now just pass this indicator directly to TabRow:
*
* @sample androidx.compose.material3.samples.FancyIndicatorContainerTabs
- *
* @param selectedTabIndex the index of the currently selected tab
* @param modifier the [Modifier] to be applied to this tab row
* @param containerColor the color used for the background of this tab row. Use [Color.Transparent]
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Text.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Text.kt
index fe0f83c..94fabde 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Text.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Text.kt
@@ -198,7 +198,6 @@
* See an example of displaying text with links where links apply the styling from the theme:
*
* @sample androidx.compose.material3.samples.TextWithLinks
- *
* @param text the text to be displayed
* @param modifier the [Modifier] to be applied to this layout node
* @param color [Color] to apply to the text. If [Color.Unspecified], and [style] has no color set,
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/TextFieldDefaults.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/TextFieldDefaults.kt
index e07731f..a7f4fb3 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/TextFieldDefaults.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/TextFieldDefaults.kt
@@ -194,7 +194,6 @@
* An example of building a custom text field using [DecorationBox]:
*
* @sample androidx.compose.material3.samples.CustomTextFieldBasedOnDecorationBox
- *
* @param value the input [String] shown by the text field
* @param innerTextField input text field that this decoration box wraps. You will pass here a
* framework-controlled composable parameter "innerTextField" from the decorationBox lambda of
@@ -811,7 +810,6 @@
* An example of building a custom text field using [DecorationBox]:
*
* @sample androidx.compose.material3.samples.CustomOutlinedTextFieldBasedOnDecorationBox
- *
* @param value the input [String] shown by the text field
* @param innerTextField input text field that this decoration box wraps. You will pass here a
* framework-controlled composable parameter "innerTextField" from the decorationBox lambda of
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/TimePicker.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/TimePicker.kt
index 40a23ec..cb515cc 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/TimePicker.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/TimePicker.kt
@@ -197,7 +197,6 @@
* image](https://developer.android.com/images/reference/androidx/compose/material3/time-picker.png)
*
* @sample androidx.compose.material3.samples.TimePickerSample
- *
* @sample androidx.compose.material3.samples.TimePickerSwitchableSample
*
* [state] state for this timepicker, allows to subscribe to changes to [TimePickerState.hour] and
@@ -245,7 +244,6 @@
* and one for hours Subscribe to updates through [TimePickerState]
*
* @sample androidx.compose.material3.samples.TimeInputSample
- *
* @param state state for this timepicker, allows to subscribe to changes to [TimePickerState.hour]
* and [TimePickerState.minute], and set the initial time for this picker.
* @param modifier the [Modifier] to be applied to this time input
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Tooltip.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Tooltip.kt
index f4e12ac..9ae181a 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Tooltip.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/Tooltip.kt
@@ -104,7 +104,6 @@
* Rich tooltip shown on long press with a custom caret
*
* @sample androidx.compose.material3.samples.RichTooltipWithCustomCaretSample
- *
* @param positionProvider [PopupPositionProvider] that will be used to place the tooltip relative
* to the anchor content.
* @param tooltip the composable that will be used to populate the tooltip's content.
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/carousel/Carousel.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/carousel/Carousel.kt
index 0bd44ad..9a0ac735 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/carousel/Carousel.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/carousel/Carousel.kt
@@ -75,7 +75,6 @@
* Example of a multi-browse carousel:
*
* @sample androidx.compose.material3.samples.HorizontalMultiBrowseCarouselSample
- *
* @param state The state object to be used to control the carousel's state
* @param preferredItemWidth The width that large, fully visible items would like to be in the
* horizontal axis. This width is a target and will likely be adjusted by carousel in order to fit
@@ -155,7 +154,6 @@
* Example of an uncontained carousel:
*
* @sample androidx.compose.material3.samples.HorizontalUncontainedCarouselSample
- *
* @param state The state object to be used to control the carousel's state
* @param itemWidth The width of items in the carousel
* @param modifier A modifier instance to be applied to this carousel container
diff --git a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/pulltorefresh/PullToRefresh.kt b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/pulltorefresh/PullToRefresh.kt
index d2c2de3..1ec27e6 100644
--- a/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/pulltorefresh/PullToRefresh.kt
+++ b/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/pulltorefresh/PullToRefresh.kt
@@ -104,7 +104,6 @@
* Scaling behavior can be implemented like this
*
* @sample androidx.compose.material3.samples.PullToRefreshScalingSample
- *
* @param isRefreshing whether a refresh is occurring
* @param onRefresh callback invoked when the user gesture crosses the threshold, thereby requesting
* a refresh.
diff --git a/compose/runtime/runtime-rxjava2/src/main/java/androidx/compose/runtime/rxjava2/RxJava2Adapter.kt b/compose/runtime/runtime-rxjava2/src/main/java/androidx/compose/runtime/rxjava2/RxJava2Adapter.kt
index 52fb78e..e85cbce 100644
--- a/compose/runtime/runtime-rxjava2/src/main/java/androidx/compose/runtime/rxjava2/RxJava2Adapter.kt
+++ b/compose/runtime/runtime-rxjava2/src/main/java/androidx/compose/runtime/rxjava2/RxJava2Adapter.kt
@@ -41,7 +41,6 @@
* or [Observable.onErrorResumeNext].
*
* @sample androidx.compose.runtime.rxjava2.samples.ObservableSample
- *
* @param initial The initial value for the returned [State] which will be asynchronously updated
* with the real one once we receive it from the stream
*/
@@ -61,7 +60,6 @@
* [Flowable.onErrorResumeNext].
*
* @sample androidx.compose.runtime.rxjava2.samples.FlowableSample
- *
* @param initial The initial value for the returned [State] which will be asynchronously updated
* with the real one once we receive it from the stream
*/
@@ -81,7 +79,6 @@
* [Single.onErrorResumeNext].
*
* @sample androidx.compose.runtime.rxjava2.samples.SingleSample
- *
* @param initial The initial value for the returned [State] which will be asynchronously updated
* with the real one once we receive it from the stream
*/
@@ -100,7 +97,6 @@
* [Maybe.onErrorReturn] or [Maybe.onErrorResumeNext].
*
* @sample androidx.compose.runtime.rxjava2.samples.MaybeSample
- *
* @param initial The initial value for the returned [State] which will be asynchronously updated
* with the real one once we receive it from the stream
*/
diff --git a/compose/runtime/runtime-rxjava3/src/main/java/androidx/compose/runtime/rxjava3/RxJava3Adapter.kt b/compose/runtime/runtime-rxjava3/src/main/java/androidx/compose/runtime/rxjava3/RxJava3Adapter.kt
index d3aa403..b26a92f1 100644
--- a/compose/runtime/runtime-rxjava3/src/main/java/androidx/compose/runtime/rxjava3/RxJava3Adapter.kt
+++ b/compose/runtime/runtime-rxjava3/src/main/java/androidx/compose/runtime/rxjava3/RxJava3Adapter.kt
@@ -41,7 +41,6 @@
* or [Observable.onErrorResumeNext].
*
* @sample androidx.compose.runtime.rxjava3.samples.ObservableSample
- *
* @param initial The initial value for the returned [State] which will be asynchronously updated
* with the real one once we receive it from the stream
*/
@@ -62,7 +61,6 @@
* [Flowable.onErrorResumeNext].
*
* @sample androidx.compose.runtime.rxjava3.samples.FlowableSample
- *
* @param initial The initial value for the returned [State] which will be asynchronously updated
* with the real one once we receive it from the stream
*/
@@ -83,7 +81,6 @@
* [Single.onErrorResumeNext].
*
* @sample androidx.compose.runtime.rxjava3.samples.SingleSample
- *
* @param initial The initial value for the returned [State] which will be asynchronously updated
* with the real one once we receive it from the stream
*/
@@ -103,7 +100,6 @@
* [Maybe.onErrorReturn] or [Maybe.onErrorResumeNext].
*
* @sample androidx.compose.runtime.rxjava3.samples.MaybeSample
- *
* @param initial The initial value for the returned [State] which will be asynchronously updated
* with the real one once we receive it from the stream
*/
diff --git a/compose/runtime/runtime-saveable/src/commonMain/kotlin/androidx/compose/runtime/saveable/RememberSaveable.kt b/compose/runtime/runtime-saveable/src/commonMain/kotlin/androidx/compose/runtime/saveable/RememberSaveable.kt
index 57ea656..7d0f0804 100644
--- a/compose/runtime/runtime-saveable/src/commonMain/kotlin/androidx/compose/runtime/saveable/RememberSaveable.kt
+++ b/compose/runtime/runtime-saveable/src/commonMain/kotlin/androidx/compose/runtime/saveable/RememberSaveable.kt
@@ -53,7 +53,6 @@
* overload with which has `stateSaver` param.
*
* @sample androidx.compose.runtime.saveable.samples.RememberSaveableWithMutableStateAndCustomSaver
- *
* @param inputs A set of inputs such that, when any of them have changed, will cause the state to
* reset and [init] to be rerun
* @param saver The [Saver] object which defines how the state is saved and restored.
@@ -105,7 +104,6 @@
* so you have to provide a custom saver object.
*
* @sample androidx.compose.runtime.saveable.samples.RememberSaveableWithMutableStateAndCustomSaver
- *
* @param inputs A set of inputs such that, when any of them have changed, will cause the state to
* reset and [init] to be rerun
* @param stateSaver The [Saver] object which defines how the value inside the MutableState is saved
diff --git a/compose/runtime/runtime-saveable/src/commonMain/kotlin/androidx/compose/runtime/saveable/Saver.kt b/compose/runtime/runtime-saveable/src/commonMain/kotlin/androidx/compose/runtime/saveable/Saver.kt
index 25b9823..7c2066c 100644
--- a/compose/runtime/runtime-saveable/src/commonMain/kotlin/androidx/compose/runtime/saveable/Saver.kt
+++ b/compose/runtime/runtime-saveable/src/commonMain/kotlin/androidx/compose/runtime/saveable/Saver.kt
@@ -50,7 +50,6 @@
* You can pass the implementations of this class as a parameter for [rememberSaveable].
*
* @sample androidx.compose.runtime.saveable.samples.CustomSaverSample
- *
* @param save Defines how to convert the value into a saveable one. If null is returned the value
* will not be saved.
* @param restore Defines how to convert the restored value back to the original Class. If null is
diff --git a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/Applier.kt b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/Applier.kt
index 500dec7..e1cd951 100644
--- a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/Applier.kt
+++ b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/Applier.kt
@@ -26,7 +26,6 @@
* maintain a tree of a novel type.
*
* @sample androidx.compose.runtime.samples.CustomTreeComposition
- *
* @see AbstractApplier
* @see Composition
* @see Composer
@@ -181,7 +180,6 @@
* An abstract [Applier] implementation.
*
* @sample androidx.compose.runtime.samples.CustomTreeComposition
- *
* @see Applier
* @see Composition
* @see Composer
diff --git a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/Composables.kt b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/Composables.kt
index 0ac1d58..12114bd 100644
--- a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/Composables.kt
+++ b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/Composables.kt
@@ -116,7 +116,6 @@
* A compound key can be created by passing in multiple arguments:
*
* @sample androidx.compose.runtime.samples.TwoInputsKeySample
- *
* @param keys The set of values to be used to create a compound key. These will be compared to
* their previous values using [equals] and [hashCode]
* @param block The composable children for this group.
@@ -221,7 +220,6 @@
* [currentComposer].
*
* @sample androidx.compose.runtime.samples.CustomTreeComposition
- *
* @param factory A function which will create a new instance of [T]. This function is NOT
* guaranteed to be called in place.
* @param update A function to perform updates on the node. This will run every time emit is
@@ -256,7 +254,6 @@
* [currentComposer].
*
* @sample androidx.compose.runtime.samples.CustomTreeComposition
- *
* @param factory A function which will create a new instance of [T]. This function is NOT
* guaranteed to be called in place.
* @param update A function to perform updates on the node. This will run every time emit is
@@ -292,7 +289,6 @@
* [currentComposer].
*
* @sample androidx.compose.runtime.samples.CustomTreeComposition
- *
* @param factory A function which will create a new instance of [T]. This function is NOT
* guaranteed to be called in place.
* @param update A function to perform updates on the node. This will run every time emit is
@@ -331,7 +327,6 @@
* [currentComposer].
*
* @sample androidx.compose.runtime.samples.CustomTreeComposition
- *
* @param factory A function which will create a new instance of [T]. This function is NOT
* guaranteed to be called in place.
* @param update A function to perform updates on the node. This will run every time emit is
@@ -370,7 +365,6 @@
* [currentComposer].
*
* @sample androidx.compose.runtime.samples.CustomTreeComposition
- *
* @param factory A function which will create a new instance of [T]. This function is NOT
* guaranteed to be called in place.
* @param update A function to perform updates on the node. This will run every time emit is
@@ -417,7 +411,6 @@
* [currentComposer].
*
* @sample androidx.compose.runtime.samples.CustomTreeComposition
- *
* @param factory A function which will create a new instance of [T]. This function is NOT
* guaranteed to be called in place.
* @param update A function to perform updates on the node. This will run every time emit is
diff --git a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/Composition.kt b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/Composition.kt
index d9a2494..6f8f20a 100644
--- a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/Composition.kt
+++ b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/Composition.kt
@@ -315,7 +315,6 @@
* release resources.
*
* @sample androidx.compose.runtime.samples.CustomTreeComposition
- *
* @param applier The [Applier] instance to be used in the composition.
* @param parent The parent [CompositionContext].
* @see Applier
@@ -354,7 +353,6 @@
* release resources.
*
* @sample androidx.compose.runtime.samples.CustomTreeComposition
- *
* @param applier The [Applier] instance to be used in the composition.
* @param parent The parent [CompositionContext].
* @see Applier
diff --git a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/CompositionLocal.kt b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/CompositionLocal.kt
index 35661b2..35d6a21 100644
--- a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/CompositionLocal.kt
+++ b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/CompositionLocal.kt
@@ -121,9 +121,7 @@
* would automatically update all the accent colors.
*
* @sample androidx.compose.runtime.samples.compositionLocalProvidedComputed
- *
* @sample androidx.compose.runtime.samples.compositionLocalComputedAfterProvidingLocal
- *
* @see CompositionLocal
* @see CompositionLocalContext
* @see ProvidableCompositionLocal
@@ -291,9 +289,7 @@
* colors.
*
* @sample androidx.compose.runtime.samples.compositionLocalComputedByDefault
- *
* @sample androidx.compose.runtime.samples.compositionLocalComputedAfterProvidingLocal
- *
* @param defaultComputation the default computation to use when this [CompositionLocal] is not
* provided.
* @see CompositionLocal
@@ -329,7 +325,6 @@
* [ProvidableCompositionLocal.providesComputed] infix operator.
*
* @sample androidx.compose.runtime.samples.compositionLocalProvidedComputed
- *
* @see ProvidableCompositionLocal
* @see ProvidableCompositionLocal.providesComputed
* @see ProvidableCompositionLocal.provides
@@ -357,7 +352,6 @@
* indirectly in the [content] lambda.
*
* @sample androidx.compose.runtime.samples.compositionLocalProvider
- *
* @see CompositionLocal
* @see compositionLocalOf
* @see staticCompositionLocalOf
@@ -378,7 +372,6 @@
* indirectly in the [content] lambda.
*
* @sample androidx.compose.runtime.samples.compositionLocalProvider
- *
* @see CompositionLocal
* @see compositionLocalOf
* @see staticCompositionLocalOf
@@ -399,7 +392,6 @@
* [content] lambda.
*
* @sample androidx.compose.runtime.samples.compositionLocalProvider
- *
* @see CompositionLocal
* @see compositionLocalOf
* @see staticCompositionLocalOf
diff --git a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/DerivedState.kt b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/DerivedState.kt
index e50046a..499e7fd 100644
--- a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/DerivedState.kt
+++ b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/DerivedState.kt
@@ -322,7 +322,6 @@
* [SnapshotMutationPolicy] through [derivedStateOf] overload.
*
* @sample androidx.compose.runtime.samples.DerivedStateSample
- *
* @param calculation the calculation to create the value this state object represents.
*/
@StateFactoryMarker
@@ -339,7 +338,6 @@
* observed context such as a [Composable] function.
*
* @sample androidx.compose.runtime.samples.DerivedStateSample
- *
* @param policy mutation policy to control when changes to the [calculation] result trigger update.
* @param calculation the calculation to create the value this state object represents.
*/
diff --git a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/MovableContent.kt b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/MovableContent.kt
index a2166bd..f142586 100644
--- a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/MovableContent.kt
+++ b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/MovableContent.kt
@@ -29,7 +29,6 @@
* such as,
*
* @sample androidx.compose.runtime.samples.MovableContentMultiColumnSample
- *
* @param content The composable lambda to convert into a state tracking lambda.
* @return A tracking composable lambda
*/
@@ -52,7 +51,6 @@
* such as,
*
* @sample androidx.compose.runtime.samples.MovableContentMultiColumnSample
- *
* @param content The composable lambda to convert into a state tracking lambda.
* @return A tracking composable lambda
*/
@@ -75,7 +73,6 @@
* such as,
*
* @sample androidx.compose.runtime.samples.MovableContentMultiColumnSample
- *
* @param content The composable lambda to convert into a state tracking lambda.
* @return A tracking composable lambda
*/
@@ -98,7 +95,6 @@
* such as,
*
* @sample androidx.compose.runtime.samples.MovableContentMultiColumnSample
- *
* @param content The composable lambda to convert into a state tracking lambda.
* @return A tracking composable lambda
*/
@@ -126,7 +122,6 @@
* such as,
*
* @sample androidx.compose.runtime.samples.MovableContentMultiColumnSample
- *
* @param content The composable lambda to convert into a state tracking lambda.
* @return A tracking composable lambda
*/
@@ -156,7 +151,6 @@
* such as,
*
* @sample androidx.compose.runtime.samples.MovableContentMultiColumnSample
- *
* @param content The composable lambda to convert into a state tracking lambda.
* @return A tracking composable lambda
*/
@@ -179,7 +173,6 @@
* such as,
*
* @sample androidx.compose.runtime.samples.MovableContentMultiColumnSample
- *
* @param content The composable lambda to convert into a state tracking lambda.
* @return A tracking composable lambda
*/
@@ -204,7 +197,6 @@
* such as,
*
* @sample androidx.compose.runtime.samples.MovableContentMultiColumnSample
- *
* @param content The composable lambda to convert into a state tracking lambda.
* @return A tracking composable lambda
*/
@@ -230,7 +222,6 @@
* such as,
*
* @sample androidx.compose.runtime.samples.MovableContentMultiColumnSample
- *
* @param content The composable lambda to convert into a state tracking lambda.
* @return A tracking composable lambda
*/
diff --git a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/ProduceState.kt b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/ProduceState.kt
index 12522ff..6beb606 100644
--- a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/ProduceState.kt
+++ b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/ProduceState.kt
@@ -69,7 +69,6 @@
* data, for example:
*
* @sample androidx.compose.runtime.samples.ProduceState
- *
* @sample androidx.compose.runtime.samples.ProduceStateAwaitDispose
*/
@Composable
@@ -96,7 +95,6 @@
* data, for example:
*
* @sample androidx.compose.runtime.samples.ProduceState
- *
* @sample androidx.compose.runtime.samples.ProduceStateAwaitDispose
*/
@Composable
@@ -127,7 +125,6 @@
* data, for example:
*
* @sample androidx.compose.runtime.samples.ProduceState
- *
* @sample androidx.compose.runtime.samples.ProduceStateAwaitDispose
*/
@Composable
@@ -159,7 +156,6 @@
* data, for example:
*
* @sample androidx.compose.runtime.samples.ProduceState
- *
* @sample androidx.compose.runtime.samples.ProduceStateAwaitDispose
*/
@Composable
@@ -192,7 +188,6 @@
* data, for example:
*
* @sample androidx.compose.runtime.samples.ProduceState
- *
* @sample androidx.compose.runtime.samples.ProduceStateAwaitDispose
*/
@Composable
diff --git a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/SnapshotFlow.kt b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/SnapshotFlow.kt
index cfd6585..56a0edc 100644
--- a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/SnapshotFlow.kt
+++ b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/SnapshotFlow.kt
@@ -41,7 +41,6 @@
* usage.
*
* @sample androidx.compose.runtime.samples.StateFlowSample
- *
* @param context [CoroutineContext] to use for collecting.
*/
@Suppress("StateFlowValueCalledInComposition")
@@ -55,7 +54,6 @@
* recomposition of every [State.value] usage.
*
* @sample androidx.compose.runtime.samples.FlowWithInitialSample
- *
* @param initial the value of the state will have until the first flow value is emitted.
* @param context [CoroutineContext] to use for collecting.
*/
diff --git a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/SnapshotState.kt b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/SnapshotState.kt
index 329cdea..6aa7865 100644
--- a/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/SnapshotState.kt
+++ b/compose/runtime/runtime/src/commonMain/kotlin/androidx/compose/runtime/SnapshotState.kt
@@ -42,15 +42,10 @@
*
* @param value the initial value for the [MutableState]
* @param policy a policy to controls how changes are handled in mutable snapshots.
- *
* @sample androidx.compose.runtime.samples.SimpleStateSample
- *
* @sample androidx.compose.runtime.samples.DestructuredStateSample
- *
* @sample androidx.compose.runtime.samples.observeUserSample
- *
* @sample androidx.compose.runtime.samples.stateSample
- *
* @see State
* @see MutableState
* @see SnapshotMutationPolicy
@@ -224,7 +219,6 @@
* Create a instance of [MutableList]<T> that is observable and can be snapshot.
*
* @sample androidx.compose.runtime.samples.stateListSample
- *
* @see mutableStateOf
* @see mutableListOf
* @see MutableList
@@ -253,7 +247,6 @@
* Create a instance of [MutableMap]<K, V> that is observable and can be snapshot.
*
* @sample androidx.compose.runtime.samples.stateMapSample
- *
* @see mutableStateOf
* @see mutableMapOf
* @see MutableMap
@@ -285,7 +278,6 @@
* Create a instance of [MutableSet]<T> that is observable and can be snapshot.
*
* @sample androidx.compose.runtime.samples.stateListSample
- *
* @see mutableStateOf
* @see mutableSetOf
* @see MutableSet
diff --git a/compose/ui/ui-graphics/src/androidMain/kotlin/androidx/compose/ui/graphics/layer/AndroidGraphicsLayer.android.kt b/compose/ui/ui-graphics/src/androidMain/kotlin/androidx/compose/ui/graphics/layer/AndroidGraphicsLayer.android.kt
index 6473477..829d419 100644
--- a/compose/ui/ui-graphics/src/androidMain/kotlin/androidx/compose/ui/graphics/layer/AndroidGraphicsLayer.android.kt
+++ b/compose/ui/ui-graphics/src/androidMain/kotlin/androidx/compose/ui/graphics/layer/AndroidGraphicsLayer.android.kt
@@ -401,11 +401,8 @@
* @param layoutDirection [LayoutDirection] of the layout being drawn in.
* @param size [Size] of the [GraphicsLayer]
* @param block lambda that is called to issue drawing commands on this [DrawScope]
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerTopLeftSample
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerBlendModeSample
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerTranslateSample
*/
actual fun record(
@@ -723,7 +720,6 @@
* [shadowElevation] is non-zero a shadow is produced using this [Outline].
*
* @param path Path to be used as the Outline for the [GraphicsLayer]
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerOutlineSample
*/
actual fun setPathOutline(path: Path) {
@@ -742,7 +738,6 @@
* @param topLeft The top left of the rounded rect outline
* @param size The size of the rounded rect outline
* @param cornerRadius The corner radius of the rounded rect outline
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerRoundRectOutline
*/
actual fun setRoundRectOutline(topLeft: Offset, size: Size, cornerRadius: Float) {
@@ -768,7 +763,6 @@
*
* @param topLeft The top left of the rounded rect outline
* @param size The size of the rounded rect outline
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerRectOutline
*/
actual fun setRectOutline(topLeft: Offset, size: Size) {
diff --git a/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/Brush.kt b/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/Brush.kt
index 963cea8..a1e2b33 100644
--- a/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/Brush.kt
+++ b/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/Brush.kt
@@ -56,9 +56,7 @@
* ```
*
* @sample androidx.compose.ui.graphics.samples.LinearGradientColorStopSample
- *
* @sample androidx.compose.ui.graphics.samples.GradientBrushSample
- *
* @param colorStops Colors and their offset in the gradient area
* @param start Starting position of the linear gradient. This can be set to [Offset.Zero]
* to position at the far left and top of the drawing area
@@ -95,9 +93,7 @@
* ```
*
* @sample androidx.compose.ui.graphics.samples.LinearGradientSample
- *
* @sample androidx.compose.ui.graphics.samples.GradientBrushSample
- *
* @param colors Colors to be rendered as part of the gradient
* @param start Starting position of the linear gradient. This can be set to [Offset.Zero]
* to position at the far left and top of the drawing area
@@ -134,9 +130,7 @@
* ```
*
* @sample androidx.compose.ui.graphics.samples.HorizontalGradientSample
- *
* @sample androidx.compose.ui.graphics.samples.GradientBrushSample
- *
* @param colors colors Colors to be rendered as part of the gradient
* @param startX Starting x position of the horizontal gradient. Defaults to 0 which
* represents the left of the drawing area
@@ -169,9 +163,7 @@
* ```
*
* @sample androidx.compose.ui.graphics.samples.HorizontalGradientColorStopSample
- *
* @sample androidx.compose.ui.graphics.samples.GradientBrushSample
- *
* @param colorStops Colors and offsets to determine how the colors are dispersed throughout
* the vertical gradient
* @param startX Starting x position of the horizontal gradient. Defaults to 0 which
@@ -207,9 +199,7 @@
* ```
*
* @sample androidx.compose.ui.graphics.samples.VerticalGradientSample
- *
* @sample androidx.compose.ui.graphics.samples.GradientBrushSample
- *
* @param colors colors Colors to be rendered as part of the gradient
* @param startY Starting y position of the vertical gradient. Defaults to 0 which
* represents the top of the drawing area
@@ -242,9 +232,7 @@
* ```
*
* @sample androidx.compose.ui.graphics.samples.VerticalGradientColorStopSample
- *
* @sample androidx.compose.ui.graphics.samples.GradientBrushSample
- *
* @param colorStops Colors and offsets to determine how the colors are dispersed throughout
* the vertical gradient
* @param startY Starting y position of the vertical gradient. Defaults to 0 which
@@ -284,9 +272,7 @@
* ```
*
* @sample androidx.compose.ui.graphics.samples.RadialBrushColorStopSample
- *
* @sample androidx.compose.ui.graphics.samples.GradientBrushSample
- *
* @param colorStops Colors and offsets to determine how the colors are dispersed throughout
* the radial gradient
* @param center Center position of the radial gradient circle. If this is set to
@@ -326,9 +312,7 @@
* ```
*
* @sample androidx.compose.ui.graphics.samples.RadialBrushSample
- *
* @sample androidx.compose.ui.graphics.samples.GradientBrushSample
- *
* @param colors Colors to be rendered as part of the gradient
* @param center Center position of the radial gradient circle. If this is set to
* [Offset.Unspecified] then the center of the drawing area is used as the center for the
@@ -370,9 +354,7 @@
* ```
*
* @sample androidx.compose.ui.graphics.samples.SweepGradientColorStopSample
- *
* @sample androidx.compose.ui.graphics.samples.GradientBrushSample
- *
* @param colorStops Colors and offsets to determine how the colors are dispersed throughout
* the sweep gradient
* @param center Center position of the sweep gradient circle. If this is set to
@@ -404,9 +386,7 @@
* ```
*
* @sample androidx.compose.ui.graphics.samples.SweepGradientSample
- *
* @sample androidx.compose.ui.graphics.samples.GradientBrushSample
- *
* @param colors List of colors to fill the sweep gradient
* @param center Center position of the sweep gradient circle. If this is set to
* [Offset.Unspecified] then the center of the drawing area is used as the center for the
diff --git a/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/ImageBitmap.kt b/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/ImageBitmap.kt
index 8db3c94..4a3d61b 100644
--- a/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/ImageBitmap.kt
+++ b/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/ImageBitmap.kt
@@ -61,7 +61,6 @@
* critical code paths
*
* @sample androidx.compose.ui.graphics.samples.ImageBitmapReadPixelsSample
- *
* @param buffer The array to store the [ImageBitmap]'s colors. By default this allocates an
* [IntArray] large enough to store all the pixel information. Consumers of this API are
* advised to use the smallest [IntArray] necessary to extract relevant pixel information,
@@ -101,7 +100,6 @@
* code paths
*
* @sample androidx.compose.ui.graphics.samples.ImageBitmapToPixelMapSample
- *
* @param startX The x-coordinate of the first pixel to read from the [ImageBitmap]
* @param startY The y-coordinate of the first pixel to read from the [ImageBitmap]
* @param width The number of pixels to read from each row
diff --git a/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/PixelMap.kt b/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/PixelMap.kt
index 35a9105..2406822 100644
--- a/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/PixelMap.kt
+++ b/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/PixelMap.kt
@@ -24,7 +24,6 @@
* dimensional coordinates of the corresponding [ImageBitmap] this was obtained from
*
* @sample androidx.compose.ui.graphics.samples.ImageBitmapReadPixelsSample
- *
* @param buffer IntArray where pixel information is stored as an ARGB value packed into an Int
* @param bufferOffset first index in the buffer where pixel information for the [ImageBitmap] is
* stored
diff --git a/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/drawscope/DrawScope.kt b/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/drawscope/DrawScope.kt
index 88eaa0a..b75e743 100644
--- a/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/drawscope/DrawScope.kt
+++ b/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/drawscope/DrawScope.kt
@@ -237,7 +237,6 @@
* applied. After this call is complete, the transformation before this call was made is restored
*
* @sample androidx.compose.ui.graphics.samples.DrawScopeBatchedTransformSample
- *
* @param transformBlock Callback invoked to issue transformations to be made before the drawing
* operations are issued
* @param drawBlock Callback invoked to issue drawing operations after the transformations are
@@ -281,7 +280,6 @@
* as a receiver
*
* @sample androidx.compose.ui.graphics.samples.DrawScopeRetargetingSample
- *
* @param density [Density] used to assist in conversions of density independent pixels to raw
* pixels to draw
* @param layoutDirection [LayoutDirection] of the layout being drawn in.
@@ -691,7 +689,6 @@
* @param style Whether or not the oval is stroked or filled in
* @param colorFilter ColorFilter to apply to the [brush] when drawn into the destination
* @param blendMode Blending algorithm to be applied to the brush
- *
* @sample androidx.compose.ui.graphics.samples.DrawScopeOvalBrushSample
*/
fun drawOval(
@@ -717,7 +714,6 @@
* @param style Whether or not the oval is stroked or filled in
* @param colorFilter ColorFilter to apply to the [color] when drawn into the destination
* @param blendMode Blending algorithm to be applied to the brush
- *
* @sample androidx.compose.ui.graphics.samples.DrawScopeOvalColorSample
*/
fun drawOval(
diff --git a/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/layer/GraphicsLayer.kt b/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/layer/GraphicsLayer.kt
index ef3726e9..f9ce145 100644
--- a/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/layer/GraphicsLayer.kt
+++ b/compose/ui/ui-graphics/src/commonMain/kotlin/androidx/compose/ui/graphics/layer/GraphicsLayer.kt
@@ -40,17 +40,11 @@
* result.
*
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerTopLeftSample
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerScaleAndPivotSample
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerColorFilterSample
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerRenderEffectSample
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerAlphaSample
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerRotationX
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerRotationYWithCameraDistance
*/
fun DrawScope.drawLayer(graphicsLayer: GraphicsLayer) {
@@ -238,7 +232,6 @@
* clipped to this geometry.
*
* @param path Path to be used as the Outline for the [GraphicsLayer]
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerOutlineSample
*/
fun setPathOutline(path: Path)
@@ -253,7 +246,6 @@
* @param topLeft The top left of the rounded rect outline
* @param size The size of the rounded rect outline
* @param cornerRadius The corner radius of the rounded rect outline
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerRoundRectOutline
*/
fun setRoundRectOutline(
@@ -271,7 +263,6 @@
*
* @param topLeft The top left of the rounded rect outline
* @param size The size of the rounded rect outline
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerRectOutline
*/
fun setRectOutline(topLeft: Offset = Offset.Zero, size: Size = Size.Unspecified)
@@ -358,11 +349,8 @@
* @param layoutDirection [LayoutDirection] of the layout being drawn in.
* @param size [Size] of the [GraphicsLayer]
* @param block lambda that is called to issue drawing commands on this [DrawScope]
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerTopLeftSample
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerBlendModeSample
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerTranslateSample
*/
fun record(
diff --git a/compose/ui/ui-graphics/src/desktopMain/kotlin/androidx/compose/ui/graphics/layer/GraphicsLayer.desktop.kt b/compose/ui/ui-graphics/src/desktopMain/kotlin/androidx/compose/ui/graphics/layer/GraphicsLayer.desktop.kt
index 2a78433..8b1ad17 100644
--- a/compose/ui/ui-graphics/src/desktopMain/kotlin/androidx/compose/ui/graphics/layer/GraphicsLayer.desktop.kt
+++ b/compose/ui/ui-graphics/src/desktopMain/kotlin/androidx/compose/ui/graphics/layer/GraphicsLayer.desktop.kt
@@ -382,7 +382,6 @@
* @param topLeft The top left of the rounded rect outline
* @param size The size of the rounded rect outline
* @param cornerRadius The corner radius of the rounded rect outline
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerRoundRectOutline
*/
actual fun setRoundRectOutline(topLeft: Offset, size: Size, cornerRadius: Float) {
@@ -397,7 +396,6 @@
* [shadowElevation] is non-zero a shadow is produced using this [Outline].
*
* @param path Path to be used as the Outline for the [GraphicsLayer]
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerOutlineSample
*/
actual fun setPathOutline(path: Path) {
@@ -422,7 +420,6 @@
*
* @param topLeft The top left of the rounded rect outline
* @param size The size of the rounded rect outline
- *
* @sample androidx.compose.ui.graphics.samples.GraphicsLayerRectOutline
*/
actual fun setRectOutline(topLeft: Offset, size: Size) {
diff --git a/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/Actions.kt b/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/Actions.kt
index 92bbd1d..6ad2457 100644
--- a/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/Actions.kt
+++ b/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/Actions.kt
@@ -277,7 +277,6 @@
* Example of performing a click:
*
* @sample androidx.compose.ui.test.samples.gestureClick
- *
* @param block A lambda with [GestureScope] as receiver that describes the gesture by sending all
* touch events.
* @return The [SemanticsNodeInteraction] that is the receiver of this method
@@ -339,7 +338,6 @@
* Example of performing a click-and-drag:
*
* @sample androidx.compose.ui.test.samples.touchInputClickAndDrag
- *
* @param block A lambda with [TouchInjectionScope] as receiver that describes the gesture by
* sending all touch events.
* @return The [SemanticsNodeInteraction] that is the receiver of this method
@@ -389,7 +387,6 @@
* Example of scrolling the mouse wheel while the mouse button is pressed:
*
* @sample androidx.compose.ui.test.samples.mouseInputScrollWhileDown
- *
* @param block A lambda with [MouseInjectionScope] as receiver that describes the gesture by
* sending all mouse events.
* @return The [SemanticsNodeInteraction] that is the receiver of this method
diff --git a/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/Assertions.kt b/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/Assertions.kt
index bf050e5..27abeb5 100644
--- a/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/Assertions.kt
+++ b/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/Assertions.kt
@@ -342,7 +342,6 @@
* multiple nodes match, throws an [AssertionError].
*
* @sample androidx.compose.ui.test.samples.waitForDisplayed
- *
* @throws AssertionError If multiple nodes match this [SemanticsNodeInteraction].
*/
fun SemanticsNodeInteraction.isDisplayed(): Boolean = checkIsDisplayed(assertIsFullyVisible = false)
@@ -353,7 +352,6 @@
* If no matching node is found, returns true. If multiple nodes match, throws an [AssertionError].
*
* @sample androidx.compose.ui.test.samples.waitForNotDisplayed
- *
* @throws AssertionError If multiple nodes match this [SemanticsNodeInteraction].
*/
fun SemanticsNodeInteraction.isNotDisplayed(): Boolean =
diff --git a/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/BoundsAssertions.kt b/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/BoundsAssertions.kt
index 3799a98..d15e9b4 100644
--- a/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/BoundsAssertions.kt
+++ b/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/BoundsAssertions.kt
@@ -189,7 +189,6 @@
* example [TouchInjectionScope.click] or [MouseInjectionScope.moveTo].
*
* @sample androidx.compose.ui.test.samples.touchInputOnFirstSpecificLinkInText
- *
* @sample androidx.compose.ui.test.samples.hoverAnyFirstLinkInText
*/
fun SemanticsNodeInteraction.getPartialBoundsOfLinks(
diff --git a/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/DeviceConfigurationOverride.kt b/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/DeviceConfigurationOverride.kt
index c39d6e6..55f08fb 100644
--- a/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/DeviceConfigurationOverride.kt
+++ b/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/DeviceConfigurationOverride.kt
@@ -31,9 +31,7 @@
* [layout direction][DeviceConfigurationOverride.Companion.LayoutDirection].
*
* @sample androidx.compose.ui.test.samples.DeviceConfigurationOverrideFontScaleSample
- *
* @sample androidx.compose.ui.test.samples.DeviceConfigurationOverrideForcedSizeSample
- *
* @sample androidx.compose.ui.test.samples.DeviceConfigurationOverrideLayoutDirectionSample
*/
@Composable
diff --git a/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/MouseInjectionScope.kt b/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/MouseInjectionScope.kt
index 079c385..ddf3117 100644
--- a/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/MouseInjectionScope.kt
+++ b/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/MouseInjectionScope.kt
@@ -70,7 +70,6 @@
* Example of scrolling the mouse wheel while the mouse button is pressed:
*
* @sample androidx.compose.ui.test.samples.mouseInputScrollWhileDown
- *
* @see InjectionScope
*/
@Suppress("NotCloseable")
@@ -233,7 +232,6 @@
* Example of how scroll could be used:
*
* @sample androidx.compose.ui.test.samples.mouseInputScrollWhileDown
- *
* @param delta The amount of scroll
* @param scrollWheel Which scroll wheel to rotate. Can be either [ScrollWheel.Vertical] (the
* default) or [ScrollWheel.Horizontal].
@@ -447,7 +445,6 @@
* Example of moving the mouse along a line:
*
* @sample androidx.compose.ui.test.samples.mouseInputAnimateTo
- *
* @param position The position where to move the mouse to, in the node's local coordinate system
* @param durationMillis The duration of the gesture. By default 300 milliseconds.
*/
@@ -491,7 +488,6 @@
* Example of moving the mouse along a curve:
*
* @sample androidx.compose.ui.test.samples.mouseInputAnimateAlong
- *
* @param curve The function that defines the position of the mouse over time for this gesture, in
* the node's local coordinate system.
* @param durationMillis The duration of the gesture. By default 300 milliseconds.
@@ -571,7 +567,6 @@
* Example of a horizontal smooth scroll:
*
* @sample androidx.compose.ui.test.samples.mouseInputSmoothScroll
- *
* @param scrollAmount The total delta to scroll the [scrollWheel] by
* @param durationMillis The duration of the gesture. By default 300 milliseconds.
* @param scrollWheel Which scroll wheel will be rotated. By default [ScrollWheel.Vertical].
diff --git a/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/MultiModalInjectionScope.kt b/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/MultiModalInjectionScope.kt
index 5b1a5b7..3cdca1d 100644
--- a/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/MultiModalInjectionScope.kt
+++ b/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/MultiModalInjectionScope.kt
@@ -39,7 +39,6 @@
* Example of performing a click via touch input followed by drag and drop via mouse input:
*
* @sample androidx.compose.ui.test.samples.multiModalInputClickDragDrop
- *
* @see InjectionScope
* @see TouchInjectionScope
* @see MouseInjectionScope
diff --git a/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/TouchInjectionScope.kt b/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/TouchInjectionScope.kt
index 19ae176..ac98264 100644
--- a/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/TouchInjectionScope.kt
+++ b/compose/ui/ui-test/src/commonMain/kotlin/androidx/compose/ui/test/TouchInjectionScope.kt
@@ -76,7 +76,6 @@
* Example of performing an L-shaped gesture:
*
* @sample androidx.compose.ui.test.samples.touchInputLShapedGesture
- *
* @see InjectionScope
*/
@JvmDefaultWithCompatibility
@@ -240,7 +239,6 @@
* events quicker than can be dispatched and batches them together.
*
* @sample androidx.compose.ui.test.samples.touchInputMultiTouchWithHistory
- *
* @param relativeHistoricalTimes Time of each historical event, as a millisecond relative to
* the time the actual event is sent. For example, -10L means 10ms earlier.
* @param historicalCoordinates Coordinates of each historical event, in the same coordinate
diff --git a/compose/ui/ui-text/src/androidMain/kotlin/androidx/compose/ui/text/style/LineBreak.android.kt b/compose/ui/ui-text/src/androidMain/kotlin/androidx/compose/ui/text/style/LineBreak.android.kt
index fa5540c..89911a1 100644
--- a/compose/ui/ui-text/src/androidMain/kotlin/androidx/compose/ui/text/style/LineBreak.android.kt
+++ b/compose/ui/ui-text/src/androidMain/kotlin/androidx/compose/ui/text/style/LineBreak.android.kt
@@ -36,7 +36,6 @@
* [Strictness], and [WordBreak].
*
* @sample androidx.compose.ui.text.samples.LineBreakSample
- *
* @sample androidx.compose.ui.text.samples.AndroidLineBreakSample
*/
@Immutable
diff --git a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/AnnotatedString.kt b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/AnnotatedString.kt
index ad4d8de..e66c58e 100644
--- a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/AnnotatedString.kt
+++ b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/AnnotatedString.kt
@@ -61,9 +61,7 @@
* required that [Range]s of paragraphs don't overlap with each other. If there are gaps
* between specified paragraph [Range]s, a default paragraph will be created in between.
* @throws IllegalArgumentException if [paragraphStyles] contains any two overlapping [Range]s.
- *
* @sample androidx.compose.ui.text.samples.AnnotatedStringConstructorSample
- *
* @see SpanStyle
* @see ParagraphStyle
*/
@@ -301,7 +299,6 @@
* [AnnotatedString]s:
*
* @sample androidx.compose.ui.text.samples.AnnotatedStringBuilderAppendableSample
- *
* @param capacity initial capacity for the internal char buffer
*/
class Builder(capacity: Int = 16) : Appendable {
@@ -497,9 +494,8 @@
* @param annotation the string annotation that is attached
* @param start the inclusive starting offset of the range
* @param end the exclusive end offset of the range
- * @see getStringAnnotations
- *
* @sample androidx.compose.ui.text.samples.AnnotatedStringAddStringAnnotationSample
+ * @see getStringAnnotations
*/
fun addStringAnnotation(tag: String, annotation: String, start: Int, end: Int) {
annotations.add(MutableRange(annotation, start, end, tag))
@@ -512,9 +508,8 @@
* TTS engine.
* @param start the inclusive starting offset of the range
* @param end the exclusive end offset of the range
- * @see getStringAnnotations
- *
* @sample androidx.compose.ui.text.samples.AnnotatedStringAddStringAnnotationSample
+ * @see getStringAnnotations
*/
@ExperimentalTextApi
@Suppress("SetterReturnsThis")
@@ -530,9 +525,8 @@
* @param urlAnnotation A [UrlAnnotation] object that stores the URL being linked to.
* @param start the inclusive starting offset of the range
* @param end the exclusive end offset of the range
- * @see getStringAnnotations
- *
* @sample androidx.compose.ui.text.samples.AnnotatedStringAddStringAnnotationSample
+ * @see getStringAnnotations
*/
@ExperimentalTextApi
@Suppress("SetterReturnsThis", "Deprecation")
@@ -586,7 +580,6 @@
* Applies the given [SpanStyle] to any appended text until a corresponding [pop] is called.
*
* @sample androidx.compose.ui.text.samples.AnnotatedStringBuilderPushSample
- *
* @param style SpanStyle to be applied
*/
fun pushStyle(style: SpanStyle): Int {
@@ -602,7 +595,6 @@
* called.
*
* @sample androidx.compose.ui.text.samples.AnnotatedStringBuilderPushParagraphStyleSample
- *
* @param style ParagraphStyle to be applied
*/
fun pushStyle(style: ParagraphStyle): Int {
@@ -617,7 +609,6 @@
* Attach the given [annotation] to any appended text until a corresponding [pop] is called.
*
* @sample androidx.compose.ui.text.samples.AnnotatedStringBuilderPushStringAnnotationSample
- *
* @param tag the tag used to distinguish annotations
* @param annotation the string annotation attached on this AnnotatedString
* @see getStringAnnotations
@@ -636,7 +627,6 @@
* called.
*
* @sample androidx.compose.ui.text.samples.AnnotatedStringBuilderPushStringAnnotationSample
- *
* @param ttsAnnotation an object that stores text to speech metadata that intended for the
* TTS engine.
* @see getStringAnnotations
@@ -655,7 +645,6 @@
* called.
*
* @sample androidx.compose.ui.text.samples.AnnotatedStringBuilderPushStringAnnotationSample
- *
* @param urlAnnotation A [UrlAnnotation] object that stores the URL being linked to.
* @see getStringAnnotations
* @see Range
@@ -993,7 +982,6 @@
* Pushes [style] to the [AnnotatedString.Builder], executes [block] and then pops the [style].
*
* @sample androidx.compose.ui.text.samples.AnnotatedStringBuilderWithStyleSample
- *
* @param style [SpanStyle] to be applied
* @param block function to be executed
* @return result of the [block]
@@ -1013,7 +1001,6 @@
* Pushes [style] to the [AnnotatedString.Builder], executes [block] and then pops the [style].
*
* @sample androidx.compose.ui.text.samples.AnnotatedStringBuilderWithStyleSample
- *
* @param style [SpanStyle] to be applied
* @param block function to be executed
* @return result of the [block]
@@ -1113,11 +1100,8 @@
* @param link A [LinkAnnotation] object representing a clickable part of the text
* @param block function to be executed
* @return result of the [block]
- *
* @sample androidx.compose.ui.text.samples.AnnotatedStringWithLinkSample
- *
* @sample androidx.compose.ui.text.samples.AnnotatedStringWithHoveredLinkStylingSample
- *
* @sample androidx.compose.ui.text.samples.AnnotatedStringWithListenerSample
*/
inline fun <R : Any> Builder.withLink(link: LinkAnnotation, block: Builder.() -> R): R {
@@ -1183,7 +1167,6 @@
* [builder].
*
* @sample androidx.compose.ui.text.samples.AnnotatedStringBuilderLambdaSample
- *
* @param builder lambda to modify [AnnotatedString.Builder]
*/
inline fun buildAnnotatedString(builder: (Builder).() -> Unit): AnnotatedString =
diff --git a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/Html.kt b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/Html.kt
index 4e94577..53ed97a4 100644
--- a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/Html.kt
+++ b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/Html.kt
@@ -43,7 +43,6 @@
* Example of displaying styled string from resources
*
* @sample androidx.compose.ui.text.samples.AnnotatedStringFromHtml
- *
* @see LinkAnnotation
*/
expect fun AnnotatedString.Companion.fromHtml(
diff --git a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/ParagraphStyle.kt b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/ParagraphStyle.kt
index 957b390..f727872 100644
--- a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/ParagraphStyle.kt
+++ b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/ParagraphStyle.kt
@@ -41,9 +41,7 @@
* was added.
*
* @sample androidx.compose.ui.text.samples.ParagraphStyleSample
- *
* @sample androidx.compose.ui.text.samples.ParagraphStyleAnnotatedStringsSample
- *
* @param textAlign The alignment of the text within the lines of the paragraph.
* @param textDirection The algorithm to be used to resolve the final text direction: Left To Right
* or Right To Left.
diff --git a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/SpanStyle.kt b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/SpanStyle.kt
index d9614be..387fec6 100644
--- a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/SpanStyle.kt
+++ b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/SpanStyle.kt
@@ -58,9 +58,7 @@
* [ParagraphStyle].
*
* @sample androidx.compose.ui.text.samples.SpanStyleSample
- *
* @sample androidx.compose.ui.text.samples.AnnotatedStringBuilderSample
- *
* @param fontSize The size of glyphs (in logical pixels) to use when painting the text. This may be
* [TextUnit.Unspecified] for inheriting from another [SpanStyle].
* @param fontWeight The typeface thickness to use when painting the text (e.g., bold).
@@ -113,9 +111,7 @@
* please see [ParagraphStyle].
*
* @sample androidx.compose.ui.text.samples.SpanStyleSample
- *
* @sample androidx.compose.ui.text.samples.AnnotatedStringBuilderSample
- *
* @param color The text color.
* @param fontSize The size of glyphs (in logical pixels) to use when painting the text. This
* may be [TextUnit.Unspecified] for inheriting from another [SpanStyle].
@@ -183,9 +179,7 @@
* please see [ParagraphStyle].
*
* @sample androidx.compose.ui.text.samples.SpanStyleSample
- *
* @sample androidx.compose.ui.text.samples.AnnotatedStringBuilderSample
- *
* @param color The color to draw the text.
* @param fontSize The size of glyphs (in logical pixels) to use when painting the text. This
* may be [TextUnit.Unspecified] for inheriting from another [SpanStyle].
@@ -255,9 +249,7 @@
* please see [ParagraphStyle].
*
* @sample androidx.compose.ui.text.samples.SpanStyleSample
- *
* @sample androidx.compose.ui.text.samples.AnnotatedStringBuilderSample
- *
* @param color The color to draw the text.
* @param fontSize The size of glyphs (in logical pixels) to use when painting the text. This
* may be [TextUnit.Unspecified] for inheriting from another [SpanStyle].
@@ -325,9 +317,7 @@
* please see [ParagraphStyle].
*
* @sample androidx.compose.ui.text.samples.SpanStyleBrushSample
- *
* @sample androidx.compose.ui.text.samples.AnnotatedStringBuilderSample
- *
* @param brush The brush to use when painting the text. If brush is given as null, it will be
* treated as unspecified. It is equivalent to calling the alternative color constructor with
* [Color.Unspecified]
diff --git a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/TextMeasurer.kt b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/TextMeasurer.kt
index 85091c5..b9e30ed 100644
--- a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/TextMeasurer.kt
+++ b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/TextMeasurer.kt
@@ -136,7 +136,6 @@
* specified, defaults to the value that was given during initialization of this
* [TextMeasurer].
* @param skipCache Disables cache optimization if it is passed as true.
- *
* @sample androidx.compose.ui.text.samples.measureTextAnnotatedString
*/
@Stable
@@ -230,7 +229,6 @@
* specified, defaults to the value that was given during initialization of this
* [TextMeasurer].
* @param skipCache Disables cache optimization if it is passed as true.
- *
* @sample androidx.compose.ui.text.samples.measureTextStringWithConstraints
*/
@Stable
diff --git a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/TextPainter.kt b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/TextPainter.kt
index 96aa936..4ef4dad 100644
--- a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/TextPainter.kt
+++ b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/TextPainter.kt
@@ -138,7 +138,6 @@
* Otherwise, [Size.height] either defines where the text is clipped ([TextOverflow.Clip]) or
* becomes no-op.
* @param blendMode Blending algorithm to be applied to the text
- *
* @sample androidx.compose.ui.text.samples.DrawTextAnnotatedStringSample
*/
fun DrawScope.drawText(
@@ -203,9 +202,7 @@
* Otherwise, [Size.height] either defines where the text is clipped ([TextOverflow.Clip]) or
* becomes no-op.
* @param blendMode Blending algorithm to be applied to the text
- *
* @sample androidx.compose.ui.text.samples.DrawTextSample
- *
* @sample androidx.compose.ui.text.samples.DrawTextStyledSample
*/
fun DrawScope.drawText(
@@ -254,9 +251,7 @@
* @param textDecoration The decorations to paint on the text (e.g., an underline).
* @param drawStyle Whether or not the text is stroked or filled in.
* @param blendMode Blending algorithm to be applied to the text
- *
* @sample androidx.compose.ui.text.samples.DrawTextMeasureInLayoutSample
- *
* @sample androidx.compose.ui.text.samples.DrawTextDrawWithCacheSample
*/
fun DrawScope.drawText(
diff --git a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/TextStyle.kt b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/TextStyle.kt
index 8569bca..527f81a 100644
--- a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/TextStyle.kt
+++ b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/TextStyle.kt
@@ -45,7 +45,6 @@
* Styling configuration for a `Text`.
*
* @sample androidx.compose.ui.text.samples.TextStyleSample
- *
* @param platformStyle Platform specific [TextStyle] parameters.
* @see AnnotatedString
* @see SpanStyle
@@ -192,7 +191,6 @@
* Styling configuration for a `Text`.
*
* @sample androidx.compose.ui.text.samples.TextStyleSample
- *
* @param color The text color.
* @param fontSize The size of glyphs to use when painting the text. This may be
* [TextUnit.Unspecified] for inheriting from another [TextStyle].
@@ -354,7 +352,6 @@
* Styling configuration for a `Text`.
*
* @sample androidx.compose.ui.text.samples.TextStyleSample
- *
* @param color The text color.
* @param fontSize The size of glyphs to use when painting the text. This may be
* [TextUnit.Unspecified] for inheriting from another [TextStyle].
@@ -452,7 +449,6 @@
* Styling configuration for a `Text`.
*
* @sample androidx.compose.ui.text.samples.TextStyleBrushSample
- *
* @param brush The brush to use when painting the text. If brush is given as null, it will be
* treated as unspecified. It is equivalent to calling the alternative color constructor with
* [Color.Unspecified]
diff --git a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/font/Font.kt b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/font/Font.kt
index d50ebcc..6fbce13 100644
--- a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/font/Font.kt
+++ b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/font/Font.kt
@@ -142,7 +142,6 @@
* Defines a font to be used while rendering text with resource ID.
*
* @sample androidx.compose.ui.text.samples.CustomFontFamilySample
- *
* @param resId The resource ID of the font file in font resources. i.e. "R.font.myfont".
* @param weight The weight of the font. The system uses this to match a font to a font request that
* is given in a [androidx.compose.ui.text.TextStyle].
diff --git a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/font/FontFamily.kt b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/font/FontFamily.kt
index 0a5c478..b9953c1 100644
--- a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/font/FontFamily.kt
+++ b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/font/FontFamily.kt
@@ -155,7 +155,6 @@
* Defines a font family with list of [Font].
*
* @sample androidx.compose.ui.text.samples.FontFamilySansSerifSample
- *
* @sample androidx.compose.ui.text.samples.CustomFontFamilySample
*/
@Immutable
diff --git a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/input/VisualTransformation.kt b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/input/VisualTransformation.kt
index 33bf501..a88498f 100644
--- a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/input/VisualTransformation.kt
+++ b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/input/VisualTransformation.kt
@@ -72,7 +72,6 @@
* 1234567890123456 transformed text: 1234-5678-9012-3456
*
* @sample androidx.compose.ui.text.samples.creditCardFilter
- *
* @param text The original text
* @return the pair of filtered text and offset translator.
*/
diff --git a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/style/BaselineShift.kt b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/style/BaselineShift.kt
index 0fa3454..c663518 100644
--- a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/style/BaselineShift.kt
+++ b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/style/BaselineShift.kt
@@ -25,9 +25,7 @@
*
* @param multiplier shift the baseline by multiplier * (baseline - ascent)
* @constructor
- *
* @sample androidx.compose.ui.text.samples.BaselineShiftSample
- *
* @sample androidx.compose.ui.text.samples.BaselineShiftAnnotatedStringSample
*/
@Immutable
diff --git a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/style/TextDecoration.kt b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/style/TextDecoration.kt
index 728ed48..70dcdea 100644
--- a/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/style/TextDecoration.kt
+++ b/compose/ui/ui-text/src/commonMain/kotlin/androidx/compose/ui/text/style/TextDecoration.kt
@@ -45,7 +45,6 @@
* Creates a decoration that includes all the given decorations.
*
* @sample androidx.compose.ui.text.samples.TextDecorationCombinedSample
- *
* @param decorations The decorations to be added
*/
fun combine(decorations: List<TextDecoration>): TextDecoration {
diff --git a/compose/ui/ui-tooling/src/androidMain/kotlin/androidx/compose/ui/tooling/animation/clock/TransitionClock.android.kt b/compose/ui/ui-tooling/src/androidMain/kotlin/androidx/compose/ui/tooling/animation/clock/TransitionClock.android.kt
index 90c1cbb..ae3d6c1 100644
--- a/compose/ui/ui-tooling/src/androidMain/kotlin/androidx/compose/ui/tooling/animation/clock/TransitionClock.android.kt
+++ b/compose/ui/ui-tooling/src/androidMain/kotlin/androidx/compose/ui/tooling/animation/clock/TransitionClock.android.kt
@@ -31,13 +31,9 @@
* * Transition.AnimatedContent
*
* @sample androidx.compose.animation.core.samples.GestureAnimationSample
- *
* @sample androidx.compose.animation.samples.AnimatedVisibilityLazyColumnSample
- *
* @sample androidx.compose.animation.samples.CrossfadeSample
- *
* @sample androidx.compose.animation.samples.TransitionExtensionAnimatedContentSample
- *
* @sample androidx.compose.animation.samples.AnimateIncrementDecrementSample
*/
internal class TransitionClock<T>(override val animation: TransitionBasedAnimation<T>) :
diff --git a/compose/ui/ui-viewbinding/src/main/java/androidx/compose/ui/viewinterop/AndroidViewBinding.kt b/compose/ui/ui-viewbinding/src/main/java/androidx/compose/ui/viewinterop/AndroidViewBinding.kt
index 23bbba4..a865cd4 100644
--- a/compose/ui/ui-viewbinding/src/main/java/androidx/compose/ui/viewinterop/AndroidViewBinding.kt
+++ b/compose/ui/ui-viewbinding/src/main/java/androidx/compose/ui/viewinterop/AndroidViewBinding.kt
@@ -65,7 +65,6 @@
* improvements.
*
* @sample androidx.compose.ui.samples.AndroidViewBindingSample
- *
* @param factory The block creating the [ViewBinding] to be composed.
* @param modifier The modifier to be applied to the layout.
* @param update The callback to be invoked after the layout is inflated and upon recomposition to
@@ -126,7 +125,6 @@
* by calling the [factory].
*
* @sample androidx.compose.ui.samples.AndroidViewBindingReusableSample
- *
* @param factory The block creating the [ViewBinding] to be composed.
* @param modifier The modifier to be applied to the layout.
* @param onReset A callback invoked as a signal that the view is about to be attached to the
diff --git a/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/input/key/Key.android.kt b/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/input/key/Key.android.kt
index f1ea657..aaf73bf 100644
--- a/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/input/key/Key.android.kt
+++ b/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/input/key/Key.android.kt
@@ -27,7 +27,6 @@
* Actual implementation of [Key] for Android.
*
* @param keyCode an integer code representing the key pressed.
- *
* @sample androidx.compose.ui.samples.KeyEventIsAltPressedSample
*/
@JvmInline
diff --git a/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/res/PainterResources.android.kt b/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/res/PainterResources.android.kt
index 6587316..13b7dc8 100644
--- a/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/res/PainterResources.android.kt
+++ b/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/res/PainterResources.android.kt
@@ -50,7 +50,6 @@
* Example:
*
* @sample androidx.compose.ui.samples.AndroidDrawableInDrawScopeSample
- *
* @param id Resources object to query the image file from
* @return [Painter] used for drawing the loaded resource
*/
diff --git a/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/viewinterop/AndroidView.android.kt b/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/viewinterop/AndroidView.android.kt
index 77bb59f..9649463 100644
--- a/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/viewinterop/AndroidView.android.kt
+++ b/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/viewinterop/AndroidView.android.kt
@@ -91,9 +91,7 @@
* that participates in nested scroll. For more information on how to enable nested scroll interop:
*
* @sample androidx.compose.ui.samples.ViewInComposeNestedScrollInteropSample
- *
* @sample androidx.compose.ui.samples.AndroidViewSample
- *
* @param factory The block creating the [View] to be composed.
* @param modifier The modifier to be applied to the layout.
* @param update A callback to be invoked after the layout is inflated and upon recomposition to
@@ -176,13 +174,9 @@
* that participates in nested scroll. For more information on how to enable nested scroll interop:
*
* @sample androidx.compose.ui.samples.ViewInComposeNestedScrollInteropSample
- *
* @sample androidx.compose.ui.samples.AndroidViewSample
- *
* @sample androidx.compose.ui.samples.ReusableAndroidViewInLazyColumnSample
- *
* @sample androidx.compose.ui.samples.AndroidViewWithReleaseSample
- *
* @param factory The block creating the [View] to be composed.
* @param modifier The modifier to be applied to the layout.
* @param onReset A callback invoked as a signal that the view is about to be attached to the
diff --git a/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/window/AndroidDialog.android.kt b/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/window/AndroidDialog.android.kt
index 37bbfc5..2bf8d79 100644
--- a/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/window/AndroidDialog.android.kt
+++ b/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/window/AndroidDialog.android.kt
@@ -155,7 +155,6 @@
* Example usage:
*
* @sample androidx.compose.ui.samples.DialogSample
- *
* @param onDismissRequest Executes when the user tries to dismiss the dialog.
* @param properties [DialogProperties] for further customization of this dialog's behavior.
* @param content The content to be displayed inside the dialog.
diff --git a/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/window/AndroidPopup.android.kt b/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/window/AndroidPopup.android.kt
index ba9f34c..08a4867 100644
--- a/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/window/AndroidPopup.android.kt
+++ b/compose/ui/ui/src/androidMain/kotlin/androidx/compose/ui/window/AndroidPopup.android.kt
@@ -251,7 +251,6 @@
* visible as long as it is part of the composition hierarchy.
*
* @sample androidx.compose.ui.samples.PopupSample
- *
* @param alignment The alignment relative to the parent.
* @param offset An offset from the original aligned position of the popup. Offset respects the
* Ltr/Rtl context, thus in Ltr it will be added to the original aligned position and in Rtl it
@@ -285,7 +284,6 @@
* The popup is positioned using a custom [popupPositionProvider].
*
* @sample androidx.compose.ui.samples.PopupSample
- *
* @param popupPositionProvider Provides the screen position of the popup.
* @param onDismissRequest Executes when the user clicks outside of the popup.
* @param properties [PopupProperties] for further customization of this popup's behavior.
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/ComposedModifier.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/ComposedModifier.kt
index 6741458..eba09e7 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/ComposedModifier.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/ComposedModifier.kt
@@ -38,7 +38,6 @@
* Example usage:
*
* @sample androidx.compose.ui.samples.InspectorInfoInComposedModifierSample
- *
* @sample androidx.compose.ui.samples.InspectorInfoInComposedModifierWithArgumentsSample
*
* [materialize] must be called to create instance-specific modifiers if you are directly applying a
@@ -66,7 +65,6 @@
* Example usage:
*
* @sample androidx.compose.ui.samples.InspectorInfoInComposedModifierSample
- *
* @sample androidx.compose.ui.samples.InspectorInfoInComposedModifierWithArgumentsSample
*
* [materialize] must be called to create instance-specific modifiers if you are directly applying a
@@ -97,7 +95,6 @@
* Example usage:
*
* @sample androidx.compose.ui.samples.InspectorInfoInComposedModifierSample
- *
* @sample androidx.compose.ui.samples.InspectorInfoInComposedModifierWithArgumentsSample
*
* [materialize] must be called to create instance-specific modifiers if you are directly applying a
@@ -130,7 +127,6 @@
* Example usage:
*
* @sample androidx.compose.ui.samples.InspectorInfoInComposedModifierSample
- *
* @sample androidx.compose.ui.samples.InspectorInfoInComposedModifierWithArgumentsSample
*
* [materialize] must be called to create instance-specific modifiers if you are directly applying a
@@ -164,7 +160,6 @@
* Example usage:
*
* @sample androidx.compose.ui.samples.InspectorInfoInComposedModifierSample
- *
* @sample androidx.compose.ui.samples.InspectorInfoInComposedModifierWithArgumentsSample
*
* [materialize] must be called to create instance-specific modifiers if you are directly applying a
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/Modifier.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/Modifier.kt
index e7dc8b0..df5b726 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/Modifier.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/Modifier.kt
@@ -192,7 +192,6 @@
* after the node is detached (after [onDetach] returns).
*
* @sample androidx.compose.ui.samples.ModifierNodeCoroutineScopeSample
- *
* @throws IllegalStateException If called while the node is not attached.
*/
val coroutineScope: CoroutineScope
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Alpha.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Alpha.kt
index 643ed6f..c04593b 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Alpha.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Alpha.kt
@@ -30,11 +30,10 @@
* modifier is configured on, and contents outside of these bounds are omitted.
*
* @param alpha the fraction of children's alpha value and must be between `0` and `1`, inclusive.
+ * @sample androidx.compose.ui.samples.AlphaSample
* @see graphicsLayer
*
* Example usage:
- *
- * @sample androidx.compose.ui.samples.AlphaSample
*/
@Stable
fun Modifier.alpha(
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Blur.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Blur.kt
index acd7da2..7cad218 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Blur.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Blur.kt
@@ -83,13 +83,11 @@
* @param radiusX Radius of the blur along the x axis
* @param radiusY Radius of the blur along the y axis
* @param edgeTreatment Strategy used to render pixels outside of bounds of the original input
+ * @sample androidx.compose.ui.samples.BlurSample
+ * @sample androidx.compose.ui.samples.ImageBlurSample
* @see graphicsLayer
*
* Example usage:
- *
- * @sample androidx.compose.ui.samples.BlurSample
- *
- * @sample androidx.compose.ui.samples.ImageBlurSample
*/
@Stable
fun Modifier.blur(
@@ -136,13 +134,11 @@
*
* @param radius Radius of the blur along both the x and y axis
* @param edgeTreatment Strategy used to render pixels outside of bounds of the original input
+ * @sample androidx.compose.ui.samples.BlurSample
+ * @sample androidx.compose.ui.samples.ImageBlurSample
* @see graphicsLayer
*
* Example usage:
- *
- * @sample androidx.compose.ui.samples.BlurSample
- *
- * @sample androidx.compose.ui.samples.ImageBlurSample
*/
@Stable
fun Modifier.blur(
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/DrawModifier.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/DrawModifier.kt
index 5dbf144..77a96e4 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/DrawModifier.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/DrawModifier.kt
@@ -125,9 +125,7 @@
* calls without having to re-allocate.
*
* @sample androidx.compose.ui.samples.DrawWithCacheModifierSample
- *
* @sample androidx.compose.ui.samples.DrawWithCacheModifierStateParameterSample
- *
* @sample androidx.compose.ui.samples.DrawWithCacheContentSample
*/
fun Modifier.drawWithCache(onBuildDrawCache: CacheDrawScope.() -> DrawResult) =
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/PainterModifier.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/PainterModifier.kt
index b1637e8..334a0ad 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/PainterModifier.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/PainterModifier.kt
@@ -54,7 +54,6 @@
* @param contentScale strategy for scaling [painter] if its size does not match the content size
* @param alpha opacity of [painter]
* @param colorFilter optional [ColorFilter] to apply to [painter]
- *
* @sample androidx.compose.ui.samples.PainterModifierSample
*/
fun Modifier.paint(
@@ -84,7 +83,6 @@
* @param contentScale strategy for scaling [painter] if its size does not match the content size
* @param alpha opacity of [painter]
* @param colorFilter optional [ColorFilter] to apply to [painter]
- *
* @sample androidx.compose.ui.samples.PainterModifierSample
*/
private data class PainterElement(
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Rotate.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Rotate.kt
index 4dcc81f..3754ed7 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Rotate.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Rotate.kt
@@ -27,11 +27,10 @@
*
* Usage of this API renders this composable into a separate graphics layer.
*
+ * @sample androidx.compose.ui.samples.RotateSample
* @see graphicsLayer
*
* Example usage:
- *
- * @sample androidx.compose.ui.samples.RotateSample
*/
@Stable
fun Modifier.rotate(degrees: Float) =
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Scale.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Scale.kt
index 65efbb9..907fa78 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Scale.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Scale.kt
@@ -49,10 +49,9 @@
* Usage of this API renders this composable into a separate graphics layer
*
* @param scale Multiplier to scale content along the horizontal and vertical axis
+ * @sample androidx.compose.ui.samples.ScaleUniformSample
* @see graphicsLayer
*
* Example usage:
- *
- * @sample androidx.compose.ui.samples.ScaleUniformSample
*/
@Stable fun Modifier.scale(scale: Float) = scale(scale, scale)
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Shadow.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Shadow.kt
index 1365dd3..573200b 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Shadow.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/draw/Shadow.kt
@@ -45,11 +45,10 @@
* @param elevation The elevation for the shadow in pixels
* @param shape Defines a shape of the physical object
* @param clip When active, the content drawing clips to the shape.
+ * @sample androidx.compose.ui.samples.ShadowSample
* @see graphicsLayer
*
* Example usage:
- *
- * @sample androidx.compose.ui.samples.ShadowSample
*/
@Deprecated(
"Replace with shadow which accepts ambientColor and spotColor parameters",
@@ -93,11 +92,10 @@
* @param clip When active, the content drawing clips to the shape.
* @param ambientColor Color of the ambient shadow drawn when [elevation] > 0f
* @param spotColor Color of the spot shadow that is drawn when [elevation] > 0f
+ * @sample androidx.compose.ui.samples.ShadowSample
* @see graphicsLayer
*
* Example usage:
- *
- * @sample androidx.compose.ui.samples.ShadowSample
*/
@Stable
fun Modifier.shadow(
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusManager.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusManager.kt
index a0eff64..b28cd1a 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusManager.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusManager.kt
@@ -26,7 +26,6 @@
*
* @param force: Whether we should forcefully clear focus regardless of whether we have any
* components that have Captured focus.
- *
* @sample androidx.compose.ui.samples.ClearFocusSample
*/
fun clearFocus(force: Boolean = false)
@@ -38,7 +37,6 @@
* [Modifier.focusProperties()][focusProperties].
*
* @return true if focus was moved successfully. false if the focused item is unchanged.
- *
* @sample androidx.compose.ui.samples.MoveFocusSample
*/
fun moveFocus(focusDirection: FocusDirection): Boolean
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusOrderModifier.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusOrderModifier.kt
index 249ce09..86b4d50 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusOrderModifier.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusOrderModifier.kt
@@ -143,7 +143,6 @@
* the current focus to the [next][FocusOrder.next] item, or wants to move focus
* [left][FocusOrder.left], [right][FocusOrder.right], [up][FocusOrder.up] or
* [down][FocusOrder.down].
- *
* @sample androidx.compose.ui.samples.CustomFocusOrderSample
*/
@Deprecated(
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusRequester.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusRequester.kt
index 1d3656f..f1dd626 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusRequester.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusRequester.kt
@@ -46,7 +46,6 @@
* focus.
*
* @sample androidx.compose.ui.samples.RequestFocusSample
- *
* @see androidx.compose.ui.focus.focusRequester
*/
@Stable
@@ -91,7 +90,6 @@
*
* @return true if the focus was successfully captured by one of the [focus][focusTarget]
* modifiers associated with this [FocusRequester]. False otherwise.
- *
* @sample androidx.compose.ui.samples.CaptureFocusSample
*/
fun captureFocus(): Boolean {
@@ -115,7 +113,6 @@
*
* @return true if the captured focus was successfully released. i.e. At the end of this
* operation, one of the components associated with this [focusRequester] freed focus.
- *
* @sample androidx.compose.ui.samples.CaptureFocusSample
*/
fun freeFocus(): Boolean {
@@ -135,7 +132,6 @@
*
* @return true if the focus target associated with this [FocusRequester] has a focused child
* and we successfully saved a reference to it.
- *
* @sample androidx.compose.ui.samples.RestoreFocusSample
*/
@ExperimentalComposeUiApi
@@ -152,7 +148,6 @@
*
* @return true if we successfully restored focus to one of the children of the [focusTarget]
* associated with this [FocusRequester]
- *
* @sample androidx.compose.ui.samples.RestoreFocusSample
*/
@ExperimentalComposeUiApi
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusRequesterModifier.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusRequesterModifier.kt
index 1fd0a57..d474394 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusRequesterModifier.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusRequesterModifier.kt
@@ -25,7 +25,6 @@
* request focus state changes.
*
* @sample androidx.compose.ui.samples.RequestFocusSample
- *
* @see FocusRequester
* @see Modifier.focusRequester
*/
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusRequesterModifierNode.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusRequesterModifierNode.kt
index cdf573a..e7da1e8 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusRequesterModifierNode.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusRequesterModifierNode.kt
@@ -59,7 +59,6 @@
*
* @return true if the focus was successfully captured by one of the [focus][focusTarget] modifiers
* associated with this [FocusRequester]. False otherwise.
- *
* @sample androidx.compose.ui.samples.CaptureFocusSample
*/
fun FocusRequesterModifierNode.captureFocus(): Boolean {
@@ -80,7 +79,6 @@
*
* @return true if the captured focus was successfully released. i.e. At the end of this operation,
* one of the components associated with this [focusRequester] freed focus.
- *
* @sample androidx.compose.ui.samples.CaptureFocusSample
*/
fun FocusRequesterModifierNode.freeFocus(): Boolean {
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusRestorer.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusRestorer.kt
index 3fd6a4d..40d3c9e6 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusRestorer.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusRestorer.kt
@@ -81,9 +81,7 @@
* @param onRestoreFailed callback provides a lambda that is invoked if focus restoration fails.
* This lambda can be used to return a custom fallback item by providing a [FocusRequester]
* attached to that item. This can be used to customize the initially focused item.
- *
* @sample androidx.compose.ui.samples.FocusRestorerSample
- *
* @sample androidx.compose.ui.samples.FocusRestorerCustomFallbackSample
*/
@ExperimentalComposeUiApi
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusState.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusState.kt
index d706476..dc7c8c2 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusState.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/focus/FocusState.kt
@@ -27,7 +27,6 @@
* Whether the component is focused or not.
*
* @sample androidx.compose.ui.samples.FocusableSample
- *
* @return true if the component is focused, false otherwise.
*/
val isFocused: Boolean
@@ -49,7 +48,6 @@
* by calling [focusRequester.freeFocus()][freeFocus].
*
* @return true if focus is captured, false otherwise.
- *
* @sample androidx.compose.ui.samples.CaptureFocusSample
*/
val isCaptured: Boolean
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/graphics/GraphicsLayerModifier.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/graphics/GraphicsLayerModifier.kt
index de9fb2e..e7813a0 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/graphics/GraphicsLayerModifier.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/graphics/GraphicsLayerModifier.kt
@@ -53,7 +53,6 @@
* block will only cause the layer properties update without triggering recomposition and relayout.
*
* @sample androidx.compose.ui.samples.ChangeOpacity
- *
* @param scaleX see [GraphicsLayerScope.scaleX]
* @param scaleY see [GraphicsLayerScope.scaleY]
* @param alpha see [GraphicsLayerScope.alpha]
@@ -137,7 +136,6 @@
* block will only cause the layer properties update without triggering recomposition and relayout.
*
* @sample androidx.compose.ui.samples.ChangeOpacity
- *
* @param scaleX see [GraphicsLayerScope.scaleX]
* @param scaleY see [GraphicsLayerScope.scaleY]
* @param alpha see [GraphicsLayerScope.alpha]
@@ -226,7 +224,6 @@
* block will only cause the layer properties update without triggering recomposition and relayout.
*
* @sample androidx.compose.ui.samples.ChangeOpacity
- *
* @param scaleX see [GraphicsLayerScope.scaleX]
* @param scaleY see [GraphicsLayerScope.scaleY]
* @param alpha see [GraphicsLayerScope.alpha]
@@ -326,9 +323,7 @@
* block will only cause the layer properties update without triggering recomposition and relayout.
*
* @sample androidx.compose.ui.samples.ChangeOpacity
- *
* @sample androidx.compose.ui.samples.CompositingStrategyModulateAlpha
- *
* @param scaleX see [GraphicsLayerScope.scaleX]
* @param scaleY see [GraphicsLayerScope.scaleY]
* @param alpha see [GraphicsLayerScope.alpha]
@@ -483,7 +478,6 @@
* cause the layer properties update without triggering recomposition and relayout.
*
* @sample androidx.compose.ui.samples.AnimateFadeIn
- *
* @param block block on [GraphicsLayerScope] where you define the layer properties.
*/
@Stable
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/key/Key.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/key/Key.kt
index 0552464..2668771 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/key/Key.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/key/Key.kt
@@ -21,7 +21,6 @@
*
* @param keyCode a Long value representing the key pressed. Note: This keycode can be used to
* uniquely identify a hardware key. It is different from the native keycode.
- *
* @sample androidx.compose.ui.samples.KeyEventIsAltPressedSample
*/
@kotlin.jvm.JvmInline
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/key/KeyInputModifier.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/key/KeyInputModifier.kt
index 04c9f7a..cba5ff1 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/key/KeyInputModifier.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/key/KeyInputModifier.kt
@@ -27,7 +27,6 @@
* @param onKeyEvent This callback is invoked when the user interacts with the hardware keyboard.
* While implementing this callback, return true to stop propagation of this event. If you return
* false, the key event will be sent to this [onKeyEvent]'s parent.
- *
* @sample androidx.compose.ui.samples.KeyEventSample
*/
fun Modifier.onKeyEvent(onKeyEvent: (KeyEvent) -> Boolean): Modifier =
@@ -42,7 +41,6 @@
* Return true to stop propagation of this event. If you return false, the key event will be sent
* to this [onPreviewKeyEvent]'s child. If none of the children consume the event, it will be sent
* back up to the root [KeyInputModifierNode] using the onKeyEvent callback.
- *
* @sample androidx.compose.ui.samples.KeyEventSample
*/
fun Modifier.onPreviewKeyEvent(onPreviewKeyEvent: (KeyEvent) -> Boolean): Modifier =
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/key/SoftwareKeyboardInterceptionModifier.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/key/SoftwareKeyboardInterceptionModifier.kt
index ea7075b..961677a 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/key/SoftwareKeyboardInterceptionModifier.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/key/SoftwareKeyboardInterceptionModifier.kt
@@ -31,7 +31,6 @@
* hardware keyboard. While implementing this callback, return true to stop propagation of this
* event. If you return false, the key event will be sent to this
* [SoftKeyboardInterceptionModifierNode]'s parent, and ultimately to the software keyboard.
- *
* @sample androidx.compose.ui.samples.KeyEventSample
*/
@ExperimentalComposeUiApi
@@ -58,7 +57,6 @@
* will be sent to this [SoftKeyboardInterceptionModifierNode]'s child. If none of the children
* consume the event, it will be sent back up to the root [KeyInputModifierNode] using the
* onKeyEvent callback, and ultimately to the software keyboard.
- *
* @sample androidx.compose.ui.samples.KeyEventSample
*/
@ExperimentalComposeUiApi
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/pointer/PointerIcon.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/pointer/PointerIcon.kt
index a7695fd..be06d69 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/pointer/PointerIcon.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/pointer/PointerIcon.kt
@@ -72,7 +72,6 @@
* icon using this modifier.
*
* @sample androidx.compose.ui.samples.PointerIconSample
- *
* @param icon The icon to set
* @param overrideDescendants when false (by default) descendants are able to set their own pointer
* icon. If true, no descendants under this parent are eligible to change the icon (it will be set
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/rotary/RotaryInputModifier.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/rotary/RotaryInputModifier.kt
index 993a03d..857fc44 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/rotary/RotaryInputModifier.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/input/rotary/RotaryInputModifier.kt
@@ -61,7 +61,6 @@
* Return true to indicate that you consumed the event and want to stop propagation of this event.
*
* @return true if the event is consumed, false otherwise.
- *
* @sample androidx.compose.ui.samples.PreRotaryEventSample
*/
fun Modifier.onPreRotaryScrollEvent(
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/AlignmentLine.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/AlignmentLine.kt
index 856319e..1259025 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/AlignmentLine.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/AlignmentLine.kt
@@ -46,7 +46,6 @@
* [HorizontalAlignmentLine] instances instead.
*
* @sample androidx.compose.ui.samples.AlignmentLineSample
- *
* @see VerticalAlignmentLine
* @see HorizontalAlignmentLine
*/
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/Layout.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/Layout.kt
index 9085f7d..4947cd0 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/Layout.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/Layout.kt
@@ -61,7 +61,6 @@
* Example usage with custom intrinsic measurements:
*
* @sample androidx.compose.ui.samples.LayoutWithProvidedIntrinsicsUsage
- *
* @param content The children composable to be laid out.
* @param modifier Modifiers to be applied to the layout.
* @param measurePolicy The policy defining the measurement and positioning of the layout.
@@ -109,7 +108,6 @@
* Example usage with custom intrinsic measurements:
*
* @sample androidx.compose.ui.samples.LayoutWithProvidedIntrinsicsUsage
- *
* @param modifier Modifiers to be applied to the layout.
* @param measurePolicy The policy defining the measurement and positioning of the layout.
* @see Layout
@@ -151,7 +149,6 @@
* Example usage:
*
* @sample androidx.compose.ui.samples.LayoutWithMultipleContentsUsage
- *
* @param contents The list of children composable contents to be laid out.
* @param modifier Modifiers to be applied to the layout.
* @param measurePolicy The policy defining the measurement and positioning of the layout.
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/LayoutModifier.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/LayoutModifier.kt
index 7097439..881e7f6 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/LayoutModifier.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/LayoutModifier.kt
@@ -34,7 +34,6 @@
* children.
*
* @sample androidx.compose.ui.samples.LayoutModifierSample
- *
* @see androidx.compose.ui.layout.Layout
*/
@JvmDefaultWithCompatibility
@@ -240,7 +239,6 @@
* Example usage:
*
* @sample androidx.compose.ui.samples.ConvenienceLayoutModifierSample
- *
* @see androidx.compose.ui.layout.LayoutModifier
*/
fun Modifier.layout(measure: MeasureScope.(Measurable, Constraints) -> MeasureResult) =
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/LookaheadScope.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/LookaheadScope.kt
index a9a1d49..8c36bae 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/LookaheadScope.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/LookaheadScope.kt
@@ -40,7 +40,6 @@
* [Layout]s in the [content] will have the same parent as they would without [LookaheadScope].
*
* @sample androidx.compose.ui.samples.LookaheadLayoutCoordinatesSample
- *
* @param content The child composable to be laid out.
* @see ApproachLayoutModifierNode
* @see approachLayout
@@ -96,9 +95,8 @@
* [isMeasurementApproachInProgress]. A prolonged indication of incomplete approach will prevent the
* system from potentially skipping approach pass when possible.
*
- * @see ApproachLayoutModifierNode
- *
* @sample androidx.compose.ui.samples.approachLayoutSample
+ * @see ApproachLayoutModifierNode
*/
fun Modifier.approachLayout(
isMeasurementApproachInProgress: (lookaheadSize: IntSize) -> Boolean,
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/SubcomposeLayout.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/SubcomposeLayout.kt
index f90fccf..124bc66 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/SubcomposeLayout.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/layout/SubcomposeLayout.kt
@@ -68,7 +68,6 @@
* visible(say 5 of them) and compose next items when the component is scrolled.
*
* @sample androidx.compose.ui.samples.SubcomposeLayoutSample
- *
* @param modifier [Modifier] to apply for the layout.
* @param measurePolicy Measure policy which provides ability to subcompose during the measuring.
*/
@@ -99,7 +98,6 @@
* visible(say 5 of them) and compose next items when the component is scrolled.
*
* @sample androidx.compose.ui.samples.SubcomposeLayoutSample
- *
* @param state the state object to be used by the layout.
* @param modifier [Modifier] to apply for the layout.
* @param measurePolicy Measure policy which provides ability to subcompose during the measuring.
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/modifier/ModifierLocal.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/modifier/ModifierLocal.kt
index 84d1d28..d6aecc4 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/modifier/ModifierLocal.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/modifier/ModifierLocal.kt
@@ -84,7 +84,6 @@
* Sample 2: Modifier sending a message to a modifier on a parent layout node.
*
* @sample androidx.compose.ui.samples.ModifierLocalChildParentCommunicationInterLayoutNodeSample
- *
* @see ProvidableModifierLocal
* @see ModifierLocal
* @see modifierLocalProvider
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/modifier/ModifierLocalModifierNode.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/modifier/ModifierLocalModifierNode.kt
index 2bcf8ec..638ebed 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/modifier/ModifierLocalModifierNode.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/modifier/ModifierLocalModifierNode.kt
@@ -113,7 +113,6 @@
* [ModifierLocalProvider] interfaces.
*
* @sample androidx.compose.ui.samples.JustReadingOrProvidingModifierLocalNodeSample
- *
* @see modifierLocalOf
* @see ModifierLocal
* @see androidx.compose.runtime.CompositionLocal
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/CompositionLocalConsumerModifierNode.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/CompositionLocalConsumerModifierNode.kt
index 151bfea..d938827 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/CompositionLocalConsumerModifierNode.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/CompositionLocalConsumerModifierNode.kt
@@ -29,7 +29,6 @@
* corresponding layout node.
*
* @sample androidx.compose.ui.samples.CompositionLocalConsumingModifierSample
- *
* @see Modifier.Node
* @see CompositionLocal
*/
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/DelegatingNode.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/DelegatingNode.kt
index 5d7e36e..4ebca58e 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/DelegatingNode.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/DelegatingNode.kt
@@ -26,15 +26,10 @@
* This can be useful to compose multiple node implementations into one.
*
* @sample androidx.compose.ui.samples.DelegatedNodeSampleExplicit
- *
* @sample androidx.compose.ui.samples.DelegatedNodeSampleImplicit
- *
* @sample androidx.compose.ui.samples.LazyDelegationExample
- *
* @sample androidx.compose.ui.samples.ConditionalDelegationExample
- *
* @sample androidx.compose.ui.samples.DelegateInAttachSample
- *
* @see DelegatingNode
*/
abstract class DelegatingNode : Modifier.Node() {
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/GlobalPositionAwareModifierNode.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/GlobalPositionAwareModifierNode.kt
index cb565b6..8c1de3d 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/GlobalPositionAwareModifierNode.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/GlobalPositionAwareModifierNode.kt
@@ -30,9 +30,7 @@
* Usage example:
*
* @sample androidx.compose.ui.samples.OnGloballyPositioned
- *
* @sample androidx.compose.ui.samples.GlobalPositionAwareModifierNodeSample
- *
* @see LayoutCoordinates
*/
interface GlobalPositionAwareModifierNode : DelegatableNode {
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/LayoutAwareModifierNode.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/LayoutAwareModifierNode.kt
index 6718c52..8f32b3a 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/LayoutAwareModifierNode.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/LayoutAwareModifierNode.kt
@@ -32,9 +32,7 @@
* Example usage:
*
* @sample androidx.compose.ui.samples.OnSizeChangedSample
- *
* @sample androidx.compose.ui.samples.OnPlaced
- *
* @sample androidx.compose.ui.samples.LayoutAwareModifierNodeSample
*/
interface LayoutAwareModifierNode : DelegatableNode {
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/LayoutModifierNode.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/LayoutModifierNode.kt
index 0acd408..f06dc05 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/LayoutModifierNode.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/LayoutModifierNode.kt
@@ -46,7 +46,6 @@
* [androidx.compose.ui.layout.LayoutModifier]
*
* @sample androidx.compose.ui.samples.LayoutModifierNodeSample
- *
* @see androidx.compose.ui.layout.Layout
*/
interface LayoutModifierNode : DelegatableNode {
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/ModifierNodeElement.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/ModifierNodeElement.kt
index d5bb36a..e4f9b48 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/ModifierNodeElement.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/node/ModifierNodeElement.kt
@@ -31,9 +31,7 @@
* necessary to create and maintain an instance of the associated [Modifier.Node] type.
*
* @sample androidx.compose.ui.samples.ModifierNodeElementSample
- *
* @sample androidx.compose.ui.samples.SemanticsModifierNodeSample
- *
* @see Modifier.Node
* @see Modifier.Element
*/
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/platform/PlatformTextInputModifierNode.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/platform/PlatformTextInputModifierNode.kt
index 840b5e4..27774fc 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/platform/PlatformTextInputModifierNode.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/platform/PlatformTextInputModifierNode.kt
@@ -120,7 +120,6 @@
* automatically be closed if the modifier is detached.
*
* @sample androidx.compose.ui.samples.platformTextInputModifierNodeSample
- *
* @param block A suspend function that will be called when the session is started and that must
* call [PlatformTextInputSession.startInputMethod] to actually show and initiate the connection
* with the input method.
@@ -144,7 +143,6 @@
* cancelled and the request will be re-used to pass to the new interceptor.
*
* @sample androidx.compose.ui.samples.InterceptPlatformTextInputSample
- *
* @sample androidx.compose.ui.samples.disableSoftKeyboardSample
*/
@ExperimentalComposeUiApi
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/window/Dialog.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/window/Dialog.kt
index 87e634ea..37c8dc6 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/window/Dialog.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/window/Dialog.kt
@@ -57,7 +57,6 @@
* Example usage:
*
* @sample androidx.compose.ui.samples.DialogSample
- *
* @param onDismissRequest Executes when the user tries to dismiss the dialog.
* @param properties [DialogProperties] for further customization of this dialog's behavior.
* @param content The content to be displayed inside the dialog.
diff --git a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/window/Popup.kt b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/window/Popup.kt
index de00d54..4086683 100644
--- a/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/window/Popup.kt
+++ b/compose/ui/ui/src/commonMain/kotlin/androidx/compose/ui/window/Popup.kt
@@ -113,7 +113,6 @@
* visible as long as it is part of the composition hierarchy.
*
* @sample androidx.compose.ui.samples.PopupSample
- *
* @param alignment The alignment relative to the parent.
* @param offset An offset from the original aligned position of the popup. Offset respects the
* Ltr/Rtl context, thus in Ltr it will be added to the original aligned position and in Rtl it
@@ -137,7 +136,6 @@
* The popup is positioned using a custom [popupPositionProvider].
*
* @sample androidx.compose.ui.samples.PopupSample
- *
* @param popupPositionProvider Provides the screen position of the popup.
* @param onDismissRequest Executes when the user clicks outside of the popup.
* @param properties [PopupProperties] for further customization of this popup's behavior.
diff --git a/compose/ui/ui/src/skikoMain/kotlin/androidx/compose/ui/window/Popup.skiko.kt b/compose/ui/ui/src/skikoMain/kotlin/androidx/compose/ui/window/Popup.skiko.kt
index f87bd38..de52b39 100644
--- a/compose/ui/ui/src/skikoMain/kotlin/androidx/compose/ui/window/Popup.skiko.kt
+++ b/compose/ui/ui/src/skikoMain/kotlin/androidx/compose/ui/window/Popup.skiko.kt
@@ -125,7 +125,6 @@
* visible as long as it is part of the composition hierarchy.
*
* @sample androidx.compose.ui.samples.PopupSample
- *
* @param alignment The alignment relative to the parent.
* @param offset An offset from the original aligned position of the popup. Offset respects the
* Ltr/Rtl context, thus in Ltr it will be added to the original aligned position and in Rtl it
@@ -181,7 +180,6 @@
* The popup is positioned using a custom [popupPositionProvider].
*
* @sample androidx.compose.ui.samples.PopupSample
- *
* @param popupPositionProvider Provides the screen position of the popup.
* @param onDismissRequest Executes when the user clicks outside of the popup.
* @param focusable Indicates if the popup can grab the focus.
@@ -237,7 +235,6 @@
* visible as long as it is part of the composition hierarchy.
*
* @sample androidx.compose.ui.samples.PopupSample
- *
* @param alignment The alignment relative to the parent.
* @param offset An offset from the original aligned position of the popup. Offset respects the
* Ltr/Rtl context, thus in Ltr it will be added to the original aligned position and in Rtl it
@@ -270,7 +267,6 @@
* The popup is positioned using a custom [popupPositionProvider].
*
* @sample androidx.compose.ui.samples.PopupSample
- *
* @param popupPositionProvider Provides the screen position of the popup.
* @param onDismissRequest Executes when the user clicks outside of the popup.
* @param properties [PopupProperties] for further customization of this popup's behavior.
@@ -303,7 +299,6 @@
* visible as long as it is part of the composition hierarchy.
*
* @sample androidx.compose.ui.samples.PopupSample
- *
* @param alignment The alignment relative to the parent.
* @param offset An offset from the original aligned position of the popup. Offset respects the
* Ltr/Rtl context, thus in Ltr it will be added to the original aligned position and in Rtl it
@@ -348,7 +343,6 @@
* The popup is positioned using a custom [popupPositionProvider].
*
* @sample androidx.compose.ui.samples.PopupSample
- *
* @param popupPositionProvider Provides the screen position of the popup.
* @param onDismissRequest Executes when the user clicks outside of the popup.
* @param properties [PopupProperties] for further customization of this popup's behavior.
diff --git a/core/haptics/haptics/src/main/java/androidx/core/haptics/HapticManager.kt b/core/haptics/haptics/src/main/java/androidx/core/haptics/HapticManager.kt
index dc25961..fead4c2 100644
--- a/core/haptics/haptics/src/main/java/androidx/core/haptics/HapticManager.kt
+++ b/core/haptics/haptics/src/main/java/androidx/core/haptics/HapticManager.kt
@@ -43,7 +43,6 @@
* vibrator check [Vibrator.hasVibrator] returns true, and returns null otherwise.
*
* @sample androidx.core.haptics.samples.PlaySystemStandardClick
- *
* @param context Context to load the device vibrator.
* @return a new instance of HapticManager for the system vibrator, or null if the device
* does not have a vibrator motor.
@@ -80,7 +79,6 @@
* Play a [HapticSignal].
*
* @sample androidx.core.haptics.samples.PlayHapticSignal
- *
* @param signal The haptic signal to be played.
* @param attrs The attributes corresponding to the haptic signal. For example, specify
* [HapticAttributes.USAGE_NOTIFICATION] for notification vibrations or
@@ -96,7 +94,6 @@
* [HapticSignal] only once using this [deviceProfile] and then reusing it.
*
* @sample androidx.core.haptics.samples.PlayResolvableHapticSignal
- *
* @param signal The haptic signal to be resolved using this device profile and played.
* @param attrs The attributes corresponding to the haptic signal. For example, specify
* [HapticAttributes.USAGE_NOTIFICATION] for notification vibrations or
diff --git a/core/haptics/haptics/src/main/java/androidx/core/haptics/signal/CompositionSignal.kt b/core/haptics/haptics/src/main/java/androidx/core/haptics/signal/CompositionSignal.kt
index 4ce01e2..7875984 100644
--- a/core/haptics/haptics/src/main/java/androidx/core/haptics/signal/CompositionSignal.kt
+++ b/core/haptics/haptics/src/main/java/androidx/core/haptics/signal/CompositionSignal.kt
@@ -53,7 +53,6 @@
* Returns a [CompositionSignal] with given atoms.
*
* @sample androidx.core.haptics.samples.CompositionSignalOfScaledEffectsAndOff
- *
* @param atoms The [CompositionSignal.Atom] instances that define the [CompositionSignal].
*/
@JvmStatic
@@ -164,7 +163,6 @@
* Returns a [CompositionSignal.Atom] to turn the vibrator off for the specified duration.
*
* @sample androidx.core.haptics.samples.CompositionSignalOfScaledEffectsAndOff
- *
* @param duration The duration the vibrator should be turned off.
*/
@RequiresApi(Build.VERSION_CODES.O)
@@ -175,7 +173,6 @@
* Returns a [CompositionSignal.Atom] to turn the vibrator off for the specified duration.
*
* @sample androidx.core.haptics.samples.CompositionSignalOfScaledEffectsAndOff
- *
* @param durationMillis The duration the vibrator should be turned off, in milliseconds.
*/
@JvmStatic fun off(durationMillis: Long) = OffAtom(durationMillis.milliseconds)
@@ -377,7 +374,6 @@
* Returns a [PrimitiveAtom] with same effect type and new [amplitudeScale].
*
* @sample androidx.core.haptics.samples.CompositionSignalOfScaledEffectsAndOff
- *
* @param newAmplitudeScale The amplitude scale for the new [PrimitiveAtom]
* @return A new [PrimitiveAtom] with the same effect type and the new amplitude scale.
*/
diff --git a/core/haptics/haptics/src/main/java/androidx/core/haptics/signal/FallbackChainSignal.kt b/core/haptics/haptics/src/main/java/androidx/core/haptics/signal/FallbackChainSignal.kt
index afddb6a..ee8d533 100644
--- a/core/haptics/haptics/src/main/java/androidx/core/haptics/signal/FallbackChainSignal.kt
+++ b/core/haptics/haptics/src/main/java/androidx/core/haptics/signal/FallbackChainSignal.kt
@@ -26,7 +26,6 @@
* composing this with generic haptic signal extensions, including other fallback chains.
*
* @sample androidx.core.haptics.samples.HapticFallbackChainOfSignals
- *
* @see HapticDeviceProfile
*/
class FallbackChainSignal(
diff --git a/core/haptics/haptics/src/main/java/androidx/core/haptics/signal/WaveformSignal.kt b/core/haptics/haptics/src/main/java/androidx/core/haptics/signal/WaveformSignal.kt
index ea1a856..9c22d48 100644
--- a/core/haptics/haptics/src/main/java/androidx/core/haptics/signal/WaveformSignal.kt
+++ b/core/haptics/haptics/src/main/java/androidx/core/haptics/signal/WaveformSignal.kt
@@ -37,7 +37,6 @@
* vibration is canceled.
*
* @sample androidx.core.haptics.samples.AmplitudeWaveform
- *
* @sample androidx.core.haptics.samples.PatternThenRepeatAmplitudeWaveform
*/
class WaveformSignal(
@@ -57,7 +56,6 @@
* Use [on] and [off] to create atoms.
*
* @sample androidx.core.haptics.samples.AmplitudeWaveform
- *
* @param atoms The [WaveformSignal.Atom] instances that define the [WaveformSignal].
*/
@JvmStatic
@@ -70,7 +68,6 @@
* the atom list.
*
* @sample androidx.core.haptics.samples.RepeatingAmplitudeWaveform
- *
* @param atoms The [WaveformSignal.Atom] instances that define the
* [RepeatingWaveformSignal].
*/
@@ -82,7 +79,6 @@
* Returns a [WaveformSignal.Atom] that turns off the vibrator for the specified duration.
*
* @sample androidx.core.haptics.samples.PatternWaveform
- *
* @param duration The duration the vibrator should be turned off.
*/
@RequiresApi(Build.VERSION_CODES.O)
@@ -94,7 +90,6 @@
* Returns a [WaveformSignal.Atom] that turns off the vibrator for the specified duration.
*
* @sample androidx.core.haptics.samples.PatternWaveform
- *
* @param durationMillis The duration the vibrator should be turned off, in milliseconds.
*/
@JvmStatic
@@ -106,7 +101,6 @@
* a device-specific default amplitude.
*
* @sample androidx.core.haptics.samples.PatternWaveform
- *
* @param duration The duration for the vibration.
*/
@RequiresApi(Build.VERSION_CODES.O)
@@ -119,7 +113,6 @@
* a device-specific default amplitude.
*
* @sample androidx.core.haptics.samples.PatternWaveform
- *
* @param durationMillis The duration for the vibration, in milliseconds.
*/
@JvmStatic
@@ -131,7 +124,6 @@
* the specified amplitude.
*
* @sample androidx.core.haptics.samples.AmplitudeWaveform
- *
* @param duration The duration for the vibration.
* @param amplitude The vibration strength, with 1 representing maximum amplitude, and 0
* representing off - equivalent to calling [off].
@@ -146,7 +138,6 @@
* the specified amplitude.
*
* @sample androidx.core.haptics.samples.AmplitudeWaveform
- *
* @param durationMillis The duration for the vibration, in milliseconds.
* @param amplitude The vibration strength, with 1 representing maximum amplitude, and 0
* representing off - equivalent to calling [off].
@@ -169,7 +160,6 @@
* given waveform signal on repeat until the vibration is canceled.
*
* @sample androidx.core.haptics.samples.PatternThenRepeatExistingWaveform
- *
* @param waveformToRepeat The waveform to be played on repeat after this waveform.
*/
fun thenRepeat(waveformToRepeat: WaveformSignal): RepeatingWaveformSignal =
@@ -180,7 +170,6 @@
* given waveform atoms on repeat until the vibration is canceled.
*
* @sample androidx.core.haptics.samples.PatternThenRepeatAmplitudeWaveform
- *
* @param atoms The [WaveformSignal.Atom] instances that define the repeating [WaveformSignal]
* to be played after this waveform.
*/
@@ -215,7 +204,6 @@
* step waveform. They can also be used to describe simpler on-off vibration patterns.
*
* @sample androidx.core.haptics.samples.PatternWaveform
- *
* @sample androidx.core.haptics.samples.AmplitudeWaveform
*/
abstract class Atom internal constructor() {
@@ -235,7 +223,6 @@
* vibration strength.
*
* @sample androidx.core.haptics.samples.PatternWaveform
- *
* @sample androidx.core.haptics.samples.AmplitudeWaveform
*/
class ConstantVibrationAtom
diff --git a/credentials/credentials/src/main/java/androidx/credentials/CreateCredentialResponse.kt b/credentials/credentials/src/main/java/androidx/credentials/CreateCredentialResponse.kt
index 4ba376e..f1e20b2 100644
--- a/credentials/credentials/src/main/java/androidx/credentials/CreateCredentialResponse.kt
+++ b/credentials/credentials/src/main/java/androidx/credentials/CreateCredentialResponse.kt
@@ -25,7 +25,6 @@
* [CreateCredentialRequest].
*
* @sample androidx.credentials.samples.processCreateCredentialResponse
- *
* @property type the credential type determined by the credential-type-specific subclass (e.g. the
* type for [CreatePasswordResponse] is [PasswordCredential.TYPE_PASSWORD_CREDENTIAL] and for
* [CreatePublicKeyCredentialResponse] is [PublicKeyCredential.TYPE_PUBLIC_KEY_CREDENTIAL])
diff --git a/credentials/credentials/src/main/java/androidx/credentials/Credential.kt b/credentials/credentials/src/main/java/androidx/credentials/Credential.kt
index aa78e4a..5911e11 100644
--- a/credentials/credentials/src/main/java/androidx/credentials/Credential.kt
+++ b/credentials/credentials/src/main/java/androidx/credentials/Credential.kt
@@ -24,7 +24,6 @@
* Base class for a credential with which the user consented to authenticate to the app.
*
* @sample androidx.credentials.samples.processCredential
- *
* @property type the credential type determined by the credential-type-specific subclass (e.g.
* [PasswordCredential.TYPE_PASSWORD_CREDENTIAL] for `PasswordCredential` or
* [PublicKeyCredential.TYPE_PUBLIC_KEY_CREDENTIAL] for `PublicKeyCredential`)
diff --git a/credentials/credentials/src/main/java/androidx/credentials/CredentialManager.kt b/credentials/credentials/src/main/java/androidx/credentials/CredentialManager.kt
index 6c0a815..0fc653a 100644
--- a/credentials/credentials/src/main/java/androidx/credentials/CredentialManager.kt
+++ b/credentials/credentials/src/main/java/androidx/credentials/CredentialManager.kt
@@ -99,7 +99,6 @@
* credentials, consent to using one of them, etc.
*
* @sample androidx.credentials.samples.callGetCredential
- *
* @param context the context used to launch any UI needed; use an activity context to make sure
* the UI will be launched within the same task stack
* @param request the request for getting the credential
diff --git a/fragment/fragment-compose/src/main/java/androidx/fragment/compose/AndroidFragment.kt b/fragment/fragment-compose/src/main/java/androidx/fragment/compose/AndroidFragment.kt
index a429427..5d9884b 100644
--- a/fragment/fragment-compose/src/main/java/androidx/fragment/compose/AndroidFragment.kt
+++ b/fragment/fragment-compose/src/main/java/androidx/fragment/compose/AndroidFragment.kt
@@ -39,7 +39,6 @@
* added to the fragment manager and invoke the [onUpdate] callback with the new instance.
*
* @sample androidx.fragment.compose.samples.BasicAndroidFragment
- *
* @param modifier the modifier to be applied to the layout
* @param fragmentState the savedState of the fragment
* @param arguments args to be passed to the fragment
@@ -63,7 +62,6 @@
* added to the fragment manager and invoke the [onUpdate] callback with the new instance.
*
* @sample androidx.fragment.compose.samples.BasicAndroidFragment
- *
* @param clazz fragment class to be created
* @param modifier the modifier to be applied to the layout
* @param fragmentState the savedState of the fragment
diff --git a/glance/glance-appwidget-testing/src/main/java/androidx/glance/appwidget/testing/unit/GlanceAppWidgetUnitTest.kt b/glance/glance-appwidget-testing/src/main/java/androidx/glance/appwidget/testing/unit/GlanceAppWidgetUnitTest.kt
index f126e4a..6636b8d 100644
--- a/glance/glance-appwidget-testing/src/main/java/androidx/glance/appwidget/testing/unit/GlanceAppWidgetUnitTest.kt
+++ b/glance/glance-appwidget-testing/src/main/java/androidx/glance/appwidget/testing/unit/GlanceAppWidgetUnitTest.kt
@@ -45,7 +45,6 @@
* Note: Keeping a reference to the [GlanceAppWidgetUnitTest] outside of this function is an error.
*
* @sample androidx.glance.appwidget.testing.samples.isolatedGlanceComposableTestSamples
- *
* @param timeout test time out; defaults to 10s
* @param block The test block that involves calling methods in [GlanceAppWidgetUnitTest]
*/
diff --git a/glance/glance-appwidget/src/main/java/androidx/glance/appwidget/GlanceAppWidget.kt b/glance/glance-appwidget/src/main/java/androidx/glance/appwidget/GlanceAppWidget.kt
index b4eb75e..2018ab0 100644
--- a/glance/glance-appwidget/src/main/java/androidx/glance/appwidget/GlanceAppWidget.kt
+++ b/glance/glance-appwidget/src/main/java/androidx/glance/appwidget/GlanceAppWidget.kt
@@ -77,7 +77,6 @@
* Worker for this widget is not currently running.
*
* @sample androidx.glance.appwidget.samples.provideGlanceSample
- *
* @sample androidx.glance.appwidget.samples.provideGlancePeriodicWorkSample
*/
abstract suspend fun provideGlance(
diff --git a/gradle/libs.versions.toml b/gradle/libs.versions.toml
index 35aabf3..bb362ee 100644
--- a/gradle/libs.versions.toml
+++ b/gradle/libs.versions.toml
@@ -50,7 +50,7 @@
kotlinCoroutines = "1.7.3"
kotlinSerialization = "1.6.3"
ksp = "1.9.24-1.0.20"
-ktfmt = "0.49"
+ktfmt = "0.50"
leakcanary = "2.13"
media3 = "1.1.0"
metalava = "1.0.0-alpha10"
diff --git a/health/connect/connect-client/src/main/java/androidx/health/connect/client/HealthConnectClient.kt b/health/connect/connect-client/src/main/java/androidx/health/connect/client/HealthConnectClient.kt
index a5e0b5c..d179b26 100644
--- a/health/connect/connect-client/src/main/java/androidx/health/connect/client/HealthConnectClient.kt
+++ b/health/connect/connect-client/src/main/java/androidx/health/connect/client/HealthConnectClient.kt
@@ -364,7 +364,6 @@
* @param providerPackageName optional package provider to choose for backend implementation
* @return One of [SDK_UNAVAILABLE], [SDK_UNAVAILABLE_PROVIDER_UPDATE_REQUIRED], or
* [SDK_AVAILABLE]
- *
* @sample androidx.health.connect.client.samples.AvailabilityCheckSamples
*/
@JvmOverloads
diff --git a/health/connect/connect-client/src/main/java/androidx/health/connect/client/HealthConnectClientExt.kt b/health/connect/connect-client/src/main/java/androidx/health/connect/client/HealthConnectClientExt.kt
index f087845..b003557 100644
--- a/health/connect/connect-client/src/main/java/androidx/health/connect/client/HealthConnectClientExt.kt
+++ b/health/connect/connect-client/src/main/java/androidx/health/connect/client/HealthConnectClientExt.kt
@@ -37,11 +37,10 @@
* @throws SecurityException For requests with unpermitted access.
* @throws IOException For any disk I/O issues.
* @throws IllegalStateException If service is not available.
+ * @sample androidx.health.connect.client.samples.DeleteByUniqueIdentifier
* @see HealthConnectClient.deleteRecords
*
* Example usage to delete written steps data by its unique identifier:
- *
- * @sample androidx.health.connect.client.samples.DeleteByUniqueIdentifier
*/
suspend inline fun <reified T : Record> HealthConnectClient.deleteRecords(
recordIdsList: List<String>,
@@ -65,11 +64,10 @@
* @throws SecurityException For requests with unpermitted access.
* @throws IOException For any disk I/O issues.
* @throws IllegalStateException If service is not available.
+ * @sample androidx.health.connect.client.samples.DeleteByTimeRange
* @see HealthConnectClient.deleteRecords
*
* Example usage to delete written steps data in a time range:
- *
- * @sample androidx.health.connect.client.samples.DeleteByTimeRange
*/
suspend inline fun <reified T : Record> HealthConnectClient.deleteRecords(
timeRangeFilter: TimeRangeFilter,
diff --git a/health/connect/connect-client/src/main/java/androidx/health/connect/client/PermissionController.kt b/health/connect/connect-client/src/main/java/androidx/health/connect/client/PermissionController.kt
index dff2f69..2ff38f8 100644
--- a/health/connect/connect-client/src/main/java/androidx/health/connect/client/PermissionController.kt
+++ b/health/connect/connect-client/src/main/java/androidx/health/connect/client/PermissionController.kt
@@ -31,7 +31,6 @@
* @throws android.os.RemoteException For any IPC transportation failures.
* @throws java.io.IOException For any disk I/O issues.
* @throws IllegalStateException If service is not available.
- *
* @sample androidx.health.connect.client.samples.GetPermissions
*/
suspend fun getGrantedPermissions(): Set<String>
@@ -52,9 +51,7 @@
*
* @param providerPackageName Optional provider package name to request health permissions
* from.
- *
* @sample androidx.health.connect.client.samples.RequestPermission
- *
* @see androidx.activity.ComponentActivity.registerForActivityResult
*/
@JvmStatic
diff --git a/health/connect/connect-client/src/main/java/androidx/health/connect/client/permission/HealthPermission.kt b/health/connect/connect-client/src/main/java/androidx/health/connect/client/permission/HealthPermission.kt
index a11aa2d..93d5287 100644
--- a/health/connect/connect-client/src/main/java/androidx/health/connect/client/permission/HealthPermission.kt
+++ b/health/connect/connect-client/src/main/java/androidx/health/connect/client/permission/HealthPermission.kt
@@ -151,7 +151,6 @@
* An attempt to read data in background without this permission may result in an error.
*
* @sample androidx.health.connect.client.samples.RequestBackgroundReadPermission
- *
* @sample androidx.health.connect.client.samples.ReadRecordsInBackground
*/
@RestrictTo(RestrictTo.Scope.LIBRARY) // Hidden for now
diff --git a/hilt/hilt-navigation-compose/src/main/java/androidx/hilt/navigation/compose/HiltViewModel.kt b/hilt/hilt-navigation-compose/src/main/java/androidx/hilt/navigation/compose/HiltViewModel.kt
index 7ab2b31..1f54465 100644
--- a/hilt/hilt-navigation-compose/src/main/java/androidx/hilt/navigation/compose/HiltViewModel.kt
+++ b/hilt/hilt-navigation-compose/src/main/java/androidx/hilt/navigation/compose/HiltViewModel.kt
@@ -39,7 +39,6 @@
* fragment or an activity.
*
* @sample androidx.hilt.navigation.compose.samples.NavComposable
- *
* @sample androidx.hilt.navigation.compose.samples.NestedNavComposable
*/
@Composable
@@ -64,7 +63,6 @@
* fragment or an activity.
*
* @sample androidx.hilt.navigation.compose.samples.NavComposable
- *
* @sample androidx.hilt.navigation.compose.samples.NestedNavComposable
*/
@Composable
diff --git a/lifecycle/lifecycle-runtime-compose/src/commonMain/kotlin/androidx/lifecycle/compose/DropUnlessLifecycle.kt b/lifecycle/lifecycle-runtime-compose/src/commonMain/kotlin/androidx/lifecycle/compose/DropUnlessLifecycle.kt
index 6922e13..f8fc429 100644
--- a/lifecycle/lifecycle-runtime-compose/src/commonMain/kotlin/androidx/lifecycle/compose/DropUnlessLifecycle.kt
+++ b/lifecycle/lifecycle-runtime-compose/src/commonMain/kotlin/androidx/lifecycle/compose/DropUnlessLifecycle.kt
@@ -68,7 +68,6 @@
* [State.STARTED].
* @return A decorated function that invoke [block] only if the lifecycle state is at least
* [State.STARTED].
- *
* @sample androidx.lifecycle.compose.samples.DropUnlessStarted
*/
@CheckResult
@@ -91,7 +90,6 @@
* [State.RESUMED].
* @return A decorated function that invoke [block] only if the lifecycle state is at least
* [State.RESUMED].
- *
* @sample androidx.lifecycle.compose.samples.DropUnlessResumed
*/
@CheckResult
diff --git a/lifecycle/lifecycle-runtime-compose/src/commonMain/kotlin/androidx/lifecycle/compose/LifecycleEffect.kt b/lifecycle/lifecycle-runtime-compose/src/commonMain/kotlin/androidx/lifecycle/compose/LifecycleEffect.kt
index 54ad8ad..6bd95af 100644
--- a/lifecycle/lifecycle-runtime-compose/src/commonMain/kotlin/androidx/lifecycle/compose/LifecycleEffect.kt
+++ b/lifecycle/lifecycle-runtime-compose/src/commonMain/kotlin/androidx/lifecycle/compose/LifecycleEffect.kt
@@ -43,7 +43,6 @@
* in response to state changes.
*
* @sample androidx.lifecycle.compose.samples.lifecycleEventEffectSample
- *
* @param event The [Lifecycle.Event] to listen for
* @param lifecycleOwner The lifecycle owner to attach an observer
* @param onEvent The effect to be launched when we receive an [event] callback
diff --git a/lifecycle/lifecycle-viewmodel-compose/src/androidMain/kotlin/androidx/lifecycle/viewmodel/compose/ViewModel.android.kt b/lifecycle/lifecycle-viewmodel-compose/src/androidMain/kotlin/androidx/lifecycle/viewmodel/compose/ViewModel.android.kt
index 8d4c7cb..b860968 100644
--- a/lifecycle/lifecycle-viewmodel-compose/src/androidMain/kotlin/androidx/lifecycle/viewmodel/compose/ViewModel.android.kt
+++ b/lifecycle/lifecycle-viewmodel-compose/src/androidMain/kotlin/androidx/lifecycle/viewmodel/compose/ViewModel.android.kt
@@ -98,7 +98,6 @@
* null if you would like to use the default factory from the [LocalViewModelStoreOwner]
* @param extras The default extras used to create the [ViewModel].
* @return A [ViewModel] that is an instance of the given [VM] type.
- *
* @sample androidx.lifecycle.viewmodel.compose.samples.CreationExtrasViewModel
*/
@Suppress("MissingJvmstatic")
diff --git a/lifecycle/lifecycle-viewmodel-compose/src/commonMain/kotlin/androidx/lifecycle/viewmodel/compose/ViewModel.kt b/lifecycle/lifecycle-viewmodel-compose/src/commonMain/kotlin/androidx/lifecycle/viewmodel/compose/ViewModel.kt
index cbbad0e..0ce03db 100644
--- a/lifecycle/lifecycle-viewmodel-compose/src/commonMain/kotlin/androidx/lifecycle/viewmodel/compose/ViewModel.kt
+++ b/lifecycle/lifecycle-viewmodel-compose/src/commonMain/kotlin/androidx/lifecycle/viewmodel/compose/ViewModel.kt
@@ -46,7 +46,6 @@
* null if you would like to use the default factory from the [LocalViewModelStoreOwner]
* @param extras The default extras used to create the [ViewModel].
* @return A [ViewModel] that is an instance of the given [VM] type.
- *
* @sample androidx.lifecycle.viewmodel.compose.samples.CreationExtrasViewModel
*/
@Suppress("MissingJvmstatic")
@@ -84,7 +83,6 @@
* null if you would like to use the default factory from the [LocalViewModelStoreOwner]
* @param extras The default extras used to create the [ViewModel].
* @return A [ViewModel] that is an instance of the given [VM] type.
- *
* @sample androidx.lifecycle.viewmodel.compose.samples.CreationExtrasViewModel
*/
@Suppress("MissingJvmstatic")
@@ -120,7 +118,6 @@
* @param key The key to use to identify the [ViewModel].
* @param initializer lambda used to create an instance of the ViewModel class
* @return A [ViewModel] that is an instance of the given [VM] type.
- *
* @sample androidx.lifecycle.viewmodel.compose.samples.CreationExtrasViewModelInitializer
*/
@Composable
diff --git a/navigation/navigation-compose/src/main/java/androidx/navigation/compose/NavGraphBuilder.kt b/navigation/navigation-compose/src/main/java/androidx/navigation/compose/NavGraphBuilder.kt
index 8ec6591..df6bc23 100644
--- a/navigation/navigation-compose/src/main/java/androidx/navigation/compose/NavGraphBuilder.kt
+++ b/navigation/navigation-compose/src/main/java/androidx/navigation/compose/NavGraphBuilder.kt
@@ -229,7 +229,6 @@
* Construct a nested [NavGraph]
*
* @sample androidx.navigation.compose.samples.NavWithArgsInNestedGraph
- *
* @param startDestination the starting destination's route for this NavGraph
* @param route the destination's unique route
* @param arguments list of arguments to associate with destination
@@ -303,7 +302,6 @@
* Construct a nested [NavGraph]
*
* @sample androidx.navigation.compose.samples.SizeTransformNav
- *
* @param startDestination the starting destination's route for this NavGraph
* @param route the destination's unique route
* @param arguments list of arguments to associate with destination
@@ -363,7 +361,6 @@
* Construct a nested [NavGraph]
*
* @sample androidx.navigation.compose.samples.SizeTransformNav
- *
* @param T the destination's unique route from a KClass
* @param startDestination the starting destination's route from [KClass] for this NavGraph
* @param typeMap map of destination arguments' kotlin type [KType] to its respective custom
@@ -465,7 +462,6 @@
* Construct a nested [NavGraph]
*
* @sample androidx.navigation.compose.samples.SizeTransformNav
- *
* @param T the destination's unique route from a KClass
* @param startDestination the starting destination's route from an Object for this NavGraph
* @param typeMap map of destination arguments' kotlin type [KType] to its respective custom
diff --git a/navigation/navigation-compose/src/main/java/androidx/navigation/compose/NavHost.kt b/navigation/navigation-compose/src/main/java/androidx/navigation/compose/NavHost.kt
index b4f6dd3..09f0b3f 100644
--- a/navigation/navigation-compose/src/main/java/androidx/navigation/compose/NavHost.kt
+++ b/navigation/navigation-compose/src/main/java/androidx/navigation/compose/NavHost.kt
@@ -69,7 +69,6 @@
* contents of the builder cannot be changed.
*
* @sample androidx.navigation.compose.samples.NavScaffold
- *
* @param navController the navController for this host
* @param startDestination the route for the start destination
* @param modifier The modifier to be applied to the layout.
diff --git a/paging/paging-common/src/commonMain/kotlin/androidx/paging/CachedPagingData.kt b/paging/paging-common/src/commonMain/kotlin/androidx/paging/CachedPagingData.kt
index 3ec9188..0b56afe 100644
--- a/paging/paging-common/src/commonMain/kotlin/androidx/paging/CachedPagingData.kt
+++ b/paging/paging-common/src/commonMain/kotlin/androidx/paging/CachedPagingData.kt
@@ -79,7 +79,6 @@
* unnecessary code unless it is being collected.
*
* @sample androidx.paging.samples.cachedInSample
- *
* @param scope The coroutine scope where this page cache will be kept alive.
*/
@CheckResult
diff --git a/paging/paging-common/src/commonMain/kotlin/androidx/paging/PagingDataPresenter.kt b/paging/paging-common/src/commonMain/kotlin/androidx/paging/PagingDataPresenter.kt
index 97d46f9..b069102 100644
--- a/paging/paging-common/src/commonMain/kotlin/androidx/paging/PagingDataPresenter.kt
+++ b/paging/paging-common/src/commonMain/kotlin/androidx/paging/PagingDataPresenter.kt
@@ -312,9 +312,8 @@
* Invalidation due repository-layer signals, such as DB-updates, should instead use
* [PagingSource.invalidate].
*
- * @see PagingSource.invalidate
- *
* @sample androidx.paging.samples.refreshSample
+ * @see PagingSource.invalidate
*/
public fun refresh() {
log(DEBUG) { "Refresh signal received" }
@@ -407,9 +406,8 @@
* [PagingData] yet, and thus has no state to emit.
*
* @param listener [LoadStates] listener to receive updates.
- * @see removeLoadStateListener
- *
* @sample androidx.paging.samples.addLoadStateListenerSample
+ * @see removeLoadStateListener
*/
public fun addLoadStateListener(listener: (@JvmSuppressWildcards CombinedLoadStates) -> Unit) {
combinedLoadStatesCollection.addListener(listener)
diff --git a/paging/paging-common/src/commonMain/kotlin/androidx/paging/PagingDataTransforms.kt b/paging/paging-common/src/commonMain/kotlin/androidx/paging/PagingDataTransforms.kt
index ea03c2f..f2eda1b 100644
--- a/paging/paging-common/src/commonMain/kotlin/androidx/paging/PagingDataTransforms.kt
+++ b/paging/paging-common/src/commonMain/kotlin/androidx/paging/PagingDataTransforms.kt
@@ -79,9 +79,7 @@
* generator, `before` and `after`, will be `null` respectively. In cases where the fully
* paginated list is empty, a single separator will be added where both `before` and `after` items
* are `null`.
- *
* @sample androidx.paging.samples.insertSeparatorsSample
- *
* @sample androidx.paging.samples.insertSeparatorsUiModelSample
*/
@CheckResult
diff --git a/paging/paging-common/src/commonMain/kotlin/androidx/paging/PagingSource.kt b/paging/paging-common/src/commonMain/kotlin/androidx/paging/PagingSource.kt
index d2c272f..cc99734 100644
--- a/paging/paging-common/src/commonMain/kotlin/androidx/paging/PagingSource.kt
+++ b/paging/paging-common/src/commonMain/kotlin/androidx/paging/PagingSource.kt
@@ -60,11 +60,8 @@
* @param Value Type of data loaded in by this [PagingSource]. E.g., the type of data that will be
* passed to a [PagingDataAdapter][androidx.paging.PagingDataAdapter] to be displayed in a
* `RecyclerView`.
- *
* @sample androidx.paging.samples.pageKeyedPagingSourceSample
- *
* @sample androidx.paging.samples.itemKeyedPagingSourceSample
- *
* @see Pager
*/
public abstract class PagingSource<Key : Any, Value : Any> {
@@ -233,7 +230,6 @@
* As a convenience, iterating on this object will iterate through its loaded [data].
*
* @sample androidx.paging.samples.pageKeyedPage
- *
* @sample androidx.paging.samples.pageIndexedPage
*/
public data class Page<Key : Any, Value : Any>
diff --git a/paging/paging-common/src/commonMain/kotlin/androidx/paging/RemoteMediator.kt b/paging/paging-common/src/commonMain/kotlin/androidx/paging/RemoteMediator.kt
index dea52cb..8f2ff2b 100644
--- a/paging/paging-common/src/commonMain/kotlin/androidx/paging/RemoteMediator.kt
+++ b/paging/paging-common/src/commonMain/kotlin/androidx/paging/RemoteMediator.kt
@@ -37,7 +37,6 @@
* [LoadResult.Page.nextKey] set to `null` respectively.
*
* @sample androidx.paging.samples.remoteMediatorItemKeyedSample
- *
* @sample androidx.paging.samples.remoteMediatorPageKeyedSample
*/
@ExperimentalPagingApi
diff --git a/paging/paging-compose/src/commonMain/kotlin/androidx/paging/compose/LazyFoundationExtensions.kt b/paging/paging-compose/src/commonMain/kotlin/androidx/paging/compose/LazyFoundationExtensions.kt
index 6391558..d46b433 100644
--- a/paging/paging-compose/src/commonMain/kotlin/androidx/paging/compose/LazyFoundationExtensions.kt
+++ b/paging/paging-compose/src/commonMain/kotlin/androidx/paging/compose/LazyFoundationExtensions.kt
@@ -30,9 +30,7 @@
* Examples:
*
* @sample androidx.paging.compose.samples.PagingWithHorizontalPager
- *
* @sample androidx.paging.compose.samples.PagingWithLazyGrid
- *
* @param [key] a factory of stable and unique keys representing the item. Using the same key for
* multiple items in the list is not allowed. Type of the key should be saveable via Bundle on
* Android. When you specify the key the scroll position will be maintained based on the key,
@@ -64,9 +62,7 @@
* Examples:
*
* @sample androidx.paging.compose.samples.PagingWithLazyGrid
- *
* @sample androidx.paging.compose.samples.PagingWithLazyList
- *
* @param [contentType] a factory of the content types for the item. The item compositions of the
* same type could be reused more efficiently. Note that null is a valid type and items of such
* type will be considered compatible.
diff --git a/paging/paging-compose/src/commonMain/kotlin/androidx/paging/compose/LazyPagingItems.kt b/paging/paging-compose/src/commonMain/kotlin/androidx/paging/compose/LazyPagingItems.kt
index dbcee1e..89d0ace 100644
--- a/paging/paging-compose/src/commonMain/kotlin/androidx/paging/compose/LazyPagingItems.kt
+++ b/paging/paging-compose/src/commonMain/kotlin/androidx/paging/compose/LazyPagingItems.kt
@@ -51,7 +51,6 @@
* mock data.
*
* @sample androidx.paging.compose.samples.PagingPreview
- *
* @param T the type of value used by [PagingData].
*/
public class LazyPagingItems<T : Any>
@@ -184,7 +183,6 @@
* [LazyListScope.items] in order to display the data obtained from a [Flow] of [PagingData].
*
* @sample androidx.paging.compose.samples.PagingBackendSample
- *
* @param context the [CoroutineContext] to perform the collection of [PagingData] and
* [CombinedLoadStates].
*/
diff --git a/paging/paging-guava/src/main/java/androidx/paging/ListenableFuturePagingData.kt b/paging/paging-guava/src/main/java/androidx/paging/ListenableFuturePagingData.kt
index 8b4aa02..1a4094b 100644
--- a/paging/paging-guava/src/main/java/androidx/paging/ListenableFuturePagingData.kt
+++ b/paging/paging-guava/src/main/java/androidx/paging/ListenableFuturePagingData.kt
@@ -82,9 +82,7 @@
* @param generator [AsyncFunction] used to generate separator between two [AdjacentItems] or the
* header or footer if either [AdjacentItems.before] or [AdjacentItems.after] is `null`.
* @param executor [Executor] to run the [AsyncFunction] in.
- *
* @sample androidx.paging.samples.insertSeparatorsFutureSample
- *
* @sample androidx.paging.samples.insertSeparatorsUiModelFutureSample
*/
@JvmName("insertSeparators")
diff --git a/paging/paging-runtime/src/main/java/androidx/paging/AsyncPagingDataDiffer.kt b/paging/paging-runtime/src/main/java/androidx/paging/AsyncPagingDataDiffer.kt
index b1fd93d..724cf94 100644
--- a/paging/paging-runtime/src/main/java/androidx/paging/AsyncPagingDataDiffer.kt
+++ b/paging/paging-runtime/src/main/java/androidx/paging/AsyncPagingDataDiffer.kt
@@ -409,9 +409,8 @@
* Invalidation due repository-layer signals, such as DB-updates, should instead use
* [PagingSource.invalidate].
*
- * @see PagingSource.invalidate
- *
* @sample androidx.paging.samples.refreshSample
+ * @see PagingSource.invalidate
*/
fun refresh() {
presenter.refresh()
@@ -554,9 +553,8 @@
* reflect the current [CombinedLoadStates].
*
* @param listener [LoadStates] listener to receive updates.
- * @see removeLoadStateListener
- *
* @sample androidx.paging.samples.addLoadStateListenerSample
+ * @see removeLoadStateListener
*/
fun addLoadStateListener(listener: (CombinedLoadStates) -> Unit) {
if (parentLoadStateListener.get() == null) {
diff --git a/paging/paging-runtime/src/main/java/androidx/paging/LoadStateAdapter.kt b/paging/paging-runtime/src/main/java/androidx/paging/LoadStateAdapter.kt
index e811c55..4787cb9 100644
--- a/paging/paging-runtime/src/main/java/androidx/paging/LoadStateAdapter.kt
+++ b/paging/paging-runtime/src/main/java/androidx/paging/LoadStateAdapter.kt
@@ -32,11 +32,10 @@
* [PagingDataAdapter.withLoadStateHeaderAndFooter], or use
* [ConcatAdapter][androidx.recyclerview.widget.ConcatAdapter] directly to concatenate Adapters.
*
+ * @sample androidx.paging.samples.loadStateAdapterSample
* @see PagingDataAdapter.withLoadStateHeaderAndFooter
* @see PagingDataAdapter.withLoadStateHeader
* @see PagingDataAdapter.withLoadStateFooter
- *
- * @sample androidx.paging.samples.loadStateAdapterSample
*/
abstract class LoadStateAdapter<VH : RecyclerView.ViewHolder> : RecyclerView.Adapter<VH>() {
/**
diff --git a/paging/paging-runtime/src/main/java/androidx/paging/PagingDataAdapter.kt b/paging/paging-runtime/src/main/java/androidx/paging/PagingDataAdapter.kt
index e342b5c..309bddf 100644
--- a/paging/paging-runtime/src/main/java/androidx/paging/PagingDataAdapter.kt
+++ b/paging/paging-runtime/src/main/java/androidx/paging/PagingDataAdapter.kt
@@ -235,7 +235,6 @@
* [collectLatest][kotlinx.coroutines.flow.collectLatest].
*
* @sample androidx.paging.samples.submitDataFlowSample
- *
* @see [Pager]
*/
suspend fun submitData(pagingData: PagingData<T>) {
@@ -251,9 +250,7 @@
* via [CoroutineScope][kotlinx.coroutines.CoroutineScope] instead of relying of [Lifecycle].
*
* @sample androidx.paging.samples.submitDataLiveDataSample
- *
* @sample androidx.paging.samples.submitDataRxSample
- *
* @see submitData
* @see [Pager]
*/
@@ -288,9 +285,8 @@
* Invalidation due repository-layer signals, such as DB-updates, should instead use
* [PagingSource.invalidate].
*
- * @see PagingSource.invalidate
- *
* @sample androidx.paging.samples.refreshSample
+ * @see PagingSource.invalidate
*/
fun refresh() {
differ.refresh()
@@ -357,9 +353,8 @@
* reflect the current [CombinedLoadStates].
*
* @param listener [LoadStates] listener to receive updates.
- * @see removeLoadStateListener
- *
* @sample androidx.paging.samples.addLoadStateListenerSample
+ * @see removeLoadStateListener
*/
fun addLoadStateListener(listener: (CombinedLoadStates) -> Unit) {
differ.addLoadStateListener(listener)
diff --git a/paging/paging-rxjava2/src/main/java/androidx/paging/rxjava2/RxPagingData.kt b/paging/paging-rxjava2/src/main/java/androidx/paging/rxjava2/RxPagingData.kt
index 3ef4df3..bbd2e32 100644
--- a/paging/paging-rxjava2/src/main/java/androidx/paging/rxjava2/RxPagingData.kt
+++ b/paging/paging-rxjava2/src/main/java/androidx/paging/rxjava2/RxPagingData.kt
@@ -65,7 +65,6 @@
* between pages are only computed once both pages are loaded.
*
* @sample androidx.paging.samples.insertSeparatorsRxSample
- *
* @sample androidx.paging.samples.insertSeparatorsUiModelRxSample
*/
@JvmName("insertSeparators")
diff --git a/paging/paging-rxjava3/src/main/java/androidx/paging/rxjava3/RxPagingData.kt b/paging/paging-rxjava3/src/main/java/androidx/paging/rxjava3/RxPagingData.kt
index 4591123..82d25a7f 100644
--- a/paging/paging-rxjava3/src/main/java/androidx/paging/rxjava3/RxPagingData.kt
+++ b/paging/paging-rxjava3/src/main/java/androidx/paging/rxjava3/RxPagingData.kt
@@ -65,7 +65,6 @@
* between pages are only computed once both pages are loaded.
*
* @sample androidx.paging.samples.insertSeparatorsRxSample
- *
* @sample androidx.paging.samples.insertSeparatorsUiModelRxSample
*/
@JvmName("insertSeparators")
diff --git a/tv/tv-material/src/main/java/androidx/tv/material3/Button.kt b/tv/tv-material/src/main/java/androidx/tv/material3/Button.kt
index 0447dd5..e010833 100644
--- a/tv/tv-material/src/main/java/androidx/tv/material3/Button.kt
+++ b/tv/tv-material/src/main/java/androidx/tv/material3/Button.kt
@@ -49,9 +49,7 @@
* Samples:
*
* @sample androidx.tv.material3.samples.ButtonSample
- *
* @sample androidx.tv.material3.samples.LikeButtonSample
- *
* @param onClick called when this button is clicked
* @param modifier the [Modifier] to be applied to this button
* @param onLongClick called when this button is long clicked (long-pressed).
@@ -124,7 +122,6 @@
* Samples:
*
* @sample androidx.tv.material3.samples.OutlinedButtonSample
- *
* @param onClick called when this button is clicked
* @param modifier the [Modifier] to be applied to this button
* @param onLongClick called when this button is long clicked (long-pressed).
diff --git a/tv/tv-material/src/main/java/androidx/tv/material3/Card.kt b/tv/tv-material/src/main/java/androidx/tv/material3/Card.kt
index 69e4f3d..017f73e 100644
--- a/tv/tv-material/src/main/java/androidx/tv/material3/Card.kt
+++ b/tv/tv-material/src/main/java/androidx/tv/material3/Card.kt
@@ -48,11 +48,8 @@
* Guidelines for Aspect ratios</a> for cards
*
* @sample androidx.tv.material3.samples.HorizontalImageAspectRatioCardSample
- *
* @sample androidx.tv.material3.samples.VerticalImageAspectRatioCardSample
- *
* @sample androidx.tv.material3.samples.SquareImageAspectRatioCardSample
- *
* @param onClick called when this card is clicked.
* @param modifier the [Modifier] to be applied to this card.
* @param onLongClick called when this card is long clicked (long-pressed).
@@ -117,7 +114,6 @@
* This Card handles click events, calling its [onClick] lambda.
*
* @sample androidx.tv.material3.samples.ClassicCardSample
- *
* @param onClick called when this card is clicked.
* @param image defines the [Composable] image to be displayed on top of the Card.
* @param title defines the [Composable] title placed below the image in the Card.
@@ -194,7 +190,6 @@
* This Card handles click events, calling its [onClick] lambda.
*
* @sample androidx.tv.material3.samples.CompactCardSample
- *
* @param onClick called when this card is clicked.
* @param image defines the [Composable] image to be displayed on top of the Card.
* @param title defines the [Composable] title placed below the image in the Card.
@@ -281,7 +276,6 @@
* class="external" target="_blank">Material Wide Classic Card</a>.
*
* @sample androidx.tv.material3.samples.WideClassicCardSample
- *
* @param onClick called when this card is clicked.
* @param image defines the [Composable] image to be displayed on top of the Card.
* @param title defines the [Composable] title placed below the image in the Card.
diff --git a/tv/tv-material/src/main/java/androidx/tv/material3/CardContainer.kt b/tv/tv-material/src/main/java/androidx/tv/material3/CardContainer.kt
index ca2f09c..82ae32e3 100644
--- a/tv/tv-material/src/main/java/androidx/tv/material3/CardContainer.kt
+++ b/tv/tv-material/src/main/java/androidx/tv/material3/CardContainer.kt
@@ -48,7 +48,6 @@
* class="external" target="_blank">Material Standard Card</a>.
*
* @sample androidx.tv.material3.samples.StandardCardContainerSample
- *
* @param imageCard defines the [Composable] to be used for the image card.
* @param title defines the [Composable] title placed below the image card in the CardContainer.
* @param modifier the [Modifier] to be applied to this CardContainer.
@@ -109,7 +108,6 @@
* class="external" target="_blank">Material Wide Standard Card</a>.
*
* @sample androidx.tv.material3.samples.WideCardContainerSample
- *
* @param imageCard defines the [Composable] to be used for the image card.
* @param title defines the [Composable] title placed below the image card in the CardContainer.
* @param modifier the [Modifier] to be applied to this CardContainer.
diff --git a/tv/tv-material/src/main/java/androidx/tv/material3/Carousel.kt b/tv/tv-material/src/main/java/androidx/tv/material3/Carousel.kt
index 3b1aadb..eb0a2c3 100644
--- a/tv/tv-material/src/main/java/androidx/tv/material3/Carousel.kt
+++ b/tv/tv-material/src/main/java/androidx/tv/material3/Carousel.kt
@@ -91,9 +91,7 @@
* Examples:
*
* @sample androidx.tv.material3.samples.SimpleCarousel
- *
* @sample androidx.tv.material3.samples.CarouselIndicatorWithRectangleShape
- *
* @param modifier Modifier applied to the Carousel.
* @param itemCount total number of items present in the carousel.
* @param carouselState state associated with this carousel.
diff --git a/tv/tv-material/src/main/java/androidx/tv/material3/Checkbox.kt b/tv/tv-material/src/main/java/androidx/tv/material3/Checkbox.kt
index 8be1c5c..1dbfe64 100644
--- a/tv/tv-material/src/main/java/androidx/tv/material3/Checkbox.kt
+++ b/tv/tv-material/src/main/java/androidx/tv/material3/Checkbox.kt
@@ -78,9 +78,8 @@
* emitting [Interaction]s for this checkbox. You can use this to change the checkbox's appearance
* or preview the checkbox in different states. Note that if `null` is provided, interactions will
* still happen internally.
- * @see [TriStateCheckbox] if you require support for an indeterminate state.
- *
* @sample androidx.tv.material3.samples.CheckboxSample
+ * @see [TriStateCheckbox] if you require support for an indeterminate state.
*/
@Composable
fun Checkbox(
diff --git a/tv/tv-material/src/main/java/androidx/tv/material3/IconButton.kt b/tv/tv-material/src/main/java/androidx/tv/material3/IconButton.kt
index 7412e53..7f840252 100644
--- a/tv/tv-material/src/main/java/androidx/tv/material3/IconButton.kt
+++ b/tv/tv-material/src/main/java/androidx/tv/material3/IconButton.kt
@@ -42,7 +42,6 @@
* The default text style for internal [Text] components will be set to [Typography.labelLarge].
*
* @sample androidx.tv.material3.samples.IconButtonSample
- *
* @param onClick called when this button is clicked.
* @param modifier the [Modifier] to be applied to this button.
* @param onLongClick called when this button is long clicked (long-pressed).
@@ -109,7 +108,6 @@
* The default text style for internal [Text] components will be set to [Typography.labelLarge].
*
* @sample androidx.tv.material3.samples.OutlinedIconButtonSample
- *
* @param onClick called when this button is clicked.
* @param modifier the [Modifier] to be applied to this button.
* @param onLongClick called when this card is long clicked (long-pressed).
diff --git a/tv/tv-material/src/main/java/androidx/tv/material3/NavigationDrawer.kt b/tv/tv-material/src/main/java/androidx/tv/material3/NavigationDrawer.kt
index db7d3b2..bb310f3 100644
--- a/tv/tv-material/src/main/java/androidx/tv/material3/NavigationDrawer.kt
+++ b/tv/tv-material/src/main/java/androidx/tv/material3/NavigationDrawer.kt
@@ -58,9 +58,7 @@
* Example:
*
* @sample androidx.tv.material3.samples.SampleModalNavigationDrawerWithSolidScrim
- *
* @sample androidx.tv.material3.samples.SampleModalNavigationDrawerWithGradientScrim
- *
* @param drawerContent Content that needs to be displayed on the drawer based on whether the drawer
* is [DrawerValue.Open] or [DrawerValue.Closed]. Drawer-entries can be animated when the drawer
* moves from Closed to Open state and vice-versa. For, e.g., the entry could show only an icon in
@@ -128,7 +126,6 @@
* Example:
*
* @sample androidx.tv.material3.samples.SampleNavigationDrawer
- *
* @param drawerContent Content that needs to be displayed on the drawer based on whether the drawer
* is [DrawerValue.Open] or [DrawerValue.Closed]. Drawer-entries can be animated when the drawer
* moves from Closed to Open state and vice-versa. For, e.g., the entry could show only an icon in
diff --git a/tv/tv-material/src/main/java/androidx/tv/material3/NavigationDrawerItem.kt b/tv/tv-material/src/main/java/androidx/tv/material3/NavigationDrawerItem.kt
index 36e2965..b49c576 100644
--- a/tv/tv-material/src/main/java/androidx/tv/material3/NavigationDrawerItem.kt
+++ b/tv/tv-material/src/main/java/androidx/tv/material3/NavigationDrawerItem.kt
@@ -35,11 +35,8 @@
* [ModalNavigationDrawer]
*
* @sample androidx.tv.material3.samples.SampleNavigationDrawer
- *
* @sample androidx.tv.material3.samples.SampleModalNavigationDrawerWithSolidScrim
- *
* @sample androidx.tv.material3.samples.SampleModalNavigationDrawerWithGradientScrim
- *
* @param selected defines whether this composable is selected or not
* @param onClick called when this composable is clicked
* @param leadingContent the leading content of the list item
diff --git a/tv/tv-material/src/main/java/androidx/tv/material3/RadioButton.kt b/tv/tv-material/src/main/java/androidx/tv/material3/RadioButton.kt
index df8eb6d..efb2119 100644
--- a/tv/tv-material/src/main/java/androidx/tv/material3/RadioButton.kt
+++ b/tv/tv-material/src/main/java/androidx/tv/material3/RadioButton.kt
@@ -51,7 +51,6 @@
* image](https://developer.android.com/images/reference/androidx/compose/material3/radio-button.png)
*
* @sample androidx.tv.material3.samples.RadioButtonSample
- *
* @param selected whether this radio button is selected or not
* @param onClick called when this radio button is clicked. If `null`, then this radio button will
* not be interactable, unless something else handles its input events and updates its state.
diff --git a/tv/tv-material/src/main/java/androidx/tv/material3/Switch.kt b/tv/tv-material/src/main/java/androidx/tv/material3/Switch.kt
index c85a738..f005367 100644
--- a/tv/tv-material/src/main/java/androidx/tv/material3/Switch.kt
+++ b/tv/tv-material/src/main/java/androidx/tv/material3/Switch.kt
@@ -69,7 +69,6 @@
* Switch can be used with a custom icon via [thumbContent] parameter
*
* @sample androidx.tv.material3.samples.SwitchSample
- *
* @param checked whether or not this switch is checked
* @param onCheckedChange called when this switch is clicked. If `null`, then this switch will not
* be interactable, unless something else handles its input events and updates its state.
diff --git a/tv/tv-material/src/main/java/androidx/tv/material3/TabRow.kt b/tv/tv-material/src/main/java/androidx/tv/material3/TabRow.kt
index 6dc1fe4..73a257e 100644
--- a/tv/tv-material/src/main/java/androidx/tv/material3/TabRow.kt
+++ b/tv/tv-material/src/main/java/androidx/tv/material3/TabRow.kt
@@ -72,13 +72,9 @@
* Examples:
*
* @sample androidx.tv.material3.samples.PillIndicatorTabRow
- *
* @sample androidx.tv.material3.samples.UnderlinedIndicatorTabRow
- *
* @sample androidx.tv.material3.samples.TabRowWithDebounce
- *
* @sample androidx.tv.material3.samples.OnClickNavigation
- *
* @param selectedTabIndex the index of the currently selected tab
* @param modifier the [Modifier] to be applied to this tab row
* @param containerColor the color used for the background of this tab row
diff --git a/tv/tv-material/src/main/java/androidx/tv/material3/WideButton.kt b/tv/tv-material/src/main/java/androidx/tv/material3/WideButton.kt
index 70d60dd..bb13c9f 100644
--- a/tv/tv-material/src/main/java/androidx/tv/material3/WideButton.kt
+++ b/tv/tv-material/src/main/java/androidx/tv/material3/WideButton.kt
@@ -50,7 +50,6 @@
* Samples:
*
* @sample androidx.tv.material3.samples.WideButtonSample
- *
* @param onClick called when this button is clicked
* @param modifier the [Modifier] to be applied to this button
* @param onLongClick called when this button is long clicked (long-pressed).
@@ -119,11 +118,8 @@
* Samples:
*
* @sample androidx.tv.material3.samples.WideButtonWithIcon
- *
* @sample androidx.tv.material3.samples.WideButtonWithSubtitle
- *
* @sample androidx.tv.material3.samples.WideButtonWithIconAndSubtitle
- *
* @param onClick called when this button is clicked
* @param title the title content of the button, typically a [Text]
* @param modifier the [Modifier] to be applied to this button
diff --git a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/BasicCurvedText.kt b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/BasicCurvedText.kt
index 39b120d..868b699 100644
--- a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/BasicCurvedText.kt
+++ b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/BasicCurvedText.kt
@@ -60,7 +60,6 @@
* created within a [CurvedLayout] since it's not a composable.
*
* @sample androidx.wear.compose.foundation.samples.CurvedAndNormalText
- *
* @param text The text to display
* @param modifier The [CurvedModifier] to apply to this curved text.
* @param angularDirection Specify if the text is laid out clockwise or anti-clockwise, and if those
@@ -93,7 +92,6 @@
* created within a [CurvedLayout] since it's not a composable.
*
* @sample androidx.wear.compose.foundation.samples.CurvedAndNormalText
- *
* @param text The text to display
* @param style A style to use.
* @param modifier The [CurvedModifier] to apply to this curved text.
diff --git a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/BasicSwipeToDismissBox.kt b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/BasicSwipeToDismissBox.kt
index 2e079b3..78cdb6f 100644
--- a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/BasicSwipeToDismissBox.kt
+++ b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/BasicSwipeToDismissBox.kt
@@ -476,7 +476,6 @@
* Example of a modifier usage with SwipeToDismiss
*
* @sample androidx.wear.compose.foundation.samples.EdgeSwipeForSwipeToDismiss
- *
* @param swipeToDismissBoxState State of [BasicSwipeToDismissBox]. Used to trigger swipe gestures
* on SwipeToDismissBox.
* @param edgeWidth Width of the edge zone in which the swipe will be recognised.
diff --git a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedBox.kt b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedBox.kt
index 7e8597e..f394eb9 100644
--- a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedBox.kt
+++ b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedBox.kt
@@ -31,7 +31,6 @@
* Example usage:
*
* @sample androidx.wear.compose.foundation.samples.CurvedBoxSample
- *
* @param modifier The [CurvedModifier] to apply to this curved row.
* @param radialAlignment Radial alignment specifies where to lay down children that are thinner
* than the CurvedBox, either closer to the center [CurvedAlignment.Radial.Inner], apart from the
diff --git a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedColumn.kt b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedColumn.kt
index 4e5ec4f..0533026 100644
--- a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedColumn.kt
+++ b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedColumn.kt
@@ -36,7 +36,6 @@
* Example usage:
*
* @sample androidx.wear.compose.foundation.samples.CurvedRowAndColumn
- *
* @param modifier The [CurvedModifier] to apply to this curved column.
* @param radialDirection Order to lay out components, outside in or inside out. The default is to
* inherit from the containing [curvedColumn] or [CurvedLayout]
diff --git a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedDraw.kt b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedDraw.kt
index e35f08e..0042714 100644
--- a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedDraw.kt
+++ b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedDraw.kt
@@ -43,7 +43,6 @@
* Example usage:
*
* @sample androidx.wear.compose.foundation.samples.CurvedBackground
- *
* @param colorStops Colors and their offset in the gradient area. Note that the offsets should be
* in ascending order. 0 means the outer curve and 1 means the inner curve of the curved element.
* @param cap How to start and end the background.
@@ -83,7 +82,6 @@
* Example usage:
*
* @sample androidx.wear.compose.foundation.samples.CurvedBackground
- *
* @param colorStops Colors and their offset in the gradient area. Note that the offsets should be
* in ascending order. 0 means where the curved element starts laying out, 1 means the end
* @param cap How to start and end the background.
diff --git a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedLayout.kt b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedLayout.kt
index 6b06ddf..97a73ee 100644
--- a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedLayout.kt
+++ b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedLayout.kt
@@ -69,7 +69,6 @@
* Example usage:
*
* @sample androidx.wear.compose.foundation.samples.SimpleCurvedWorld
- *
* @param modifier The modifier to be applied to the CurvedRow.
* @param anchor The angle at which children are laid out relative to, in degrees. An angle of 0
* corresponds to the right (3 o'clock on a watch), 90 degrees is bottom (6 o'clock), and so on.
diff --git a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedParentData.kt b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedParentData.kt
index 75ee3c2..755493f 100644
--- a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedParentData.kt
+++ b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedParentData.kt
@@ -37,7 +37,6 @@
* Example usage:
*
* @sample androidx.wear.compose.foundation.samples.CurvedWeight
- *
* @param weight The proportional size to give to this element, as related to the total of all
* weighted siblings. Must be positive.
*/
diff --git a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedRow.kt b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedRow.kt
index 765f9d4..b8b6425 100644
--- a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedRow.kt
+++ b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedRow.kt
@@ -33,7 +33,6 @@
* Example usage:
*
* @sample androidx.wear.compose.foundation.samples.CurvedRowAndColumn
- *
* @param modifier The [CurvedModifier] to apply to this curved row.
* @param radialAlignment Radial alignment specifies where to lay down children that are thinner
* than the CurvedRow, either closer to the center [CurvedAlignment.Radial.Inner], apart from the
diff --git a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedSize.kt b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedSize.kt
index 5c1e187..492ba24 100644
--- a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedSize.kt
+++ b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedSize.kt
@@ -50,7 +50,6 @@
* Specify the dimensions (sweep and thickness) for the content.
*
* @sample androidx.wear.compose.foundation.samples.CurvedFixedSize
- *
* @param sweepDegrees Indicates the sweep (angular size) of the content.
* @param thickness Indicates the thickness (radial size) of the content.
*/
@@ -70,7 +69,6 @@
* center of the item, except for [basicCurvedText], where it will be measured at the text baseline.
*
* @sample androidx.wear.compose.foundation.samples.CurvedFixedSize
- *
* @param angularWidth Indicates the arc length of the content in Dp.
*/
public fun CurvedModifier.angularSizeDp(angularWidth: Dp) =
diff --git a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedTextStyle.kt b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedTextStyle.kt
index 50e6726..f1d40ed 100644
--- a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedTextStyle.kt
+++ b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/CurvedTextStyle.kt
@@ -42,7 +42,6 @@
* Styling configuration for a curved text.
*
* @sample androidx.wear.compose.foundation.samples.CurvedAndNormalText
- *
* @param background The background color for the text.
* @param color The text color.
* @param fontSize The size of glyphs (in logical pixels) to use when painting the text. This may be
@@ -66,7 +65,6 @@
* Styling configuration for a curved text.
*
* @sample androidx.wear.compose.foundation.samples.CurvedAndNormalText
- *
* @param background The background color for the text.
* @param color The text color.
* @param fontSize The size of glyphs (in logical pixels) to use when painting the text. This
diff --git a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/Expandable.kt b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/Expandable.kt
index 78163f3..94c6b4f1 100644
--- a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/Expandable.kt
+++ b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/Expandable.kt
@@ -47,7 +47,6 @@
* Example of an expandable text:
*
* @sample androidx.wear.compose.foundation.samples.ExpandableTextSample
- *
* @param initiallyExpanded The initial value of the state.
* @param expandAnimationSpec The [AnimationSpec] to use when showing the extra information.
* @param collapseAnimationSpec The [AnimationSpec] to use when hiding the extra information.
@@ -99,7 +98,6 @@
* Example of an expandable list:
*
* @sample androidx.wear.compose.foundation.samples.ExpandableWithItemsSample
- *
* @param state The [ExpandableState] connected to these items.
* @param count The number of items
* @param key a factory of stable and unique keys representing the item. Using the same key for
@@ -169,7 +167,6 @@
* Example of an expandable text:
*
* @sample androidx.wear.compose.foundation.samples.ExpandableTextSample
- *
* @param state The [ExpandableState] to connect this button to.
* @param key A stable and unique key representing the item. Using the same key for multiple items
* in the list is not allowed. Type of the key should be saveable via Bundle on Android. If null
diff --git a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/HierarchicalFocusCoordinator.kt b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/HierarchicalFocusCoordinator.kt
index 8b4f00f..208918f 100644
--- a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/HierarchicalFocusCoordinator.kt
+++ b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/HierarchicalFocusCoordinator.kt
@@ -47,7 +47,6 @@
* Example usage:
*
* @sample androidx.wear.compose.foundation.samples.HierarchicalFocusCoordinatorSample
- *
* @param requiresFocus a function that returns true when the [content] is active in the composition
* and requires the focus
* @param content The content of this component.
diff --git a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/SwipeToReveal.kt b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/SwipeToReveal.kt
index 0703aa2..7a819ae 100644
--- a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/SwipeToReveal.kt
+++ b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/SwipeToReveal.kt
@@ -369,7 +369,6 @@
* Example of SwipeToReveal used with Expandables
*
* @sample androidx.wear.compose.foundation.samples.SwipeToRevealWithExpandables
- *
* @param primaryAction The primary action that will be triggered in the event of a completed swipe.
* We also strongly recommend to trigger the action when it is clicked.
* @param modifier Optional [Modifier] for this component.
diff --git a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/rotary/RotaryScrollable.kt b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/rotary/RotaryScrollable.kt
index 9bfda3e..98e459b 100644
--- a/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/rotary/RotaryScrollable.kt
+++ b/wear/compose/compose-foundation/src/main/java/androidx/wear/compose/foundation/rotary/RotaryScrollable.kt
@@ -89,7 +89,6 @@
* Example of scrolling with snap:
*
* @sample androidx.wear.compose.foundation.samples.RotarySnapSample
- *
* @param behavior Specified [RotaryScrollableBehavior] for rotary handling with snap or fling.
* @param focusRequester Used to request the focus for rotary input. Each composable with this
* modifier should have a separate focusRequester, and only one of them at a time can be active.
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/HorizontalPageIndicator.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/HorizontalPageIndicator.kt
index ed0dfcb..5cf8a4c 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/HorizontalPageIndicator.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/HorizontalPageIndicator.kt
@@ -76,7 +76,6 @@
* visually represented.
*
* @sample androidx.wear.compose.material.samples.HorizontalPageIndicatorSample
- *
* @param pageIndicatorState The state object of a [HorizontalPageIndicator] to be used to observe
* the Pager's state.
* @param modifier Modifier to be applied to the [HorizontalPageIndicator]
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/ListHeader.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/ListHeader.kt
index 2bf6f5e..6dc1784 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/ListHeader.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/ListHeader.kt
@@ -40,7 +40,6 @@
* Example usage:
*
* @sample androidx.wear.compose.material.samples.ScalingLazyColumnWithHeaders
- *
* @param modifier The modifier for the list header
* @param backgroundColor The background color to apply - typically Color.Transparent
* @param contentColor The color to apply to content
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Picker.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Picker.kt
index adcf8e2..b79a374 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Picker.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Picker.kt
@@ -89,7 +89,6 @@
* Example of dual pickers, where clicking switches which one is editable and which is read-only:
*
* @sample androidx.wear.compose.material.samples.DualPicker
- *
* @param state The state of the component
* @param contentDescription Text used by accessibility services to describe what the selected
* option represents. This text should be localized, such as by using
@@ -180,7 +179,6 @@
* Example of dual pickers, where clicking switches which one is editable and which is read-only:
*
* @sample androidx.wear.compose.material.samples.DualPicker
- *
* @param state The state of the component
* @param contentDescription Text used by accessibility services to describe what the selected
* option represents. This text should be localized, such as by using
@@ -395,7 +393,6 @@
* Example of dual pickers, where clicking switches which one is editable and which is read-only:
*
* @sample androidx.wear.compose.material.samples.DualPicker
- *
* @param state The state of the component
* @param contentDescription Text used by accessibility services to describe what the selected
* option represents. This text should be localized, such as by using
@@ -476,7 +473,6 @@
* Example of dual pickers, where clicking switches which one is editable and which is read-only:
*
* @sample androidx.wear.compose.material.samples.DualPicker
- *
* @param state The state of the component
* @param modifier Modifier to be applied to the Picker
* @param readOnly Determines whether the Picker should display other available options for this
@@ -649,7 +645,6 @@
* Instantly scroll to an item.
*
* @sample androidx.wear.compose.material.samples.OptionChangePicker
- *
* @param index The index of the option to scroll to.
*/
public suspend fun scrollToOption(index: Int) {
@@ -668,7 +663,6 @@
* If the distance between possible targets is the same, picker will be scrolled backwards.
*
* @sample androidx.wear.compose.material.samples.AnimateOptionChangePicker
- *
* @param index The index of the option to scroll to.
*/
public suspend fun animateScrollToOption(index: Int) {
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/PickerGroup.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/PickerGroup.kt
index ae19370..9c499c7 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/PickerGroup.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/PickerGroup.kt
@@ -66,7 +66,6 @@
* Example of an auto centering picker group where the total width exceeds screen's width
*
* @sample androidx.wear.compose.material.samples.AutoCenteringPickerGroup
- *
* @param pickers List of [Picker]s represented using [PickerGroupItem] in the same order of display
* from left to right.
* @param modifier Modifier to be applied to the PickerGroup
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Placeholder.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Placeholder.kt
index 67c66bb..2d86922 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Placeholder.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Placeholder.kt
@@ -392,7 +392,6 @@
* modifiers.
*
* @sample androidx.wear.compose.material.samples.TextPlaceholder
- *
* @param placeholderState determines whether the placeholder is visible and controls animation
* effects for the placeholder.
* @param shape the shape to apply to the placeholder
@@ -445,7 +444,6 @@
* modifiers.
*
* @sample androidx.wear.compose.material.samples.TextPlaceholder
- *
* @param placeholderState the current placeholder state that determine whether the placeholder
* shimmer should be shown.
* @param shape the shape of the component.
@@ -504,7 +502,6 @@
* once all of the placeholder data is loaded:
*
* @sample androidx.wear.compose.material.samples.ChipWithIconAndLabelAndPlaceholders
- *
* @param originalChipColors the chip colors to use when not in placeholder mode.
* @param placeholderState the placeholder state of the component
* @param color the color to use for the placeholder background brush
@@ -554,7 +551,6 @@
* away once all of the placeholder data is loaded:
*
* @sample androidx.wear.compose.material.samples.ChipWithIconAndLabelsAndOverlaidPlaceholder
- *
* @param color the color to use for the placeholder background brush.
* @param placeholderState the current placeholder state.
*/
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/ProgressIndicator.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/ProgressIndicator.kt
index a798053..6d8bab1 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/ProgressIndicator.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/ProgressIndicator.kt
@@ -66,7 +66,6 @@
* Example:
*
* @sample androidx.wear.compose.material.samples.CircularProgressIndicatorFullscreenWithGap
- *
* @param modifier Modifier to be applied to the CircularProgressIndicator
* @param progress The progress of this progress indicator where 0.0 represents no progress and 1.0
* represents completion. Values outside of this range are coerced into the range 0..1.
@@ -129,7 +128,6 @@
* Example of indeterminate progress indicator:
*
* @sample androidx.wear.compose.material.samples.IndeterminateCircularProgressIndicator
- *
* @param modifier Modifier to be applied to the CircularProgressIndicator
* @param startAngle The starting position of the progress arc, measured clockwise in degrees (0
* to 360) from the 3 o'clock position. For example, 0 and 360 represent 3 o'clock, 90 and 180
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Scaffold.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Scaffold.kt
index 425bf72b..d16a8aa 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Scaffold.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Scaffold.kt
@@ -38,7 +38,6 @@
* scroll indicator to show the position of the items in the ScalingLazyColumn as.
*
* @sample androidx.wear.compose.material.samples.SimpleScaffoldWithScrollIndicator
- *
* @param modifier optional Modifier for the root of the [Scaffold]
* @param vignette a full screen slot for applying a vignette over the contents of the scaffold. The
* vignette is used to blur the screen edges when the main content is scrollable content that
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Slider.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Slider.kt
index 68a333f..29464ec 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Slider.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Slider.kt
@@ -72,7 +72,6 @@
* A segmented slider sample:
*
* @sample androidx.wear.compose.material.samples.InlineSliderSegmentedSample
- *
* @param value Current value of the Slider. If outside of [valueRange] provided, value will be
* coerced to this range.
* @param onValueChange Lambda in which value should be updated
@@ -222,7 +221,6 @@
* A segmented slider sample:
*
* @sample androidx.wear.compose.material.samples.InlineSliderSegmentedSample
- *
* @param value Current value of the Slider. If outside of [valueProgression] provided, value will
* be coerced to this range.
* @param onValueChange Lambda in which value should be updated
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Stepper.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Stepper.kt
index 9b2378b..6b329ad 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Stepper.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Stepper.kt
@@ -38,11 +38,8 @@
* [onValueChange] in this case will not be triggered.
*
* @sample androidx.wear.compose.material.samples.StepperSample
- *
* @sample androidx.wear.compose.material.samples.StepperWithoutRangeSemanticsSample
- *
* @sample androidx.wear.compose.material.samples.StepperWithCustomSemanticsSample
- *
* @param value Current value of the Stepper. If outside of [valueRange] provided, value will be
* coerced to this range.
* @param onValueChange Lambda in which value should be updated
@@ -188,7 +185,6 @@
* [PositionIndicator] if required.
*
* @sample androidx.wear.compose.material.samples.StepperSample
- *
* @param value Current value of the Stepper. If outside of [valueRange] provided, value will be
* coerced to this range.
* @param onValueChange Lambda in which value should be updated
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/SwipeToDismissBox.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/SwipeToDismissBox.kt
index d448f0f..64de2a0 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/SwipeToDismissBox.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/SwipeToDismissBox.kt
@@ -459,7 +459,6 @@
* Example of a modifier usage with SwipeToDismiss
*
* @sample androidx.wear.compose.material.samples.EdgeSwipeForSwipeToDismiss
- *
* @param swipeToDismissBoxState A state of SwipeToDismissBox. Used to trigger swipe gestures on
* SwipeToDismissBox
* @param edgeWidth A width of edge, where swipe should be recognised
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/SwipeToReveal.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/SwipeToReveal.kt
index dbc65a9..f289319 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/SwipeToReveal.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/SwipeToReveal.kt
@@ -70,7 +70,6 @@
* Example of [SwipeToRevealChip] with primary and secondary actions
*
* @sample androidx.wear.compose.material.samples.SwipeToRevealChipSample
- *
* @param primaryAction A composable to describe the primary action when swiping. The action will be
* triggered on clicking the action. See [SwipeToRevealPrimaryAction].
* @param revealState [RevealState] of the [SwipeToReveal]
@@ -134,7 +133,6 @@
* Example of [SwipeToRevealCard] with primary and secondary actions
*
* @sample androidx.wear.compose.material.samples.SwipeToRevealCardSample
- *
* @param primaryAction A composable to describe the primary action when swiping. The action will be
* triggered on clicking the action. See [SwipeToRevealPrimaryAction].
* @param revealState [RevealState] of the [SwipeToReveal]
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/TimeText.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/TimeText.kt
index 457b197..8059b7c 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/TimeText.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/TimeText.kt
@@ -91,7 +91,6 @@
* An example of a [TimeText] animating a message that is added or removed
*
* @sample androidx.wear.compose.material.samples.TimeTextAnimation
- *
* @param modifier Current modifier.
* @param timeSource [TimeSource] which retrieves the current time and formats it.
* @param timeTextStyle Optional textStyle for the time text itself
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/ToggleControl.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/ToggleControl.kt
index 6b12942..053b7e9 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/ToggleControl.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/ToggleControl.kt
@@ -44,7 +44,6 @@
* Example of a [SplitToggleChip] with [Checkbox] toggle control:
*
* @sample androidx.wear.compose.material.samples.SplitToggleChipWithCheckbox
- *
* @param checked Boolean flag indicating whether this checkbox is currently checked.
* @param modifier Modifier to be applied to the checkbox. This can be used to provide a content
* description for accessibility.
@@ -93,7 +92,6 @@
* Example of a [ToggleChip] with [Switch] toggle control:
*
* @sample androidx.wear.compose.material.samples.ToggleChipWithSwitch
- *
* @param checked Boolean flag indicating whether this switch is currently toggled on.
* @param modifier Modifier to be applied to the switch. This can be used to provide a content
* description for accessibility.
@@ -152,7 +150,6 @@
* Example of a [ToggleChip] with [RadioButton] toggle control:
*
* @sample androidx.wear.compose.material.samples.SelectableChipWithRadioButton
- *
* @param selected Boolean flag indicating whether this radio button is currently toggled on.
* @param modifier Modifier to be applied to the radio button. This can be used to provide a content
* description for accessibility.
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Typography.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Typography.kt
index 85d7144..c1ba522 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Typography.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Typography.kt
@@ -32,7 +32,6 @@
* size for Display1:
*
* @sample androidx.wear.compose.material.samples.FixedFontSize
- *
* @property display1 Display1 is the largest headline. Displays are the largest text on the screen,
* reserved for short, important text or numerals.
* @property display2 Display2 is the second largest headline. Displays are the largest text on the
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Vignette.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Vignette.kt
index 7efeb12..2b3e495 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Vignette.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/Vignette.kt
@@ -78,7 +78,6 @@
* top/bottom vignette images can be turned on/off can be found at
*
* @sample androidx.wear.compose.material.samples.SimpleScaffoldWithScrollIndicator
- *
* @param vignettePosition whether to draw top and/or bottom images for this [Vignette]
* @param modifier optional Modifier for the root of the [Vignette]
*/
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/dialog/Dialog.android.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/dialog/Dialog.android.kt
index e591bf5..b07f490 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/dialog/Dialog.android.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/dialog/Dialog.android.kt
@@ -67,7 +67,6 @@
* Example of content using [Dialog] to trigger a confirmation dialog using [Confirmation]:
*
* @sample androidx.wear.compose.material.samples.ConfirmationDialogSample
- *
* @param showDialog Controls whether to display the [Dialog]. Set to true initially to trigger an
* 'intro' animation and display the [Dialog]. Subsequently, setting to false triggers an 'outro'
* animation, then [Dialog] calls [onDismissRequest] and hides itself.
@@ -111,7 +110,6 @@
* Example of content using [Dialog] to trigger a confirmation dialog using [Confirmation]:
*
* @sample androidx.wear.compose.material.samples.ConfirmationDialogSample
- *
* @param showDialog Controls whether to display the [Dialog]. Set to true initially to trigger an
* 'intro' animation and display the [Dialog]. Subsequently, setting to false triggers an 'outro'
* animation, then [Dialog] calls [onDismissRequest] and hides itself.
diff --git a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/dialog/Dialog.kt b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/dialog/Dialog.kt
index 05fda60..af43bb5 100644
--- a/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/dialog/Dialog.kt
+++ b/wear/compose/compose-material/src/main/java/androidx/wear/compose/material/dialog/Dialog.kt
@@ -66,7 +66,6 @@
* Example of an [Alert] with an icon, title, body text and buttons:
*
* @sample androidx.wear.compose.material.samples.AlertWithButtons
- *
* @param title A slot for displaying the title of the dialog, expected to be one or two lines of
* text.
* @param negativeButton A slot for a [Button] indicating negative sentiment (e.g. No). Clicking the
@@ -145,7 +144,6 @@
* Example of an [Alert] with an icon, title, body text and buttons:
*
* @sample androidx.wear.compose.material.samples.AlertWithButtons
- *
* @param title A slot for displaying the title of the dialog, expected to be one or two lines of
* text.
* @param negativeButton A slot for a [Button] indicating negative sentiment (e.g. No). Clicking the
@@ -269,7 +267,6 @@
* Example of an [Alert] with an icon, title, message text and chips:
*
* @sample androidx.wear.compose.material.samples.AlertWithChips
- *
* @param title A slot for displaying the title of the dialog, expected to be one or two lines of
* text.
* @param modifier Modifier to be applied to the dialog.
@@ -335,7 +332,6 @@
* Example of an [Alert] with an icon, title, message text and chips:
*
* @sample androidx.wear.compose.material.samples.AlertWithChips
- *
* @param title A slot for displaying the title of the dialog, expected to be one or two lines of
* text.
* @param modifier Modifier to be applied to the dialog.
@@ -444,7 +440,6 @@
* Example of a [Confirmation] with animation:
*
* @sample androidx.wear.compose.material.samples.ConfirmationWithAnimation
- *
* @param onTimeout Event invoked when the dialog has been shown for [durationMillis].
* @param modifier Modifier to be applied to the dialog.
* @param icon An optional slot for displaying an icon or image.
@@ -519,7 +514,6 @@
* Example of a [Confirmation] with animation:
*
* @sample androidx.wear.compose.material.samples.ConfirmationWithAnimation
- *
* @param onTimeout Event invoked when the dialog has been shown for [durationMillis].
* @param modifier Modifier to be applied to the dialog.
* @param icon An optional slot for displaying an icon or image.
diff --git a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/Button.kt b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/Button.kt
index 371f5ef..462fb83 100644
--- a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/Button.kt
+++ b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/Button.kt
@@ -93,7 +93,6 @@
* Example of a [Button] with onLongClick:
*
* @sample androidx.wear.compose.material3.samples.ButtonWithOnLongClickSample
- *
* @param onClick Will be called when the user clicks the button
* @param modifier Modifier to be applied to the button
* @param onLongClick Called when this button is long clicked (long-pressed). When this callback is
@@ -177,7 +176,6 @@
* Example of a [FilledTonalButton] with onLongClick:
*
* @sample androidx.wear.compose.material3.samples.FilledTonalButtonWithOnLongClickSample
- *
* @param onClick Will be called when the user clicks the button
* @param modifier Modifier to be applied to the button
* @param onLongClick Called when this button is long clicked (long-pressed). When this callback is
@@ -260,7 +258,6 @@
* Example of a [OutlinedButton] with onLongClick:
*
* @sample androidx.wear.compose.material3.samples.OutlinedButtonWithOnLongClickSample
- *
* @param onClick Will be called when the user clicks the button
* @param modifier Modifier to be applied to the button
* @param onLongClick Called when this button is long clicked (long-pressed). When this callback is
@@ -343,7 +340,6 @@
* Example of a [ChildButton] with onLongClick:
*
* @sample androidx.wear.compose.material3.samples.ChildButtonWithOnLongClickSample
- *
* @param onClick Will be called when the user clicks the button
* @param modifier Modifier to be applied to the button
* @param onLongClick Called when this button is long clicked (long-pressed). When this callback is
@@ -424,7 +420,6 @@
* Example of a [Button] with an icon and secondary label:
*
* @sample androidx.wear.compose.material3.samples.ButtonSample
- *
* @param onClick Will be called when the user clicks the button
* @param modifier Modifier to be applied to the button
* @param onLongClick Called when this button is long clicked (long-pressed). When this callback is
@@ -524,7 +519,6 @@
* Example of a [FilledTonalButton] with an icon and secondary label:
*
* @sample androidx.wear.compose.material3.samples.FilledTonalButtonSample
- *
* @param onClick Will be called when the user clicks the button
* @param modifier Modifier to be applied to the button
* @param onLongClick Called when this button is long clicked (long-pressed). When this callback is
@@ -618,7 +612,6 @@
* Example of an [OutlinedButton] with an icon and secondary label:
*
* @sample androidx.wear.compose.material3.samples.OutlinedButtonSample
- *
* @param onClick Will be called when the user clicks the button
* @param modifier Modifier to be applied to the button
* @param onLongClick Called when this button is long clicked (long-pressed). When this callback is
@@ -712,7 +705,6 @@
* Example of a [ChildButton] with an icon and secondary label:
*
* @sample androidx.wear.compose.material3.samples.ChildButtonSample
- *
* @param onClick Will be called when the user clicks the button
* @param modifier Modifier to be applied to the button
* @param onLongClick Called when this button is long clicked (long-pressed). When this callback is
@@ -829,7 +821,6 @@
* Example of a [CompactButton] with onLongClick:
*
* @sample androidx.wear.compose.material3.samples.CompactButtonWithOnLongClickSample
- *
* @param onClick Will be called when the user clicks the button
* @param modifier Modifier to be applied to the button
* @param onLongClick Called when this button is long clicked (long-pressed). When this callback is
diff --git a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/HorizontalPageIndicator.kt b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/HorizontalPageIndicator.kt
index f711c09..e8ec113a 100644
--- a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/HorizontalPageIndicator.kt
+++ b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/HorizontalPageIndicator.kt
@@ -81,7 +81,6 @@
* Example usage with HorizontalPager:
*
* @sample androidx.wear.compose.material3.samples.HorizontalPageIndicatorWithPagerSample
- *
* @param pageCount Total number of pages
* @param currentPage The currently selected page index
* @param currentPageOffsetFraction The offset fraction of the currently selected page. Represents
diff --git a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/IconButton.kt b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/IconButton.kt
index 6ec8aff..5a4ee1f 100644
--- a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/IconButton.kt
+++ b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/IconButton.kt
@@ -59,7 +59,6 @@
* Example of an [IconButton] with onLongClick:
*
* @sample androidx.wear.compose.material3.samples.IconButtonWithOnLongClickSample
- *
* @param onClick Will be called when the user clicks the button.
* @param modifier Modifier to be applied to the button.
* @param onLongClick Called when this button is long clicked (long-pressed). When this callback is
@@ -129,7 +128,6 @@
* Example of [FilledIconButton]:
*
* @sample androidx.wear.compose.material3.samples.FilledIconButtonSample
- *
* @param onClick Will be called when the user clicks the button.
* @param modifier Modifier to be applied to the button.
* @param onLongClick Called when this button is long clicked (long-pressed). When this callback is
@@ -199,7 +197,6 @@
* Example of [FilledTonalIconButton]:
*
* @sample androidx.wear.compose.material3.samples.FilledTonalIconButtonSample
- *
* @param onClick Will be called when the user clicks the button.
* @param modifier Modifier to be applied to the button.
* @param onLongClick Called when this button is long clicked (long-pressed). When this callback is
@@ -272,7 +269,6 @@
* Example of [OutlinedIconButton]:
*
* @sample androidx.wear.compose.material3.samples.OutlinedIconButtonSample
- *
* @param onClick Will be called when the user clicks the button.
* @param modifier Modifier to be applied to the button.
* @param onLongClick Called when this button is long clicked (long-pressed). When this callback is
@@ -342,7 +338,6 @@
* A simple icon toggle button using the default colors
*
* @sample androidx.wear.compose.material3.samples.IconToggleButtonSample
- *
* @param checked Boolean flag indicating whether this toggle button is currently checked.
* @param onCheckedChange Callback to be invoked when this toggle button is clicked.
* @param modifier Modifier to be applied to the toggle button.
diff --git a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/ListHeader.kt b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/ListHeader.kt
index dbe6bc4..2e63601 100644
--- a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/ListHeader.kt
+++ b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/ListHeader.kt
@@ -49,7 +49,6 @@
* Example of a [ListHeader]:
*
* @sample androidx.wear.compose.material3.samples.ListHeaderSample
- *
* @param modifier The modifier for the [ListHeader].
* @param backgroundColor The background color to apply - typically Color.Transparent
* @param contentColor The color to apply to content.
@@ -98,7 +97,6 @@
* Example of a [ListSubheader] with an icon:
*
* @sample androidx.wear.compose.material3.samples.ListSubheaderWithIconSample
- *
* @param modifier The modifier for the [ListSubheader].
* @param backgroundColor The background color to apply - typically Color.Transparent
* @param contentColor The color to apply to content.
diff --git a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/ScrollIndicator.kt b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/ScrollIndicator.kt
index 1e75ae5..1e48da4 100644
--- a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/ScrollIndicator.kt
+++ b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/ScrollIndicator.kt
@@ -93,7 +93,6 @@
* Example of a sample ScrollIndicator with Column:
*
* @sample androidx.wear.compose.material3.samples.ScrollIndicatorWithColumnSample
- *
* @param state The scrollState to use as the basis for the ScrollIndicatorState.
* @param modifier The modifier to be applied to the component - usually set to
* `Modifier.align(Alignment.CenterEnd)`.
@@ -144,7 +143,6 @@
* Example of a sample ScrollIndicator with LazyColumn:
*
* @sample androidx.wear.compose.material3.samples.ScrollIndicatorWithSLCSample
- *
* @param state the [ScalingLazyListState] to use as the basis for the ScrollIndicatorState.
* @param modifier The modifier to be applied to the component
* @param reverseDirection Reverses direction of ScrollIndicator if true
@@ -189,7 +187,6 @@
* Example of a sample ScrollIndicator with LazyColumn:
*
* @sample androidx.wear.compose.material3.samples.ScrollIndicatorWithLCSample
- *
* @param state the [LazyListState] to use as the basis for the ScrollIndicatorState.
* @param modifier The modifier to be applied to the component
* @param reverseDirection Reverses direction of ScrollIndicator if true
diff --git a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/Slider.kt b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/Slider.kt
index 72552ca..0dc5332 100644
--- a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/Slider.kt
+++ b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/Slider.kt
@@ -79,7 +79,6 @@
* A segmented slider sample:
*
* @sample androidx.wear.compose.material3.samples.InlineSliderSegmentedSample
- *
* @param value Current value of the Slider. If outside of [valueRange] provided, value will be
* coerced to this range.
* @param onValueChange Lambda in which value should be updated.
@@ -242,7 +241,6 @@
* A segmented slider sample:
*
* @sample androidx.wear.compose.material3.samples.InlineSliderSegmentedSample
- *
* @param value Current value of the Slider. If outside of [valueProgression] provided, value will
* be coerced to this range.
* @param onValueChange Lambda in which value should be updated.
diff --git a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/Stepper.kt b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/Stepper.kt
index 12f9f1e..34f1e69 100644
--- a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/Stepper.kt
+++ b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/Stepper.kt
@@ -45,7 +45,6 @@
* Example of a [Stepper] with range semantics:
*
* @sample androidx.wear.compose.material3.samples.StepperWithRangeSemanticsSample
- *
* @param value Current value of the Stepper. If outside of [valueRange] provided, value will be
* coerced to this range.
* @param onValueChange Lambda in which value should be updated
diff --git a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/TextButton.kt b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/TextButton.kt
index 46d9b0d..0b2c200 100644
--- a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/TextButton.kt
+++ b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/TextButton.kt
@@ -64,7 +64,6 @@
* Example of [TextButton] with onLongClick:
*
* @sample androidx.wear.compose.material3.samples.TextButtonWithOnLongClickSample
- *
* @param onClick Will be called when the user clicks the button.
* @param modifier Modifier to be applied to the button.
* @param onLongClick Called when this button is long clicked (long-pressed). When this callback is
@@ -141,7 +140,6 @@
* Example of a large text toggle button:
*
* @sample androidx.wear.compose.material3.samples.LargeTextToggleButtonSample
- *
* @param checked Boolean flag indicating whether this toggle button is currently checked.
* @param onCheckedChange Callback to be invoked when this toggle button is clicked.
* @param modifier Modifier to be applied to the toggle button.
@@ -214,7 +212,6 @@
* Example of [TextButton] with [filledTextButtonColors]:
*
* @sample androidx.wear.compose.material3.samples.FilledTextButtonSample
- *
* @param containerColor The background color of this text button when enabled
* @param contentColor The content color of this text button when enabled
* @param disabledContainerColor the background color of this text button when not enabled
@@ -250,7 +247,6 @@
* Example of [TextButton] with [filledTonalTextButtonColors]:
*
* @sample androidx.wear.compose.material3.samples.FilledTonalTextButtonSample
- *
* @param containerColor The background color of this text button when enabled
* @param contentColor The content color of this text button when enabled
* @param disabledContainerColor the background color of this text button when not enabled
@@ -287,7 +283,6 @@
* [ButtonDefaults.outlinedButtonBorder]:
*
* @sample androidx.wear.compose.material3.samples.OutlinedTextButtonSample
- *
* @param contentColor The content color of this text button when enabled
* @param disabledContentColor The content color of this text button when not enabled
*/
diff --git a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/TimeText.kt b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/TimeText.kt
index 534aeb0..ecd66ef 100644
--- a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/TimeText.kt
+++ b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/TimeText.kt
@@ -93,7 +93,6 @@
* An example of a [TimeText] with an icon along with the clock:
*
* @sample androidx.wear.compose.material3.samples.TimeTextWithIcon
- *
* @param modifier The modifier to be applied to the component.
* @param curvedModifier The [CurvedModifier] used to restrict the arc in which [TimeText] is drawn.
* @param maxSweepAngle The default maximum sweep angle in degrees.
@@ -170,7 +169,6 @@
* An example of a [TimeText] with an icon along with the clock:
*
* @sample androidx.wear.compose.material3.samples.TimeTextWithIcon
- *
* @param content Slot for the [composable] to be displayed.
*/
abstract fun composable(content: @Composable () -> Unit)
diff --git a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/ToggleControls.kt b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/ToggleControls.kt
index eb214e9..89ae031 100644
--- a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/ToggleControls.kt
+++ b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/ToggleControls.kt
@@ -59,7 +59,6 @@
* Checkbox sample:
*
* @sample androidx.wear.compose.material3.samples.ToggleButtonWithCheckbox
- *
* @param modifier Modifier to be applied to the checkbox. This can be used to provide a content
* description for accessibility.
* @param colors [CheckboxColors] from which the box and checkmark colors will be obtained.
@@ -97,7 +96,6 @@
* Switch samples:
*
* @sample androidx.wear.compose.material3.samples.ToggleButtonWithSwitch
- *
* @param modifier Modifier to be applied to the switch. This can be used to provide a content
* description for accessibility.
* @param colors [SwitchColors] from which the colors of the thumb and track will be obtained.
diff --git a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/Typography.kt b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/Typography.kt
index 21ab4bc..556592d 100644
--- a/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/Typography.kt
+++ b/wear/compose/compose-material3/src/main/java/androidx/wear/compose/material3/Typography.kt
@@ -35,7 +35,6 @@
* size for DisplayLarge:
*
* @sample androidx.wear.compose.material3.samples.FixedFontSize
- *
* @property displayLarge DisplayLarge is the largest headline. Displays are the largest text on the
* screen, reserved for short, important text or numerals.
* @property displayMedium DisplayMedium is the second largest headline. Displays are the largest
diff --git a/wear/compose/compose-navigation/src/main/java/androidx/wear/compose/navigation/SwipeDismissableNavHost.kt b/wear/compose/compose-navigation/src/main/java/androidx/wear/compose/navigation/SwipeDismissableNavHost.kt
index 8df8ef2..7b14d8f 100644
--- a/wear/compose/compose-navigation/src/main/java/androidx/wear/compose/navigation/SwipeDismissableNavHost.kt
+++ b/wear/compose/compose-navigation/src/main/java/androidx/wear/compose/navigation/SwipeDismissableNavHost.kt
@@ -88,7 +88,6 @@
* Example of a [SwipeDismissableNavHost] for which a destination has a named argument:
*
* @sample androidx.wear.compose.navigation.samples.NavHostWithNamedArgument
- *
* @param navController The navController for this host
* @param startDestination The route for the start destination
* @param modifier The modifier to be applied to the layout
@@ -139,7 +138,6 @@
* Example of a [SwipeDismissableNavHost] for which a destination has a named argument:
*
* @sample androidx.wear.compose.navigation.samples.NavHostWithNamedArgument
- *
* @param navController [NavHostController] for this host
* @param graph Graph for this host
* @param modifier [Modifier] to be applied to the layout
@@ -337,7 +335,6 @@
* Example of a [SwipeDismissableNavHost] for which a destination has a named argument:
*
* @sample androidx.wear.compose.navigation.samples.NavHostWithNamedArgument
- *
* @param navController The navController for this host
* @param startDestination The route for the start destination
* @param modifier The modifier to be applied to the layout
@@ -391,7 +388,6 @@
* Example of a [SwipeDismissableNavHost] for which a destination has a named argument:
*
* @sample androidx.wear.compose.navigation.samples.NavHostWithNamedArgument
- *
* @param navController [NavHostController] for this host
* @param graph Graph for this host
* @param modifier [Modifier] to be applied to the layout
diff --git a/wear/compose/compose-ui-tooling/src/main/java/androidx/wear/compose/ui/tooling/preview/WearPreviewDevices.kt b/wear/compose/compose-ui-tooling/src/main/java/androidx/wear/compose/ui/tooling/preview/WearPreviewDevices.kt
index 6b2b1e4..0ac8d8b 100644
--- a/wear/compose/compose-ui-tooling/src/main/java/androidx/wear/compose/ui/tooling/preview/WearPreviewDevices.kt
+++ b/wear/compose/compose-ui-tooling/src/main/java/androidx/wear/compose/ui/tooling/preview/WearPreviewDevices.kt
@@ -24,7 +24,6 @@
* shapes and sizes. It supports [WearDevices.SMALL_ROUND] and [WearDevices.LARGE_ROUND].
*
* @sample androidx.wear.compose.material.samples.ToggleButtonWithIconPreview
- *
* @see WearDevices.SMALL_ROUND
* @see WearDevices.LARGE_ROUND
*/
diff --git a/wear/compose/compose-ui-tooling/src/main/java/androidx/wear/compose/ui/tooling/preview/WearPreviewLargeRound.kt b/wear/compose/compose-ui-tooling/src/main/java/androidx/wear/compose/ui/tooling/preview/WearPreviewLargeRound.kt
index a40e37a..2718138 100644
--- a/wear/compose/compose-ui-tooling/src/main/java/androidx/wear/compose/ui/tooling/preview/WearPreviewLargeRound.kt
+++ b/wear/compose/compose-ui-tooling/src/main/java/androidx/wear/compose/ui/tooling/preview/WearPreviewLargeRound.kt
@@ -24,7 +24,6 @@
* round Wear device ([WearDevices.LARGE_ROUND]).
*
* @sample androidx.wear.compose.material.samples.ButtonWithIconPreview
- *
* @see [WearDevices.LARGE_ROUND]
*/
@Preview(
diff --git a/wear/compose/compose-ui-tooling/src/main/java/androidx/wear/compose/ui/tooling/preview/WearPreviewSmallRound.kt b/wear/compose/compose-ui-tooling/src/main/java/androidx/wear/compose/ui/tooling/preview/WearPreviewSmallRound.kt
index 853d836..a390175 100644
--- a/wear/compose/compose-ui-tooling/src/main/java/androidx/wear/compose/ui/tooling/preview/WearPreviewSmallRound.kt
+++ b/wear/compose/compose-ui-tooling/src/main/java/androidx/wear/compose/ui/tooling/preview/WearPreviewSmallRound.kt
@@ -24,7 +24,6 @@
* round Wear device ([WearDevices.SMALL_ROUND]).
*
* @sample androidx.wear.compose.material.samples.ButtonWithIconPreview
- *
* @see [WearDevices.SMALL_ROUND]
*/
@Preview(
diff --git a/wear/compose/compose-ui-tooling/src/main/java/androidx/wear/compose/ui/tooling/preview/WearPreviewSquare.kt b/wear/compose/compose-ui-tooling/src/main/java/androidx/wear/compose/ui/tooling/preview/WearPreviewSquare.kt
index 1e4eac9..1e96371 100644
--- a/wear/compose/compose-ui-tooling/src/main/java/androidx/wear/compose/ui/tooling/preview/WearPreviewSquare.kt
+++ b/wear/compose/compose-ui-tooling/src/main/java/androidx/wear/compose/ui/tooling/preview/WearPreviewSquare.kt
@@ -24,7 +24,6 @@
* Wear screen ([WearDevices.SQUARE]).
*
* @sample androidx.wear.compose.material.samples.ButtonWithIconPreview
- *
* @see [WearDevices.SQUARE]
*/
@Preview(
diff --git a/wear/wear-phone-interactions/src/main/java/androidx/wear/phone/interactions/authentication/RemoteAuthClient.kt b/wear/wear-phone-interactions/src/main/java/androidx/wear/phone/interactions/authentication/RemoteAuthClient.kt
index a6cbaca..b641eb3 100644
--- a/wear/wear-phone-interactions/src/main/java/androidx/wear/phone/interactions/authentication/RemoteAuthClient.kt
+++ b/wear/wear-phone-interactions/src/main/java/androidx/wear/phone/interactions/authentication/RemoteAuthClient.kt
@@ -249,7 +249,6 @@
* Sdk WEAR_TIRAMISU_4.
*
* @sample androidx.wear.phone.interactions.samples.AuthAvailabilitySample
- *
* @return a [Flow] with a stream of status updates that could be one of [STATUS_UNKNOWN],
* [STATUS_UNAVAILABLE], [STATUS_TEMPORARILY_UNAVAILABLE], [STATUS_AVAILABLE].
*/
diff --git a/wear/wear-remote-interactions/src/main/java/androidx/wear/remote/interactions/RemoteActivityHelper.kt b/wear/wear-remote-interactions/src/main/java/androidx/wear/remote/interactions/RemoteActivityHelper.kt
index 60c969c..9345fcf8 100644
--- a/wear/wear-remote-interactions/src/main/java/androidx/wear/remote/interactions/RemoteActivityHelper.kt
+++ b/wear/wear-remote-interactions/src/main/java/androidx/wear/remote/interactions/RemoteActivityHelper.kt
@@ -187,7 +187,6 @@
* devices, it will always return [STATUS_UNKNOWN].
*
* @sample androidx.wear.remote.interactions.samples.RemoteActivityAvailabilitySample
- *
* @return a [Flow] with a stream of status updates that could be one of [STATUS_UNKNOWN],
* [STATUS_UNAVAILABLE], [STATUS_TEMPORARILY_UNAVAILABLE], [STATUS_AVAILABLE].
*/
diff --git a/window/window/src/main/java/androidx/window/RequiresWindowSdkExtension.kt b/window/window/src/main/java/androidx/window/RequiresWindowSdkExtension.kt
index 5010f43..41e6719 100644
--- a/window/window/src/main/java/androidx/window/RequiresWindowSdkExtension.kt
+++ b/window/window/src/main/java/androidx/window/RequiresWindowSdkExtension.kt
@@ -27,7 +27,6 @@
* exceptions or unexpected results.
*
* @param version the minimum required [WindowSdkExtensions] version of the denoted target
- *
* @sample androidx.window.samples.annotateRequiresWindowSdkExtension
*/
@MustBeDocumented
diff --git a/window/window/src/main/java/androidx/window/embedding/SplitController.kt b/window/window/src/main/java/androidx/window/embedding/SplitController.kt
index a6a592d..fc28d14e 100644
--- a/window/window/src/main/java/androidx/window/embedding/SplitController.kt
+++ b/window/window/src/main/java/androidx/window/embedding/SplitController.kt
@@ -116,7 +116,6 @@
* calculator as the sample linked below shows.
*
* @sample androidx.window.samples.embedding.splitAttributesCalculatorSample
- *
* @param calculator the function to calculate [SplitAttributes] based on the
* [SplitAttributesCalculatorParams]. It will replace the previously set if it exists.
* @throws UnsupportedOperationException if [WindowSdkExtensions.extensionVersion] is less
diff --git a/window/window/src/main/java/androidx/window/embedding/SplitRule.kt b/window/window/src/main/java/androidx/window/embedding/SplitRule.kt
index ae9ca26..13cfa6b 100644
--- a/window/window/src/main/java/androidx/window/embedding/SplitRule.kt
+++ b/window/window/src/main/java/androidx/window/embedding/SplitRule.kt
@@ -51,7 +51,6 @@
* directions with different device states.
*
* @sample androidx.window.samples.embedding.splitWithOrientations
- *
* @see androidx.window.embedding.SplitPairRule
* @see androidx.window.embedding.SplitPlaceholderRule
*/
