mainThe GNU Bourne-Again SHell - Support: sr #110564, man bash results in mandoc:...

 
 

sr #110564: man bash results in mandoc: /usr/share/man/man1/bash.1 UNSUPP: unsupported control character: 0x7

Submitter:  None
Submitted:  Sat 13 Nov 2021 12:03:49 AM UTC
Votes: 1
 
Category:  None Priority:  5 - Normal
Severity:  3 - Normal Status:  Invalid
Privacy:  Public Assigned to:  None
Originator Email:  -email is unavailable- Open/Closed:  Open
Operating System:  Mac OS
* Mandatory Fields

Add a New Comment Rich Markup
   

Jump to the original submission

Mon 22 Nov 2021 02:21:53 PM UTC, comment #9: 

The important point is that after \", everything to the end of the line is ignored, including the ^G.

Chet Ramey <chet>
Group administrator
Mon 22 Nov 2021 02:17:15 PM UTC, comment #8: 

Hombrew's issue tracker seems down at the moment, so I posted this discussion here:

https://github.com/Homebrew/discussions/discussions/2506

Luke Hamburg <luckman212>
Sun 21 Nov 2021 10:29:12 PM UTC, comment #7: 

You should probably file a bug report with apple, then.

You omitted the portion of the file that contains the actual commented-out macro definition in question:

.\" .de }1
.\" .ds ]X \&\\*(]B\\
.\" .nr )E 0
.\" .if !"\\$1"" .nr )I \\$1n
.\" .}f
.\" .ll \\n(LLu
.\" .in \\n()Ru+\\n(INu+\\n()Iu
.\" .ti \\n(INu
.\" .ie !\\n()Iu+\\n()Ru-\w^G\\*(]X^Gu-3p \{\\*(]X
.\" .br\}
.\" .el \\*(]X\h^G|\\n()Iu+\\n()Ru^G\c
.\" .}f
.\" ..

If mandoc isn't treating the undefined request followed by a comment by ignoring the entire line, it needs to be fixed.


Chet Ramey <chet>
Group administrator
Sun 21 Nov 2021 08:54:07 PM UTC, comment #6: 

I want to clarify a couple of things:

1) I now have installed Bash 5.1.12 via Homebrew, so it should be current. Since my original post a few days ago (I was running 5.1.8 then), I also fixed a problem with my $MANPATH environment variable which was causing the old manpage to display (you were correct about that).


$ bash --version
GNU bash, version 5.1.12(1)-release (aarch64-apple-darwin21.1.0)
Copyright (C) 2020 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>


2) I just uploaded a screenshot, showing the `bash.1` man file, which is timestamped Sep 23 2020. So should be recent enough.

3) The bash.rb formula at Homebrew (https://github.com/Homebrew/homebrew-core/blob/HEAD/Formula/bash.rb) indicates that the files are being sourced directly from the master GNU.org stable repo.

Still I am not sure where to go from here-

Luke Hamburg <luckman212>
Sun 21 Nov 2021 08:44:21 PM UTC, comment #5: 


comment #4:

> MacOS X is still using a version of bash that was released over 15 years ago. This particular change (commenting out the definition) was made about three years ago, back in December of 2018.
>
> So, the version of the man page on macos is the one from 2006, which still has the ^G in the macro definition.
>
> I can't really do anything about that; Apple will remove bash completely before they ship a version that uses GPLv3.



Luke Hamburg <luckman212>
Sun 21 Nov 2021 06:01:03 PM UTC, comment #4: 

MacOS X is still using a version of bash that was released over 15 years ago. This particular change (commenting out the definition) was made about three years ago, back in December of 2018.

So, the version of the man page on macos is the one from 2006, which still has the ^G in the macro definition.

I can't really do anything about that; Apple will remove bash completely before they ship a version that uses GPLv3.

Chet Ramey <chet>
Group administrator
Sat 20 Nov 2021 09:25:37 PM UTC, comment #3: 

Thanks for looking. I guess maybe the bug is in OSX's implementation of `man` then?

I tried running `man bash` and then while less was still displaying the text, I checked `ps auxwww | grep man` to see the commandline that was running. It is:


sh -c (cd "/usr/share/man" && (echo ".ll 10.8i"; echo ".nr LL 10.8i"; /bin/cat '/usr/share/man/man1/bash.1') | /usr/bin/tbl | /usr/bin/groff -Wall -mtty-char -Tascii -mandoc -c | (/usr/bin/less -is || true))


Pretty verbose, I stripped off a bit and just ran

(echo ".ll 10.8i"; echo ".nr LL 10.8i"; cat '/usr/share/man/man1/bash.1') | tbl | groff -Wall -mtty-char -Tascii -mandoc -c | less


Which displayed the manpage without barfing anything to the console. I wish I was smart enough to know where the problem is.

Luke Hamburg <luckman212>
Fri 19 Nov 2021 10:19:02 PM UTC, comment #2: 

It's a red herring. Those characters appear in a commented-out macro definition.

Chet Ramey <chet>
Group administrator
Sat 13 Nov 2021 12:10:40 AM UTC, comment #1: 

I am the submitter of this report, it was not intended to be anonymous. But, I can't seem to get registered at savannah. Not receiving the activation emails.

Luke Hamburg <luckman212>
Sat 13 Nov 2021 12:03:49 AM UTC, original submission:  

Using bash 5.1.8 on macOS 12 (Installed via Homebrew)


$ bash --version
GNU bash, version 5.1.8(1)-release (aarch64-apple-darwin20.4.0)


I noticed when trying to view the manpage with `man bash`, the following errors are output to the console:


$ man bash
mandoc: /usr/share/man/man1/bash.1:35:24: UNSUPP: unsupported control character: 0x7
mandoc: /usr/share/man/man1/bash.1:35:31: UNSUPP: unsupported control character: 0x7
mandoc: /usr/share/man/man1/bash.1:37:13: UNSUPP: unsupported control character: 0x7
mandoc: /usr/share/man/man1/bash.1:37:30: UNSUPP: unsupported control character: 0x7


I don't know if these control chars (BEL?) snuck in there by mistake, or this is a red herring etc. But, I searched the rest of my mandoc files in /usr/share/man1/ and found no others containing them.

Anonymous

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

Attached Files
file #52263:  0x7.png added by None (74KiB - image/png)

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by chet (Posted a comment)
  • -email is unavailable- added by luckman212 (Voted in favor of this item)
  • -email is unavailable- added by luckman212 (Posted a comment)
  • -email is unavailable- added by None (Submitted the item)
  •  

    There is 1 vote so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only logged-in users can vote.

     

    Follow 4 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2021-11-21 luckman212 Attached File- Added a117b315219d8d136664d606149e5f776b535022.png, #52317
    2021-11-19 chet StatusNone Invalid
    2021-11-13 luckman212 Carbon-Copy- Added luckman212
    2021-11-13 None Attached File- Added 0x7.png, #52263

    Back to the top

    Powered by Savane 3.13-758e.
    Corresponding source code