OSDN Git Service

4676c85a56ba81df8d28b34498f89f03c434587a
[mingw/website.git] / about.html
1 <!DOCTYPE HTML><!--
2  *
3  * about.html
4  *
5  * Default landing page content for the MinGW.org web-site.
6  *
7  *
8  * $Id$
9  *
10  * Written by Keith Marshall <keith@users.osdn.me>
11  * Copyright (C) 2020, MinGW.org Project
12  *
13  *
14  * Redistribution and use in source and 'compiled' forms (SGML, HTML,
15  * PDF, PostScript, RTF, etc) with or without modification, are permitted
16  * provided that the following conditions are met:
17  *
18  * 1. Redistributions of source code must retain the above copyright
19  *    notice, this list of conditions and the following disclaimer as
20  *    the first lines of this file, unmodified.
21  *
22  * 2. Redistributions in compiled form (transformed to other DTDs,
23  *    converted to PDF, PostScript, RTF and other formats) must
24  *    reproduce the above copyright notice, this list of conditions
25  *    and the following disclaimer in the documentation and/or other
26  *    materials provided with the distribution.
27  *
28  * THIS DOCUMENTATION IS PROVIDED BY THE MINGW.ORG PROJECT "AS IS" AND
29  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
30  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
31  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE MINGW.ORG PROJECT, OR
32  * ITS CONTRIBUTORS, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
33  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
34  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
35  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
36  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
37  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
38  * OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
39  * DAMAGE.
40  *
41  *
42  * Note: this page assumes browser support for the following numeric
43  * HTML entity codes:
44  *
45  *    &#8209;   non-breaking hyphen
46  *    &#8217;   typographic apostrophe
47  *    &#8220;   left (opening) typographic double quote
48  *    &#8221;   right (closing) typographic double quote
49  *
50 -->
51 <dl class="masthead"><!-- hidden for masthead class -->
52 <!-- FIXME: is there a better way to do this?  We need to propagate
53  content to the "as-page-title" and "as-page-subtitle" place-holders,
54  within the "page-content" div of "index.html"; our javascript page
55  loader will explicitly look for these hidden elements, and copy
56  their content into the corresponding visible place-holders.
57 -->
58  <dt id="page-title">Welcome to MinGW.org</dt>
59  <dt id="page-subtitle">Home of the MinGW and MSYS Projects</dt>
60 </dl><!-- masthead -->
61 <p><strong>MinGW</strong>,
62 a contraction of &#8220;Minimalist GNU for Windows&#8221;,
63 is a minimalist development environment
64 for native Microsoft Windows applications.
65 </p>
66 <p><strong>MinGW</strong> is a registered trademark of
67 <a href="https://www.spi-inc.org/projects/mingw/"
68 >Software in the Public Interest Inc.</a>,
69 registration
70 <a href="https://tsdr.uspto.gov/#caseNumber=86017856&#038;
71 caseSearchType=US_APPLICATION&#038;caseType=DEFAULT&#038;
72 searchType=statusSearch">number 86017856</a>;
73 it has been registered on behalf of MinGW.org,
74 and its use by any other project is unauthorized.
75 </p>
76 <p><strong>MinGW</strong>
77 provides a complete Open Source programming tool set which is
78 suitable for the development of native MS-Windows applications,
79 and which do not depend on any 3rd&#8209;party C&#8209;Runtime DLLs.
80 (It <strong><em>does</em></strong>
81 depend on a number of DLLs provided by Microsoft
82 themselves, as components of the operating system;
83 most notable among these is MSVCRT.DLL,
84 the Microsoft C runtime library.
85 Additionally, threaded applications <strong><em>must</em></strong>
86 ship with a freely distributable thread support DLL,
87 provided as part of MinGW itself).
88 </p>
89 <p><strong>MinGW</strong>
90 compilers provide access to the functionality of the
91 Microsoft C runtime and some language&#8209;specific runtimes.
92 MinGW, being Minimalist, <strong>does not, and never will, attempt to
93 provide a full POSIX runtime environment for POSIX application deployment
94 on MS&#8209;Windows</strong>.
95 If you want POSIX application deployment on this platform,
96 please consider
97 <a href="http://www.cygwin.com">Cygwin</a> instead.
98 </p>
99 <p>Primarily intended for use by developers working on the native
100 MS&#8209;Windows platform,
101 but also available for cross&#8209;hosted use,
102 (<a href="#cross-compile">see note below</a>),
103 <strong>MinGW</strong> includes:&mdash;
104 </p>
105 <ul>
106 <li><a href="https://osdn.net/projects/mingw/releases/p15691"
107 >A port of the GNU Compiler Collection</a>
108 (GCC), including C, C++, ADA and Fortran compilers;
109 </li>
110 <li><a href="https://osdn.net/projects/mingw/releases/p15608"
111 >GNU Binutils for Windows</a> (assembler, linker, archive manager)
112 </li>
113 <li>A command&#8209;line installer,
114 with optional GUI front&#8209;end,
115 (<a href="https://osdn.net/projects/mingw/releases/p15522"
116 >mingw&#8209;get</a>)
117 for MinGW and MSYS deployment on MS&#8209;Windows</li>
118 <li>A GUI first&#8209;time setup tool
119 (<a href="https://osdn.net/projects/mingw/downloads/68260/mingw-get-setup.exe/"
120 >mingw&#8209;get&#8209;setup</a>),
121 to get you up and running with
122 <a href="https://osdn.net/projects/mingw/releases/p15522"
123 >mingw&#8209;get</a>.
124 </li>
125 </ul>
126 <div><p><strong>MSYS</strong>,
127 a contraction of &#8220;Minimal SYStem&#8221;,
128 is a Bourne Shell command line interpreter system.
129 Offered as an alternative to Microsoft&#8217;s cmd.exe,
130 this provides a general purpose command line environment,
131 which is particularly suited to use with <strong>MinGW</strong>,
132 for porting of many Open Source applications to the
133 MS&#8209;Windows platform;
134 a light&#8209;weight fork of Cygwin&#8209;1.3,
135 it includes a small selection of Unix tools,
136 chosen to facilitate that objective.
137 </p>
138 <hr /></div>
139 <h3>Project Mailing Lists</h3>
140 <p>The MinGW.org Project operates one active discussion
141 <a rel="noopener noreferrer" target="_blank"
142  href="https://lists.osdn.me/mailman/listinfo/mingw-users"
143 >mailing list</a>,
144 to which you are encouraged to subscribe,
145 and to participate in the discussion.
146 Please use this list,
147 if you wish to seek advice on using MinGW;
148 <strong>do not</strong> create wiki pages, or add comments to wiki pages,
149 to ask questions.
150 </p>
151 <p>In addition to the above discussion list, we also operate
152 <a rel="noopener noreferrer" target="_blank"
153  href="https://lists.osdn.me/mailman/listinfo/mingw-notify"
154 >a read&#8209;only mailing list</a>,
155 for posting of notifications about project activity;
156 while this may be of more interest to project contributors,
157 you are also welcome to subscribe to this list,
158 if you would like to receive such notifications.
159 </p>
160 <p>Archives of past postings,
161 to each of these mailing lists, are available
162 <a rel="noopener noreferrer" target="_blank"
163  href="https://osdn.net/projects/mingw/lists/"
164 >on OSDN</a>.
165 There are also historical archives of older
166 &mdash; now defunct &mdash;
167 project mailing lists available
168 <a rel="noopener noreferrer" target="_blank"
169  href="https://sourceforge.net/p/mingw/mailman/"
170 >on SourceForge.net</a>;
171 subscription to these older lists is no longer permitted.
172 </p>
173 <hr />
174 <div class="overlapped" id="cross-compile">
175 <h3>Using MinGW for Cross-Hosted Development</h3>
176 <p>While <strong>MinGW</strong> provides tools
177 primarily intended for use by developers working on the
178 MS&#8209;Windows platform,
179 many developers choose to run cross&#8209;compiler
180 variants of the <strong>MinGW</strong> tools,
181 on platforms such as GNU/Linux,
182 to generate applications for deployment on MS&#8209;Windows.
183 To facilitate this development model,
184 many Linux distributors provide the necessary cross-compiler tools,
185 derived from the <strong>MinGW</strong> tool chains;
186 such cross&#8209;compiler tool chains are
187 <strong><em>not</em></strong> directly supported by MinGW.org,
188 although we may be able to help out with advice related to the specifics
189 of MS&#8209;Windows applications development,
190 common to the use of our own native tool chains
191 and to such cross&#8209;compilers.
192 </p></div><!-- cross-compile -->
193
194 <!-- $RCSfile$: end of file -->