Path: csiph.com!xmission!news.snarked.org!news.linkpendium.com!news.linkpendium.com!panix!usenet.stanford.edu!not-for-mail
From: Hongyi Zhao <hongyi.zhao@gmail.com>
Newsgroups: gnu.bash.bug
Subject: Re: `help declare' don't show the same document with the online one.
Date: Tue, 28 Jul 2020 22:21:36 +0800
Lines: 38
Approved: bug-bash@gnu.org
Message-ID: <mailman.206.1595946579.2739.bug-bash@gnu.org>
References: <CAGP6POJRc+J=3-9psywybQa+A_NJ0EqrBEdpbiTHkXtXCoWNVA@mail.gmail.com> <43223707-2235-2349-3b37-f18ab4e780e3@case.edu> <CAGP6PO++vQdP5XaoMd-stx52fBLauJt+eVLqJ4=XhAmx1fxFEw@mail.gmail.com>
NNTP-Posting-Host: lists.gnu.org
Mime-Version: 1.0
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
Cc: bug-bash@gnu.org
To: chet.ramey@case.edu
Envelope-to: bug-bash@gnu.org
In-Reply-To: <43223707-2235-2349-3b37-f18ab4e780e3@case.edu>
Received-SPF: pass client-ip=2607:f8b0:4864:20::533; envelope-from=hongyi.zhao@gmail.com; helo=mail-pg1-x533.google.com
X-Spam_score_int: -20
X-Spam_score: -2.1
X-Spam_bar: --
X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=unavailable autolearn_force=no
X-Spam_action: no action
X-BeenThere: bug-bash@gnu.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: Bug reports for the GNU Bourne Again SHell <bug-bash.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-bash>, <mailto:bug-bash-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/bug-bash>
List-Post: <mailto:bug-bash@gnu.org>
List-Help: <mailto:bug-bash-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-bash>, <mailto:bug-bash-request@gnu.org?subject=subscribe>
X-Mailman-Original-Message-ID: <CAGP6PO++vQdP5XaoMd-stx52fBLauJt+eVLqJ4=XhAmx1fxFEw@mail.gmail.com>
X-Mailman-Original-References: <CAGP6POJRc+J=3-9psywybQa+A_NJ0EqrBEdpbiTHkXtXCoWNVA@mail.gmail.com> <43223707-2235-2349-3b37-f18ab4e780e3@case.edu>
Xref: csiph.com gnu.bash.bug:16639

On Tue, Jul 28, 2020 at 9:25 PM Chet Ramey <chet.ramey@case.edu> wrote:
>
>
> > The online version of the document for declare told the following usage=
:
> >
> >
> > declare
> > declare [-aAfFgilnrtux] [-p] [name[=3Dvalue] =E2=80=A6]
> > [...]
> > The -p option will display the attributes and values of each name.
> > When -p is used with name arguments, additional options, other than -f
> > and -F, are ignored.
> >
> >
> > But I can't find the same notes from the local version of the document
> > for this command given by `help declare', any hints for this problem?
>
> The help text built into bash is a much shorter version of the manual
> text. It's intended to be a hint, with the man page providing the detail.

Thanks a lot for your help. I rechecked the man page with the
following command and confirmed the comments you told above:

$ man bash | egrep -A10 '^[ ]*declare \['
       declare [-aAfFgilnrtux] [-p] [name[=3Dvalue] ...]
       typeset [-aAfFgilnrtux] [-p] [name[=3Dvalue] ...]
              Declare  variables  and/or give them attributes.  If no
names are given then display the
              values of variables.  The -p option will display the
attributes and values of each name.
              When  -p  is used with name arguments, additional
options, other than -f and -F, are ig=E2=80=90
              nored.

--=20
Hongyi Zhao <hongyi.zhao@gmail.com>