hc-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ol...@apache.org
Subject svn commit: r1821476 [7/10] - in /httpcomponents/site: ./ css/ httpcomponents-asyncclient-4.0.x/ httpcomponents-asyncclient-4.1.x/ httpcomponents-client-4.3.x/ httpcomponents-client-4.5.x/ httpcomponents-client-5.0.x/ httpcomponents-core-4.4.x/ httpcom...
Date Thu, 18 Jan 2018 10:39:41 GMT
Modified: httpcomponents/site/mail.html
URL: http://svn.apache.org/viewvc/httpcomponents/site/mail.html?rev=1821476&r1=1821475&r2=1821476&view=diff
==============================================================================
--- httpcomponents/site/mail.html (original)
+++ httpcomponents/site/mail.html Thu Jan 18 10:39:41 2018
@@ -1,35 +1,47 @@
-<?xml version="1.0" standalone="yes"?>
-<html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml"><head><meta
http-equiv="Content-Type" content="text/html; charset=UTF-8"></meta><title>Apache
HttpComponents &#8211; HttpComponents Mailing Lists</title><style type="text/css"
media="all">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia at 2018-01-18 ( $Revision$ ) -->
+<!-- $HeadURL: https://svn.apache.org/repos/asf/httpcomponents/maven-skin/trunk/src/main/resources/META-INF/maven/site.vm
$ -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+    <title>Apache HttpComponents &#x2013; HttpComponents Mailing Lists</title>
+    <style type="text/css" media="all">
       @import url("./css/maven-base.css");
       @import url("./css/maven-theme.css");
       @import url("./css/site.css");
-    </style><link rel="stylesheet" href="./css/print.css" type="text/css" media="print"></link><meta
name="Date-Revision-yyyymmdd" content="20171007"></meta><meta http-equiv="Content-Language"
content="en"></meta></head><body class="composite">
+    </style>
+    <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+    <meta name="Date-Revision-yyyymmdd" content="20180118" />
+    <meta http-equiv="Content-Language" content="en" />
+        
+        </head>
+  <body class="composite">
     <div id="banner">
-                        <a shape="rect" id="bannerLeft" href="http://www.apache.org/">
-                                        <img src="http://www.apache.org/images/asf_logo_wide.gif"
alt="Apache"></img>
+                        <a href="http://www.apache.org/" id="bannerLeft">
+                                        <img src="http://www.apache.org/images/asf_logo_wide.gif"
alt="Apache" />
                 </a>
-                                            <a shape="rect" id="bannerRight" href="./">
-                                                <img src="images/logos/httpcomponents.png"
alt="HttpComponents"></img>
+                                            <a href="./" id="bannerRight">
+                                                <img src="images/logos/httpcomponents.png"
alt="HttpComponents" />
                 </a>
             <div class="clear">
-        <hr></hr>
+        <hr/>
       </div>
     </div>
     <div id="breadcrumbs">
             
                 
                 <div class="xleft">
-        <span id="publishDate">Last Published: 2017-10-07</span>
-                  &#160;| <span id="projectVersion">Version: 1-SNAPSHOT</span>
+        <span id="publishDate">Last Published: 2018-01-18</span>
+                  &nbsp;| <span id="projectVersion">Version: 1-SNAPSHOT</span>
                       </div>
-            <div class="xright">                    <a shape="rect" class="externalLink"
href="http://www.apache.org/" title="Apache">Apache</a>
+            <div class="xright">                    <a href="http://www.apache.org/"
class="externalLink" title="Apache">Apache</a>
             |
-                        <a shape="rect" href="index.html" title="HttpComponents">HttpComponents</a>
+                        <a href="index.html" title="HttpComponents">HttpComponents</a>
               
                 
       </div>
       <div class="clear">
-        <hr></hr>
+        <hr/>
       </div>
     </div>
     <div id="leftColumn">
@@ -37,72 +49,103 @@
              
                 
                                 <h5>HttpComponents</h5>
