Skip to content

Latest commit

 

History

History
64 lines (41 loc) · 2.51 KB

README.md

File metadata and controls

64 lines (41 loc) · 2.51 KB
Raw

#LLVM TextMate Bundle

This is a TextMate Bundle for viewing and editing LLVM (Low Level Virtual Machine) assembly files (.ll).

Installation

For background on installing TextMate Bundles read Installing a Bundle.

Install Location

If you plan on making changes to the Bundle that you want me to pickup, you must install in a different location than you would typically install TextMate Bundles. If you use the TextMate Bundle editor to edit a bundle in any location other than ~/Library/Application Support/TextMate/Bundles, it will create delta files which are very difficult to merge.

Normal Install

cd ~/Library/Application\ Support/TextMate/Pristine\ Copy/Bundles
git clone git@github.com:hansstimer/llvm.tmbundle.git 
osascript -e 'tell app "TextMate" to reload bundles'

Development Install

cd ~/Library/Application Support/TextMate/Bundles
git clone git@github.com:hansstimer/llvm.tmbundle.git 
osascript -e 'tell app "TextMate" to reload bundles'

Non TextMate Install

There are other editors that have some level of TextMate Bundle compatibility:

  • Sublime Text 2
  • Vico
  • VIM (with SnipMate plugin)
  • and many more

Please see the documentation for your editor as to where to put the files. Not all Bundle features will work with all editors, however most editors support TextMate snippet files now days.

Use

These are the snippets implemented:

Instruction Short Cut
alloca alloca
branch conditionally br
branch unconditionally bru
call call
def def
getelementptr getelementptr
hello world program hello
icmp icmp
load load
ret ret
store store

The syntax highlighting is basic, but it is enough to help clarify the elements of an LLVM file.

Contributing to LLVM.tmbundle

I'm happy to merge any fixes/additions people might have.

A word of caution on making changes outside the TextMate Bundle editor; you must make sure you create a new UUID for each new file you add to the bundle. TextMate uses the UUID to provide for a kind of inheritance and to support name changes. Most other editors which use the same files don't care about the UUIDs, but non unique UUIDs will break TextMate.

Each file contains a UUID that can not be replicated in any other file in any other Bundle. The TextMate Bundle editor will take care of this for you automatically, but if you use a text editor you will need to generate a new UUID for each new item you add to the bundle i.e. a new snippet. You can create a new UUID with uuidgen.