3 .TH CYGSTART 1 "14 Mar 2002" "cygstart 1.0 (cygutils)" "Cygutils"
7 cygstart \- start a program or open a file or URL
12 .RB "[\-\fBoxefp?\fP] [\-\fBa\fP \fIaction\fP] [\-\fBd\fP \fIdirectory\fP]"
13 .RB "[\-\-\fBhide\fP] [\-\-\fBmaximize\fP] [\-\-\fBminimize\fP]"
14 .RB "[\-\-\fBrestore\fP] [\-\-\fBshow\fP] [\-\-\fBshowmaximized\fP]"
15 .RB "[\-\-\fBshowminimized\fP] [\-\-\fBshowminnoactive\fP]"
16 .RB "[\-\-\fBshowna\fP] [\-\-\fBshownoactivate\fP]"
17 .RB "[\-\-\fBshownormal\fP] [\-\-\fBusage\fP] [\-\-\fBversion\fP]"
18 .RB "[\-\-\fBlicense\fP] [\-\-\fBreference\fP]"
19 .RB "\fIfile\fP [\fIarguments\fP]"
25 is a command-line tool which allows you to let Windows start a program or open
26 a file or URL in its associated application. It is similar to the Windows
27 command-line \fBstart\fP command.
36 \fB\-a\fP, \fB\-\-action\fP=\fISTRING\fP
37 Use specified action instead of default
40 \fB\-o\fP, \fB\-\-open\fP
41 Short for: \fB\-\-action\fP \fIopen\fP
44 \fB\-x\fP, \fB\-\-explore\fP
45 Short for: \fB\-\-action\fP \fIexplore\fP
48 \fB\-e\fP, \fB\-\-edit\fP
49 Short for: \fB\-\-action\fP \fIedit\fP
52 \fB\-f\fP, \fB\-\-find\fP
53 Short for: \fB\-\-action\fP \fIfind\fP
56 \fB\-p\fP, \fB\-\-print\fP
57 Short for: \fB\-\-action\fP \fIprint\fP
60 \fIDirectory options\fP
63 \fB\-d\fP, \fB\-\-directory\fP=\fISTRING\fP
71 Hides the window and activates another window
75 Maximizes the specified window
79 Minimizes the specified window and activates the
80 next top-level window in the z-order
84 Activates and displays the window. If the window
85 is minimized or maximized, Windows restores it to
86 its original size and position. An application
87 should specify this flag when restoring a
92 Activates the window and displays it in its
93 current size and position
96 \fB\-\-showmaximized\fP
97 Activates the window and displays it as a
101 \fB\-\-showminimized\fP
102 Activates the window and displays it as a
106 \fB\-\-showminnoactive\fP
107 Displays the window as a minimized window. The
108 active window remains active
112 Displays the window in its current state. The
113 active window remains active
116 \fB\-\-shownoactivate\fP
117 Displays a window in its most recent size and
118 position. The active window remains active
122 Activates and displays a window. If the window is
123 minimized or maximized, Windows restores it to
124 its original size and position. An application
125 should specify this flag when displaying the
126 window for the first time
132 \fB\-?\fP, \fB\-\-help\fP
133 Show this help message
137 Display brief usage message
141 Display version information
145 Display licensing information
149 Open MSDN reference for ShellExecute
152 Start Bash in a new window
155 \fB$ cygstart bash\fP
158 Open the Cygwin website in your default browser:
161 \fB$ cygstart http://www.cygwin.com\fP
167 \fB$ cygstart --print README.txt\fP
170 Open a Word document in a maximized window
173 \fB$ cygstart --maximize ~/projects/whatever/design.doc\fP
177 Copyright (C) 2002 Michael Schaap
179 \fBcygstart\fP is free software; you can redistribute it and/or modify
180 it under the terms of the GNU General Public License as published by
181 the Free Software Foundation; either version 2, or (at your option) any
184 \fBcygstart\fP is distributed in the hope that it will be useful, but
185 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
186 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
189 You should have received a copy of the GNU General Public License;
190 see the file COPYING. If not, write to the
191 Free Software Foundation,
193 Suite 330, Boston, MA 02111-1307, USA.
197 Michael Schaap <cygstart(at)mscha.org>
201 .BR <http://msdn.microsoft.com/library/en-us/shellcc/platform/Shell/reference/functions/shellexecute.asp>