Bad appledoc build #13375

Closed
sbentzen opened this Issue Jul 12, 2012 · 13 comments

5 participants

@sbentzen

There seems to be a bad appledoc build with Homebrew and Mountain Lion (10.8), causing crash issues.

See tomaz/appledoc#230 for reference to issue.

@samueljohn

so basically we have to wait for an upstream fix?

@adamv

Is this 10.8 specific? I don't see that mentioned in the upstream bug report.

@sbentzen

I'm having an issue with regards to 10.8 with this specific build (build 737), while the person who filed the upstream bug report moved to a newer build (build 789) and reports that the problem was fixed.

I guess this means that we either need to wait for a new tag (or whatever)

@MikeMcQuaid
Homebrew member

Where do I put the settings you've referenced? Can you provide us with a step-by-step test case please? Thanks!

@sbentzen

So I install Homebrew, and the install appledoc through homebrew. I then try to generate documentation (and it does) but generates some kind of crash (see the forementioned issue in the appledoc)

However… @timshadel mentioned that he'll fix this when @tomaz tags a new version, so i guess this can either be closed or wait…

@MikeMcQuaid
Homebrew member

I then try to generate documentation

Can you provide me with the commands to try and do this? Are you saying upstream has admitted this is their fault?

Thanks!

@sbentzen

I wouldn't quite call it upstream admitting it fault… i guess that appledoc just broke with 10.8.

To generate the documentation, I did the following (relative to your project)
appledoc --project-name NAME-OF-PROJECT --project-company YOURCOMPANY --company-id com.yourcompany --output /your/output/dir ./(input directory)

@MikeMcQuaid
Homebrew member
mikebook # appledoc --project-name project --project-company company --company-id com.company.project --output output .
appledoc version: 2.0.5 (build 737)

ERROR: AppledocException: No predefined templates path exists and no template path specified from command line!

Any pointers here?

@sbentzen

did you run this?

ln -sf "#{prefix}/Templates" "#{ENV['HOME']}/Library/Application Support/appledoc"

@MikeMcQuaid
Homebrew member

Ah, did now. Yes, I can reproduce this. Can you try and work out which upstream commit fixed it? git bisect may help. I might get round to doing that eventually.

@adamv

They've tagged a new version; it uses clang to build in the Xcode project, and fails to run on Snow Leopard.

@timshadel

I don't know about the Snow Leopard part, but I've updated the recipe to use the compile-time template dir option and remove the caveat, as requested in the comments. #14693

@adamv

Pulled 2.0.6.

@adamv adamv closed this Sep 4, 2012
@xu-cheng xu-cheng locked and limited conversation to collaborators Feb 16, 2016
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.