Hello Bash maintainers,

We are planning to migrate all templated pages on gnu.org to HTML5 in
order to improve accessibility. But before doing this, deprecated tags
such as <tt>, <acronym> and <big> need to be removed.

<tt> is found in the home page of Bash. I got rid of it, and took
this opportunity to do some minor edits:

* Replace <tt> with quotes; <kbd> for commands, <code> for files, etc.
* Introduction: avoid repeating "Bash" too many times; add
  punctuation to the list.
* Downloads: avoid long URLs as link text.
* Mailing lists: <ul> instead of <p>; address at the beginning of the
sentence.
* Translations: more concise wording.
* http > https where possible; local URLs relative to server root.
* Update to latest boilerplate and reduce line width.

If you agree with the changes but don't have time to commit them right
now, I will gladly do it.

BEst regards,
Thérèse

Index: bash.html
===================================================================
RCS file: /webcvs/bash/bash/bash.html,v
retrieving revision 1.16
diff -U 2 -r1.16 bash.html
--- bash.html	15 Dec 2017 10:46:14 -0000	1.16
+++ bash.html	18 Sep 2020 13:31:51 -0000
@@ -1,13 +1,17 @@
 <!--#include virtual="/server/header.html" -->
-<!-- Parent-Version: 1.79 -->
+<!-- Parent-Version: 1.92 -->
+<!-- This page is derived from /server/standards/boilerplate.html -->
 <title>Bash - GNU Project - Free Software Foundation</title>
 <!--#include virtual="/server/gnun/initial-translations-list.html" -->
 <!--#include virtual="/server/banner.html" -->
+<div class="reduced-width">
+
 <h2>GNU Bash</h2>
+<hr class="thin" />
 
 <p>
-Bash is the GNU Project's shell.  Bash is the Bourne Again SHell.
-Bash is an sh-compatible shell that
-incorporates useful features from the Korn shell (ksh) and C shell
+Bash is the GNU Project's shell&mdash;the Bourne Again SHell.
+This is an sh-compatible shell that
+incorporates useful features from the Korn shell (ksh) and the C shell
 (csh).  It is intended to conform to the IEEE POSIX P1003.2/ISO 9945.2
 Shell and Tools standard.  It offers functional improvements over sh
@@ -17,29 +21,26 @@
 <p>The improvements offered by Bash include:</p>
 <ul>
-<li>Command line editing</li>
-<li>Unlimited size command history</li>
-<li>Job Control</li>
-<li>Shell Functions and Aliases</li>
-<li>Indexed arrays of unlimited size</li>
-<li>Integer arithmetic in any base from two to sixty-four</li>
+<li>command-line editing,</li>
+<li>unlimited size command history,</li>
+<li>job control,</li>
+<li>shell functions and aliases,</li>
+<li>indexed arrays of unlimited size,</li>
+<li>integer arithmetic in any base from two to sixty-four.</li>
 </ul>
 
 <p>The maintainer also has a <a
-href="https://tiswww.case.edu/php/chet/bash/bashtop.html";>bash page</a> which
+href="https://tiswww.case.edu/php/chet/bash/bashtop.html";>Bash page</a> which
 includes <a
-href="ftp://ftp.cwru.edu/pub/bash/FAQ";>Frequently-Asked-Questions</a>.</p>
+href="ftp://ftp.cwru.edu/pub/bash/FAQ";>Frequently Asked Questions</a>.</p>
 
-<h3 id="download">Downloading Bash</h3>
 
-<p>Bash
-can be found on the main GNU ftp server:
-<a href="http://ftp.gnu.org/gnu/bash/";>http://ftp.gnu.org/gnu/bash/</a>
-(via HTTP) and
-<a href="ftp://ftp.gnu.org/gnu/bash/";>ftp://ftp.gnu.org/gnu/bash/</a>
-(via FTP).  It can also be found
-on the <a href="/prep/ftp.html">GNU mirrors</a>;
-please
-<a href="http://ftpmirror.gnu.org/bash/";>use
-a mirror</a> if possible.</p>
+<h3 id="download">Download</h3>
+
+<p>Stable releases are available from the main GNU server
+(<a href="https://ftp.gnu.org/gnu/bash/";>HTTPS</a>,&nbsp;
+<a href="http://ftp.gnu.org/gnu/bash/";>HTTP</a>,&nbsp;
+<a href="ftp://ftp.gnu.org/gnu/bash/";>FTP</a>), and its
+<a href="/prep/ftp.html">mirrors</a>; please
+<a href="https://ftpmirror.gnu.org/bash/";>use a mirror</a> if possible.</p>
 
 
@@ -50,42 +51,38 @@
 is available online, as
 is <a href="/manual/">documentation for most GNU software</a>.  You may
-also find more information about
+also find information about
 Bash
-by running
-<em>info&nbsp;bash</em>
+by running <kbd>info&nbsp;bash</kbd>
 or
-<em>man&nbsp;bash</em>,
-or by looking at
-<em>/usr/doc/bash/</em>,
-<em>/usr/local/doc/bash/</em>,
+<kbd>man&nbsp;bash</kbd>, or by looking at
+<code>/usr/share/doc/bash/</code>, <code>/usr/local/share/doc/bash/</code>,
 or similar directories on your system.  A brief summary is available by