-                  <ul><li class="none">
-                          <a shape="rect" href="index.html" title="Home">Home</a>
-            </li><li class="none">
-                          <a shape="rect" class="externalLink" href="http://www.apache.org/licenses/"
title="License">License</a>
-            </li><li class="none">
-                          <a shape="rect" href="downloads.cgi" title="Download">Download</a>
-            </li><li class="none">
+                  <ul>
+                  <li class="none">
+                          <a href="index.html" title="Home">Home</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/licenses/" class="externalLink"
title="License">License</a>
+            </li>
+                  <li class="none">
+                          <a href="downloads.cgi" title="Download">Download</a>
+            </li>
+                  <li class="none">
             <strong>Mailing Lists</strong>
-          </li><li class="none">
-                          <a shape="rect" href="dev-docs.html" title="Developer documents">Developer
documents</a>
-            </li><li class="none">
-                          <a shape="rect" class="externalLink" href="http://wiki.apache.org/HttpComponents/"
title="Wiki (external)">Wiki (external)</a>
-            </li><li class="none">
-                          <a shape="rect" class="externalLink" href="http://www.apache.org/security/"
title="Security">Security</a>
-            </li></ul>
+          </li>
+                  <li class="none">
+                          <a href="dev-docs.html" title="Developer documents">Developer
documents</a>
+            </li>
+                  <li class="none">
+                          <a href="http://wiki.apache.org/HttpComponents/" class="externalLink"
title="Wiki (external)">Wiki (external)</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/security/" class="externalLink"
title="Security">Security</a>
+            </li>
+          </ul>
                        <h5>Overview</h5>
-                  <ul><li class="none">
-                          <a shape="rect" href="index.html" title="About">About</a>
-            </li><li class="none">
-                          <a shape="rect" href="news.html" title="News">News</a>
-            </li><li class="none">
-                          <a shape="rect" href="poweredby.html" title="Powered by">Powered
by</a>
-            </li><li class="none">
-                          <a shape="rect" href="get-involved.html" title="Get Involved">Get
Involved</a>
-            </li></ul>
+                  <ul>
+                  <li class="none">
+                          <a href="index.html" title="About">About</a>
+            </li>
+                  <li class="none">
+                          <a href="news.html" title="News">News</a>
+            </li>
+                  <li class="none">
+                          <a href="poweredby.html" title="Powered by">Powered by</a>
+            </li>
+                  <li class="none">
+                          <a href="get-involved.html" title="Get Involved">Get Involved</a>
+            </li>
+          </ul>
                        <h5>Components</h5>
-                  <ul><li class="collapsed">
-                          <a shape="rect" href="httpcomponents-client-5.0.x/index.html"
title="HttpClient 5.0 alpha">HttpClient 5.0 alpha</a>
-                  </li><li class="collapsed">
-                          <a shape="rect" href="httpcomponents-client-4.5.x/index.html"
title="HttpClient 4.5">HttpClient 4.5</a>
-                  </li><li class="collapsed">
-                          <a shape="rect" href="httpcomponents-core-5.0.x/index.html"
title="HttpCore 5.0 alpha">HttpCore 5.0 alpha</a>
-                  </li><li class="collapsed">
-                          <a shape="rect" href="httpcomponents-core-4.4.x/index.html"
title="HttpCore 4.4">HttpCore 4.4</a>
-                  </li><li class="collapsed">
-                          <a shape="rect" href="httpcomponents-asyncclient-4.1.x/index.html"
title="HttpAsyncClient 4.1">HttpAsyncClient 4.1</a>
-                  </li></ul>
+                  <ul>
+                                                                                        
                                                                     <li class="collapsed">
+                          <a href="httpcomponents-client-5.0.x/index.html" title="HttpClient
5.0 beta">HttpClient 5.0 beta</a>
+                  </li>
+                                                                                        
                                                                                         
                                 <li class="collapsed">
+                          <a href="httpcomponents-client-4.5.x/index.html" title="HttpClient
4.5">HttpClient 4.5</a>
+                  </li>
+                                                                                        
               <li class="collapsed">
+                          <a href="httpcomponents-core-5.0.x/index.html" title="HttpCore
5.0 beta">HttpCore 5.0 beta</a>
+                  </li>
+                                                                                        
                                 <li class="collapsed">
+                          <a href="httpcomponents-core-4.4.x/index.html" title="HttpCore
4.4">HttpCore 4.4</a>
+                  </li>
+                                                                                        
                                 <li class="collapsed">
