From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 9CFC2138350 for ; Wed, 15 Jan 2020 22:36:24 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id CE2ECE085B; Wed, 15 Jan 2020 22:36:23 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 98CB7E085B for ; Wed, 15 Jan 2020 22:36:23 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 7E3E334E0BD for ; Wed, 15 Jan 2020 22:36:22 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 00D133B for ; Wed, 15 Jan 2020 22:36:20 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1579127717.75a0de8654435df5ca5b12b2670e24258d30ffc9.ulm@gentoo> Subject: [gentoo-commits] proj/devmanual:master commit in: appendices/devbook-guide/ X-VCS-Repository: proj/devmanual X-VCS-Files: appendices/devbook-guide/text.xml X-VCS-Directories: appendices/devbook-guide/ X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 75a0de8654435df5ca5b12b2670e24258d30ffc9 X-VCS-Branch: master Date: Wed, 15 Jan 2020 22:36:20 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: c9c2f6ba-3aa0-412b-a1a2-4aa5c91d3361 X-Archives-Hash: 9cf6d1df9ade819008867452a8dace94 commit: 75a0de8654435df5ca5b12b2670e24258d30ffc9 Author: Ulrich Müller gentoo org> AuthorDate: Wed Jan 15 22:35:17 2020 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Wed Jan 15 22:35:17 2020 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=75a0de86 devbook-guide: Remove obsolete text in "" subsection. Linking to other parts of the Gentoo web site doesn't apply to us, because the devmanual isn't at www.gentoo.org. Consistently have a trailing slash in example URIs. Signed-off-by: Ulrich Müller gentoo.org> appendices/devbook-guide/text.xml | 16 +++++----------- 1 file changed, 5 insertions(+), 11 deletions(-) diff --git a/appendices/devbook-guide/text.xml b/appendices/devbook-guide/text.xml index 5f084bb..9b7a0c3 100644 --- a/appendices/devbook-guide/text.xml +++ b/appendices/devbook-guide/text.xml @@ -163,7 +163,7 @@ an example <body> element: <p> This is a paragraph. <c>/etc/passwd</c> is a file. -<uri>https://forums.gentoo.org</uri> is my favorite website. +<uri>https://forums.gentoo.org/</uri> is my favorite website. Type <c>ls</c> if you feel like it. I <e>really</e> want to go to sleep now. </p> @@ -196,7 +196,7 @@ Now, here's how the <body> element above is rendered:

This is a paragraph. /etc/passwd is a file. -https://forums.gentoo.org is my favorite web site. +https://forums.gentoo.org/ is my favorite web site. Type ls if you feel like it. I really want to go to sleep now.

@@ -370,13 +370,7 @@ displayed in the body text, such as this link to when you want to associate a URI with some other text for example, the Gentoo Forums. To create this link, I typed <uri link="https://forums.gentoo.org/">the -Gentoo Forums</uri>. You don't need to write -https://www.gentoo.org/ to link to other parts of the Gentoo web site. -For instance, a link to the documentation main index -should be simply <uri link="/doc/en/index.xml">documentation main -index</uri>. You can even omit index.xml when you link to a -directory index, e.g. <uri link="/doc/en/">documentation main -index</uri>. Leaving the trailing slash saves an extra HTTP request. +Gentoo Forums</uri>.

@@ -649,8 +643,8 @@ with a capital letter.

Try to use <uri> with the link attribute as much as -possible. In other words, the Gentoo -Forums is preferred over https://forums.gentoo.org. +possible. In other words, the Gentoo +Forums is preferred over https://forums.gentoo.org/.