commit:     e0a3f3f2db7367737da6d17fa08c22bcf1763834
Author:     Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
AuthorDate: Wed Apr 12 21:08:26 2017 +0000
Commit:     Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
CommitDate: Wed Apr 12 21:08:26 2017 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=e0a3f3f2

appendices/contributing/devbook-guide: remove documentation on <mail>

The tag <mail> doesn't work in devmanual. Remove the section devoted
to that.

 appendices/contributing/devbook-guide/text.xml | 28 +-------------------------
 1 file changed, 1 insertion(+), 27 deletions(-)

diff --git a/appendices/contributing/devbook-guide/text.xml 
b/appendices/contributing/devbook-guide/text.xml
index 967c990..64db156 100644
--- a/appendices/contributing/devbook-guide/text.xml
+++ b/appendices/contributing/devbook-guide/text.xml
@@ -413,31 +413,10 @@ Fill this section with the information about the use of
 </body>
 </section>
 <section>
-<title>&lt;mail&gt; and &lt;uri&gt;</title>
+<title>&lt;uri&gt;</title>
 <body>
 
 <p>
-We've taken a look at the <c>&lt;mail&gt;</c> tag earlier; it's used to link
-some text with a particular email address, and takes the form <c>&lt;mail
-link="[email protected]"&gt;Mr. Foo Bar&lt;/mail&gt;</c>. If you want to 
display the
-email address, you can use 
<c>&lt;mail&gt;[email protected]&lt;/mail&gt;</c>, this
-would be displayed as <mail>[email protected]</mail>.
-</p>
-
-<p>
-Shorter forms make it easier to use names and emails of Gentoo developers. Both
-<c>&lt;mail&gt;neysx&lt;/mail&gt;</c> and <c>&lt;mail link="neysx"/&gt;</c>
-would appear as <mail>neysx</mail>. If you want to use a Gentoo dev's email
-with a different content than his full name, use the second form with some
-content. For instance, use a dev's first name: <c>&lt;mail
-link="neysx"&gt;Xavier&lt;/mail&gt;</c> appears as <mail
-link="neysx">Xavier</mail>.
-<br/>
-This is particularly useful when you want to name a developer whose name
-contains "funny" characters that you can't type.
-</p>
-
-<p>
 The <c>&lt;uri&gt;</c> tag is used to point to files/locations on the Internet.
 It has two forms -- the first can be used when you want to have the actual URI
 displayed in the body text, such as this link to
@@ -456,11 +435,6 @@ index&lt;/uri&gt;</c>. Leaving the trailing slash saves an 
extra HTTP request.
 </p>
 
 <p>
-You should not use a <c>&lt;uri&gt;</c> tag with a <c>link</c> attribute that
-starts with <c>mailto:</c>. In this case, use a <c>&lt;mail&gt;</c> tag.
-</p>
-
-<p>
 Please avoid the <uri link="http://en.wikipedia.org/wiki/Click_here";>click here
 syndrome</uri> as recommended by the <uri
 link="http://www.w3.org/QA/Tips/noClickHere";>W3C</uri>.

Reply via email to