+                          <a href="httpcomponents-asyncclient-4.1.x/index.html" title="HttpAsyncClient
4.1">HttpAsyncClient 4.1</a>
+                  </li>
+          </ul>
                        <h5>Legacy</h5>
-                  <ul><li class="none">
-                          <a shape="rect" href="httpclient-legacy/index.html" title="Commons
HttpClient">Commons HttpClient</a>
-            </li></ul>
+                  <ul>
+                  <li class="none">
+                          <a href="httpclient-legacy/index.html" title="Commons HttpClient">Commons
HttpClient</a>
+            </li>
+          </ul>
                        <h5>Project</h5>
-                  <ul><li class="none">
-                          <a shape="rect" href="status.html" title="Status">Status</a>
-            </li><li class="none">
-                          <a shape="rect" href="charter.html" title="Charter">Charter</a>
-            </li></ul>
+                  <ul>
+                  <li class="none">
+                          <a href="status.html" title="Status">Status</a>
+            </li>
+                  <li class="none">
+                          <a href="charter.html" title="Charter">Charter</a>
+            </li>
+          </ul>
                        <h5>Project Documentation</h5>
-                  <ul><li class="collapsed">
-                          <a shape="rect" href="project-info.html" title="Project Information">Project
Information</a>
-                  </li></ul>
+                  <ul>
+                                                                                        
                                 <li class="collapsed">
+                          <a href="project-info.html" title="Project Information">Project
Information</a>
+                  </li>
+          </ul>
                        <h5>ASF</h5>
-                  <ul><li class="none">
-                          <a shape="rect" class="externalLink" href="http://www.apache.org"
title="ASF Home Page">ASF Home Page</a>
-            </li><li class="none">
-                          <a shape="rect" class="externalLink" href="http://www.apache.org/foundation/"
title="Foundation">Foundation</a>
-            </li><li class="none">
-                          <a shape="rect" class="externalLink" href="http://www.apache.org/foundation/sponsorship.html"
title="Sponsor Apache">Sponsor Apache</a>
-            </li><li class="none">
-                          <a shape="rect" class="externalLink" href="http://www.apache.org/foundation/thanks.html"
title="Thanks">Thanks</a>
-            </li></ul>
-                                                                                        
                          <a shape="rect" class="poweredBy" href="http://www.apache.org/events/current-event.html"
title="ApacheCon">
-        <img class="poweredBy" alt="ApacheCon" src="http://www.apache.org/events/current-event-125x125.png"></img>
+                  <ul>
+                  <li class="none">
+                          <a href="http://www.apache.org" class="externalLink" title="ASF
Home Page">ASF Home Page</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/" class="externalLink"
title="Foundation">Foundation</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/sponsorship.html"
class="externalLink" title="Sponsor Apache">Sponsor Apache</a>
+            </li>
+                  <li class="none">
+                          <a href="http://www.apache.org/foundation/thanks.html" class="externalLink"
title="Thanks">Thanks</a>
+            </li>
+          </ul>
+                                                                                        
                          <a href="http://www.apache.org/events/current-event.html" title="ApacheCon"
class="poweredBy">
+        <img class="poweredBy"  alt="ApacheCon" src="http://www.apache.org/events/current-event-125x125.png"
   />
       </a>
-                                                                                        
           <a shape="rect" class="poweredBy" href="http://maven.apache.org/" title="Maven">
-        <img class="poweredBy" alt="Maven" src="http://maven.apache.org/images/logos/maven-feather.png"></img>
+                                                                                        
           <a href="http://maven.apache.org/" title="Maven" class="poweredBy">
+        <img class="poweredBy"  alt="Maven" src="http://maven.apache.org/images/logos/maven-feather.png"
   />
       </a>
                        
                 
@@ -111,64 +154,73 @@
     <div id="bodyColumn">
       <div id="contentBox">
         <div class="section">
-<h2><a shape="rect" name="About_Mailing_Lists">About Mailing Lists</a></h2>
+<h2><a name="About_Mailing_Lists">About Mailing Lists</a></h2>
 <p>A mailing list is an electronic discussion forum that you can subscribe to. Once
