patgdut / xvim

Xcode plugin for Vim keybindings

XVim

XVim is a Vim plugin for Xcode. The plugin intends to offer a compelling Vim experience without the need to give up any Xcode features.

(I'm looking for a job now. See HIREME.md.... Sorry if this is inappropriate to be here)

INSTALL

From Installer Package

Download a daily build from http://programming.jugglershu.net/xvim . Usually the latest one is the best choice for you.

( Sorry, daily build is not working correctly. If you want really updated version see "From Source Code" section)

( For Xcode 4.2 for Snow Leopard you can not use the installer package. See below to install from source code. )

Install it without changing the installation directory and then restart Xcode. That's it!

From Source Code

Download source code and build XVim.xcodeproj. It automatically build and installs the plugin into the correct directory.

If you are building it with Xcode 4.2 for Snow Leopard change the build setting. Open project editing page and set "Mac OS X Deployment Target" to "10.6" and build it.

Then restart Xcode.

Uninstall

Delete the following directory:

$HOME/Library/Application\ Support/Developer/Shared/Xcode/Plug-ins/XVim.xcplugin

Feature list

See separate FeatureList.md

Support Xcode Versions

We are developing XVim with Xcode 4.3 at the moment, So we recommend you use XVim with XCode 4.3. Though, it should work on 4.2 too and we want to support that as much as possible. So if you have any problems with Xcode 4.2 feel free to create a new issue.

Bug reports

Unfortunately XVim sometimes crashes Xcode. We are working on eliminating all the bugs but it's really hard work. Your bug reports with following information is really usuful to fix the problems.

• Crash information ( Xcode shows threads stack trace when crashes. Copy them. )
• The operations you did to cause the crash ( series of key strokes or mouse clicks )
• The text you were manipulating
• Xcode version ( 4.3 or 4.2 ... )
• XVim version ( Version number of the revision you built or the date of the daylybuild package )

There is also a logging feature in XVim. You can turn it on by the command ":set debug". After the command all the key input is logged in "$HOME/.xvimlog". To trun it off execute ":set nodebug". Write "set debug" in .xvimrc to turn it always on. This log file also really helpful to find out the cause of problems.

Contributions

Any suggestions, bug reports or feature requests are welcome. Any pull requests are very much appreciated. If you are interested in contributing I can assign you as a collaborator of this repository.

For Japanese Users/Developsers(日本の開発者のみなさまへ）

このプラグインは世界中で使えるようにと、基本的に英語で開発したり、コミュニケーションを取ったり しています。ただし、それを強制するものではありません。 できるだけ多くの方に使っていただきたい、参加していただきたいのですが、日本のユーザー/開発者の中には英語に 抵抗のある方も少なからずいるのではなかと思っています。 ぜひ日本語でリクエストを出したり、コメントを書いてください。必要な場合はこちらで英訳します。 あと、英語の意味分からないなどある場合も聞いてください。 (What I wrote here is to tell Japanese users/developers NOT TO HESITATE to communicate in Japanese in this project. I'll translate them if needed.)

Donations

If you think the plugin is useful please donate. Since I do not intend make money from this project I decided to donate all donations I recieve to the people who are suffering from the damage of the 2011 Tohoku earthquake and tsunami in Japan.

To reduce the transfer fee please donate directly through Paypal donation site below.

https://www.paypal-donations.com/pp-charity/web.us/campaign.jsp?cid=-12

Since no messages are sent to me(us) when you donate from above it is appreciated to write a message on Message Board. It will really motivate me(us)!

このプロジェクト、プラグインがよいと思われましたら寄付をいただけると非常にうれしいです。 寄付はすべて東日本大震災の復興のためにそのまま寄付をいたします。 手数料などがかかってしまいますので、賛同いただける方は以下から直接寄付いただければと思います。

https://www.paypal-donations.com/pp-charity/web.us/campaign.jsp?cid=-12

この場合、こちらにメッセージなどが来ることはありませんので、 メッセージをMessage Boardにいただけると、開発のモチベーションにつながります。

Contributors

See contributors page in github repository. https://github.com/JugglerShu/XVim/contributors