JSDuck - the tool for documenting your Ext JS apps

[kstudio]

Hi, All

I have installed Xcode 4.5 with command line tool. But no difference.

Unix:WebServer DoYoungMin$ sudo gem install jsduck
Password:
Building native extensions.  This could take a while...
ERROR:  Error installing jsduck:
	ERROR: Failed to build gem native extension.


        /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/bin/ruby extconf.rb
checking for random()... *** extconf.rb failed ***
Could not create Makefile due to some reason, probably lack of
necessary libraries and/or headers.  Check the mkmf.log file for more
details.  You may need configuration options.


Provided configuration options:
	--with-opt-dir
	--without-opt-dir
	--with-opt-include
	--without-opt-include=${opt-dir}/include
	--with-opt-lib
	--without-opt-lib=${opt-dir}/lib
	--with-make-prog
	--without-make-prog
	--srcdir=.
	--curdir
	--ruby=/Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/bin/ruby
	--with-rdiscount-dir
	--without-rdiscount-dir
	--with-rdiscount-include
	--without-rdiscount-include=${rdiscount-dir}/include
	--with-rdiscount-lib
	--without-rdiscount-lib=${rdiscount-dir}/lib
/Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:381:in `try_do': The compiler failed to generate an executable file. (RuntimeError)
You have to install development tools first.
	from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:461:in `try_link0'
	from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:476:in `try_link'
	from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:619:in `try_func'
	from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:894:in `block in have_func'
	from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:790:in `block in checking_for'
	from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:284:in `block (2 levels) in postpone'
	from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:254:in `open'
	from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:284:in `block in postpone'
	from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:254:in `open'
	from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:280:in `postpone'
	from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:789:in `checking_for'
	from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:893:in `have_func'
	from extconf.rb:5:in `<main>'




Gem files will remain installed in /Users/DoYoungMin/.rvm/gems/ruby-1.9.3-p0/gems/rdiscount-1.6.8 for inspection.
Results logged to /Users/DoYoungMin/.rvm/gems/ruby-1.9.3-p0/gems/rdiscount-1.6.8/ext/gem_make.out

Does anyone have any idea?

[shmeltex]

Hi, All

I have installed Xcode 4.5 with command line tool. But no difference.

Does anyone have any idea?

You need to rebuild ruby after installing Xcode, do

rvm reinstall ruby-1.9.3

[kstudio]

Thank you shmeltex, but, no difference. Do you have any idea?

mac:~ DoYoungMin$ sudo gem install jsduckPassword:
Building native extensions.  This could take a while...
ERROR:  Error installing jsduck:
    ERROR: Failed to build gem native extension.


        /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/bin/ruby extconf.rb
checking for random()... *** extconf.rb failed ***
Could not create Makefile due to some reason, probably lack of
necessary libraries and/or headers.  Check the mkmf.log file for more
details.  You may need configuration options.


Provided configuration options:
    --with-opt-dir
    --without-opt-dir
    --with-opt-include
    --without-opt-include=${opt-dir}/include
    --with-opt-lib
    --without-opt-lib=${opt-dir}/lib
    --with-make-prog
    --without-make-prog
    --srcdir=.
    --curdir
    --ruby=/Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/bin/ruby
    --with-rdiscount-dir
    --without-rdiscount-dir
    --with-rdiscount-include
    --without-rdiscount-include=${rdiscount-dir}/include
    --with-rdiscount-lib
    --without-rdiscount-lib=${rdiscount-dir}/lib
/Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:381:in `try_do': The compiler failed to generate an executable file. (RuntimeError)
You have to install development tools first.
    from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:461:in `try_link0'
    from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:476:in `try_link'
    from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:619:in `try_func'
    from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:894:in `block in have_func'
    from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:790:in `block in checking_for'
    from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:284:in `block (2 levels) in postpone'
    from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:254:in `open'
    from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:284:in `block in postpone'
    from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:254:in `open'
    from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:280:in `postpone'
    from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:789:in `checking_for'
    from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:893:in `have_func'
    from extconf.rb:5:in `<main>'




