docs: add deprecation message (#1310)

packages/td-tools/src/td-helpers.ts

@@ -43,6 +43,9 @@ export function findPort(td: ThingDescription): number {
     return parseInt(returnString);
 }
 
+/**
+ * @deprecated This function will be removed in the future.
+ */
 export function setContextLanguage(thing: ThingDescription, language: string, forceOverride: boolean): void {
     // forceOverride == false -> set @language if no @language set
     // forceOverride == true  -> set/override @language in any case

packages/td-tools/src/td-parser.ts

@@ -55,7 +55,10 @@ function adjustBooleanField(affordance: AffordanceElement, key: string) {
     }
 }
 
-/** Parses a TD into a Thing object */
+/** Parses a TD into a Thing object
+ *
+ * @deprecated This function will be removed in the future.
+ */
 export function parseTD(td: string, normalize?: boolean): Thing {
     logDebug(`parseTD() parsing\n\`\`\`\n${td}\n\`\`\``);
 
@@ -220,7 +223,10 @@ export function parseTD(td: string, normalize?: boolean): Thing {
     return thing;
 }
 
-/** Serializes a Thing object into a TD */
+/** Serializes a Thing object into a TD
+ *
+ * @deprecated This function will be removed in the future.
+ */
 export function serializeTD(thing: Thing): string {
     const copy: Thing = JSON.parse(JSON.stringify(thing));