[LL FIR] FirDesignation: update KDoc for collectDesignationWithOptionalFile

^KT-65344
This commit is contained in:
Dmitrii Gridin
2024-02-13 12:42:55 +01:00
committed by Space Team
parent ca484fae2c
commit ab328e76d4
@@ -313,6 +313,10 @@ private fun findKotlinStdlibClass(classId: ClassId, target: FirDeclaration): Fir
/**
* Consider using this function only if [collectDesignation] is not applicable.
*
* This extension function can be used in the case there your [FirElementWithResolveState] probably
* doesn't have [getContainingFile] and it doesn't matter for your purposes.
* Potentially, this function can become obsolete if we support all possible cases in [getContainingFile]
*
* @return [FirDesignation] where [FirDesignation.fileOrNull] can be null or throws an exception.
*
* @see collectDesignation
@@ -339,6 +343,10 @@ fun FirElementWithResolveState.collectDesignation(providedFile: FirFile? = null)
/**
* Consider using this function only if [tryCollectDesignation] is not applicable.
*
* This extension function can be used in the case there your [FirElementWithResolveState] probably
* doesn't have [getContainingFile] and it doesn't matter for your purposes.
* Potentially, this function can become obsolete if we support all possible cases in [getContainingFile]
*
* @return [FirDesignation] where [FirDesignation.fileOrNull] can be null or null.
*
* @see collectDesignationWithOptionalFile