OSDN Git Service

Publish MinGW installation and maintenance guidelines.
[mingw/website.git] / mailing.html
index df6a8b1..2374960 100644 (file)
@@ -5,7 +5,7 @@
  * $Id$
  *
  * Written by Keith Marshall <keith@users.osdn.me>
- * Copyright (C) 2020, MinGW.org Project
+ * Copyright (C) 2020, 2021, MinGW.OSDN Project
  *
  * Uses a web-search form-field implementation derived from the
  * DuckDuckGo search widget implementation by Juri Wornowitski, as
  *    and the following disclaimer in the documentation and/or other
  *    materials provided with the distribution.
  *
- * THIS DOCUMENTATION IS PROVIDED BY THE MINGW.ORG PROJECT "AS IS" AND
- * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
- * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
- * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE MINGW.ORG PROJECT, OR
+ * THIS DOCUMENTATION IS PROVIDED BY THE MINGW.OSDN PROJECT "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+ * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE MINGW.OSDN PROJECT, OR
  * ITS CONTRIBUTORS, BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  *    &#8221;   right (closing) typographic double quote
  *
 -->
-<dl class="masthead"><!-- hidden for masthead class -->
-<!-- FIXME: is there a better way to do this?  We need to propagate
- content to the "as-page-title" and "as-page-subtitle" place-holders,
- within the "page-content" div of "index.html"; our javascript page
- loader will explicitly look for these hidden elements, and copy
- their content into the corresponding visible place-holders.
--->
- <dt id="page-title">MinGW.org Mailing-Lists</dt>
- <dt id="page-subtitle">Mailing-Lists and Mail Archives Operated by MinGW.org</dt>
-</dl><!-- masthead -->
-<p>MinGW.org&#8217;s preferred method for communication,
+<script class="masthead">
+/* Script fragment, to assign titles specific to this page; this is
+ * encapsulated within the "masthead", where such titles are displayed,
+ * to ensure that whatever page content may follow will be correctly
+ * positioned, relative to the masthead content.
+ */
+ set_page("title", "MinGW.OSDN Mailing-Lists");
+ set_page("subtitle", "Mailing-Lists and Mail Archives Operated by MinGW.OSDN");
+</script><!-- masthead -->
+<p>MinGW.OSDN&#8217;s preferred method for communication,
 between users and the project team, is by way of mailing&#8209;lists.
 Historically, there were several topic&#8209;specific lists, originally
 <a rel="noopener noreferrer" target="_blank"
@@ -72,15 +71,15 @@ today, only two remain operational, and both are
 </p>
 <h3>Operational Mailing&#8209;Lists</h3>
 <p>The currently operational
-MinGW.org mailing&#8209;lists are:&mdash;
+MinGW.OSDN mailing&#8209;lists are:&mdash;
 </p>
-<dl class="no-indent" id="mingw-users">
+<dl class="no-indent overlapped" id="mingw-users">
 <dt><a rel="noopener noreferrer" target="_blank"
  href="https://lists.osdn.me/mailman/listinfo/mingw-users"
 >MinGW&#8209;Users Mailing&#8209;List</a>
 </dt>
 <dd>This is the primary conduit for dialogue between MinGW users
-and the MinGW.org project team;
+and the MinGW.OSDN project team;
 (you are advised to use this mailing&#8209;list
 at any time when you wish to engage in such dialogue).
 It is a public mailing&#8209;list, but to avoid spam,
