Changeset 146 for trunk/launch/launch/README

Timestamp:

10/23/03 21:06:33 (21 years ago)

Author:

Nicholas Riley

Message:

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.

package-launch.sh: 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:

• trunk/launch/launch/README (modified) (11 diffs)

trunk/launch/launch/README

@@ -1 @@
-launch 1.0b3 [xx April 2003]
-============
+launch 1.0 [23 October 2003]
+==========
 
 A command-line launcher for Mac OS X in the spirit of open(1).
@@ -14 +14 @@
 or by path, launching TextEdit, or opening a number of applications,
 documents, folders, or URLs.  With the exception of special support for
-TextEdit, 'launch' does all this and:
+TextEdit (open -a), 'launch' does all this and:
 
 - opens URLs, directly or in your preferred helper application (-l)
@@ -27 +27 @@
 - launches Carbon applications in Classic
 - displays file information including type, creator, bundle ID,
-  data and resource fork sizes, and dates
+  data and resource fork sizes, dates and version
 - reports errors intelligibly
 - and much more!
@@ -49 +49 @@
 modify the install line as appropriate.
 
-% sudo /usr/bin/install -d /usr/local/bin
+% sudo /usr/bin/install -d /usr/local/bin /usr/local/man/man1
 % sudo /usr/bin/install -c build/launch /usr/local/bin
+% sudo /usr/bin/install -c launch.1 /usr/local/man/man1
 % rehash
 
 Uninstallation:
 
-% sudo rm -f /usr/local/bin/launch
+% sudo rm -f /usr/local/bin/launch /usr/local/man/man1/appswitch.1
 
 COMPILATION
 -----------
 
-A Project Builder project, 'launch.pbproj', is included.  A
+An Xcode/Project Builder project, 'launch.pbproj', is included.  A
 precompiled binary is also provided.  'launch' was developed and
-tested under Mac OS 10.2.3 with the December 2002 Developer Tools,
-and does not require any additional software to build.
+tested under Mac OS 10.3 with the October 2003 Developer Tools, and
+does not require any additional software to build.
 
 USAGE
@@ -82 +83 @@
 
 % launch -i org.mozilla.navigator http://www.apple.com/
-[Chimera Navigator opens Apple's Web site]
+[Camino opens Apple's Web site]
 
 % launch -l launchsw@sabi.net
@@ -91 +92 @@
         type: 'APPL'    creator: 'prvw'
         bundle ID: com.apple.Preview
+        version: 2.1.0
         kind: Application
-        contents: 2 items
+        contents: 1 item
 [...]
+
+A scripting example: a zsh function which provides an OS X wrapper
+around emacsclient and the Carbon build of GNU Emacs, using launch and
+appswitch (another one of my command-line tools).
+
+    e() {
+      ( emacsclient -n $@ >&/dev/null && \
+        appswitch -a Emacs ) || \
+      ( launch -ba Emacs && \
+        until { emacsclient -n $@ >&/dev/null } do sleep 1; done;
+        appswitch -a Emacs )
+      export EDITOR=emacsclient
+    }
 
 FREQUENTLY ASKED QUESTIONS
@@ -108 +123 @@
         type: 'APPL'    creator: 'OWEB'
         bundle ID: com.omnigroup.OmniWeb
+        version: 4.5
         kind: Application
 
@@ -119 +135 @@
 A. Your application does not support stationery.  Applications which
 support stationery respond to it by creating a new untitled document
-with the contents of the stationery.  Most (all?) Cocoa applications,
-such as TextEdit, do not support stationery.  If you're looking for
-a text editor which supports stationery, try BBEdit, Tex-Edit Plus,
-the CodeWarrior IDE, or almost any other Carbon editor.
+with the contents of the stationery.  Most Cocoa applications, such as
+TextEdit, do not support stationery.  (Omni Group applications are a
+notable exception.)  If you're looking for a text editor which
+supports stationery, try BBEdit, Tex-Edit Plus, the CodeWarrior IDE,
+or almost any other Carbon editor.
 
 For the curious: launch processes input by simultaneously reading it
@@ -146 +163 @@
 /Volumes/GrayApps/Utilities/Resorcerer 2.4/Resorcerer: scriptable Mac OS X application [Carbon, prefers native OS X]
         type: 'APPL'    creator: 'Doug'
+        bundle ID: com.mathemaesthetics.resorcerer
+        version: 2.4 [0x2418010 = 37847056]
         kind: Application
+[...]
 
 
@@ -162 +182 @@
 using the creator instead of the bundle ID as a workaround (-c instead
 of -i).
-
-
-Q. Why does launch display '[can't access CFBundle for application]'
-in place of the bundle identifiers of non-packaged applications?
-
-A. This is a CFBundle bug which remains as of Mac OS X 10.2.3.  If
-this matters to you, please ask Apple to fix it, or implement a
-workaround in launch by parsing the 'plst' id 0 resource directly.
 
 
@@ -225 +237 @@
 ---------------
 
-1.0b3 - xx April 2003
+1.0 - 23 October 2003
  - work around CFBundle bug to report bundle identifiers and versions
    from resource forks of unpackaged Carbon applications and Classic
    applications [Lloyd Dupont]
+ - added descriptions for more error codes and clarified error
+   reporting
+ - output all errors to stderr
+ - provide better errors for -X option
+ - restored -m: OS X bug is fixed in Panther
+ - fixed a couple of tiny memory leaks
+ - added man page [Hisashi T Fujinaka]
+ - work around bug in LSOpenFromURLSpec opening multiple items in
+   Mac OS X 10.3
 1.0b2 - 9 March 2003
  - fixed install instructions to create /usr/local/bin if needed