Skip to content


Subversion checkout URL

You can clone with
Download ZIP


Initial install failed - activeSupport documentation - unrecognized option `--encoding` #652

craigwatkinson opened this Issue · 7 comments

7 participants


I have just tried to install cocoaPods for the first time, but it has failed with the error shown below. I updated RubyGems and then attempted to install cocoapods.

I am installing on a MacBook Pro running Mountain Lion 10.8.2. I have Xcode 4.5.2 installed.

Craigs-MacBook-Pro:~ craigwatkinson$ sudo gem update --system
Updating RubyGems
Updating rubygems-update
Successfully installed rubygems-update-1.8.24
Updating RubyGems to 1.8.24
Installing RubyGems 1.8.24
RubyGems 1.8.24 installed

== 1.8.24 / 2012-04-27

  • 1 bug fix:

    • Install the .pem files properly. Fixes #320
    • Remove OpenSSL dependency from the http code path

RubyGems installed the following executables:

Craigs-MacBook-Pro:~ craigwatkinson$ gem -v

Craigs-MacBook-Pro:~ craigwatkinson$ sudo gem install cocoapods
Fetching: i18n-0.6.1.gem (100%)
Fetching: multi_json-1.3.7.gem (100%)
Fetching: activesupport-3.2.9.gem (100%)
Fetching: xcodeproj-0.3.5.gem (100%)
Building native extensions. This could take a while...
Fetching: multipart-post-1.1.5.gem (100%)
Fetching: faraday-0.8.4.gem (100%)
Fetching: addressable-2.3.2.gem (100%)
Fetching: faraday_middleware-0.9.0.gem (100%)
Fetching: hashie-1.2.0.gem (100%)
Fetching: octokit-1.18.0.gem (100%)
Fetching: colored-1.2.gem (100%)
Fetching: escape-0.0.4.gem (100%)
Fetching: json-1.7.5.gem (100%)
Building native extensions. This could take a while...
Fetching: open4-1.3.0.gem (100%)
Fetching: rake-0.9.4.gem (100%)
Fetching: cocoapods-0.15.2.gem (100%)
Successfully installed i18n-0.6.1
Successfully installed multi_json-1.3.7
Successfully installed activesupport-3.2.9
Successfully installed xcodeproj-0.3.5
Successfully installed multipart-post-1.1.5
Successfully installed faraday-0.8.4
Successfully installed addressable-2.3.2
Successfully installed faraday_middleware-0.9.0
Successfully installed hashie-1.2.0
Successfully installed octokit-1.18.0
Successfully installed colored-1.2
Successfully installed escape-0.0.4
Successfully installed json-1.7.5
Successfully installed open4-1.3.0
Successfully installed rake-0.9.4
Successfully installed cocoapods-0.15.2
16 gems installed
Installing ri documentation for i18n-0.6.1...
Installing ri documentation for multi_json-1.3.7...
Installing ri documentation for activesupport-3.2.9...

unrecognized option `--encoding'

For help on options, try 'rdoc --help'

ERROR: While generating documentation for activesupport-3.2.9
... MESSAGE: exit
... RDOC args: --ri --op /Library/Ruby/Gems/1.8/doc/activesupport-3.2.9/ri --encoding UTF-8 lib --title activesupport-3.2.9 Documentation --quiet
Craigs-MacBook-Pro:~ craigwatkinson$


I retried this, and it seemed to complete ok the second time. The only thing I changed was to close Xcode. I don't know if I am missing documentation for a lot of the gems now though.

Craigs-MacBook-Pro:~ craigwatkinson$ sudo gem install cocoapods
Successfully installed cocoapods-0.15.2
1 gem installed
Installing ri documentation for cocoapods-0.15.2...
Installing RDoc documentation for cocoapods-0.15.2...


I’m personally unable to reproduce this. Others do run into it, but I have not found a definitive answer as to why it occurs. Most people seem to just ignore the issue by not generating docs (--no-rdoc --no-ri).

I’m closing this for now, if others run into this please share your experience.

@alloy alloy closed this

I've also encountered this issue, closing Xcode after installing Command Line Tools and running

$ sudo gem install cocoapods

once again, helped in my situation


I had to update the Command Line Tools from within Xcode. After doing so and exiting Xcode, re-running sudo gem install cocoapods worked great.


Quitting Xcode and rerunning the command: sudo gem install cocoapods
worked for me as well.



I ran into the exact same problem using OS X Lion and having installed the Xcode command line tools long ago. I didn't have XCode open when I ran the installer the first time. I simply entered the command again and everything seems to have gone fine the second time around.


I had the same problem when running for the first time, with Xcode opened. Let it opened and executed the very same command again and it worked. Go figure it.... :smiley:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Something went wrong with that request. Please try again.