Changeset 309 for trunk/launch

Timestamp:

10/30/06 11:06:21 (18 years ago)

Author:

Nicholas Riley

Message:

VERSION: Updated for 1.1.

main.c: Disabled -o since it doesn't work.

launch.1: Updated for 1.1. Added description of -a which had been
missing (oops).

README: Updated for 1.1. Turned out the Resorcerer example is still
fine (though rather out of date contextually, oh well.)

Location:

trunk/launch/launch

Files:

• README (modified) (3 diffs)
• VERSION (modified) (1 diff)
• launch.1 (modified) (7 diffs)
• main.c (modified) (6 diffs)

trunk/launch/launch/README

@@ -1 @@
-launch 1.1d2 [unreleased]
-============
+launch 1.1 [30 October 2006]
+==========
 
 A command-line launcher for Mac OS X in the spirit of open(1).
@@ -105 +105 @@
     e() {
       ( emacsclient -n $@ >&/dev/null && \
-        appswitch -a Emacs ) || \
+        appswitch -a Emacs ) || \
       ( launch -ba Emacs && \
         until { emacsclient -n $@ >&/dev/null } do sleep 1; done;
@@ -223 +223 @@
 ---------------
 
-1.1 - unreleased
+1.1 - 30 October 2006
  - -L: send "launch" (ascr/noop) event to app, bypasses automatic
    opening of untitled document, etc.
- - -o: pass command-line arguments (broken, r. 4474993)
+ - -o: pass command-line arguments (undocumented while still broken,
+   r. 4474993)
  - display content type ID (UTI)    
  - display architecture of Mach-O files

trunk/launch/launch/VERSION

@@ -1 @@
-1.1b1
+1.1

trunk/launch/launch/launch.1

@@ -1 @@
-.Dd Sun Apr 3 2005       \" DATE 
+.Dd Mon Oct 30 2006      \" DATE 
 .Dt LAUNCH 1 LOCAL       \" Program name and manual section number 
-.Os launch 1.0.1
+.Os launch 1.1
 .Sh NAME
 .Nm launch
@@ -7 +7 @@
 .Sh SYNOPSIS
 .Nm launch
-.Op Fl npswbmhCXU        \" [-npswbmhCXU]
-.Op Fl c Ar creator      \" [-c creator]
-.Op Fl i Ar bundleID     \" [-i bundleID]
-.Op Fl u Ar URL          \" [-u URL]
-.Op Fl a Ar name         \" [-a name]
-.Op Ar item ...          \" [item ...]
-.Op Ar -                 \" [-]
+.Op Fl npswbmhCXLU          \" [-npswbmhCXLU]
+.Op Fl c Ar creator         \" [-c creator]
+.Op Fl i Ar bundleID        \" [-i bundleID]
+.Op Fl u Ar URL             \" [-u URL]
+.Op Fl a Ar name | Ar path  \" [-a name|path]
+.Op Ar item ...             \" [item ...]
+.Op Ar -                    \" [-]
 .Nm 
-.Op Fl npflswbmhCXU
+.Op Fl npflswbmhCXLU
 .Ar item ...
 .Sh DESCRIPTION
@@ -24 +24 @@
 command and opens a file (or a folder/directory or URL), as if you had
 double-clicked its icon in the Finder. If no application is specified,
-the default application determined by LaunchServices is used to open
+the default application determined by Launch Services is used to open
 items.
 .Pp
@@ -66 +66 @@
 .Ar URL
 (which must be a file:// URL).
+.It Fl a Ar name | Ar path
+Match application named
+.Ar name
+or at the path
+.Ar path .
 .El
 .Pp
@@ -99 +104 @@
 Don't start the Classic environment for this Classic application if
 Classic isn't running.
+.It Fl L
+Suppress the normal opening behavior of the application; for example,
+opening an untitled document.  (This works by sending a "launch", or
+ascr/noop, Apple event to the application.)
 .It Fl U
 Interpret items as URLs, even if files with the same names as the URLs
@@ -112 +121 @@
 .Xr open 1
 .Sh BUGS              \" Document known, unremedied bugs
-Launching may be very slow on Mac OS X 10.2.8 and earlier; this is an
-acknowledged Mac OS X bug with no known workaround, and may affect
-Apple's
-.Xr open 1
-command as well in certain cases.  It is fixed in Mac OS X 10.3.
-.Pp
-The
-.Fl m
-option may not work well (or at all) before Mac OS X 10.3 because of
-Mac OS X bugs.
-.Pp
 The
 .Fl h
@@ -129 +127 @@
 option to be used as well, or Cocoa applications will not hide on
 startup.  This is a Mac OS X bug which is still unfixed as of Mac OS X
-10.3.
+10.4.8.
 .Sh AUTHOR
 .An "Nicholas Riley" Aq launchsw@sabi.net
 .Pp
-This page written in part by
+Original man page written by
 .An "Hisashi T Fujinaka" Aq htodd@twofifty.com .
 .\" .Sh HISTORY           \" Document history if command behaves in a unique manner 

trunk/launch/launch/main.c

@@ -17 +17 @@
 
 #define BROKEN_AUTHORIZATION 1
+#define BROKEN_ARGUMENTS 1
 #define kComponentSignatureString "launch"
 
@@ -36 +37 @@
 const char *APP_NAME;
 
-#define VERSION "1.1b1"
+#define VERSION "1.1"
 
 #define STRBUF_LEN 1024
@@ -95 +96 @@
 
 void usage() {
-    fprintf(stderr, "usage: %s [-npswbmhCXLU] [-c creator] [-i bundleID] [-u URL] [-a name] [-o argument] [item ...] [-]\n"
-                    "   or: %s [-npflswbmhCXLU] [-o argument] item ...\n", APP_NAME, APP_NAME);
+    fprintf(stderr, "usage: %s [-npswbmhCXLU] [-c creator] [-i bundleID] [-u URL] [-a name|path] [-o argument] [item ...] [-]\n"
+                    "   or: %s [-npflswbmhCXLU] "
+#ifndef BROKEN_ARGUMENTS
+                    "[-o argument] "
+#endif
+                    "item ...\n", APP_NAME, APP_NAME);
     fprintf(stderr,
         "  -n            print matching paths/URLs instead of opening them\n"
@@ -117 +122 @@
         "  -u URL        open application at file:// URL (NOT RECOMMENDED for scripts)\n"
         "  -a name|path  match application by name/path (NOT RECOMMENDED, very fragile)\n"
+#ifndef BROKEN_ARGUMENTS
         "  -o argument   pass argument to application (may be specified more than once)\n"
+#endif
         "'document' may be a file, folder, or disk - whatever the application can open.\n"
         "'item' may be a file, folder, disk, or URL.\n\n");
@@ -416 +423 @@
             appSpecified = true;
             break;
+#ifndef BROKEN_ARGUMENTS
         case 'o':
             if (LPARAMS.argv == NULL)
@@ -422 +430 @@
                                CFStringCreateWithCString(NULL, optarg, kCFStringEncodingUTF8));
             break;
+#endif
         default: usage();
         }