Haddock : 종속성 그래프를 만들지 못했습니다 ( * 또는 모듈 제목으로 섹션을 추가 할 때)

StackOverflow https://stackoverflow.com/questions/1303381

  •  19-09-2019
  •  | 
  •  

문제

Tarball 소스에서 Haddock-2.4.2를 컴파일하고 설치했습니다.

코드에 몇 가지 간단한 댓글을 추가합니다.

그리고 Haddock 달리기

$ haddock -h -o doc Data/DualMap.hs
Warning: Data.DualMap: could not find link destinations for:
    Data.Typeable.Typeable2 GHC.Base.Eq GHC.Show.Show GHC.Base.Ord GHC.Base.Bool Data.Set.Set

수확량 :

상황이 좋아 보인다. (이 모듈은 GHC와 다른 소스 모듈이없는 LIB에만 의존합니다.)

그러나 섹션을 추가하려고 할 때 (A LA http://www.haskell.org/haddock/doc/html/ch03s04.html#id289234 ) "- * test"에 대한 주석에서 : 나는 얻는다 :

$ haddock -h -o doc Data/DualMap.hs
Data/DualMap.hs:20:0: parse error on input `-- * test'
haddock: Failed to create dependency graph

이 오류 메시지는 Haddock.interface.depanal이 (Haddock 소스의 Grep에 따라) 아무것도 반환하지 않았지만 의존성 분석이 실패하지 않도록하는 방법은 없다고 말하면서이 작업을 시작해야 할 곳을 어디서 시작 해야할지 모르겠습니다. 아마도 GHC/Base/Containers Documentation 또는 일부 Haddock 구성 파일의 누락 된 링크 대상에 대한 명령 줄 인수 또는 참조가 필요할 수 있습니까?

Google을 검색하면 해킹의 패키지에 대해 동일한 ILK의 CABAL 빌드 오류가 많이 발생했지만 수정 방법에 대한 것은 없습니다.

섹션 (별표 포함)을 추가하고 문서를 생성하려면 Haddock을 얻으려면 어떻게해야합니까? 내가 무엇을 놓치고 있을까요?

도움이 되었습니까?

해결책

간단한 수정 (끔찍한 오류 메시지) :

이동 (모듈 이름이있는 줄까지 이동하십시오. 이전 불량 코드 :

module Data.DualMap
   -- * The @DualMap@ abstract type
   ( DualMap ()
   -- * (?) internal? -- exposed for testing purposes, for now...
   , dmFlip
   -- * converting to and from DualMap
   , toList, fromList, map
   -- * constructing a DualMap
   , empty, null, insert, union

행복한 코드는 다음과 같습니다.

module Data.DualMap (
   -- * The @DualMap@ abstract type                                                                                                                                 
     DualMap ()
   -- * (?) internal? -- exposed for testing purposes, for now...                                                                                                   
   , dmFlip
   -- * converting to and from DualMap                                                                                                                              
   , toList, fromList, map
   -- * constructing a DualMap                                                                                                                                      
   , empty, null, insert, union

충분히 간단합니다. 다운로드하여 이것을 찾았습니다 Hacakge의 DLIST 코드를 내 코드로 바꾸고 교체합니다. DLIST가 'Cabal Haddock'과 함께 일했을 때 (별표를 추가하려고 할 때), 나는 파일의 차이점을 보았고 내 괄호가 잘못된 줄에 충분히 있는지 확인했습니다.

BTW 나는 DLIST를 새로운 Haskell 프로젝트 대신 시작 장소로 적극 권장합니다. hnop.

라이센스 : CC-BY-SA ~와 함께 속성
제휴하지 않습니다 StackOverflow
scroll top