I am trying to hook into the @doc deprecated: "message" annotation using __on_definition__. defmodule ExampleCompiler do def __on_definition__(env, _, fun, _, _, _) do doc = Module.get_attribute(env.module, :doc) IO.inspect(doc, label: fun) end end defmodule DemoModule do @on_definit…

Unfortunately it would be possible not sooner than in Elixir version 2.x, see: Provide an API to access documentation metadata at compile time · Issue #8095 · elixir-lang/elixir · GitHub

I assume that @doc just accepts a string and replaces anything else with nil. Maybe you want hello2 looks like: @doc "hello2` @deprecated "use hello instead" def hello2() do end I also assume that the line number means the position in the file not the position in the definition.

I would expect the keyword list approach to work because it’s also used this way in the stdlib. For example, from docs_test.exs: @doc "Callback doc" @doc since: "1.2.3", color: :red, deprecated: "use baz/2 instead" @doc color: :blue, stable: true @callback foo(any) :: any and @doc deprecated: "Us…

Yeah @doc deprecated: … is used for soft deprecation @deprecated is hard deprecation integrated with the compiler.

Elixir Programming Language Forum

Catching @doc deprecated: "..." annotations

Questions & Help Questions

arjan March 20, 2024, 10:36am 6

Thanks, very helpful link!