deprecated_new_in_comment_reference

문서 주석의 대괄호 안에 적는 comment reference에서 생성자를 가리킬 때 new 키워드를 쓰면 이 진단이 나와요. 예전 방식이라 이제는 권장되지 않아요. 어떻게 바꿔야 하는지 천천히 살펴볼게요.

출처: deprecated_new_in_comment_reference

본문

comment reference(문서 주석에서 대괄호로 감싼 선언 이름)가 생성자를 가리키는 데 new 키워드를 사용하면 analyzer가 이 진단을 만들어요. 이 형태는 deprecated예요.

다음 코드는 이름 없는 생성자를 new C로 참조하고 있어서 이 진단이 나와요.

/// See [new C].
class C {
  C();
}

다음 코드는 c라는 이름의 생성자를 new C.c로 참조하고 있어서 이 진단이 나와요.

/// See [new C.c].
class C {
  C.c();
}

이름 있는 생성자를 참조하고 있다면 new 키워드를 제거하면 돼요.

/// See [C.c].
class C {
  C.c();
}

이름 없는 생성자를 참조하고 있다면 new 키워드를 제거하고 클래스 이름 뒤에 .new를 붙여주세요.

/// See [C.new].
class C {
  C.c();
}