you are subscribed, you will receive every email that is sent to the list, and you can send
mails to the list yourself. Every mail you send there will be received by hundreds, maybe
thousands of subscribers. It will also become available in public archives indefinitely.</p>
-<p>Please note that usage of these mailing lists is subject to the <a shape="rect"
class="externalLink" href="http://www.apache.org/foundation/public-archives.html">Public
Forum Archive Policy</a></p>
+<p>Please note that usage of these mailing lists is subject to the <a class="externalLink"
href="http://www.apache.org/foundation/public-archives.html">Public Forum Archive Policy</a></p>
 <p><b>Please</b> take a few minutes to read this page, in order to avoid
annoyance for other subscribers, and embarrassment for yourself. There is a common set of
etiquette guidelines for internet forums, sometimes called <i>netiquette</i>.
You should be aware of these and try to observe them, here as well as in other forums.</p>
-<p>Eric S. Raymond and Rick Moen have written an article called <a shape="rect"
class="externalLink" href="http://www.catb.org/~esr/faqs/smart-questions.html"> "How To
Ask Questions The Smart Way"</a> about mailing list netiquette. It's a long read, but
worth the effort. <br clear="none"></br><b>Note:</b> Please do NOT
send your HttpComponents questions to the two authors. They welcome feedback on the article
itself, but are simply not a help resource for HttpComponents.</p></div>
+<p>Eric S. Raymond and Rick Moen have written an article called <a class="externalLink"
href="http://www.catb.org/~esr/faqs/smart-questions.html"> &quot;How To Ask Questions
The Smart Way&quot;</a> about mailing list netiquette. It's a long read, but worth
the effort. <br /><b>Note:</b> Please do NOT send your HttpComponents questions
to the two authors. They welcome feedback on the article itself, but are simply not a help
resource for HttpComponents.</p></div>
 <div class="section">
-<h2><a shape="rect" name="Research_First">Research First</a></h2>
-<p>Before you post a question to a mailing list, make sure it isn't already answered.
Read the available documentation. Search the web, and in particular the mailing list archives.
Being answered with a link to a mail or FAQ entry that addresses exactly your question is
one of the embarrassments you should avoid. <br clear="none"></br>If you are answered
with a link to a mail, don't take it too hard either. Maybe you didn't know the correct terms
to search for, or the mail was sent on another list. People that follow a mailing list for
a long time are bound to remember some of the old mails, and it may be easier for them to
locate the old mail than to write down the answer again.</p></div>
+<h2><a name="Research_First">Research First</a></h2>
+<p>Before you post a question to a mailing list, make sure it isn't already answered.
Read the available documentation. Search the web, and in particular the mailing list archives.
Being answered with a link to a mail or FAQ entry that addresses exactly your question is
one of the embarrassments you should avoid. <br />If you are answered with a link to
a mail, don't take it too hard either. Maybe you didn't know the correct terms to search for,
or the mail was sent on another list. People that follow a mailing list for a long time are
bound to remember some of the old mails, and it may be easier for them to locate the old mail
than to write down the answer again.</p></div>
 <div class="section">
-<h2><a shape="rect" name="Choose_The_Appropriate_Forum">Choose The Appropriate
Forum</a></h2>
-<p>Different kinds of questions are discussed in different forums. It is important
to choose the right forum for your question. Posting a question to the wrong forum reduces
your chances of getting a useful response. You will reach fewer people that can answer your
question, and those that could will be less inclined to do so. <br clear="none"></br><b>Do
not cross-post.</b> Do not send your question to more than one list. If you are in doubt
where to post your question, it is better to pick the wrong list than to send it to several
lists. Even if you get answers on more than one list, people subscribed to only one list will
not be able to follow the whole discussion. Mailing list archives will also contain only fragments
of the discussion, so that it becomes harder for others with the same question to find the
answer.</p>
-<p>The article mentioned above has a section called <a shape="rect" class="externalLink"
href="http://www.catb.org/~esr/faqs/smart-questions.html#forum"> "Choose your forum carefully"</a>.
It basically tells you the same stuff you'll find below.</p>
+<h2><a name="Choose_The_Appropriate_Forum">Choose The Appropriate Forum</a></h2>
+<p>Different kinds of questions are discussed in different forums. It is important
to choose the right forum for your question. Posting a question to the wrong forum reduces
your chances of getting a useful response. You will reach fewer people that can answer your
question, and those that could will be less inclined to do so. <br /><b>Do not
cross-post.</b> Do not send your question to more than one list. If you are in doubt
where to post your question, it is better to pick the wrong list than to send it to several
lists. Even if you get answers on more than one list, people subscribed to only one list will
not be able to follow the whole discussion. Mailing list archives will also contain only fragments
of the discussion, so that it becomes harder for others with the same question to find the
answer.</p>
+<p>The article mentioned above has a section called <a class="externalLink" href="http://www.catb.org/~esr/faqs/smart-questions.html#forum">
&quot;Choose your forum carefully&quot;</a>. It basically tells you the same
stuff you'll find below.</p>
 <div class="section">
