diff options
| author | rentzsch <jwr.git@redshed.net> | 2012-08-10 20:47:25 +0400 |
|---|---|---|
| committer | rentzsch <jwr.git@redshed.net> | 2012-08-10 20:47:25 +0400 |
| commit | c07a99996d9d7433f3fed816900b339829a88a51 (patch) | |
| tree | 8b456daf1a267ed6657ff80780627b111d1afbc0 | |
| parent | 162f8c703f9ca1aec8cb6dadc253621cb6a1a8c4 (diff) | |
add must be this tall to ride to README
| -rw-r--r-- | README.markdown | 14 |
1 files changed, 10 insertions, 4 deletions
diff --git a/README.markdown b/README.markdown index 7032b95..6b6ac6f 100644 --- a/README.markdown +++ b/README.markdown @@ -2,6 +2,12 @@ mach_override enables you to override ("patch") program- and system-supplied functions at runtime. You can fully replace functions with your implementations, or merely head- or tail-patch the original implementations to add functionality and/or work around bugs. +## Must Be This Tall To Ride + +Dynamic function overriding is tricky business. You should be familiar with assembly and runtime calling conventions (ABIs) before using mach_override. + +mach_override is certainly not bug free and patches are extremely welcome, but the onus is on you when things don't work. Please don't file a bug report stating mach_override is crashing for you when you try to use it -- you have to be hard-core enough to debug the problem yourself. + ## Contributing Please base your work off the unstable branch. After making your changes please re-run `rake` to ensure it compiles cleanly and the tests pass. Then submit your Pull Request. @@ -38,7 +44,7 @@ Obviously ppc can only be tested on ppc Macs or on 10.5 and 10.6 (Rosetta-suppor ## Version History -### mach_override 1.2: Thu Aug 9 2012 +### mach_override 1.2: Aug 9 2012 * [NEW] i386 and x86_64 support. @@ -46,7 +52,7 @@ Obviously ppc can only be tested on ppc Macs or on 10.5 and 10.6 (Rosetta-suppor * [CHANGE] Threw away Xcode projects. Trying to get them to work across new and old system versions and Xcode versions is a fool's game. Now there's a Rakefile. Type `rake`. You've built and tested. Ta-da. -### mach_star 1.1.1: Sun Dec 18 2005 +### mach_star 1.1.1: Dec 18 2005 * General Xcode 2.2 project cleanup. mach_star now includes `.xcodeproj` Xcode 2.2 project files for all of its projects. The old `.xcode` project files have been left in place, but they aren't maintained and may not work. Xcode 2.2 is the recommended mach_star development environment -- Xcode 2.1 had a bug with inter-project dependancies which would cause compilation failure. It works now again in Xcode 2.2. @@ -60,7 +66,7 @@ Obviously ppc can only be tested on ppc Macs or on 10.5 and 10.6 (Rosetta-suppor * Added this document. -### mach_star 1.1: Wed Apr 06 2005 +### mach_star 1.1: Apr 06 2005 * New package added: `mach_inject_bundle`. It has a private subproject: `mach_inject_bundle_stub`. The stub is a generic reusable implementation of the code that gets squirted across the address spaces, which was always tricky to write. `mach_inject_bundle` is an embeddable framework that wraps `mach_inject` and the stub with a simple fire-and-forget API. @@ -72,6 +78,6 @@ Obviously ppc can only be tested on ppc Macs or on 10.5 and 10.6 (Rosetta-suppor * Thanks to Jon Gotow for letting me peek at `SCPatch`, which I used as a guide for `mach_inject_bundle`. It saved me a bunch of time. Also thanks to Bob Ippolito for `CALL_ON_LOAD` assistance. -### mach_star 1.0: Wed Jun 18 2003 +### mach_star 1.0: Jun 18 2003 * Initial release at MacHack 2003.
\ No newline at end of file |