@@ -121,19 +120,27 @@ keyword searches within the OSDN.net (upper),
 and the SourceForge.net (lower box) archives, respectively.
 (If your question relates to MSYS, you may also wish to refer to the
 <a href="#mingw-msys">historical MinGW&#8209;MSYS archive, below</a>).
+<!-- Search widget using DuckDuckGo, does not work well on OSDN! --><!--
 <form class="search" method="get" action="https://duckduckgo.com/" target="_blank">
   <button class="fa fa-search" type="submit"></button>
   <input type="text" name="q" placeholder="Search MinGW-Users on OSDN.net ..." />
   <input type="hidden" name="sites" value="https://osdn.net/projects/mingw/lists/archive/users" />
   <input type="hidden" name="kn" value="1" />
 </form>
+--><!-- Alternative search widget, using Google, does work -->
+<form class="search" onsubmit="ddg_widget(this).click()">
+  <button class="fa fa-search" type="submit"
+    onclick="return ddg_google_search(this, true, osdn_archive('mingw', 'users'))"
+  ></button>
+  <input type="text" name="q" placeholder="Search MinGW-Users on OSDN.net ..." />
+</form>
 <form class="search" method="get" action="https://sourceforge.net/p/mingw/mailman/search/" target="_blank">
   <button class="fa fa-search" type="submit"></button>
   <input type="text" name="q" placeholder="Search MinGW-Users on SourceForge.net ..." />
   <input type="hidden" name="mailing_list" value="mingw-users" />
 </form>
 </dd>
-</dl><dl class="no-indent" id="mingw-notify">
+</dl><dl class="no-indent overlapped" id="mingw-notify">
 <dt><a rel="noopener noreferrer" target="_blank"
  href="https://lists.osdn.me/mailman/listinfo/mingw-notify"
 >MinGW&#8209;Notify Mailing&#8209;List</a>
@@ -156,12 +163,20 @@ while notifications posted prior to September&nbsp;2017 have been
 >archived, on SourceForge.net</a>.
 Once again, you may use the following pair of search boxes
 to perform keyword searches on these archives, respectively.
+<!-- Search widget using DuckDuckGo, does not work well on OSDN! --><!--
 <form class="search" method="get" action="https://duckduckgo.com/" target="_blank">
   <button class="fa fa-search" type="submit"></button>
   <input type="text" name="q" placeholder="Search MinGW-Notify on OSDN.net ..." />
   <input type="hidden" name="sites" value="https://osdn.net/projects/mingw/lists/archive/notify" />
   <input type="hidden" name="kn" value="1" />
 </form>
+--><!-- Alternative search widget, using Google, does work -->
+<form class="search" onsubmit="ddg_widget(this).click()">
+  <button class="fa fa-search" type="submit"
+    onclick="return ddg_google_search(this, true, osdn_archive('mingw', 'notify'))"
+  ></button>
+  <input type="text" name="q" placeholder="Search MinGW-Notify on OSDN.net ..." />
+</form>
 <form class="search" method="get" action="https://sourceforge.net/p/mingw/mailman/search/" target="_blank">
   <button class="fa fa-search" type="submit"></button>
   <input type="text" name="q" placeholder="Search MinGW-Notify on SourceForge.net ..." />
@@ -186,7 +201,7 @@ However, archives of historical postings remain
 and may be searched using their respective keyword&#8209;search boxes,
 below.
 </p>
-<dl class="no-indent" id="mingw-msys">
+<dl class="no-indent overlapped" id="mingw-msys">
 <dt><a rel="noopener noreferrer" target="_blank"
  href="https://sourceforge.net/p/mingw/mailman/mingw-msys"
 >MinGW&#8209;MSYS Mailing&#8209;List</a>
@@ -210,7 +225,7 @@ on the historical MinGW-MSYS archive.
 >MinGW&#8209;Dvlpr Mailing&#8209;List</a>
 </dt>
 <dd>This was a private, but publicly archived mailing&#8209;list,
-which was used by MinGW.org Project contributors, to discuss various
+which was used by MinGW.OSDN Project contributors, to discuss various
 aspects of project development; this mailing&#8209;list has now been
 superseded by alternative web technologies, for such discussion.
 </dd>
@@ -228,7 +243,7 @@ on the historical MinGW-Dvlpr public archive.
 </dt>
 <dd>This obsolete <em>read&#8209;only</em> mailing&#8209;list was
 formerly used for posting of notifications of updates to the
-MinGW.org CVS, (and more recently <em>git</em>),
+MinGW.OSDN CVS, (and more recently <em>git</em>),
 source code repositories;
 since migration of these repositories to
 <a rel="noopener noreferrer" target="_blank"
@@ -245,7 +260,7 @@ on the historical MinGW-CVS archive.
 </form>
 </dd>
 </dl>
-<div id="list-etiquette">
+<div class="overlapped" id="list-etiquette">
 <h3>Mailing&#8209;List Posting Etiquette</h3>
 <p>MinGW is an open source project.
 As such, it is heavily dependent on people who dedicate
@@ -261,7 +276,7 @@ in your posts being ignored by a number of knowledgeable people,
 and repeated offenses may even lead to your posts being vetted,
 and potentially rejected, by the list moderator.
 </p>
-<ul style="padding-right: 1em">
+<ul>
 <li>The language of the lists is <em><strong>English</strong></em>&hairsp;;
 if you post in any other language, you are unlikely to elicit a response.
 </li>