/* Ċ Ġ* ĠCopyright Ġ( C ) Ġ 2 0 1 2 - 2 0 2 2 , ĠTom Tom Ġ( http :// tom tom . com ). Ċ Ġ* Ċ Ġ* ĠLicensed Ġunder Ġthe ĠApache ĠLicense , ĠVersion Ġ 2 . 0 Ġ( the Ġ" License "); Ċ Ġ* Ġyou Ġmay Ġnot Ġuse Ġthis Ġfile Ġexcept Ġin Ġcompliance Ġwith Ġthe ĠLicense . Ċ Ġ* ĠYou Ġmay Ġobtain Ġa Ġcopy Ġof Ġthe ĠLicense Ġat Ċ Ġ* Ċ Ġ* ĠĠĠĠ Ġhttp :// www . apache . org / licenses / LICENSE - 2 . 0 Ċ Ġ* Ċ Ġ* ĠUnless Ġrequired Ġby Ġapplicable Ġlaw Ġor Ġagreed Ġto Ġin Ġwriting , Ġsoftware Ċ Ġ* Ġdistributed Ġunder Ġthe ĠLicense Ġis Ġdistributed Ġon Ġan Ġ" AS ĠIS " ĠBASIS , Ċ Ġ* ĠWITHOUT ĠWARRANTIES ĠOR ĠCONDITIONS ĠOF ĠANY ĠKIND , Ġeither Ġexpress Ġor Ġimplied . Ċ Ġ* ĠSee Ġthe ĠLicense Ġfor Ġthe Ġspecific Ġlanguage Ġgoverning Ġpermissions Ġand Ċ Ġ* Ġlimitations Ġunder Ġthe ĠLicense . Ċ Ġ*/ Ċ package Ġcom . tom tom . kotlin . trace events Ċ Ċ /** Ċ Ġ* ĠThis Ġannotation Ġcan Ġbe Ġused Ġto Ġannotate Ġfunctions Ġin Ġfor Ġa Ġtrace Ġevent Ġlistener . Ċ Ġ* ĠBoth Ġinterfaces Ġand Ġindividual Ġfunctions Ġcan Ġbe Ġannotated . ĠAn notations Ġat Ġthe Ġfunction Ġlevel Ċ Ġ* Ġoverride Ġthose Ġat Ġthe Ġinterface Ġlevel . Ċ Ġ* Ċ Ġ* Ġ@ param Ġinclude Exception StackTrace ĠSpecifies Ġwhether Ġa Ġstack Ġtrace Ġshould Ġbe Ġincluded Ġif Ġthe Ġlast Ċ Ġ* Ġparameter Ġof Ġthe Ġevent Ġis Ġderived Ġfrom Ġ[ Throwable ]. ĠIf Ġfalse , Ġonly Ġthe Ġexception Ġmessage Ġis Ċ Ġ* Ġshown . Ċ Ġ* ĠDefault Ġvalue Ġis Ġtrue . Ċ Ġ* Ċ Ġ* Ġ@ param Ġinclude Tagging Class ĠSpecifies Ġwhether Ġowner Ġclass Ġof Ġthe Ġevent Ġdefinition Ġshould Ġbe Ġlogged Ċ Ġ* Ġor Ġnot . Ċ Ġ* ĠDefault Ġis Ġfalse . ĊĊ Ġ* Ġ@ param Ġinclude File Location ĠSpecifies Ġwhether Ġthe Ġfilename Ġand Ġline Ġnumber Ġof Ġthe Ġcaller Ċ Ġ* Ġshould Ġbe Ġlogged Ġor Ġnot . Ċ Ġ* ĠDefault Ġis Ġfalse . Ċ Ġ* Ċ Ġ* Ġ@ param Ġinclude Event Interface ĠSpecifies Ġwhether Ġthe Ġinterface Ġname Ġof Ġthe Ġ[ Trace EventListener ] Ċ Ġ* Ġinterface Ġshould Ġbe Ġlogged Ġor Ġnot . Ċ Ġ* ĠDefault Ġis Ġfalse . Ċ Ġ* Ċ Ġ*/ Ċ @ Retention ( Annotation Retention . RUNTIME ) Ċ @ Target ( Annotation Target . FUNCTION , ĠAnnotation Target . CLASS ) Ċ annotation Ġclass ĠTrace Options ( ĊĠĠĠ Ġval Ġinclude Exception StackTrace : ĠBoolean Ġ= Ġtrue , ĊĠĠĠ Ġval Ġinclude Tagging Class : ĠBoolean Ġ= Ġfalse , ĊĠĠĠ Ġval Ġinclude File Location : ĠBoolean Ġ= Ġfalse , ĊĠĠĠ Ġval Ġinclude Event Interface : ĠBoolean Ġ= Ġfalse Ċ ) Ċ