-<h3><a shape="rect" name="User_List">User List</a></h3>
-<p>If you develop an application that <b>uses</b> HttpClient, and you need
advice on how to achieve something with it, post your question to the <b>httpclient-users</b>
list. If you don't know whether HttpClient can do what you want it to do, post your question
to the users list. Even though you are a developer, you are not a developer of the HttpComponents.
So please don't post your question to the developer list. <br clear="none"></br>And
if somebody else asks a question you can answer, please do so!</p></div>
+<h3><a name="User_List">User List</a></h3>
+<p>If you develop an application that <b>uses</b> HttpClient, and you need
advice on how to achieve something with it, post your question to the <b>httpclient-users</b>
list. If you don't know whether HttpClient can do what you want it to do, post your question
to the users list. Even though you are a developer, you are not a developer of the HttpComponents.
So please don't post your question to the developer list. <br />And if somebody else
asks a question you can answer, please do so!</p></div>
 <div class="section">
-<h3><a shape="rect" name="Developer_List">Developer List</a></h3>
-<p>If you want to discuss <b>development of HttpComponents</b>, post your
question or suggestion to the <b>dev</b> list. The developer list is used to discuss
architecture, API design, new features, and bugs. Bug reports and comments filed in <a
shape="rect" href="./issue-tracking.html">JIRA</a> will automatically be sent to
this list, too.</p></div>
+<h3><a name="Developer_List">Developer List</a></h3>
+<p>If you want to discuss <b>development of HttpComponents</b>, post your
question or suggestion to the <b>dev</b> list. The developer list is used to discuss
architecture, API design, new features, and bugs. Bug reports and comments filed in <a
href="./issue-tracking.html">JIRA</a> will automatically be sent to this list, too.</p></div>
 <div class="section">
-<h3><a shape="rect" name="Issue_Tracking">Issue Tracking</a></h3>
-<p>We are using <a shape="rect" href="./issue-tracking.html">JIRA</a> as
our issue tracking system. Although this is not a mailing list, and should not be abused as
a general discussion forum, it is another way to contact the HttpComponent developers. All
issues and comments will be sent to the developer mailing list. <br clear="none"></br>If
you are absolutely sure that you have found a bug, you can open a new issue for it. Choose
"Bug" as the issue type. If you are absolutely sure that our components don't provide a feature
that would be useful for you and others, you can open a new issue for it. Choose "New Feature"
or "Wish" for it. <br clear="none"></br>If you are not absolutely sure, please
ask on the appropriate mailing list first. Most developers are monitoring both lists, and
we will tell you if you should open a new issue.</p></div>
+<h3><a name="Issue_Tracking">Issue Tracking</a></h3>
+<p>We are using <a href="./issue-tracking.html">JIRA</a> as our issue tracking
system. Although this is not a mailing list, and should not be abused as a general discussion
forum, it is another way to contact the HttpComponent developers. All issues and comments
will be sent to the developer mailing list. <br />If you are absolutely sure that you
have found a bug, you can open a new issue for it. Choose &quot;Bug&quot; as the issue
type. If you are absolutely sure that our components don't provide a feature that would be
useful for you and others, you can open a new issue for it. Choose &quot;New Feature&quot;
or &quot;Wish&quot; for it. <br />If you are not absolutely sure, please ask
on the appropriate mailing list first. Most developers are monitoring both lists, and we will
tell you if you should open a new issue.</p></div>
 <div class="section">
