동적 문서화, 다른 YARD의 설명에서 메서드 반환을 사용합니까?

Question

나는 프로젝트를 문서화하고 있고 essientially 나는 다음과 유사한 있습니다

def foo 
    return bar(__method__) 
end 

def bar (method) 
return method.to_s + 'somestring' 
end 

나는 그들이 바의 수익을 반환하는있는 foo는 구현 방법과 유사한 방법의 다수를 설정하고있다.

# The descriptions for foo0... 
# @return [String] the method name concatenated with somestring 
def foo0 
    return bar(__method__) 
end 
# The descriptions for foo1... 
# @return [String] the method name concatenated with somestring 
def foo1 
    return bar(__method__) 
end 

# The descriptions for bar... 
# @return [String] the method name concatenated with somestring 
def bar (method) 
return method.to_s + 'somestring' 
end 

을하지만 bar 내 문서가 잘못된 다음 정수로 반환하는 내용을 변경 말을 다음과 같이 예입니다. 나는 YARD의 DSL 문서화에 익숙하지만, 다른 메소드를 설명 할 때 bar 메소드 반환의 반환 유형을 #bar@return.type으로 지정하는 방법은 무엇입니까?

# The descriptions for foo0... 
# @return [#bar@return.type] the method name concatenated with somestring 
def foo0 
    return bar(__method__) 
end 
# The descriptions for foo1... 
# @return [#bar@return.type] the method name concatenated with somestring 
def foo1 
    return bar(__method__) 
end 

# The descriptions for bar... 
# @return [String] the method name concatenated with somestring 
def bar (method) 
return method.to_s + 'somestring' 
end 

궁극적으로 내가 무엇을 달성하려고하는 또 다른 방법으로 정의되는 사항에 대한 의존 반환 유형 등의 절대성을 정의 할 필요없이 내 코드를 문서화하는 것입니다 : 다음과 같다 내가 무엇을 말하는거다의 예 있다.

UPDATE : 나는 당신이 # @return (see #bar)를 호출 할 수 있습니다 그것은 반환 또는 bar 방법과 동일 foo 방법을 표시해야하지만 반환되는 유형을 얻을 방법을 간단하게 확인할 수 없습니다임을 발견했다 /foo에 대한 사용자 정의 설명이있는 bar에 대한 반품 설명에 과부하가 걸릴 수 있습니다.

Answer 1

발견 한대로 을 사용하여 @return 태그를 #bar 그대로에서 다른 docstrings으로 복사해야합니다. 참고 : 설명 텍스트도 복사됩니다. 메소드의 유형을 보간하는 방법은 없습니다. 당신은 당신의 특정한보기에서 그것을 필요로하지 않는 것처럼 보입니다.