IDL Problem Code 53 with alias docs-invalid-in-out

Want to disable me? Check out the configuration guide to learn more.

Documentation Best Practice

This problem indicates that there's an opportunity to improve the documentation for your code.

This helps make sure the extension can properly detect types, provide a better user experience, and ensures other users can be successful with code that you write.

Want to automate documentation generation? Learn about comment style and AutoDoc here.

This problem indicates that the documentation for the direction for a parameter (argument or keyword) is not in, out, or bidirectional.

Here's an example that highlights the problem:

;+
; :Returns: Number
;
; :Arguments:
;   arg: not right, required, Number
;     My favorite arg
;
;-
function myfunc, arg
  compile_opt idl2
  return, 42 + arg
end

To fix the issue, adjust the direction to be one of the following:

Direction: "in"

;+
; :Returns: Number
;
; :Arguments:
;   arg: in, required, Number
;     My favorite arg
;
;-
function myfunc, arg
  compile_opt idl2
  return, 42 + arg
end

Direction: "out"

;+
; :Returns: Number
;
; :Arguments:
;   arg: out, required, Number
;     My favorite arg
;
;-
function myfunc, arg
  compile_opt idl2
  return, 42 + arg
end

Direction: "bidirectional"

;+
; :Returns: Number
;
; :Arguments:
;   arg: bidirectional, required, Number
;     My favorite arg
;
;-
function myfunc, arg
  compile_opt idl2
  return, 42 + arg
end