source: trunk/appswitch/appswitch/README @ 352

Last change on this file since 352 was 352, checked in by Nicholas Riley, 12 years ago

svn:ignore: added appswitch, now it builds in the top-level directory.

README: Fixed installation instructions, now appswitch builds in the
top-level directory.

appswitch.xcodeproj: Add Xcode 3 specific stuff; remove detritus from
install build.

package-appswitch.sh: Update based on package-launch.sh from [305] and
[312]: simplifies and moves executable out of build directory;
properly creates man directory and sets permissions on man page;
removes mentions of .dmg packaging; excludes more useless things
instead of ineffectively deleting them.

File size: 3.5 KB
Line 
1appswitch 1.1 [6 November 2007]
2=============
3
4A command-line interface to the Mac OS X process manager.
5
6Written by Nicholas Riley <mailto:appswitch@sabi.net>.
7Obtain updates from <http://web.sabi.net/nriley/software/>.
8
9WHAT IS IT?
10-----------
11
12If you use shell scripts to automate Mac OS X applications, you may
13need to switch between applications.  You could use AppleScript via
14osascript(1), but that can take several seconds for the script to
15compile and execute - or you could use appswitch, which works almost
16instantly.
17
18Say you're launching an X11 application from Terminal but the X server
19isn't in front when you need it.  Use appswitch to fix the problem.
20
21Or, if you'd like a version of the ps(1) utility which understands the
22concept of OS X applications, appswitch can help.
23
24INSTALLATION
25------------
26
27The commands below install the 'appswitch' tool in /usr/local/bin,
28which is in the default path.  You should subsequently be able to use
29'appswitch' by typing its name.  If you wish to install it somewhere
30else, modify the install line as appropriate.
31
32% sudo /usr/bin/install -d /usr/local/bin /usr/local/man/man1
33% sudo /usr/bin/install appswitch /usr/local/bin
34% sudo /usr/bin/install appswitch.1 /usr/local/man/man1
35% rehash                                # if necessary
36
37Uninstallation:
38
39% sudo rm -f /usr/local/bin/appswitch /usr/local/man/man1/appswitch.1
40
41COMPILATION
42-----------
43
44An Xcode project, 'appswitch.xcodeproj', is included.  A precompiled
45Universal binary is also provided.  'appswitch' should build under
46Xcode 2.4 or later.
47
48USAGE
49-----
50
51Just type 'appswitch' by itself to receive usage information.  See the
52manual page (man appswitch) for more information.
53
54If you're curious about the speed difference between appswitch and
55other methods, this should give you some indication.
56
57appswitch -a Emacs          0.01s user 0.01s system 28% cpu 0.069 total
58launch -a Emacs             0.01s user 0.01s system 35% cpu 0.076 total
59open -a Emacs               0.04s user 0.02s system 52% cpu 0.115 total
60osascript -e 'tell application "Emacs" to activate'
61                            0.13s user 0.06s system 59% cpu 0.326 total
62
63The above tests were performed on a Mac mini Core Duo 1.66 GHz; slower
64systems show more dramatic differences.
65
66COMMENTS, SUGGESTIONS, BUG REPORTS, ETC.
67----------------------------------------
68
69Please send to the author, Nicholas Riley, at <appswitch@sabi.net>.
70
71VERSION HISTORY
72---------------
73
741.1   - 6 November 2007
75 - switched to Process Manager instead of CPS where possible - slower
76   but more compatible (r. 4808397, 4808400)
77 - fixed description of -k option: SIGTERM, not SIGINT
78 - added -f option
79 - fixed incorrect output/behavior with Mac OS X 10.5
80 - Universal Binary, compatible with Intel Macs; built for OS X 10.4
81   or later
821.0.1 - 16 May 2004
83 - fixed crash matching applications with no bundle identifier
84 - fixed process listing PSN column width
851.0   - 19 February 2003
86 - added description of -q delay bug (no workaround)
871.0b3 - 13 February 2003
88 - display spaces instead of ? characters when unprintable
89 - properly handle very narrow window width with -l
90 - further revised and clarified man page
91 - added -q, -K, -L options
921.0b2 - 11 February 2003
93 - display ? characters for unprintable creator code characters
94   (e.g. java)
95 - fixed -P/-p error in man page
96 - revised and clarified man page
971.0b1 - 10 February 2003
98 - added -S, -S, -h, -H, -k, -P, -l, -F options
99 - fixed reference to bogus -u option
100 - fixed bug where unknown match type was silently discarded
101 - added man page and this README
1021.0d1 - 4 February 2003
103 - initial release
Note: See TracBrowser for help on using the repository browser.