-running <tt>bash&nbsp;--help</tt>.</p>
+running <kbd>bash&nbsp;--help</kbd>.</p>
 
 
 <h3 id="mail">Mailing lists</h3>
 
-<p>
-To ask for help about bash, bash programming or bash shell scripting
-please use the
-<a href="mailto:help-b...@gnu.org">&lt;help-b...@gnu.org&gt;</a>
-mailing list.  To report bugs or to discuss most aspects of developing
-bash please use the
-<a href="mailto:bug-bash@gnu.org">&lt;bug-bash@gnu.org&gt;</a>
-mailing list.</p>
+<ul>
+ <li>&lt;<a href="mailto:help-b...@gnu.org">help-b...@gnu.org</a>&gt;
+  (<a href="https://lists.gnu.org/mailman/listinfo/help-bash";>web
+  interface</a>) is used to ask for help about Bash, Bash programming or
+  Bash shell scripting;</li>
+ <li>&lt;<a href="mailto:bug-bash@gnu.org">bug-bash@gnu.org</a>&gt;
+  (<a href="https://lists.gnu.org/mailman/listinfo/bug-bash";>web
+  interface</a>) is used to report bugs or discuss most aspects of
+  developing Bash.</li>
+</ul>
 
 <p>Announcements about
 Bash
-and most other GNU software are made on
-<a href="mailto:info-...@gnu.org">&lt;info-...@gnu.org&gt;</a>.</p>
+and most other GNU software are made on <a
+href="https://lists.gnu.org/mailman/listinfo/info-gnu";>info-...@gnu.org</a>.</p>
 
-<p>To subscribe to these or any GNU mailing lists, please send an empty
-mail with a Subject: header of just <tt>subscribe</tt> to the relevant
--request list.  For example, to subscribe yourself to the GNU
-announcement list, you would send mail to <a
-href="mailto:info-gnu-requ...@gnu.org?Subject=subscribe"
->&lt;info-gnu-requ...@gnu.org&gt;</a>.
-Or you can use the <a
-href="http://lists.gnu.org/mailman/listinfo/info-gnu";>mailing list web
-interface</a>.</p>
+<p>To subscribe to these or any GNU mailing lists, please send an empty mail
+with a <i>Subject:</i> header of just &ldquo;subscribe&rdquo; to the relevant
+<i>-request</i> list.  For example, to subscribe yourself to the GNU
+announcement list, you would send mail to &lt;<a
+href="mailto:info-gnu-requ...@gnu.org?Subject=subscribe">info-gnu-requ...@gnu.org</a>&gt;.
+Or you can use the web interface.</p>
 
 
@@ -99,5 +96,4 @@
 list (see above).</p>
 
-
 <dl>
 <dt>Development</dt>
@@ -105,34 +101,22 @@
 <dd>For development sources, bug and patch trackers, and other
 information, please see the
-<a href="http://savannah.gnu.org/projects/bash/";>Bash
+<a href="https://savannah.gnu.org/projects/bash/";>Bash
 project page</a>
-at <a href="http://savannah.gnu.org";>savannah.gnu.org</a>.</dd>
-
+at <a href="https://savannah.gnu.org";>savannah.gnu.org</a>.</dd>
 
 <dt>Translating Bash</dt>
 
-<dd>To translate
-Bash's
-messages into other languages, please see the <a
-href="http://translationproject.org/domain/bash.html";>Translation Project
-page for
-Bash</a>.
-If you have a new translation of the message strings,
-or updates to the existing strings, please have the changes made in this
-repository.  Only translations from this site will be incorporated into
-Bash.
+<dd>To translate the program messages into other languages, please refer to
+the <a href="https://translationproject.org/domain/bash.html";>Translation
+Project page for Bash</a>. New translations or updates to the existing
+strings will not be incorporated into Bash if they are sent elsewhere.
 For more information, see the <a
-href="http://translationproject.org/html/welcome.html";>Translation
-Project</a>.</dd>
-
+href="https://translationproject.org/html/welcome.html";>Translation Project
+home page</a>.</dd>
 
 <dt>Maintainer</dt>
 
-<dd>Bash
-is currently being maintained by
-Chet Ramey.
+<dd>Bash is currently maintained by Chet Ramey.
 Please use the mailing lists for contact.</dd>
-
-
 </dl>
 
@@ -142,10 +126,10 @@
 <p>Bash
 is free software; you can redistribute it and/or modify it under the
-terms of the <a href="http://www.gnu.org/licenses/gpl.html";
+terms of the <a href="/licenses/gpl.html"
 rel="license">GNU General Public License</a> as published by the Free
 Software Foundation; either version&nbsp;3 of the License, or (at your
 option) any later version.</p>
 
-
+</div>
 </div><!-- for id="content", starts in the include above -->
 <!--#include virtual="/server/footer.html" -->
@@ -161,5 +145,5 @@
 <p>Please see the <a
 href="/server/standards/README.translations.html">Translations
-README</a> for information on coordinating and submitting translations
+README</a> for information on coordinating and contributing translations
 of this article.</p>
 </div>

Reply via email to