Mirror of forum.nim-lang.org

8750 :: Would the Nim version number be helpful in deprecation documentation?

• tmsa04 (orginal) [2021-12-29T04:03:37+01:00] view original

  I was just using sequtils delete. I saw one form was deprecated: https://nim-lang.org/docs/sequtils.html#delete%2Cseq%5BT%5D%2CNatural%2CNatural So I used the newer one, which was fine with the latest nim-git. But in Nim 1.4.8 it fails, the older version is required. I can write some Nim version check to get this to work in both places, but then first I need to find out what version the new form will work in, perhaps the git commit history might help, or I can just try building against the other versions. Compare this to glibc documentation: https://docs.gtk.org/gtk3/struct.WidgetPath.html So here you can see what version functions and things were introduced, and when they were deprecated, which is obviously helpful to know, and avoids finding out by trial and error. Adding that to everything in the Nim docs would probably be a huge task, but it might be more reasonable to add it to new deprecation notices, and the person writing it is probably going to be better informed of those details than many of the readers will be.

---

• Araq (orginal) [2021-12-29T06:23:50+01:00] view original

  We usually add the version information, for example:

  
      "Deprecated since v1.4; it was more confusing than useful, use `[]=`".
  Run

  Unfortunately not in your case though...

---

• tmsa04 (orginal) [2021-12-30T03:35:44+01:00] view original

  https://github.com/nim-lang/Nim/commit/1d6863a7899fd87fd9eb017ae370ef37db18ad32#diff-5bcacc6f2c5664f94022187523f52ec45aff40c875f75910a538512ac45428d8

  Found it! 1.6.0 was the version it was introduced.

  
    when NimVersion >= "1.6.0":
      someseq.delete(a..b)
    else:
      someseq.delete(a,b)
  Run

  Thank you.

---