-<h3><a shape="rect" name="Personal_Mail">Personal Mail</a></h3>
-<p><b>Never</b> send a question directly to one of the people you have
seen active on the mailing lists, or whose email address you've found in the source code.
You will be scorned and rebuffed, or at best ignored. <br clear="none"></br>HttpComponents,
as any other Apache project, is a <i>community</i>. Questions asked on a mailing
list can be answered by any member of the community who knows the answer and has the time
to write it down. Answers sent to a mailing list are available to everyone, through the public
mailing list archives. This benefits the whole community. <br clear="none"></br>By
sending a question directly to somebody, you are implying that this person alone is responsible
for helping you out, and only you. No, we're not. We participate in a community. Post your
question to the community at large, and chances are that one of the members will answer it.
If that requires information that is of little interest to the community, for example large
log files, you will be <
 i>asked</i> to send such information directly to the person that picked up your
question. <br clear="none"></br>It's OK to send a "Thank You" mail to a person
that helped you. Just make sure that your next question goes to the mailing list again.</p></div></div>
+<h3><a name="Personal_Mail">Personal Mail</a></h3>
+<p><b>Never</b> send a question directly to one of the people you have
seen active on the mailing lists, or whose email address you've found in the source code.
You will be scorned and rebuffed, or at best ignored. <br />HttpComponents, as any other
Apache project, is a <i>community</i>. Questions asked on a mailing list can be
answered by any member of the community who knows the answer and has the time to write it
down. Answers sent to a mailing list are available to everyone, through the public mailing
list archives. This benefits the whole community. <br />By sending a question directly
to somebody, you are implying that this person alone is responsible for helping you out, and
only you. No, we're not. We participate in a community. Post your question to the community
at large, and chances are that one of the members will answer it. If that requires information
that is of little interest to the community, for example large log files, you will be <i>asked</i>
to send such informa
 tion directly to the person that picked up your question. <br />It's OK to send a &quot;Thank
You&quot; mail to a person that helped you. Just make sure that your next question goes
to the mailing list again.</p></div></div>
 <div class="section">
-<h2><a shape="rect" name="Shape_Your_Mail">Shape Your Mail</a></h2>
-<p>Some of the people reading your mail will be processing dozens or hundreds of mails
daily. To get their attention and a quick reply, it is important that you make your mail easy
to read and that you provide the background information that is needed to answer your question.
The biggest part of the article on <a shape="rect" class="externalLink" href="http://www.catb.org/~esr/faqs/smart-questions.html">
asking smart questions</a> mentioned above addresses this problem, so we'll only give
you the highlights here.</p>
-<ul><li><b>Choose a descriptive Subject</b> for your mail. Not: <br
clear="none"></br>"Help! URGENT: Problem with HttpClient!!!" <br clear="none"></br>This
subject does not give the least indication of what your mail is about. So you have a problem
with HttpClient? And you need help? Duh, why else would you post to the mailing list. And
it's urgent? For you maybe, but not for anyone else here.</li><li><b>Don't
send HTML mail</b>, or other stylized mails. Use plain text. Either format it with about
72 characters per line, or just type without linebreaks so automatic formatters can take care
of it. Don't format your mails with 90 characters per line. Automatic formatters will split
each line, making the result very hard to read.</li><li><b>Get to the point.</b>
Ideally, keep your mail short. Just describe the problem and give the necessary background
information. If it's read in less than a minute, many people will read it and the answer can
probably be given quickly as well. If it ta
 kes several minutes to read your mail, people will take care of other mails first, and may
never bother to read yours. If you have to provide extensive background information, make
sure to get to the point in the first paragraph. The one that can be read in less than a minute.
Describe your problem there, so people can decide quickly whether it makes sense for them
to read the rest.</li><li><b>Don't Reply to send a new question.</b>
If you have an answer or otherwise want to join an ongoing discussion, then use Reply-To on
another mail. If you have a new question or want to start a new discussion, do not reply to
a mail you've received from the list. Even if you change the subject, your mail client would
still flag it as belonging to the existing thread. Many archives and email clients provide
a threaded view, where only the initial mail of a thread is shown by default. Your mail will
just get ignored by the people not interested in the original thread, even though they might
be abl
 e to help you.</li></ul></div>
