{"id":938,"date":"2010-03-23T11:38:35","date_gmt":"2010-03-23T18:38:35","guid":{"rendered":"https:\/\/blogs.mentor.com\/verificationhorizons\/?p=938"},"modified":"2026-03-27T08:44:48","modified_gmt":"2026-03-27T12:44:48","slug":"the-art-of-deprecation","status":"publish","type":"post","link":"https:\/\/blogs.sw.siemens.com\/verificationhorizons\/2010\/03\/23\/the-art-of-deprecation\/","title":{"rendered":"The Art of Deprecation"},"content":{"rendered":"

At a recent SystemVerilog requirements gathering meeting,I was quite amused to see \u201cdeprecating features\u201d come out as one of the top 10 user requested priorities<\/a> for the next revision of the IEEE 1800 standard. Even more amazing was that this request came out without listing which features were to be considered for deprecation.<\/p>\n

\"P1800
P1800 Requirements Gathering Meeting 2\/27\/2010<\/figcaption><\/figure>\n

I\u2019m sure most people don\u2019t understand the meaning of the word deprecate<\/em>. I thought I understood until I looked it up in a dictionary. According to Merriam-Webster:<\/p>\n

Deprecate:<\/p>\n

1 a<\/strong> archaic<\/em> :<\/strong> to pray against (as an evil) b<\/strong> :<\/strong> to seek to avert <deprecate the wrath\u2026of the Roman people \u2014 Tobias Smollett>
\n2<\/strong> :<\/strong> to express disapproval of
\n3 a<\/strong> :<\/strong> play down<\/a> :<\/strong> make little of <speaks five languages<\/a>\u2026but deprecates<\/em>this facility \u2014 Time<\/em>> b<\/strong> :<\/strong> belittle<\/a>, disparage<\/a><the most reluctantly admired and least easily deprecated<\/em> of\u2026novelists \u2014 New Yorker<\/em>><\/span><\/p>\n

In computer science standards and documentation, deprecation<\/a> has come to mean to supersede or discourage use of a feature. It does not mean a feature has to be removed to be compliant with the standard. You can\u2019t remove a feature from an existing standard; you can only remove a feature from being documented in a future standard. No vendor is going to immediately remove a feature from a tool that it has already implemented and in widespread use without ample warning and without providing a practical alternative to the user. Typically, a deprecated feature is never removed from support in a tool unless in the rare case it\u2019s needed to allow for a future enhancement.<\/p>\n

The current standard lists in Annex C.4 the defparam and the procedural continuous assignment statements as candidates for deprecation. Listing candidates for deprecation seems to be almost the same as actually deprecating them without removing the LRM. No tool will remove support for these statements regardless of whether they are candidates or actually removed from the LRM.<\/p>\n

Q: So why go though the trouble of deprecating a feature in a standard?
\nA: Well, to discourage use of that feature.<\/p>\n

Q: And why is that a good thing to do?
\nA: It makes learning the language and maintaining existing code much easier.<\/p>\n

Take an example from the current Verilog and SystemVerilog LRMs. The logic<\/strong> data type was added to supersede the reg<\/strong> data types; they both have the same semantics. Anyone with a history of Verilog will understand the change in keywords, but someone new to SystemVerilog will be left wondering why there are two keywords for the same thing. And then there is the issue of trying to maintain the LRM so that all references to reg<\/strong> also include logic<\/strong> and the other way around. If someone misses that in one place, people will begin to think the two keywords have different behaviors.<\/p>\n

\n

It seems it\u2019s always easier to add new features than to remove them. There are many places to create lists of your favorite enhancements. At the same time, people complain about the size of the Language Reference Manual \u2013 it\u2019s over 1200 pages. Doug Smith of Doulos writes \u201cWill this language ever stop exploding?<\/a>\u201d<\/p>\n

\n

So here is my list for deprecation, as well as a place for other to add their list by commenting here.<\/p>\n

\n

    \n
  1. Program blocks<\/a><\/li>\n
  2. Reg data type \u2013 see above<\/li>\n
  3. Wildcard associative array index types<\/a><\/li>\n
  4. Un-typed mailboxes<\/a><\/li>\n
  5. Dynamic array copy A = new[]B redundant with A = B<\/li>\n
  6. always @(*) \u2013 superseded by always_comb<\/li>\n
  7. $random\/$dist_uniform replaced by $urandom\/$urandom_range for better stability and seed control<\/li>\n
  8. Stochastic $q_ tasks replaced with queue array type<\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"

    At a recent SystemVerilog requirements gathering meeting,I was quite amused to see \u201cdeprecating features\u201d come out as one of the…<\/p>\n","protected":false},"author":71589,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"spanish_translation":"","french_translation":"","german_translation":"","italian_translation":"","polish_translation":"","japanese_translation":"","chinese_translation":"","footnotes":""},"categories":[1],"tags":[533,732,751],"industry":[],"product":[],"coauthors":[],"class_list":["post-938","post","type-post","status-publish","format-standard","hentry","category-news","tag-ieee-1800","tag-standards","tag-systemverilog"],"_links":{"self":[{"href":"https:\/\/blogs.sw.siemens.com\/verificationhorizons\/wp-json\/wp\/v2\/posts\/938","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blogs.sw.siemens.com\/verificationhorizons\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blogs.sw.siemens.com\/verificationhorizons\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/verificationhorizons\/wp-json\/wp\/v2\/users\/71589"}],"replies":[{"embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/verificationhorizons\/wp-json\/wp\/v2\/comments?post=938"}],"version-history":[{"count":3,"href":"https:\/\/blogs.sw.siemens.com\/verificationhorizons\/wp-json\/wp\/v2\/posts\/938\/revisions"}],"predecessor-version":[{"id":14687,"href":"https:\/\/blogs.sw.siemens.com\/verificationhorizons\/wp-json\/wp\/v2\/posts\/938\/revisions\/14687"}],"wp:attachment":[{"href":"https:\/\/blogs.sw.siemens.com\/verificationhorizons\/wp-json\/wp\/v2\/media?parent=938"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/verificationhorizons\/wp-json\/wp\/v2\/categories?post=938"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/verificationhorizons\/wp-json\/wp\/v2\/tags?post=938"},{"taxonomy":"industry","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/verificationhorizons\/wp-json\/wp\/v2\/industry?post=938"},{"taxonomy":"product","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/verificationhorizons\/wp-json\/wp\/v2\/product?post=938"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/blogs.sw.siemens.com\/verificationhorizons\/wp-json\/wp\/v2\/coauthors?post=938"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}