# Deprecated functions

**URL:** <https://forum.inductiveautomation.com/t/deprecated-functions/6117>\
**Category:** Ignition\
**Created:** [March 28, 2013, 10:32am UTC](https://forum.inductiveautomation.com/t/deprecated-functions/6117 "2013-03-28T10:32:55Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![systemparadox](https://avatars.discourse-cdn.com/v4/letter/s/b5e925/32.png) [@systemparadox](https://forum.inductiveautomation.com/u/systemparadox)\
**Post date:** [March 28, 2013, 10:32am UTC](https://forum.inductiveautomation.com/t/deprecated-functions/6117/1 "2013-03-28T10:32:55Z")

</div>

Ignition’s documentation appears to be lacking a section for deprecated functions.

For example, system.tag.writeToTag has been replaced by system.tag.write, but given an old project I have no way of knowing this. The function simply vanishes from the documentation. There really needs to be some sort of migration list. Even if I knew that a function was deprecated, it is not necessarily obvious what it should be replaced with.

Please can this be fixed.

Thanks.

---

<div class="post-metadata">

**Author:** ![dave.fogle](https://avatars.discourse-cdn.com/v4/letter/d/43a26b/32.png) [@dave.fogle](https://forum.inductiveautomation.com/u/dave.fogle)\
**Post date:** [March 28, 2013, 3:44pm UTC](https://forum.inductiveautomation.com/t/deprecated-functions/6117/2 "2013-03-28T15:44:33Z")

</div>

We can look into finding a way to include deprecated functions in the user manual without it confusing new users.

Really you don't need to change any of your old writeToTag() calls to the new write() style. The old function is still included for backwards compatibility and has really only been removed from the documentation and replaced with documentation for the new function.

---

<div class="post-metadata">

**Author:** ![ceidson](https://avatars.discourse-cdn.com/v4/letter/c/9d8465/32.png) [@ceidson](https://forum.inductiveautomation.com/u/ceidson)\
**Post date:** [April 17, 2013, 4:28pm UTC](https://forum.inductiveautomation.com/t/deprecated-functions/6117/3 "2013-04-17T16:28:53Z")

</div>

Is there any advantage to using system.tag.write() as opposed to system.tag.writeToTag()?

---

<div class="post-metadata">

**Author:** ![dave.fogle](https://avatars.discourse-cdn.com/v4/letter/d/43a26b/32.png) [@dave.fogle](https://forum.inductiveautomation.com/u/dave.fogle)\
**Post date:** [April 17, 2013, 4:42pm UTC](https://forum.inductiveautomation.com/t/deprecated-functions/6117/4 "2013-04-17T16:42:16Z")

</div>

No there is not. They essentially do the same thing.

---

<div class="post-metadata">

**Author:** ![systemparadox](https://avatars.discourse-cdn.com/v4/letter/s/b5e925/32.png) [@systemparadox](https://forum.inductiveautomation.com/u/systemparadox)\
**Post date:** [May 21, 2013, 7:47am UTC](https://forum.inductiveautomation.com/t/deprecated-functions/6117/5 "2013-05-21T07:47:14Z")

</div>

> [@ceidson](#):
>
> Is there any advantage to using system.tag.write() as opposed to system.tag.writeToTag()?

system.tag.write() is documented, whereas system.tag.writeToTag() is not.

---

<div class="post-metadata">

**Author:** ![Carl.Gould](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/carl.gould/32/7262_2.png) [@Carl.Gould](https://forum.inductiveautomation.com/u/Carl.Gould)\
**Post date:** [May 21, 2013, 6:46pm UTC](https://forum.inductiveautomation.com/t/deprecated-functions/6117/6 "2013-05-21T18:46:19Z")

</div>

Yes, I agree that it would be nice if we had a documentation suction for deprecated functions, but to be honest, we have a hard enough time keeping on top of the documentation as-is, and a hard enough time teaching new users about scripting, without throwing deprecated stuff into the mix. The deprecated functions aren’t going anywhere - it’s not like you need to go through your scripts and change them with any urgency.

---

<div class="post-metadata">

**Author:** ![systemparadox](https://avatars.discourse-cdn.com/v4/letter/s/b5e925/32.png) [@systemparadox](https://forum.inductiveautomation.com/u/systemparadox)\
**Post date:** [August 29, 2013, 10:46am UTC](https://forum.inductiveautomation.com/t/deprecated-functions/6117/7 "2013-08-29T10:46:32Z")

</div>

Actually I’ve been changing them purely _because_ they are undocumented.

For someone reading the code later system.tag.writeToTag is obvious enough, but that’s not always the case. Some of the old database functions changed their parameters.

---

<div class="post-metadata">

**Author:** ![Kevin.Herron](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/kevin.herron/32/7259_2.png) [@Kevin.Herron](https://forum.inductiveautomation.com/u/Kevin.Herron)\
**Post date:** [August 29, 2013, 3:43pm UTC](https://forum.inductiveautomation.com/t/deprecated-functions/6117/8 "2013-08-29T15:43:15Z")

</div>

[quote=“systemparadox”]Actually I’ve been changing them purely _because_ they are undocumented.

For someone reading the code later system.tag.writeToTag is obvious enough, but that’s not always the case. Some of the old database functions changed their parameters.[/quote]

Good. Maybe we _should_ leave them undocumented then 😈

---

<div class="post-metadata">

**Author:** ![Carl.Gould](https://sea1.discourse-cdn.com/inductiveautomation/user_avatar/forum.inductiveautomation.com/carl.gould/32/7262_2.png) [@Carl.Gould](https://forum.inductiveautomation.com/u/Carl.Gould)\
**Post date:** [August 29, 2013, 3:52pm UTC](https://forum.inductiveautomation.com/t/deprecated-functions/6117/9 "2013-08-29T15:52:03Z")

</div>

Yeah, changing them over certainly isn’t a bad idea if you’re up for it.

For what it’s worth, we recently hired a technical writer! ![:thumb_right:](https://us1.discourse-cdn.com/inductiveautomation/original/1X/2026e28c0c425034352c1b75807edf956adc75f4.gif ":thumb\_right:")  
Hopefully our documentation enters a new era of accuracy and timeliness.