+<h2><a name="Shape_Your_Mail">Shape Your Mail</a></h2>
+<p>Some of the people reading your mail will be processing dozens or hundreds of mails
daily. To get their attention and a quick reply, it is important that you make your mail easy
to read and that you provide the background information that is needed to answer your question.
The biggest part of the article on <a class="externalLink" href="http://www.catb.org/~esr/faqs/smart-questions.html">
asking smart questions</a> mentioned above addresses this problem, so we'll only give
you the highlights here.</p>
+<ul>
+<li><b>Choose a descriptive Subject</b> for your mail. Not: <br />&quot;Help!
URGENT: Problem with HttpClient!!!&quot; <br />This subject does not give the least
indication of what your mail is about. So you have a problem with HttpClient? And you need
help? Duh, why else would you post to the mailing list. And it's urgent? For you maybe, but
not for anyone else here.</li>
+<li><b>Don't send HTML mail</b>, or other stylized mails. Use plain text.
Either format it with about 72 characters per line, or just type without linebreaks so automatic
formatters can take care of it. Don't format your mails with 90 characters per line. Automatic
formatters will split each line, making the result very hard to read.</li>
+<li><b>Get to the point.</b> Ideally, keep your mail short. Just describe
the problem and give the necessary background information. If it's read in less than a minute,
many people will read it and the answer can probably be given quickly as well. If it takes
several minutes to read your mail, people will take care of other mails first, and may never
bother to read yours. If you have to provide extensive background information, make sure to
get to the point in the first paragraph. The one that can be read in less than a minute. Describe
your problem there, so people can decide quickly whether it makes sense for them to read the
rest.</li>
+<li><b>Don't Reply to send a new question.</b> If you have an answer or
otherwise want to join an ongoing discussion, then use Reply-To on another mail. If you have
a new question or want to start a new discussion, do not reply to a mail you've received from
the list. Even if you change the subject, your mail client would still flag it as belonging
to the existing thread. Many archives and email clients provide a threaded view, where only
the initial mail of a thread is shown by default. Your mail will just get ignored by the people
not interested in the original thread, even though they might be able to help you.</li></ul></div>
 <div class="section">
-<h2><a shape="rect" name="The_Lists">The Lists</a></h2>
+<h2><a name="The_Lists">The Lists</a></h2>
 <p>The HttpComponents project currently uses the following lists. Clicking on a list
