[Bash web page] Proposed changes

[Thérèse Godefroy]

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 ,  and  need to be removed.

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

* Replace  with quotes;  for commands,  for files, etc.
* Introduction: avoid repeating "Bash" too many times; add
  punctuation to the list.
* Downloads: avoid long URLs as link text.
* Mailing lists:  instead of ; 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 -	1.16
+++ bash.html	18 Sep 2020 13:31:51 -
@@ -1,13 +1,17 @@
 
-
+
+
 Bash - GNU Project - Free Software Foundation
 
 
+
+
 GNU Bash
+
 
 
-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 @@
 The improvements offered by Bash include:
 
-Command line editing
-Unlimited size command history
-Job Control
-Shell Functions and Aliases
-Indexed arrays of unlimited size
-Integer arithmetic in any base from two to sixty-four
+command-line editing,
+unlimited size command history,
+job control,
+shell functions and aliases,
+indexed arrays of unlimited size,
+integer arithmetic in any base from two to sixty-four.
 
 
 The maintainer also has a https://tiswww.case.edu/php/chet/bash/bashtop.html";>bash page which
+href="https://tiswww.case.edu/php/chet/bash/bashtop.html";>Bash page which
 includes ftp://ftp.cwru.edu/pub/bash/FAQ";>Frequently-Asked-Questions.
+href="ftp://ftp.cwru.edu/pub/bash/FAQ";>Frequently Asked Questions.
 
-Downloading Bash
 
-Bash
-can be found on the main GNU ftp server:
-http://ftp.gnu.org/gnu/bash/";>http://ftp.gnu.org/gnu/bash/
-(via HTTP) and
-ftp://ftp.gnu.org/gnu/bash/";>ftp://ftp.gnu.org/gnu/bash/
-(via FTP).  It can also be found
-on the GNU mirrors;
-please
-http://ftpmirror.gnu.org/bash/";>use
-a mirror if possible.
+Download
+
+Stable releases are available from the main GNU server
+(https://ftp.gnu.org/gnu/bash/";>HTTPS, 
+http://ftp.gnu.org/gnu/bash/";>HTTP, 
+ftp://ftp.gnu.org/gnu/bash/";>FTP), and its
+mirrors; please
+https://ftpmirror.gnu.org/bash/";>use a mirror if possible.
 
 
@@ -50,42 +51,38 @@
 is available online, as
 is documentation for most GNU software.  You may
-also find more information about
+also find information about
 Bash
-by running
-info bash
+by running info bash
 or
-man bash,
-or by looking at
-/usr/doc/bash/,
-/usr/local/doc/bash/,
+man bash, or by looking at
+/usr/share/doc/bash/, /usr/local/share/doc/bash/,
 or similar directories on your system.  A brief summary is available by
-running bash --help.
+running bash --help.
 
 
 Mailing lists
 
-
-To ask for help about bash, bash programming or bash shell scripting
-please use the
-
-mailing list.  To report bugs or to discuss most aspects of developing
-bash please use the
-
-mailing list.
+
+ 
+  (https://lists.gnu.org/mailman/listinfo/help-bash";>web
+  interface) is used to ask for help about Bash, Bash programming or
+  Bash shell scripting;
+ 
+  (https://lists.gnu.org/mailman/listinfo/bug-bash";>web
+  interface) is used to report bugs or discuss most aspects of
+  developing Bash.
+
 
 Announcements about
 Bash
-and most other GNU software are made on
-.
+and most other GNU software are made on https://lists.gnu.org/mailman/listinfo/info-gnu";>info-...@gnu.org.
 
-To subscribe to these or any GNU mailing lists, please send an empty
-mail with a Subject: header of just subscribe to the relevant
--request list.  For example, to subscribe yourself to the GNU
-announcement list, you would send mail to .
-Or you can use the http://lists.gnu.org/mailman/listinfo/info-gnu";>mailing list web
-interface.
+To subscribe to these or any GNU mailing lists, please send an empty mail
+with a Subject: header of just “subscribe” to the relevant
+-request list.  For example, to subscribe yourself to the GNU
+announcement list, you would send mail to .
+Or you can use the web interface

Re: Bash-5.1-beta available

[Chet Ramey]

On 9/17/20 5:13 PM, Robert Elz wrote:

>   | I don't have list-specific email configs.
> 
> Are there any lists for which you want to direct replies to yourself
> rather than the list? 

That doesn't have much to do with my email configs, which are not specific
to mailing lists, since those constitute a small portion of my email.

  And aside from me, do you encounter almost anyone
> whose MUA actually implements Reply-To properly, and replies only to you?

I don't pay a lot of attention to it.


>   | Because that's where the incentives are. Nobody cares if you implement
>   | "what is right" if you fail a standards conformance test.
> 
> I guess that depends upon your objectives.   I don't care in the
> slightest about conformance tests, or their results - which is why
> I won't implement "cd -L" and why NetBSD refuses to supply exec'able
> forms of "cd" "umask" ...

Sure, but others do. You're fortunate not to have to.


>   | Then the standard needs to be clarified, doesn't it?
> 
> Yes, we were kind of at that point earlier ... and we know the result
> can only be "unspecified" which isn't really very helpful.

You never know. Geoff might just say "well, it's obviously this."

> It would be nicer if before that happens we could just agree on what
> is the better result, and do that, and try to get mksh and ksh93 to
> do the same.   Then perhaps the standard would not need to say "unspecified".

We already have two camps, and netbsd/freebsd/historical sh are the ones
that print \"A\". Bash (current beta version), yash, dash, ksh93, and mksh
print "A".

Chet

-- 
``The lyf so short, the craft so long to lerne.'' - Chaucer
 ``Ars longa, vita brevis'' - Hippocrates
Chet Ramey, UTech, CWRUc...@case.eduhttp://tiswww.cwru.edu/~chet/