add-leading — 문서 노드의 앞(leading) 문서에 줄 추가하기

Raku의 문서 AST 노드는 '이 노드 앞에 붙는 문서'와 '뒤에 붙는 문서'를 따로 가질 수 있어요. add-leading은 그중 앞쪽(leading) 문서에 설명 줄을 하나 추가하는 메서드예요. 선언(declarator) 문서를 AST로 만들 때 쓰인다고 보면 돼요.

출처: Raku 공식 문서 — add-leading

본문

In RakuAST::Doc::Declarator — 앞 문서에 줄 추가

$declarator.add-leading("additional");

선언자(RakuAST::Doc::Declarator)의 앞쪽 문서에 줄을 하나 추가해요. 예제처럼 "additional"이라는 문자열을 넘기면 그 줄이 앞쪽 문서에 더해져요.

In RakuAST::Doc::DeclaratorTarget — 없으면 만들어서라도 추가

$target.add-leading("additional");

대상(RakuAST::Doc::DeclaratorTarget)의 앞쪽 문서에도 줄을 추가할 수 있어요. 여기서 차이가 나는 부분은, 이미 RakuAST::Doc::Declarator 객체가 없으면 새로 만들어서 .WHY 속성에 설정한다는 점이에요. .WHY는 문서 메타데이터가 담기는 곳이라고 보면 돼요. 그래서 첫 줄을 추가할 때 자동으로 선언자 객체를 준비해 주는 셈이죠.