source: trunk/launch/launch/launch.1 @ 166

Last change on this file since 166 was 166, checked in by Nicholas Riley, 15 years ago

VERSION: Updated for 1.0.1.

main.c: Updated copyright statement. Updated for 1.0.1. Added -U,
triggers OPTS.forceURLs. Added kLSMultipleSessionsNotSupportedErr,
nsvErr. Cleaned up string encoding handling; works much better now.
Split code into stringFromURLIsRemote, utf8StringFromCFStringRef, and
utf8StringFromOSType. Display "contents: zero items" instead of "0
items" in printMoreInfoForURL. Remove extraneous "./" at beginning of
displayed paths. Get versions of non-{applications, packages} and
info from nonbundled apps with CFBundleCopyInfoDictionaryForURL.
Replaced some error codes with numbers so we support building on 10.2
again.

launch.1: Updated for 1.0.1 and -U option.

README: Updated for 1.0.1. Fixed a paste-o in the uninstallation
instructions.

package-launch.sh: Use zsh explicitly. Build as deployment. Fix
permissions. Make tarball contents owned by root/wheel.

File size: 4.3 KB
Line 
1.Dd Sun Apr 3 2005       \" DATE
2.Dt LAUNCH 1 LOCAL       \" Program name and manual section number
3.Os launch 1.0.1
4.Sh NAME
5.Nm launch
6.Nd find, open, print, or get information about files, folders, disks and URLs
7.Sh SYNOPSIS
8.Nm launch
9.Op Fl npswbmhCXU        \" [-npswbmhCXU]
10.Op Fl c Ar creator      \" [-c creator]
11.Op Fl i Ar bundleID     \" [-i bundleID]
12.Op Fl u Ar URL          \" [-u URL]
13.Op Fl a Ar name         \" [-a name]
14.Op Ar item ...          \" [item ...]
15.Op Ar -                 \" [-]
16.Nm
17.Op Fl npflswbmhCXU
18.Ar item ...
19.Sh DESCRIPTION
20The
21.Nm
22command is a replacement for Mac OS X's
23.Xr open 1
24command and opens a file (or a folder/directory or URL), as if you had
25double-clicked its icon in the Finder. If no application is specified,
26the default application determined by LaunchServices is used to open
27items.
28.Pp
29.Nm
30invoked with a file or URL argument will open the URL directly or in
31your preferred helper application. Applications can be specified by
32their four-character creators (e.g. 'ToyS') or Java-style bundle ID
33(e.g. com.apple.scripteditor).
34.Pp
35.Nm
36can ask applications to print documents, a feature the OS X Finder is
37still missing.  It can open applications in the background; can open
38multiple copies of applications; can open Carbon applications in
39Classic, or prevent Classic from starting; and can show information
40about any item on disk, including file type, creator, data and
41resource fork sizes, dates, and bundle ID.
42.Pp
43The options to
44.Nm
45are divided in three sections according to purpose. You can give
46.Nm
47a reference to an application in many ways, using the matching
48options. Once
49.Nm
50has identified one or more items, the action options indicate what to
51do with these items. Finally, if the action involves launching an
52application, the launch options allow further customization.
53.Ss Matching options
54.Bl -tag -width -indent
55.It Fl c Ar creator
56Match by creator (a four-character code, also known as a signature).
57.It Fl i Ar bundleID
58Match by bundle identifier, usually consisting of the reversed dot
59(.)-separated components of the application developer's Internet domain
60name, followed by the application name.  For example, the Finder's
61bundle identifier is
62.Ar com.apple.Finder .
63Bundle identifiers are not case-sensitive.
64.It Fl u Ar URL
65Match application at
66.Ar URL
67(which must be a file:// URL).
68.El
69.Pp
70In addition to the above, you can specify applications, documents,
71folders, disks and URLs as item arguments.
72.Ss Action options
73.Bl -tag -width -indent
74.It Fl n
75Print matching paths/URLs instead of opening them.
76.It Fl p
77Ask application(s) to print document(s).
78.It Fl f
79Display information about item(s).
80.It Fl l
81Launch URLs, treating "http://" URLs as Web sites instead of WebDAV
82resources.
83.El
84.Ss Launch options
85.Bl -tag -width -indent
86.It Fl s
87Launch target(s) as superuser, authenticating if needed.
88.It Fl w
89Wait for application to finish opening before exiting.
90.It Fl b
91Launch application in the background.
92.It Fl m
93Launch application again, even if already running.
94.It Fl h
95Hide application after it finishes opening.
96.It Fl C
97Force CFM/PEF Carbon application to open in Classic.
98.It Fl X
99Don't start the Classic environment for this Classic application if
100Classic isn't running.
101.It Fl U
102Interpret items as URLs, even if files with the same names as the URLs
103exist.  (This was the default behavior in
104.Nm
1051.0.)
106.El
107.Sh SEE ALSO
108.\" List links in ascending order by section, alphabetically within a section.
109.\" Please do not reference files that do not exist without filing a bug report
110.Xr appswitch 1 ,
111.Xr GetFileInfo 1 ,
112.Xr open 1
113.Sh BUGS              \" Document known, unremedied bugs
114Launching may be very slow on Mac OS X 10.2.8 and earlier; this is an
115acknowledged Mac OS X bug with no known workaround, and may affect
116Apple's
117.Xr open 1
118command as well in certain cases.  It is fixed in Mac OS X 10.3.
119.Pp
120The
121.Fl m
122option may not work well (or at all) before Mac OS X 10.3 because of
123Mac OS X bugs.
124.Pp
125The
126.Fl h
127option requires the
128.Fl b
129option to be used as well, or Cocoa applications will not hide on
130startup.  This is a Mac OS X bug which is still unfixed as of Mac OS X
13110.3.
132.Sh AUTHOR
133.An "Nicholas Riley" Aq launchsw@sabi.net
134.Pp
135This page written in part by
136.An "Hisashi T Fujinaka" Aq htodd@twofifty.com .
137.\" .Sh HISTORY           \" Document history if command behaves in a unique manner
Note: See TracBrowser for help on using the repository browser.