about.html

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