source: trunk/appswitch/appswitch.1 @ 91

Last change on this file since 91 was 91, checked in by Nicholas Riley, 17 years ago

appswitch 1.0b1 code changes

File size: 4.6 KB
Line 
1.Dd Mon Feb 10 2003               \" DATE
2.Dt APPSWITCH 1 LOCAL      \" Program name and manual section number
3.Os appswitch 1.0b1
4.Sh NAME
5.Nm appswitch
6.Nd switch, hide, show, kill or list Mac OS X applications
7.Sh SYNOPSIS
8.Nm appswitch
9.Op Fl sShHkFlP          \" [-sShHkFlP]
10.Op Fl c Ar creator      \" [-c creator]
11.Op Fl i Ar bundleID     \" [-i bundleID]
12.Op Fl a Ar name         \" [-a name]
13.Op Fl p Ar pid          \" [-p pid]
14.Op Ar path              \" [path]
15.Sh DESCRIPTION
16.Nm
17controls the ordering and visibility of Mac OS X application windows.
18.Nm
19can also list or kill running applications.
20.Ss Matching options
21Matching identifies one or more applications to manipulate.
22.Bl -tag -width -indent
23.It Fl c Ar creator
24Match by creator (a four-character code, also known as a signature).
25.It Fl i Ar bundle ID
26Match by bundle identifier, usually consisting of the reversed dot
27(.)-separated components of the application developer's Internet domain
28name, followed by the application name.  For example, the Finder's
29bundle identifier is
30.Ar com.apple.Finder .
31Bundle identifiers are not case-sensitive.
32.It Fl p Ar pid
33Match by process identifier, a positive number.
34.It Ar path
35Match by bundle path.  For packaged applications, this is the package
36directory whose name typically has the .app extension, for example
37.Ar /Applications/TextEdit.app
38for the default installation location of TextEdit.  For non-packaged
39applications, this is the path to the executable itself.
40.El
41.Ss Application actions
42These actions apply to the matched application. If multiple
43applications match the supplied criteria, only the first matching
44application is acted upon.  The list option
45.Fl l
46displays all matching applications.
47.Bl -tag -width -indent
48.It Fl s
49Show the application, making the application's windows frontmost. Do
50not switch to the application.
51.It Fl h
52Hide the application's windows.
53.It Fl k
54Kill (force quit) the application.
55.It Fl l
56List applications in a format similar to that of
57.Xr ps 1 . The columns of the listing are as follows:
58.Bl -tag -width indent
59.It PSN
60The process serial number of the application.  Process serial numbers
61are unique identifiers among both native Mac OS X and Classic
62applications.
63.It PID
64The process identifier, a positive number which uniquely identifies
65native Mac OS X processes, usable with the
66.Fl p
67matching option.  Because all Classic applications run inside
68TruBlueEnvironment, a single Mac OS X process, their process
69identifiers appear as -1.
70.It TYPE
71The four-character code identifying the application's type,
72usually 'APPL' for most applications or 'FNDR' for the Finder.
73Classic applications include additional types such as 'appe'
74and 'APPC' for applications which perform the functions of extensions
75and control panels, respectively.
76.It CREA
77The four-character code identifying the application's creator, usable with the
78.Fl c
79matching option. Some Mac OS X applications have no creator, appearing
80as '????'; for these applications you must use the bundle identifier,
81name or path as match criteria.
82.It NAME
83The user-visible application name, usable with the
84.Fl a
85matching option. This field is truncated to 20 characters; the
86remainder of longer application names is not displayed.
87.It PATH
88The path to the application bundle, usable with the
89.Ar path
90matching option. This field is truncated to the window width, or to 80
91characters if the window width cannot be determined.
92.El
93.It Fl p
94Print the application's process identifier (PID), a positive number
95and unique identifier for all applications except Classic
96applications.
97.El
98.Ss Actions
99These actions affect all applications currently running.
100.Bl -tag -width -indent
101.It Fl S
102Show all applications, layering the windows of initially hidden
103applications on top.
104.It Fl H
105Hide windows of all applications other than the matched application,
106or the frontmost application if no application has been matched.
107.It Fl F
108Order the current application's windows to the front.
109.El
110.Sh SEE ALSO
111.\" List links in ascending order by section, alphabetically within a section.
112.\" Please do not reference files that do not exist without filing a bug report
113.Xr open 1 ,
114.Xr launch 1 ,
115.Xr ps 1 ,
116.Xr kill 1 ,
117.Xr GetFileInfo 1
118.Sh BUGS              \" Document known, unremedied bugs
119The
120.Fl F
121option may be unreliable if issued immediately after another show or
122hide command; try inserting a
123.Xr sleep 1
124command before it.
125.Sh AUTHORS
126.An "Nicholas Riley" Aq appswitch@sabi.net
127.\" .Sh HISTORY           \" Document history if command behaves in a unique manner
128
Note: See TracBrowser for help on using the repository browser.