Gentoo Archives: gentoo-commits

From: "Göktürk Yüksek" <gokturk@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] proj/devmanual:devbook-guide commit in: appendices/contributing/devbook-guide/
Date: Wed, 12 Apr 2017 21:24:23
Message-Id: 1492031306.e0a3f3f2db7367737da6d17fa08c22bcf1763834.gokturk@gentoo
1 commit: e0a3f3f2db7367737da6d17fa08c22bcf1763834
2 Author: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
3 AuthorDate: Wed Apr 12 21:08:26 2017 +0000
4 Commit: Göktürk Yüksek <gokturk <AT> gentoo <DOT> org>
5 CommitDate: Wed Apr 12 21:08:26 2017 +0000
6 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=e0a3f3f2
7
8 appendices/contributing/devbook-guide: remove documentation on <mail>
9
10 The tag <mail> doesn't work in devmanual. Remove the section devoted
11 to that.
12
13 appendices/contributing/devbook-guide/text.xml | 28 +-------------------------
14 1 file changed, 1 insertion(+), 27 deletions(-)
15
16 diff --git a/appendices/contributing/devbook-guide/text.xml b/appendices/contributing/devbook-guide/text.xml
17 index 967c990..64db156 100644
18 --- a/appendices/contributing/devbook-guide/text.xml
19 +++ b/appendices/contributing/devbook-guide/text.xml
20 @@ -413,31 +413,10 @@ Fill this section with the information about the use of
21 </body>
22 </section>
23 <section>
24 -<title>&lt;mail&gt; and &lt;uri&gt;</title>
25 +<title>&lt;uri&gt;</title>
26 <body>
27
28 <p>
29 -We've taken a look at the <c>&lt;mail&gt;</c> tag earlier; it's used to link
30 -some text with a particular email address, and takes the form <c>&lt;mail
31 -link="foo.bar@×××××××.com"&gt;Mr. Foo Bar&lt;/mail&gt;</c>. If you want to display the
32 -email address, you can use <c>&lt;mail&gt;foo.bar@×××××××.com&lt;/mail&gt;</c>, this
33 -would be displayed as <mail>foo.bar@×××××××.com</mail>.
34 -</p>
35 -
36 -<p>
37 -Shorter forms make it easier to use names and emails of Gentoo developers. Both
38 -<c>&lt;mail&gt;neysx&lt;/mail&gt;</c> and <c>&lt;mail link="neysx"/&gt;</c>
39 -would appear as <mail>neysx</mail>. If you want to use a Gentoo dev's email
40 -with a different content than his full name, use the second form with some
41 -content. For instance, use a dev's first name: <c>&lt;mail
42 -link="neysx"&gt;Xavier&lt;/mail&gt;</c> appears as <mail
43 -link="neysx">Xavier</mail>.
44 -<br/>
45 -This is particularly useful when you want to name a developer whose name
46 -contains "funny" characters that you can't type.
47 -</p>
48 -
49 -<p>
50 The <c>&lt;uri&gt;</c> tag is used to point to files/locations on the Internet.
51 It has two forms -- the first can be used when you want to have the actual URI
52 displayed in the body text, such as this link to
53 @@ -456,11 +435,6 @@ index&lt;/uri&gt;</c>. Leaving the trailing slash saves an extra HTTP request.
54 </p>
55
56 <p>
57 -You should not use a <c>&lt;uri&gt;</c> tag with a <c>link</c> attribute that
58 -starts with <c>mailto:</c>. In this case, use a <c>&lt;mail&gt;</c> tag.
59 -</p>
60 -
61 -<p>
62 Please avoid the <uri link="http://en.wikipedia.org/wiki/Click_here">click here
63 syndrome</uri> as recommended by the <uri
64 link="http://www.w3.org/QA/Tips/noClickHere">W3C</uri>.