ASDoc을 Bindable metatag 및 mxml과 함께 사용

Question

ASDoc을 사용하고 바인드 가능 메타 태그에 몇 가지 문제가있는 my flex 프로젝트의 문서를 만듭니다. 바인딩 가능한 태그와 연관된 이벤트 이름을 가지고 있지 않는

• ASDoc은public Bindable값을 문서화하지 않습니다.

예를 들어

: 바인딩 가능한 태그와 연관된 이벤트 이름이없는 경우

//This is documented correctly 
[Bindable("someEvent")] 
/* 
* public bindable with event name 
* */ 
public var test1:String; 

//This is not documented at all 
[Bindable] 
/* 
* public bindable without event name 
* */ 
public var test2:String; 

• ASDoc은protected Bindable값의 이름에 임의의 문자열을 앞에 추가합니다. 예를 들어

:

//This is documented correctly as test3 
[Bindable("someEvent")] 
/* 
* protected bindable with event name 
* */ 
protected var test3:String; 

//But this is documented as _110251490test4 
[Bindable] 

/* 
* protected bindable without event name 
* */ 
protected var test4:String; 

그것을 정리해하려면, ASDoc은 이벤트 이름이없는 Bindable 태그 행복하지 않다. 쉬운 솔루션은 Bindable으로 선언 할 때마다 이벤트 이름을 지정하는 것입니다. 하지만 flex docs say that Bindable 태그로 이벤트 이름을 지정하면 "이벤트 생성 및 발송 책임이 있습니다". 내 프로젝트가 거의 완료되었고 많은 장소에서 바인딩 (이벤트 이름없이)에 의존하여 돌아가서 모든 것을 변경하는 것은 비현실적이었습니다. 많은 노력이 필요할 것입니다. 더하기 나에게 무서운 소리를내는 문서 작성을위한 작업 코드를 어지럽히는 아이디어.

모든 [Bindable] 인스턴스를 [Bindable("blah")]으로 바꾸고 asdoc을 생성 한 다음 다시 변경하기 전에 내가 생각할 수있는 유일한 해결책입니다. 그러나 나는 더 좋은 방법이 있어야한다고 생각합니다.

Adobe bug tracker은 공용 변수의 문제가 최신 빌드에서 수정되었으므로 최신 flex sdk (3.4)를 다운로드하고 함께 제공된 ASDoc을 시도했지만 동일한 결과를 얻었습니다.

누구든지이 문제에 관해 밝힐 수 있습니까?

또한 Adobe blog says ASDoc도 mxml을 지원하지만 최신 (flex 3.4) ASDoc을 사용해 보았을 때 내 mxml asdoc 주석 (포함됨)이 생성 된 html 페이지에 표시되지 않았습니다. 최신 asdoc을 별도로 다운로드 할 수 있는지 누가 알 수 있습니까?

Answer 1

당신은 MXML에 대한

ASDoc의 변경 사항은 플렉스 4 (IIRC)에, 내가 바인딩 버그가 동일하지 않습니다 확인 것입니다 ... 확인하는 어떤 락스 번호를 제공하지만,하지 않습니다.

Answer 2

해결 방법을 도울 수는 없지만 [Bindable] (이벤트 이름 없음) 속성에서 래퍼 코드 (다른 속성으로 생각됩니다)가 생성된다는 점이 문제입니다. 이 코드는 분명 asdoc을 망친다.