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

Last change on this file since 146 was 146, checked in by Nicholas Riley, 19 years ago

VERSION: Updated for 1.0 (at long last!)

main.c: Dealt with -b/-h issue through documentation in man page,
removed from to do list. Dealt with -X issue through testing and
adding kLSNoClassicEnvironmentErr. Added kLSNoExecutableErr and
kCGErrorApplicationRequiresNewerSystem. Removed
BROKEN_LAUNCHNEWINSTANCE because it's fixed in Panther. Updated for
1.0. Fixed a couple of minor memory leaks. Output errors to stderr
instead of stdout. Work around bug in LSOpenFromURLSpec in Panther
(filed bug already). Don't make '????' look like a trigraph to GCC.

launch.pbproj: Updated for Xcode.

launch.1: Manual page, finally. Documents several known Mac OS X bugs
which interfere with launch's functioning.

README: Updated for 1.0. Added man page installation/removal
instructions, just like appswitch. s/Chimera/Camino/. Added my zsh
e() function as an example. Updated examples to reflect current
software versions and usage. Updated stationery discussion to mention
that Omni apps handle stationery too. Set type/creator of files (not that it matters
since we're not doing a dmg distribution any more). Changes for man
page packaging.

File size: 4.2 KB
1.Dd Wed Oct 22 2003      \" DATE
2.Dt LAUNCH 1 LOCAL       \" Program name and manual section number
3.Os launch 1.0
5.Nm launch
6.Nd find, open, print, or get information about files, folders, disks and URLs
8.Nm launch
9.Op Fl npswbmhCX         \" [-npswbmhCX]
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 -                 \" [-]
17.Op Fl npflswbmhCX
18.Ar item ...
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
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
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.
43The options to
45are divided in three sections according to purpose. You can give
47a reference to an application in many ways, using the matching
48options. Once
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 .
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).
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
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.
103.\" List links in ascending order by section, alphabetically within a section.
104.\" Please do not reference files that do not exist without filing a bug report
105.Xr appswitch 1 ,
106.Xr GetFileInfo 1 ,
107.Xr open 1
108.Sh BUGS              \" Document known, unremedied bugs
109Launching may be very slow on Mac OS X 10.2.8 and earlier; this is an
110acknowledged Mac OS X bug with no known workaround, and may affect
112.Xr open 1
113command as well in certain cases.  It is fixed in Mac OS X 10.3.
116.Fl m
117option may not work well (or at all) before Mac OS X 10.3 because of
118Mac OS X bugs.
121.Fl h
122option requires the
123.Fl b
124option to be used as well, or Cocoa applications will not hide on
125startup.  This is a Mac OS X bug which is still unfixed as of Mac OS X
128.An "Nicholas Riley" Aq
130This page written in part by
131.An "Hisashi T Fujinaka" Aq .
132.\" .Sh HISTORY           \" Document history if command behaves in a unique manner
Note: See TracBrowser for help on using the repository browser.