OSDN Git Service

df6a8b1fdfef555907c56af0260cf6e7edc3953d
[mingw/website.git] / mailing.html
1 <!DOCTYPE HTML><!--
2  *
3  * mailing.html
4  *
5  * $Id$
6  *
7  * Written by Keith Marshall <keith@users.osdn.me>
8  * Copyright (C) 2020, MinGW.org Project
9  *
10  * Uses a web-search form-field implementation derived from the
11  * DuckDuckGo search widget implementation by Juri Wornowitski, as
12  * described at https://www.plainlight.com/ddg
13  *
14  *
15  * Redistribution and use in source and 'compiled' forms (SGML, HTML,
16  * PDF, PostScript, RTF, etc) with or without modification, are permitted
17  * provided that the following conditions are met:
18  *
19  * 1. Redistributions of source code must retain the above copyright
20  *    notice, this list of conditions and the following disclaimer as
21  *    the first lines of this file, unmodified.
22  *
23  * 2. Redistributions in compiled form (transformed to other DTDs,
24  *    converted to PDF, PostScript, RTF and other formats) must
25  *    reproduce the above copyright notice, this list of conditions
26  *    and the following disclaimer in the documentation and/or other
27  *    materials provided with the distribution.
28  *
29  * THIS DOCUMENTATION IS PROVIDED BY THE MINGW.ORG PROJECT "AS IS" AND
30  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
31  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
32  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE MINGW.ORG PROJECT, OR
33  * ITS CONTRIBUTORS, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
34  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
35  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
36  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
37  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
38  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
39  * OF THIS DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
40  * DAMAGE.
41  *
42  *
43  * Note: this page assumes browser support for the following numeric
44  * HTML entity codes:
45  *
46  *    &#8209;   non-breaking hyphen
47  *    &#8217;   typographic apostrophe
48  *    &#8220;   left (opening) typographic double quote
49  *    &#8221;   right (closing) typographic double quote
50  *
51 -->
52 <dl class="masthead"><!-- hidden for masthead class -->
53 <!-- FIXME: is there a better way to do this?  We need to propagate
54  content to the "as-page-title" and "as-page-subtitle" place-holders,
55  within the "page-content" div of "index.html"; our javascript page
56  loader will explicitly look for these hidden elements, and copy
57  their content into the corresponding visible place-holders.
58 -->
59  <dt id="page-title">MinGW.org Mailing-Lists</dt>
60  <dt id="page-subtitle">Mailing-Lists and Mail Archives Operated by MinGW.org</dt>
61 </dl><!-- masthead -->
62 <p>MinGW.org&#8217;s preferred method for communication,
63 between users and the project team, is by way of mailing&#8209;lists.
64 Historically, there were several topic&#8209;specific lists, originally
65 <a rel="noopener noreferrer" target="_blank"
66  href="https://sourceforge.net/p/mingw/mailman/"
67 >hosted on SourceForge.net</a>;
68 today, only two remain operational, and both are
69 <a rel="noopener noreferrer" target="_blank"
70  href="https://osdn.net/projects/mingw/lists/"
71 >hosted on OSDN.net</a>.
72 </p>
73 <h3>Operational Mailing&#8209;Lists</h3>
74 <p>The currently operational
75 MinGW.org mailing&#8209;lists are:&mdash;
76 </p>
77 <dl class="no-indent" id="mingw-users">
78 <dt><a rel="noopener noreferrer" target="_blank"
79  href="https://lists.osdn.me/mailman/listinfo/mingw-users"
80 >MinGW&#8209;Users Mailing&#8209;List</a>
81 </dt>
82 <dd>This is the primary conduit for dialogue between MinGW users
83 and the MinGW.org project team;
84 (you are advised to use this mailing&#8209;list
85 at any time when you wish to engage in such dialogue).
86 It is a public mailing&#8209;list, but to avoid spam,
87 <a rel="noopener noreferrer" target="_blank"
88  href="https://lists.osdn.me/mailman/listinfo/mingw-users"
89 >you <em>must</em> subscribe</a>
90 <em>before</em> you will be
91 permitted to post your first message,
92 (and your subscription <em>must</em> remain active,
93 if you wish to post subsequent messages).
94 </dd>
95 <dd>Before
96 posting to this mailing&#8209;list
97 you are advised to acquaint yourself with the
98 <a href="#list-etiquette">posting etiquette</a>;
99 failure to comply with this etiquette may seriously impair
100 your chances of receiving a useful response,
101 and, in cases of flagrant disregard,
102 may even result in your future posts being moderated.
103 </dd>
104 <dd>Previous correspondence,
105 posted to this mailing&#8209;list between February&nbsp;2018
106 and the present day, has been
107 <a rel="noopener noreferrer" target="_blank"
108  href="https://osdn.net/projects/mingw/lists/archive/users"
109 >archived on OSDN.net</a>;
110 (earlier correspondence, prior to February&nbsp;2018, has also been
111 <a rel="noopener noreferrer" target="_blank"
112  href="https://sourceforge.net/p/mingw/mailman/mingw-users"
113 >archived, on SourceForge.net</a>).
114 As noted in the <a href="#list-etiquette">etiquette</a>,
115 before you introduce a new topic on this mailing&#8209;list,
116 you are advised to search these archives,
117 to ensure that you are not asking a question
118 which has already been answered.
119 You may use the following pair of search boxes to perform
120 keyword searches within the OSDN.net (upper),
121 and the SourceForge.net (lower box) archives, respectively.
122 (If your question relates to MSYS, you may also wish to refer to the
123 <a href="#mingw-msys">historical MinGW&#8209;MSYS archive, below</a>).
124 <form class="search" method="get" action="https://duckduckgo.com/" target="_blank">
125   <button class="fa fa-search" type="submit"></button>
126   <input type="text" name="q" placeholder="Search MinGW-Users on OSDN.net ..." />
127   <input type="hidden" name="sites" value="https://osdn.net/projects/mingw/lists/archive/users" />
128   <input type="hidden" name="kn" value="1" />
129 </form>
130 <form class="search" method="get" action="https://sourceforge.net/p/mingw/mailman/search/" target="_blank">
131   <button class="fa fa-search" type="submit"></button>
132   <input type="text" name="q" placeholder="Search MinGW-Users on SourceForge.net ..." />
133   <input type="hidden" name="mailing_list" value="mingw-users" />
134 </form>
135 </dd>
136 </dl><dl class="no-indent" id="mingw-notify">
137 <dt><a rel="noopener noreferrer" target="_blank"
138  href="https://lists.osdn.me/mailman/listinfo/mingw-notify"
139 >MinGW&#8209;Notify Mailing&#8209;List</a>
140 </dt>
141 <dd>This is a <em>read&#8209;only</em> mailing&#8209;list,
142 which is used to deliver notifications of source code repository updates,
143 issue tracker submissions, and feature request submissions.
144 If you would like to receive such notifications,
145 you are welcome to subscribe to this mailing&#8209;list,
146 but please <em>do not</em> attempt to post messages to it.
147 </dd>
148 <dd>Notifications posted to this mailing&#8209;list,
149 since November&nbsp;2017, have been
150 <a rel="noopener noreferrer" target="_blank"
151  href="https://osdn.net/projects/mingw/lists/archive/notify"
152 >archived on OSDN.net</a>,
153 while notifications posted prior to September&nbsp;2017 have been
154 <a rel="noopener noreferrer" target="_blank"
155  href="https://sourceforge.net/p/mingw/mailman/mingw-notify"
156 >archived, on SourceForge.net</a>.
157 Once again, you may use the following pair of search boxes
158 to perform keyword searches on these archives, respectively.
159 <form class="search" method="get" action="https://duckduckgo.com/" target="_blank">
160   <button class="fa fa-search" type="submit"></button>
161   <input type="text" name="q" placeholder="Search MinGW-Notify on OSDN.net ..." />
162   <input type="hidden" name="sites" value="https://osdn.net/projects/mingw/lists/archive/notify" />
163   <input type="hidden" name="kn" value="1" />
164 </form>
165 <form class="search" method="get" action="https://sourceforge.net/p/mingw/mailman/search/" target="_blank">
166   <button class="fa fa-search" type="submit"></button>
167   <input type="text" name="q" placeholder="Search MinGW-Notify on SourceForge.net ..." />
168   <input type="hidden" name="mailing_list" value="mingw-notify" />
169 </form>
170 </dd>
171 </dl>
172 <h3>Historical Mailing&#8209;List Archives</h3>
173 <p>In earlier days of the project history,
174 the volume of mailing&#8209;list traffic was significantly greater
175 than it is today.
176 This traffic was distributed over five topic&#8209;specific
177 mailing&#8209;lists, of which only the two identified above
178 remain operational today;
179 the other three historical lists, which are identified below,
180 are now closed, and it is no longer possible to subscribe,
181 or to post messages to them.
182 However, archives of historical postings remain
183 <a rel="noopener noreferrer" target="_blank"
184  href="https://sourceforge.net/p/mingw/mailman/"
185 >available on SourceForge.net</a>,
186 and may be searched using their respective keyword&#8209;search boxes,
187 below.
188 </p>
189 <dl class="no-indent" id="mingw-msys">
190 <dt><a rel="noopener noreferrer" target="_blank"
191  href="https://sourceforge.net/p/mingw/mailman/mingw-msys"
192 >MinGW&#8209;MSYS Mailing&#8209;List</a>
193 </dt>
194 <dd>This was a public mailing&#8209;list,
195 dedicated to correspondence relating specifically to MSYS,
196 in order to segregate it from more general MinGW&#8209;Users list traffic;
197 today, such correspondence should be directed to
198 <a href="#mingw-users">the MinGW&#8209Users mailing&#8209;list</a>.
199 </dd>
200 <dd>You may use this search box to perform a keyword search
201 on the historical MinGW-MSYS archive.
202 <form class="search" method="get" action="https://sourceforge.net/p/mingw/mailman/search/" target="_blank">
203   <button class="fa fa-search" type="submit"></button>
204   <input type="text" name="q" placeholder="Search MinGW-MSYS on SourceForge.net ..." />
205   <input type="hidden" name="mailing_list" value="mingw-msys" />
206 </form>
207 </dd>
208 <dt><a rel="noopener noreferrer" target="_blank"
209  href="https://sourceforge.net/p/mingw/mailman/mingw-dvlpr"
210 >MinGW&#8209;Dvlpr Mailing&#8209;List</a>
211 </dt>
212 <dd>This was a private, but publicly archived mailing&#8209;list,
213 which was used by MinGW.org Project contributors, to discuss various
214 aspects of project development; this mailing&#8209;list has now been
215 superseded by alternative web technologies, for such discussion.
216 </dd>
217 <dd>You may use this search box to perform a keyword search
218 on the historical MinGW-Dvlpr public archive.
219 <form class="search" method="get" action="https://sourceforge.net/p/mingw/mailman/search/" target="_blank">
220   <button class="fa fa-search" type="submit"></button>
221   <input type="text" name="q" placeholder="Search MinGW-Dvlpr on SourceForge.net ..." />
222   <input type="hidden" name="mailing_list" value="mingw-dvlpr" />
223 </form>
224 </dd>
225 <dt><a rel="noopener noreferrer" target="_blank"
226  href="https://sourceforge.net/p/mingw/mailman/mingw-cvs"
227 >MinGW&#8209;CVS Mailing&#8209;List</a>
228 </dt>
229 <dd>This obsolete <em>read&#8209;only</em> mailing&#8209;list was
230 formerly used for posting of notifications of updates to the
231 MinGW.org CVS, (and more recently <em>git</em>),
232 source code repositories;
233 since migration of these repositories to
234 <a rel="noopener noreferrer" target="_blank"
235  href="https://osdn.net/projects/mingw/scm/"
236 >OSDN.net</a>, such notifications have been directed to
237 <a href="#mingw-notify">the MinGW&#8209;Notify mailing&#8209;list</a>.
238 </dd>
239 <dd>You may use this search box to perform a keyword search
240 on the historical MinGW-CVS archive.
241 <form class="search" method="get" action="https://sourceforge.net/p/mingw/mailman/search/" target="_blank">
242   <button class="fa fa-search" type="submit"></button>
243   <input type="text" name="q" placeholder="Search MinGW-CVS on SourceForge.net ..." />
244   <input type="hidden" name="mailing_list" value="mingw-cvs" />
245 </form>
246 </dd>
247 </dl>
248 <div id="list-etiquette">
249 <h3>Mailing&#8209;List Posting Etiquette</h3>
250 <p>MinGW is an open source project.
251 As such, it is heavily dependent on people who dedicate
252 their spare time to the goals and continuing development of the project,
253 so please keep this in mind when posting to the mailing&#8209;list.
254 </p>
255 <p>Before you post, you are advised to
256 acquaint yourself with the following commonly accepted guidelines,
257 with which you are strongly encouraged to comply,
258 when composing your posts.
259 Failure to comply with these guidelines may result
260 in your posts being ignored by a number of knowledgeable people,
261 and repeated offenses may even lead to your posts being vetted,
262 and potentially rejected, by the list moderator.
263 </p>
264 <ul style="padding-right: 1em">
265 <li>The language of the lists is <em><strong>English</strong></em>&hairsp;;
266 if you post in any other language, you are unlikely to elicit a response.
267 </li>
268 <li><em><strong>Do search</strong></em> the mailing list archives,
269 (both the current archives, and those of the historical topic&#8209;specific
270 lists), before posting, (see the links associated with each of the lists above);
271 many questions have already been asked and answered.
272 </li>
273 <li><em><strong>Do use</strong></em>
274 a <em><strong>meaningful</strong></em> subject line.
275 A subject line should include a pertinent few words summarizing
276 the subject of the email;
277 (when one replies to emails,
278 one should always make certain the subject line of the email is still
279 relevant to the reply).
280 In particular, if you receive list mail in digest format,
281 <em><strong>do always</strong></em>
282 set the subject back to the original text,
283 from the message to which you are replying.
284 <em><strong>Do not</strong></em> reply with a subject of
285 <em>&#8220;Re: MinGW-??? Digest no. ???&#8221;</em>;
286 such replies are prime candidates for deletion, without being read.
287 </li>
288 <li><em><strong>Do post</strong></em> in a MIME format with
289 <em>&#8220;Content-Type: text</em>/<em>plain&#8221;</em>.
290 <em><strong>Do not</strong></em> post as HTML, or in any other MIME format,
291 (and in particular, <em><strong>do not</strong></em> use multi-part MIME,
292 with plain text duplicated as HTML);
293 some list subscribers are unable to, or choose not to read such mail,
294 and will be unable or unwilling to answer you.
295 </li>
296 <li><em><strong>Do not</strong></em>
297 post messages with very long lines of text;
298 except when pasting screenshots, where line wrapping might lead to confusion,
299 ensure that lines of running text are wrapped with hard line breaks,
300 at a length of between 65 and 72 characters.
301 </li>
302 <li><em><strong>Do quote</strong></em> sections of the original text,
303 and <em><strong>interleave</strong></em> your replies to individual points,
304 <em><strong>below</strong></em> the relevant context.
305 <em><strong>Do not</strong></em> 
306 <a rel="noopener noreferrer" target="_blank"
307  href="http://en.wikipedia.org/wiki/Top_post"
308 >top-post</a>;
309 (this 
310 <a rel="noopener noreferrer" target="_blank"
311  href="http://redballoon.net/~snorwood/quote-rant.shtml"
312 >treatise</a>
313 explains why top-posting is considered unacceptable).
314 </li>
315 <li><em><strong>Do trim out</strong></em> sections of the original mail,
316 which are not required to establish the context of your reply.
317 (Once more,
318 this is particularly important when replying to mail received in digest form;
319 <em><strong>do reply</strong></em>
320 to <em><strong>one subject at a time</strong></em>,
321 and <em><strong>do remove</strong></em> all content related to other subjects).
322 <em><strong>Do not</strong></em> persistently recycle irrelevant junk,
323 quoted from earlier messages in the thread.
324 </li>
325 <li><em><strong>Do not</strong></em>
326 include <em>&#8220;legal mumble&#8221;</em> signatures.
327 You are posting to a list that will be read by thousands of users,
328 and anything you say will be archived in the public domain;
329 in this context, such drivel in your signature is neither enforceable,
330 nor meaningful.
331 </li>
332 <li><em><strong>Do not hijack</strong></em> an existing topic thread,
333 when you wish to introduce an unrelated subject;
334 (i.e. <em><strong>do not</strong></em> reply to an existing message,
335 when your reply is unrelated to the original subject).
336 When you want to introduce a new topic, plainly start a new thread,
337 (i.e. a completely new message).
338 Replying in an existing thread confuses mail readers
339 and humans who are trying to participate in the original discussion;
340 it is a sure way to irritate other subscribers,
341 and will likely get you ignored,
342 if not even black-listed.
343 </li>
344 </ul>
345 <p>Historical information on <em>netiquette</em> may be found in 
346 <a rel="noopener noreferrer" target="_blank"
347  href="http://www.faqs.org/rfcs/rfc1855.html"
348 >RFC-1855</a>.
349 </p>
350 <p>This
351 <a rel="noopener noreferrer" target="_blank"
352  href="http://linuxmafia.com/faq/Essays/smart-questions.html"
353 >article</a>,
354 (also available 
355 <a rel="noopener noreferrer" target="_blank"
356  href="http://www.catb.org/~esr/faqs/smart-questions.html"
357 >here</a>),
358 offers valuable advice on how to ask questions,
359 in a manner most likely to elicit useful replies.
360 </p>
361 </div><!-- list-etiquette -->
362
363 <!-- $RCSfile$: end of file -->