contact.html

   1 <!DOCTYPE HTML><!--
   2  *
   3  * contact.html
   4  *
   5  * Summary of approved methods for contacting the members of the
   6  * MinGW.OSDN user and developer community.
   7  *
   8  *
   9  * $Id$
  10  *
  11  * Written by Keith Marshall <keith@users.osdn.me>
  12  * Copyright (C) 2020, 2021, MinGW.OSDN Project
  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 code:
  45  *
  46  *    &#8209;   non-breaking hyphen
  47  *    &#8220;   left (opening) typographic double quote
  48  *    &#8221;   right (closing) typographic double quote
  49  *
  50 -->
  51 <script class="masthead"><!-- hidden for masthead class -->
  52 /* Script fragment, to assign titles specific to this page; this is
  53  * encapsulated within the "masthead", where such titles are displayed,
  54  * to ensure that whatever page content may follow will be correctly
  55  * positioned, relative to the masthead content.
  56  */
  57  set_page("title", "Contacting MinGW.OSDN");
  58  set_page("subtitle", "When a Web-Search Fails to Resolve your Issue");
  59 </script><!-- masthead -->
  60 <p>If you have exhausted all of the web&#8209;site resources,
  61 and you have searched all of the
  62 <a href="index.html?page=mailing.html"
  63 >available mailing&#8209;list archives</a>,
  64 and all of the on&#8209;line
  65 <a rel="noopener noreferrer" target="_blank"
  66  href="https://osdn.net/projects/mingw/ticket/"
  67 >bug report and feature request tickets</a>,
  68 then you may wish to contact MinGW.OSDN for assistance.
  69 Please refer to the relevant sections below,
  70 for guidance on <a href="#general-enquiry">making general enquiries</a>,
  71 on <a href="#bug-report">filing bug reports</a>,
  72 or on <a href="#feature-request">requesting new features</a>.
  73 </p>
  74 <p><em>Please note:
  75 the mingw&#8209;w64 and MSYS2 projects are <strong>not</strong>,
  76 in any way, affiliated with MinGW.OSDN;
  77 MinGW.OSDN <strong>does not</strong> support the products
  78 of these projects.</em>
  79 </p>
  80 <div class="overlapped" id="general-enquiry">
  81 <h3>General Enquiries</h3>
  82 <p>If you encounter a problem using MinGW, or MSYS,
  83 and you cannot find a satisfactory answer on our web&#8209;site,
  84 in our
  85 <a href="index.html?page=mailing.html">mailing&#8209;list archives</a>,
  86 or elsewhere on the internet,
  87 or if you simply need some advice relating to MinGW, or MSYS,
  88 then we advise you to
  89 <a rel="noopener noreferrer" target="_blank"
  90  href="https://lists.osdn.me/mailman/listinfo/mingw-users"
  91 >subscribe to the MinGW&#8209;Users mailing&#8209;list</a>,
  92 and ask.
  93 </p>
  94 <p><em>Do please note that, to help avoid spam,
  95 this mailing&#8209;list is open to subscribers only.
  96 Please <strong>do not</strong>
  97 attempt to circumvent the subscription process,
  98 by sending mail to either the mingw-users-owner,
  99 or the mingw-users-admin addresses.
 100 Doing so will be of no benefit to you,
 101 since subscription is free&#8209;of&#8209;charge in any case,
 102 and you will get no reply from the former address,
 103 while the latter is reserved for automated self&#8209;help replies,
 104 in response to specific subject keywords.</em>
 105 </p>
 106 <p>Before posting to this mailing&#8209;list,
 107 we <em>strongly</em> recommend that you acquaint yourself with
 108 <a href="index.html?page=mailing.html#list-etiquette"
 109 >the mailing&#8209;list posting etiquette</a>;
 110 compliance with this may improve your chances of receiving a response,
 111 whereas non&#8209;compliance may result in your post being ignored.
 112 </p></div><!-- general-enquiry -->
 113 <div class="overlapped" id="bug-report">
 114 <h3>Reporting Bugs</h3>
 115 <p>After discussing an issue on the mailing&#8209;list,
 116 as described above, you may be asked to file a formal bug report.
 117 (Alternatively,
 118 if you are certain that you have identified a bug in a MinGW.OSDN product,
 119 you may choose to file such a bug report of your own volition;
 120 however, if you choose this course of action,
 121 please be aware that many bug reports,
 122 which are filed <em>without</em> prior discussion,
 123 are ultimately dismissed as user error).
 124 </p>
 125 <p><em>Before you even consider filing a bug report,
 126 please review
 127 <a rel="noopener noreferrer" target="_blank"
 128  href="https://osdn.net/projects/mingw/ticket/"
 129 >the list of existing tickets</a>,
 130 (<strong>including closed tickets</strong>
 131 &mdash; ensure that the &#8220;Open&#8221; and &#8220;Closed&#8221;
 132 status check&#8209;boxes are <strong>both</strong> selected,
 133 and click the &#8220;Search&#8221; button),
 134 to ensure that the issue has not already been reported</em>.
 135 </p>
 136 <p><em>Please <strong>do not</strong> file a bug report,
 137 if your issue relates to an unimplemented API feature;
 138 it is more appropriate to file
 139 a &#8220;<a href="#feature-request">Feature Request</a>&#8221; instead</em>.
 140 </p>
 141 <p><em>Please do not waste your time, (and ours),
 142 reporting issues with your anti&#8209;virus software;
 143 the heuristic nature of such software, all too frequently,
 144 results in false&#8209;positive reports,
 145 and in the absence of deterministic evidence of infection,
 146 we will take no action in response.</em>
 147 </p>
 148 <p>Regardless of your motivation for filing a bug report,
 149 you <em>must</em>, (unless you already have one),
 150 <em><a rel="noopener noreferrer" target="_blank"
 151  href="https://osdn.net/account/register.php"
 152 >create a personal OSDN.net account</a></em>,
 153 and you should also
 154 <em><a target="_blank" href="index.html?page=buginfo.html"
 155 >acquaint yourself with the bug reporting guidelines</a></em>.
 156 You may then
 157 <em><a rel="noopener noreferrer" target="_blank"
 158  href="https://osdn.net/account/login.php?return_to=/ticket/newticket.php?group_id=3917"
 159 >log in to your OSDN.net account</a></em>,
 160 and proceed to
 161 <em><a rel="noopener noreferrer" target="_blank"
 162  href="https://osdn.net/ticket/newticket.php?group_id=3917"
 163 >the bug report submission form</a></em>.
 164 Please review the submission instructions,
 165 (which appear at the top of the submission form),
 166 then complete the form,
 167 leaving the ticket type set to &#8220;Issue&#8221;.
 168 </p>
 169 <p><em>Please <strong>do not</strong> ignore the submission instructions.
 170 In particular, note that,
 171 unless you are a member of the MinGW.OSDN Project development team,
 172 you are <strong>not</strong> authorized to assign a specific responder
 173 for the ticket; nor are you authorized to assign an elevated priority
 174 or severity attribute for your ticket.
 175 If you exceed your authority,
 176 your ticket <strong>will</strong> be reassigned to <strong>lowest</strong>
 177 priority/severity, and may even be rejected altogether</em>.
 178 </p>
 179 <p>Before you finally submit your report,
 180 please use the &#8220;Preview&#8221; facility to check for,
 181 and correct, any markup errors;
 182 (these are, alas, all too common,
 183 and create a bad impression of the reporter).
 184 Pay particular attention to in&#8209;line program code references,
 185 or program code examples,
 186 (whether in&#8209;line, or multi&#8209;line code blocks);
 187 these <em>must</em>&hairsp; be enclosed in <em>triple&#8209;brace</em>&hairsp;
 188 mark&#8209;up, either as <em>in&#8209;line formatted text</em>,&hairsp;
 189 or as <em>formatted text blocks</em>&hairsp;, as appropriate;
 190 (please see <a rel="noopener noreferrer" target="_blank"
 191  href="https://osdn.net/docs/WikiSyntax"
 192 >the OSDN.net formatting guide</a>,
 193 and be aware that the use of <em>fixed pitch</em>,&hairsp;
 194 as introduced by <em>back&#8209;tick</em>&hairsp; mark&#8209;up,
 195 generally <em>isn&#8217;t</em>&hairsp; a satisfactory alternative).
 196 Finally, when you are satisfied, click the &#8220;Submit&#8221; button
 197 to complete the ticket submission process.
 198 </p></div><!-- bug-report -->
 199 <div class="overlapped" id="feature-request">
 200 <h3>Feature Requests</h3>
 201 <p>When you wish to request the implementation of a new feature,
 202 (e.g.&nbsp;to support a currently unsupported MSVC or POSIX API function),
 203 you should file a feature request ticket.
 204 The procedure is effectively the same as that for
 205 <a href="#bug-report">filing a bug report</a>,
 206 <em>except</em> that you set the ticket type to &#8220;Feature Request&#8221;,
 207 instead of leaving it as &#8220;Issue&#8221;.
 208 </p>
 209 <p><em>Please be aware that feature request submissions are subject
 210 to the same restrictions on your authority,
 211 as are applicable to <a href="#bug-report">bug reporting</a></em>.
 212 </p>
 213 <p>Before you submit a feature request,
 214 it is recommended that you discuss the feasibility of implementing
 215 the proposed feature, as a <a href="#general-enquiry">general enquiry topic</a>,
 216 on the mailing&#8209;list.
 217 Additionally, <em>after</em> you have submitted such a request,
 218 you should use the mailing&#8209;list to bring it to the
 219 attention of the MinGW user community,
 220 and invite them to support your request,
 221 by <em>voting</em> on your ticket;
 222 (please note that MinGW developers will consider votes,
 223 when prioritizing feature requests).
 224 </p></div><!-- feature-request -->