Gem files will remain installed in /Users/DoYoungMin/.rvm/gems/ruby-1.9.3-p0/gems/rdiscount-1.6.8 for inspection.
Results logged to /Users/DoYoungMin/.rvm/gems/ruby-1.9.3-p0/gems/rdiscount-1.6.8/ext/gem_make.out

[renku]

The problem still seems to be simply having the compiler available. Try if you can use the clang command.

Could you post the contents of /Users/DoYoungMin/.rvm/gems/ruby-1.9.3-p0/gems/rdiscount-1.6.8/ext/gem_make.out

[kstudio]

Hi, renku

here is,

Last login: Mon Aug 27 13:39:53 on ttys000mac:~ DoYoungMin$ clang
-bash: clang: command not found
mac:~ DoYoungMin$

and, gem_make.out is,

mac:ext DoYoungMin$ vim gem_make.out


/Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/bin/ruby extconf.rb
checking for random()... *** extconf.rb failed ***
Could not create Makefile due to some reason, probably lack of
necessary libraries and/or headers.  Check the mkmf.log file for more
details.  You may need configuration options.


Provided configuration options:
        --with-opt-dir
        --without-opt-dir
        --with-opt-include
        --without-opt-include=${opt-dir}/include
        --with-opt-lib
        --without-opt-lib=${opt-dir}/lib
        --with-make-prog
        --without-make-prog
        --srcdir=.
        --curdir
        --ruby=/Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/bin/ruby
        --with-rdiscount-dir
        --without-rdiscount-dir
        --with-rdiscount-include
        --without-rdiscount-include=${rdiscount-dir}/include
        --with-rdiscount-lib
        --without-rdiscount-lib=${rdiscount-dir}/lib
/Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:381:in `try_do': The compiler failed to generate an executable file. (RuntimeError)
You have to install development tools first.
        from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:461:in `try_link0'
        from /Users/DoYoungMin/.rvm/rubies/ruby-1.9.3-p0/lib/ruby/1.9.1/mkmf.rb:476:in `try_link'
"gem_make.out" [readonly] 39L, 2160C

[renku]

So it still seems to be the case that you are missing a C compiler. Or at least it's not available from command line. But I'm only barely familiar with Xcode, so I don't really know how to help you out with that.

You might want to try installing the bare GCC instead: https://github.com/kennethreitz/osx-gcc-installer

[shmeltex]

Here are the steps to get things rolling on OSX with the latest Xcode:
* Install Xcode from App Store
* Start Xcode, go to Preferences > Downloads > Components and install Command Line Tools
* Install RVM and Ruby 1.9.3

$ curl -L https://get.rvm.io | bash -s stable --ruby

* Set newly installed Ruby as default

$ rvm use 1.9.3 --default

* Install jsduck

$gem install jsduck

And all should be good to go.

[kstudio]

Thank you all.

Today, I had better read some unix book before proceeding.

[renku]

JSDuck 4.1.1 released

This is mostly a cleanup release with lots of refactoring gone into the internals. Some features have been removed completely: --export=api and --stats are now gone, hopefully nobody will be missing these.

A few features have been added too:

- Guides/videos/examples can now be placed into nested groups (a much requested addition).

- Support for iPad and other mobile devices through a basic mobile UI

- Automatic detection of @chainable tag. (JSDuck now does some code analyzes to see if a function always returns this).

- Parameter types are no more shown in method signatures. This makes the methods list look much less cluttered.

- Return values of constructors no more default to Object - instead they default to the class itself.


See the changelog for details.

[lsdriscoll]

Hi renku,

Had an idea for a feature: How about a @doccontact tag that works like @docauthor but for an email address?

Jsduck could have an additional flag that tells it to email parse errors to the relevant @doccontact after the generator has been run. This could be really useful in larger teams.

Lee