Ignore:
Timestamp:
02/13/04 21:01:06 (20 years ago)
Author:
Nicholas Riley
Message:

Integrates SCPatch and mach_inject; unfinished, buggy.

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/Cocoa/F-Script Anywhere/Source/Read Me

    r19 r153  
    1 F-Script Anywhere 1.1.5 [1 October 2002]
    2 =======================
     1F-Script Anywhere 1.2 [5 January 2004]
     2=====================
    33
    44Add a F-Script interpreter to Cocoa applications dynamically.
    … …  
    2424directory, such as /Library/Frameworks or ~/Library/Frameworks.
    2525
    26 F-Script Anywhere 1.1.5 was tested with FScript.framework 1.2.2
    27 (20020604), Mac OS X 10.1.5 (5S66) and 10.2.1 (6D52).  It may or may
    28 not work with earlier or later versions, I don't know.  If you are
    29 using an earlier F-Script version, please upgrade.
     26F-Script Anywhere 1.2 was tested with FScript.framework 1.2.5
     27(20031020) and Mac OS X 10.3.2 (7D24).  If you are using an earlier
     28F-Script version, please upgrade.  F-Script Anywhere 1.2 should also
     29work with Mac OS X 10.2.x, but will not work with Mac OS X 10.1 or
     30earlier: please use F-Script Anywhere 1.1.5 instead.
    3031
    3132
    … …  
    5051explaining the problem.
    5152
    52 When you're finished, quit the application before quitting F-Script
    53 Anywhere, otherwise the application will crash.  This is an inherent
    54 limitation of the Objective-C runtime, and I can't do anything about
    55 it.  F-Script Anywhere will warn you if you try to quit it when it's
    56 still installed in active applications.
     53To remove F-Script Anywhere from an application, quit the application.
     54Because of limitations in Apple's Objective-C runtime, it is
     55impossible to remove F-Script Anywhere while the application is
     56running.
    5757
    5858
    … …  
    65651. Install FScript.framework (see above).
    6666
    67 2. Install libPatch 1.2.1.
    68 
    69    <http://web.sabi.net/nriley/software/libPatch-1.2.1.tgz>
    70 
    71    I'd suggest you do it this way:
    72 
    73    % cd /
    74    % sudo gnutar --preserve-permissions -zxf libPatch-1.2.1.tgz
    75    Password:
    76      (please don't use StuffIt Expander)
    77 
    78    This installs files in /Developer/Examples and
    79    /usr/local/{bin,include,lib}.  If you're paranoid, you may want to
    80    check the contents of the directory before installing.
    81 
    82    Please note that the layout of the libPatch distribution has changed
    83    since libPatch 1.0; the above instructions will not work for 1.0.
    84    
    85    I did not write libPatch, but am distributing it for your convenience
    86    because it may be unavailable from its original source.  libPatch is
    87    unsupported; please do not contact libPatchÕs author for support.
    88 
    89 3. Check out the source of 'otool' from the Darwin CVS repository.
     672. Check out the source of 'otool' from the Darwin CVS repository.
    9068   This is required because there's a bug in the function that returns
    9169   the 'flavo(u)r' of an application: Cocoa, Carbon, Classic, etc.
    … …  
    10482   jam/pbxbuild).  I _think_ this is all you need.
    10583
    106 4. Open 'F-Script Anywhere.pbproj' in Project Builder and build the
    107    Application target.  It depends on the Library target, so you don't
    108    need to build it separately.  You shouldnÕt see any errors or
    109    warnings, and the F-Script Anywhere application (as well as the
    110    library, which you can ignore because it is also copied into the
    111    application bundle) will appear in the build product directory.
     843. Open 'F-Script Anywhere.pbproj' in Xcode and build the Application
     85   target.  This target depends on the Bundle and Bundle Loader
     86   targets, so you don't need to build them separately.  You
     87   shouldnÕt see any errors or warnings, and the F-Script Anywhere
     88   application (as well as two bundles, which you can ignore because
     89   they are copied into the application bundle) will appear in the
     90   build product directory.
    11291
    11392If you have any problems building F-Script Anywhere, please let me
    … …  
    173152   element, view it in an object browser or assign it to a variable.
    174153
    175 
    176 Q. F-Script Anywhere fails miserably on Jaguar.
    177 
    178 A. It shouldnÕt.  Apple re-added support for libPatch to Jaguar late
    179    in the development process, with the result that F-Script Anywhere
    180    works.  libPatch nevertheless needs to be replaced with a more
    181    robust mechanism, and I am currently working on using the Application
    182    Enhancer SDK <http://www.unsanity.com/haxies/ape/sdk/> for a future
    183    version of F-Script Anywhere.
    184 
    185 
    186 Q. F-Script Anywhere fails to recognize Spring as a Cocoa application.
    187 
    188 A. Yes, I'm aware of the irony: I contributed code to Spring.  Spring
    189    uses a unique application launching mechanism which makes it
    190    difficult to determine what type of application it is.  The only
    191    current workaround is to upgrade to Jaguar, where Spring will be
    192    correctly identified.  This problem will be remedied with the move
    193    to Application Enhancer, described above, in a future version of
    194    F-Script Anywhere.
     154   The F-Script object browser now provides a similar feature: click the
     155   "Select view" button.
    195156
    196157
    … …  
    218179---------------
    219180
    220 1.1.6 -                 - better manage window on startup (only display
    221                           when launch complete)
     1811.2   - 5 January 2004  - fixed window behavior on startup, delaying
     182                          display until launch is complete
     183                        - replaced libPatch with mach_inject and
     184                          SCPatch: provides improved compatibility
     185                          with Mac OS X 10.3 (doesn't crash randomly
     186                          any more!)
     187                        - no longer requires F-Script Anywhere
     188                          application to be running while installed
     189                          in applications
     190                        - F-Script Anywhere can now be installed in
     191                          itself
     192                        - check for F-Script version on startup
     193                        - use new, documented F-Script API for
     194                          identifier validation in associate window
     195                        - prepared for localization
     196                        - enable "Install" button when appropriate at
     197                          application startup
     198                        - fixed focus ring "flicker" on Mac OS X 10.3
    2221991.1.5 - 1 October 2002  - better identify Cocoa vs. Carbon applications
    223200                          on Jaguar; added hierarchical window list to
    … …  
    266243
    267244Philippe Mougin, for F-Script
     245Jonathan 'Wolf' Rentsch, for mach_inject
     246Jon Gotow, for SCPatch and lots of advice
    268247Mike Ferris, for TextExtras
    269248Apple, for Darwin
Note: See TracChangeset for help on using the changeset viewer.