OSDN Git Service

Add documentation catalogue and FAQ pages.
[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, 2021, MinGW.OSDN 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.OSDN PROJECT "AS IS"
30  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
31  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
32  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE MINGW.OSDN 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 <script class="masthead">
53 /* Script fragment, to assign titles specific to this page; this is
54  * encapsulated within the "masthead", where such titles are displayed,
55  * to ensure that whatever page content may follow will be correctly
56  * positioned, relative to the masthead content.
57  */
58  set_page("title", "MinGW.OSDN Mailing-Lists");
59  set_page("subtitle", "Mailing-Lists and Mail Archives Operated by MinGW.OSDN");
60 </script><!-- masthead -->
61 <p>MinGW.OSDN&#8217;s preferred method for communication,
62 between users and the project team, is by way of mailing&#8209;lists.
63 Historically, there were several topic&#8209;specific lists, originally
64 <a rel="noopener noreferrer" target="_blank"
65  href="https://sourceforge.net/p/mingw/mailman/"
66 >hosted on SourceForge.net</a>;
67 today, only two remain operational, and both are
68 <a rel="noopener noreferrer" target="_blank"
69  href="https://osdn.net/projects/mingw/lists/"
70 >hosted on OSDN.net</a>.
71 </p>
72 <h3>Operational Mailing&#8209;Lists</h3>
73 <p>The currently operational
74 MinGW.OSDN mailing&#8209;lists are:&mdash;
75 </p>
76 <dl class="no-indent overlapped" id="mingw-users">
77 <dt><a rel="noopener noreferrer" target="_blank"
78  href="https://lists.osdn.me/mailman/listinfo/mingw-users"
79 >MinGW&#8209;Users Mailing&#8209;List</a>
80 </dt>
81 <dd>This is the primary conduit for dialogue between MinGW users
82 and the MinGW.OSDN project team;
83 (you are advised to use this mailing&#8209;list
84 at any time when you wish to engage in such dialogue).
85 It is a public mailing&#8209;list, but to avoid spam,
86 <a rel="noopener noreferrer" target="_blank"
87  href="https://lists.osdn.me/mailman/listinfo/mingw-users"
88 >you <em>must</em> subscribe</a>
89 <em>before</em> you will be
90 permitted to post your first message,
91 (and your subscription <em>must</em> remain active,
92 if you wish to post subsequent messages).
93 </dd>
94 <dd>Before
95 posting to this mailing&#8209;list
96 you are advised to acquaint yourself with the
97 <a href="#list-etiquette">posting etiquette</a>;
98 failure to comply with this etiquette may seriously impair
99 your chances of receiving a useful response,
100 and, in cases of flagrant disregard,
101 may even result in your future posts being moderated.
102 </dd>
103 <dd>Previous correspondence,
104 posted to this mailing&#8209;list between February&nbsp;2018
105 and the present day, has been
106 <a rel="noopener noreferrer" target="_blank"
107  href="https://osdn.net/projects/mingw/lists/archive/users"
108 >archived on OSDN.net</a>;
109 (earlier correspondence, prior to February&nbsp;2018, has also been
110 <a rel="noopener noreferrer" target="_blank"
111  href="https://sourceforge.net/p/mingw/mailman/mingw-users"
112 >archived, on SourceForge.net</a>).
113 As noted in the <a href="#list-etiquette">etiquette</a>,
114 before you introduce a new topic on this mailing&#8209;list,
115 you are advised to search these archives,
116 to ensure that you are not asking a question
117 which has already been answered.
118 You may use the following pair of search boxes to perform
119 keyword searches within the OSDN.net (upper),
120 and the SourceForge.net (lower box) archives, respectively.
121 (If your question relates to MSYS, you may also wish to refer to the
122 <a href="#mingw-msys">historical MinGW&#8209;MSYS archive, below</a>).
123 <!-- Search widget using DuckDuckGo, does not work well on OSDN! --><!--
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 --><!-- Alternative search widget, using Google, does work -->
131 <form class="search" onsubmit="ddg_widget(this).click()">
132   <button class="fa fa-search" type="submit"
133     onclick="return ddg_google_search(this, true, osdn_archive('mingw', 'users'))"
134   ></button>
135   <input type="text" name="q" placeholder="Search MinGW-Users on OSDN.net ..." />
136 </form>
137 <form class="search" method="get" action="https://sourceforge.net/p/mingw/mailman/search/" target="_blank">
138   <button class="fa fa-search" type="submit"></button>
139   <input type="text" name="q" placeholder="Search MinGW-Users on SourceForge.net ..." />
140   <input type="hidden" name="mailing_list" value="mingw-users" />
141 </form>
142 </dd>
143 </dl><dl class="no-indent overlapped" id="mingw-notify">
144 <dt><a rel="noopener noreferrer" target="_blank"
145  href="https://lists.osdn.me/mailman/listinfo/mingw-notify"
146 >MinGW&#8209;Notify Mailing&#8209;List</a>
147 </dt>
148 <dd>This is a <em>read&#8209;only</em> mailing&#8209;list,
149 which is used to deliver notifications of source code repository updates,
150 issue tracker submissions, and feature request submissions.
151 If you would like to receive such notifications,
152 you are welcome to subscribe to this mailing&#8209;list,
153 but please <em>do not</em> attempt to post messages to it.
154 </dd>
155 <dd>Notifications posted to this mailing&#8209;list,
156 since November&nbsp;2017, have been
157 <a rel="noopener noreferrer" target="_blank"
158  href="https://osdn.net/projects/mingw/lists/archive/notify"
159 >archived on OSDN.net</a>,
160 while notifications posted prior to September&nbsp;2017 have been
161 <a rel="noopener noreferrer" target="_blank"
162  href="https://sourceforge.net/p/mingw/mailman/mingw-notify"
163 >archived, on SourceForge.net</a>.
164 Once again, you may use the following pair of search boxes
165 to perform keyword searches on these archives, respectively.
166 <!-- Search widget using DuckDuckGo, does not work well on OSDN! --><!--
167 <form class="search" method="get" action="https://duckduckgo.com/" target="_blank">
168   <button class="fa fa-search" type="submit"></button>
169   <input type="text" name="q" placeholder="Search MinGW-Notify on OSDN.net ..." />
170   <input type="hidden" name="sites" value="https://osdn.net/projects/mingw/lists/archive/notify" />
171   <input type="hidden" name="kn" value="1" />
172 </form>
173 --><!-- Alternative search widget, using Google, does work -->
174 <form class="search" onsubmit="ddg_widget(this).click()">
175   <button class="fa fa-search" type="submit"
176     onclick="return ddg_google_search(this, true, osdn_archive('mingw', 'notify'))"
177   ></button>
178   <input type="text" name="q" placeholder="Search MinGW-Notify on OSDN.net ..." />
179 </form>
180 <form class="search" method="get" action="https://sourceforge.net/p/mingw/mailman/search/" target="_blank">
181   <button class="fa fa-search" type="submit"></button>
182   <input type="text" name="q" placeholder="Search MinGW-Notify on SourceForge.net ..." />
183   <input type="hidden" name="mailing_list" value="mingw-notify" />
184 </form>
185 </dd>
186 </dl>
187 <h3>Historical Mailing&#8209;List Archives</h3>
188 <p>In earlier days of the project history,
189 the volume of mailing&#8209;list traffic was significantly greater
190 than it is today.
191 This traffic was distributed over five topic&#8209;specific
192 mailing&#8209;lists, of which only the two identified above
193 remain operational today;
194 the other three historical lists, which are identified below,
195 are now closed, and it is no longer possible to subscribe,
196 or to post messages to them.
197 However, archives of historical postings remain
198 <a rel="noopener noreferrer" target="_blank"
199  href="https://sourceforge.net/p/mingw/mailman/"
200 >available on SourceForge.net</a>,
201 and may be searched using their respective keyword&#8209;search boxes,
202 below.
203 </p>
204 <dl class="no-indent overlapped" id="mingw-msys">
205 <dt><a rel="noopener noreferrer" target="_blank"
206  href="https://sourceforge.net/p/mingw/mailman/mingw-msys"
207 >MinGW&#8209;MSYS Mailing&#8209;List</a>
208 </dt>
209 <dd>This was a public mailing&#8209;list,
210 dedicated to correspondence relating specifically to MSYS,
211 in order to segregate it from more general MinGW&#8209;Users list traffic;
212 today, such correspondence should be directed to
213 <a href="#mingw-users">the MinGW&#8209Users mailing&#8209;list</a>.
214 </dd>
215 <dd>You may use this search box to perform a keyword search
216 on the historical MinGW-MSYS archive.
217 <form class="search" method="get" action="https://sourceforge.net/p/mingw/mailman/search/" target="_blank">
218   <button class="fa fa-search" type="submit"></button>
219   <input type="text" name="q" placeholder="Search MinGW-MSYS on SourceForge.net ..." />
220   <input type="hidden" name="mailing_list" value="mingw-msys" />
221 </form>
222 </dd>
223 <dt><a rel="noopener noreferrer" target="_blank"
224  href="https://sourceforge.net/p/mingw/mailman/mingw-dvlpr"
225 >MinGW&#8209;Dvlpr Mailing&#8209;List</a>
226 </dt>
227 <dd>This was a private, but publicly archived mailing&#8209;list,
228 which was used by MinGW.OSDN Project contributors, to discuss various
229 aspects of project development; this mailing&#8209;list has now been
230 superseded by alternative web technologies, for such discussion.
231 </dd>
232 <dd>You may use this search box to perform a keyword search
233 on the historical MinGW-Dvlpr public archive.
234 <form class="search" method="get" action="https://sourceforge.net/p/mingw/mailman/search/" target="_blank">
235   <button class="fa fa-search" type="submit"></button>
236   <input type="text" name="q" placeholder="Search MinGW-Dvlpr on SourceForge.net ..." />
237   <input type="hidden" name="mailing_list" value="mingw-dvlpr" />
238 </form>
239 </dd>
240 <dt><a rel="noopener noreferrer" target="_blank"
241  href="https://sourceforge.net/p/mingw/mailman/mingw-cvs"
242 >MinGW&#8209;CVS Mailing&#8209;List</a>
243 </dt>
244 <dd>This obsolete <em>read&#8209;only</em> mailing&#8209;list was
245 formerly used for posting of notifications of updates to the
246 MinGW.OSDN CVS, (and more recently <em>git</em>),
247 source code repositories;
248 since migration of these repositories to
249 <a rel="noopener noreferrer" target="_blank"
250  href="https://osdn.net/projects/mingw/scm/"
251 >OSDN.net</a>, such notifications have been directed to
252 <a href="#mingw-notify">the MinGW&#8209;Notify mailing&#8209;list</a>.
253 </dd>
254 <dd>You may use this search box to perform a keyword search
255 on the historical MinGW-CVS archive.
256 <form class="search" method="get" action="https://sourceforge.net/p/mingw/mailman/search/" target="_blank">
257   <button class="fa fa-search" type="submit"></button>
258   <input type="text" name="q" placeholder="Search MinGW-CVS on SourceForge.net ..." />
259   <input type="hidden" name="mailing_list" value="mingw-cvs" />
260 </form>
261 </dd>
262 </dl>
263 <div class="overlapped" id="list-etiquette">
264 <h3>Mailing&#8209;List Posting Etiquette</h3>
265 <p>MinGW is an open source project.
266 As such, it is heavily dependent on people who dedicate
267 their spare time to the goals and continuing development of the project,
268 so please keep this in mind when posting to the mailing&#8209;list.
269 </p>
270 <p>Before you post, you are advised to
271 acquaint yourself with the following commonly accepted guidelines,
272 with which you are strongly encouraged to comply,
273 when composing your posts.
274 Failure to comply with these guidelines may result
275 in your posts being ignored by a number of knowledgeable people,
276 and repeated offenses may even lead to your posts being vetted,
277 and potentially rejected, by the list moderator.
278 </p>
279 <ul>
280 <li>The language of the lists is <em><strong>English</strong></em>&hairsp;;
281 if you post in any other language, you are unlikely to elicit a response.
282 </li>
283 <li><em><strong>Do search</strong></em> the mailing list archives,
284 (both the current archives, and those of the historical topic&#8209;specific
285 lists), before posting, (see the links associated with each of the lists above);
286 many questions have already been asked and answered.
287 </li>
288 <li><em><strong>Do use</strong></em>
289 a <em><strong>meaningful</strong></em> subject line.
290 A subject line should include a pertinent few words summarizing
291 the subject of the email;
292 (when one replies to emails,
293 one should always make certain the subject line of the email is still
294 relevant to the reply).
295 In particular, if you receive list mail in digest format,
296 <em><strong>do always</strong></em>
297 set the subject back to the original text,
298 from the message to which you are replying.
299 <em><strong>Do not</strong></em> reply with a subject of
300 <em>&#8220;Re: MinGW-??? Digest no. ???&#8221;</em>;
301 such replies are prime candidates for deletion, without being read.
302 </li>
303 <li><em><strong>Do post</strong></em> in a MIME format with
304 <em>&#8220;Content-Type: text</em>/<em>plain&#8221;</em>.
305 <em><strong>Do not</strong></em> post as HTML, or in any other MIME format,
306 (and in particular, <em><strong>do not</strong></em> use multi-part MIME,
307 with plain text duplicated as HTML);
308 some list subscribers are unable to, or choose not to read such mail,
309 and will be unable or unwilling to answer you.
310 </li>
311 <li><em><strong>Do not</strong></em>
312 post messages with very long lines of text;
313 except when pasting screenshots, where line wrapping might lead to confusion,
314 ensure that lines of running text are wrapped with hard line breaks,
315 at a length of between 65 and 72 characters.
316 </li>
317 <li><em><strong>Do quote</strong></em> sections of the original text,
318 and <em><strong>interleave</strong></em> your replies to individual points,
319 <em><strong>below</strong></em> the relevant context.
320 <em><strong>Do not</strong></em> 
321 <a rel="noopener noreferrer" target="_blank"
322  href="http://en.wikipedia.org/wiki/Top_post"
323 >top-post</a>;
324 (this 
325 <a rel="noopener noreferrer" target="_blank"
326  href="http://redballoon.net/~snorwood/quote-rant.shtml"
327 >treatise</a>
328 explains why top-posting is considered unacceptable).
329 </li>
330 <li><em><strong>Do trim out</strong></em> sections of the original mail,
331 which are not required to establish the context of your reply.
332 (Once more,
333 this is particularly important when replying to mail received in digest form;
334 <em><strong>do reply</strong></em>
335 to <em><strong>one subject at a time</strong></em>,
336 and <em><strong>do remove</strong></em> all content related to other subjects).
337 <em><strong>Do not</strong></em> persistently recycle irrelevant junk,
338 quoted from earlier messages in the thread.
339 </li>
340 <li><em><strong>Do not</strong></em>
341 include <em>&#8220;legal mumble&#8221;</em> signatures.
342 You are posting to a list that will be read by thousands of users,
343 and anything you say will be archived in the public domain;
344 in this context, such drivel in your signature is neither enforceable,
345 nor meaningful.
346 </li>
347 <li><em><strong>Do not hijack</strong></em> an existing topic thread,
348 when you wish to introduce an unrelated subject;
349 (i.e. <em><strong>do not</strong></em> reply to an existing message,
350 when your reply is unrelated to the original subject).
351 When you want to introduce a new topic, plainly start a new thread,
352 (i.e. a completely new message).
353 Replying in an existing thread confuses mail readers
354 and humans who are trying to participate in the original discussion;
355 it is a sure way to irritate other subscribers,
356 and will likely get you ignored,
357 if not even black-listed.
358 </li>
359 </ul>
360 <p>Historical information on <em>netiquette</em> may be found in 
361 <a rel="noopener noreferrer" target="_blank"
362  href="http://www.faqs.org/rfcs/rfc1855.html"
363 >RFC-1855</a>.
364 </p>
365 <p>This
366 <a rel="noopener noreferrer" target="_blank"
367  href="http://linuxmafia.com/faq/Essays/smart-questions.html"
368 >article</a>,
369 (also available 
370 <a rel="noopener noreferrer" target="_blank"
371  href="http://www.catb.org/~esr/faqs/smart-questions.html"
372 >here</a>),
373 offers valuable advice on how to ask questions,
374 in a manner most likely to elicit useful replies.
375 </p>
376 </div><!-- list-etiquette -->
377
378 <!-- $RCSfile$: end of file -->