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—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>, +<a href="http://ftp.gnu.org/gnu/bash/">HTTP</a>, +<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 bash</em> +by running <kbd>info bash</kbd> or -<em>man bash</em>, -or by looking at -<em>/usr/doc/bash/</em>, -<em>/usr/local/doc/bash/</em>, +<kbd>man 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 --help</tt>.</p> +running <kbd>bash --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"><help-b...@gnu.org></a> -mailing list. To report bugs or to discuss most aspects of developing -bash please use the -<a href="mailto:bug-bash@gnu.org"><bug-bash@gnu.org></a> -mailing list.</p> +<ul> + <li><<a href="mailto:help-b...@gnu.org">help-b...@gnu.org</a>> + (<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><<a href="mailto:bug-bash@gnu.org">bug-bash@gnu.org</a>> + (<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"><info-...@gnu.org></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" -><info-gnu-requ...@gnu.org></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 “subscribe” to the relevant +<i>-request</i> 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">info-gnu-requ...@gnu.org</a>>. +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 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>