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 3 of the License, or
182 (at your option) any later version.
184 \fBcygstart\fP is distributed in the hope that it will be useful,
185 but WITHOUT ANY WARRANTY; without even the implied warranty of
186 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
187 GNU General Public License for more details.
189 You should have received a copy of the GNU General Public License
190 along with this program. If not, see
191 .BR <http://www.gnu.org/licenses/>
193 See the COPYING file for full license information.
196 Michael Schaap <cygstart(at)mscha.org>
200 .BR <http://msdn.microsoft.com/en-us/library/bb762153%28VS.85%29.aspx>