Ticket #10555: trac_10555-scripts.patch

File trac_10555-scripts.patch, 2.3 KB (added by iandrus, 8 years ago)

  • sage-README-osx.txt 

    # HG changeset patch
# User Ivan Andrus <darthandrus@gmail.com>
# Date 1302344456 -7200
# Node ID b5e949e463fc77376931605e840d1f5a3f201101
# Parent  34535209d649f6f8c5df07a2512931f9690f6d1d
#10555/scripts: Add documentation about the services

diff --git a/sage-README-osx.txt b/sage-README-osx.txt
    a b  
    8383preferences.  You can also drag a sage folder (SAGE_ROOT) onto
    8484Sage.app to change what sage executable it will use.
    8585
     86--------
     87Services
     88--------
     89
     90Sage.app provides several system services.  On Mac OS 10.6 you will
     91have to enable those you wish to use in System Preferences > Keyboard >
     92Keyboard Shortcuts > Services.  On earlier versions all services are
     93enabled, and you must use a third party application to disable those
     94which are undesired.  Services can be invoked either from a contextual
     95menu, or from the Services submenu of the Application menu (the menu
     96with the name of the application).
     97
     98Those services provided by Sage.app are of two types: those acting on
     99files and those acting on text selection.  Selecting a file of the
     100correct type in the Finder will allow you to invoke the service which
     101act on files.  Selecting text in (almost) any application will allow
     102you to invoke the correct services on that text.  Some textual
     103services require ability to write to the document (e.g. selection on a
     104webpage won't work).  Such services have "(and replace)" in the name.
     105
     106- Act on Files
     107  - Test file with Sage -- run `sage -t` on a file or folder
     108  - Unpack Sage Package -- untar an spkg
     109  - Create Sage Package -- turn a folder into an spkg
     110  - Create Uncompressed Sage Package
     111    - as above, but uncompressed
     112- Act on text selection
     113  - New Sage Worksheet with Selection
     114  - New Sage Terminal Session with Selection
     115  - Preparse Code in Sage (and replace)
     116    - preparse in a temp file which is slightly different than `preparse("...")`
     117  - Evaluate Code in Sage (and replace)
     118    - Uses `sage -c` so it can be slow and you must `print` the answer
     119
     120One potential problem is if you have more than one version of Sage.app
     121installed the system can become confused and use the wrong version to
     122invoke the service.  I'm not aware of a work around other than
     123deleting old versions.
     124
    86125-----------
    87126Preferences
    88127-----------