name will take you to a page with subscribe, unsubscribe, and archive information. See below
for information on <i>digests</i>.</p>
-<ul><li><a shape="rect" href="./mail-lists.html">httpclient-users</a>
- The list for users of HttpClient, either version 3 or 4. Users of HttpCore can also post
their questions here, although most subscribers will probably not be able to answer them.</li><li><a
shape="rect" href="./mail-lists.html">dev</a> - The list for developers of HttpComponents
and HttpClient 3. We don't mind getting HttpCore user questions here. Our issues tracker JIRA
also posts here.</li><li><a shape="rect" href="./mail-lists.html">commits</a>
- The list for messages from our source code repository. Whenever the source code is modified,
a mail with the changes is sent. This list is read-only. HttpComponents committers are expected
to subscribe to the commits list, so they can review the changes.</li><li><i>private</i>
- The list for private communication of the HttpComponents PMC. Only PMC members and ASF members
can subscribe. There is no public archive.</li></ul></div>
-<div class="section">
-<h2><a shape="rect" name="Subscribe_And_Unsubscribe">Subscribe And Unsubscribe</a></h2>
-<p>To subscribe to the list "<i>xxx</i>", send a mail to "<i>xxx</i>-subscribe@hc.apache.org".
While you are subscribed, you will receive all mails sent to the list. You can send mails
to the list yourself using the address "<i>xxx</i>@hc.apache.org". This does not
apply for the commits list, where only the source code repository is allowed to send mails.</p>
-<p>To unsubscribe from the list "<i>xxx</i>", send a mail to "<i>xxx</i>-unsubscribe@hc.apache.org".
Unsubscribe information is also appended to every mail sent via the list.</p>
+<ul>
+<li><a href="./mail-lists.html">httpclient-users</a> - The list for users
of HttpClient, either version 3 or 4. Users of HttpCore can also post their questions here,
although most subscribers will probably not be able to answer them.</li>
+<li><a href="./mail-lists.html">dev</a> - The list for developers of HttpComponents
and HttpClient 3. We don't mind getting HttpCore user questions here. Our issues tracker JIRA
also posts here.</li>
+<li><a href="./mail-lists.html">commits</a> - The list for messages from
our source code repository. Whenever the source code is modified, a mail with the changes
is sent. This list is read-only. HttpComponents committers are expected to subscribe to the
commits list, so they can review the changes.</li>
+<li><i>private</i> - The list for private communication of the HttpComponents
PMC. Only PMC members and ASF members can subscribe. There is no public archive.</li></ul></div>
+<div class="section">
+<h2><a name="Subscribe_And_Unsubscribe">Subscribe And Unsubscribe</a></h2>
+<p>To subscribe to the list &quot;<i>xxx</i>&quot;, send a mail
to &quot;<i>xxx</i>-subscribe@hc.apache.org&quot;. While you are subscribed,
you will receive all mails sent to the list. You can send mails to the list yourself using
the address &quot;<i>xxx</i>@hc.apache.org&quot;. This does not apply
for the commits list, where only the source code repository is allowed to send mails.</p>
+<p>To unsubscribe from the list &quot;<i>xxx</i>&quot;, send a
mail to &quot;<i>xxx</i>-unsubscribe@hc.apache.org&quot;. Unsubscribe
information is also appended to every mail sent via the list.</p>
 <p>The <b>digest</b> of a list collects all mails of that list, sending
you occasional updates. Each update contains the subjects of the recent mails, and the mails
themselves as attachments. This significantly reduces the number of individual mails you receive
from the list, while still giving you access to all the information.</p>
-<p>To subscribe to the digest of list "<i>xxx</i>", send a mail to "<i>xxx</i>-digest-subscribe@hc.apache.org".
While you are subscribed to the digest, you can send mails to the list itself using the address
"<i>xxx</i>@hc.apache.org". This does not apply for the commits list, where only
the source code repository is allowed to send mails.</p>
-<p>To unsubscribe from the digest of list "<i>xxx</i>", send a mail to
"<i>xxx</i>-digest-unsubscribe@hc.apache.org". Unsubscribe information is also
appended to every mail sent by the digest.</p></div>
+<p>To subscribe to the digest of list &quot;<i>xxx</i>&quot;, send
a mail to &quot;<i>xxx</i>-digest-subscribe@hc.apache.org&quot;. While
you are subscribed to the digest, you can send mails to the list itself using the address
&quot;<i>xxx</i>@hc.apache.org&quot;. This does not apply for the commits
list, where only the source code repository is allowed to send mails.</p>
+<p>To unsubscribe from the digest of list &quot;<i>xxx</i>&quot;,
send a mail to &quot;<i>xxx</i>-digest-unsubscribe@hc.apache.org&quot;.
Unsubscribe information is also appended to every mail sent by the digest.</p></div>
       </div>
     </div>
     <div class="clear">
-      <hr></hr>
+      <hr/>
     </div>
     <div id="footer">
                       
 <div class="xleft">Apache HttpComponents, Commons HttpClient, Apache, the Apache feather
logo, and the Apache HttpComponents project logo are trademarks of The Apache Software Foundation.</div>
             
-<br clear="none"></br>
+<br/>
             
 <div class="xleft">All other marks mentioned may be trademarks or registered trademarks
of their respective owners.</div>
-                <div class="xright">Copyright &#169;                    2005-2017
-                        <a shape="rect" href="http://www.apache.org/">The Apache Software
Foundation</a>.
+                <div class="xright">Copyright &#169;                    2005-2018
+                        <a href="http://www.apache.org/">The Apache Software Foundation</a>.
             All Rights Reserved.      
                 
       </div>
       <div class="clear">
-        <hr></hr>
+        <hr/>
       </div>
     </div>
-  </body></html>
+  </body>
+</html>



Mime
View raw message