Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Move man pages to section 6 ("games")? #60

Open
apjanke opened this issue Aug 21, 2024 · 1 comment
Open

Move man pages to section 6 ("games")? #60

apjanke opened this issue Aug 21, 2024 · 1 comment
Assignees
Labels
enhancement Make stuff better!
Milestone

Comments

@apjanke
Copy link
Collaborator

apjanke commented Aug 21, 2024

Maybe the cowsay man pages should go in section 6 of the manual (man6) instead of section 1?

Cowsay is entertainment, and kind of a game. Debian's package of classic cowsay is putting its man pages in section 6. (And gzipping them.) It's putting the binaries in $prefix/games, too, for that matter. Ubuntu 24.04 is the same; no surprise, as a Debian derivative.

janke@book-test-as:~$ apt info cowsay 2>/dev/null | head -4
Package: cowsay
Version: 3.03+dfsg2-8
Priority: optional
Section: games
janke@book-test-as:~$ man -w cowsay
/usr/share/man/man6/cowsay.6.gz
janke@book-test-as:~$ ls -l /usr/share/man/man6/cow*
-rw-r--r-- 1 root root 2210 May 11  2020 /usr/share/man/man6/cowsay.6.gz
lrwxrwxrwx 1 root root   11 May 11  2020 /usr/share/man/man6/cowthink.6.gz -> cowsay.6.gz
janke@book-test-as:~$ 

Also, over on Debian bookworm, it complains about the presence of the cowsay.1.adoc file if it's on the manpath. Best to clean that up, I think.

janke@book-test-as:~/repos/cowsay$ uname -a
Linux book-test-as 6.1.0-17-arm64 #1 SMP Debian 6.1.69-1 (2023-12-30) aarch64 GNU/Linux
janke@book-test-as:~/repos/cowsay$ PATH=$PWD/bin:$PATH
janke@book-test-as:~/repos/cowsay$ man cowsay
man: warning: /home/janke/repos/cowsay/man/man1/cowsay.1.adoc: ignoring bogus filename
janke@book-test-as:~/repos/cowsay$ man -a -w cowsay
man: warning: /home/janke/repos/cowsay/man/man1/cowsay.1.adoc: ignoring bogus filename
/home/janke/repos/cowsay/man/man1/cowsay.1
janke@book-test-as:~/repos/cowsay$ man -a -w cowthink
/home/janke/repos/cowsay/man/man1/cowsay.1
janke@book-test-as:~/repos/cowsay$ 

Fedora 39 has the cowsay man pages in section 1, but they're using my 3.8.1 package, so maybe just following my choice here. cowsay in bin/, not games/.

janke@fed39-test-as:~$ man -a -w cowsay
/usr/share/man/man1/cowsay.1.gz
janke@fed39-test-as:~$ man -a -w cowthink
/usr/share/man/man1/cowsay.1.gz
janke@fed39-test-as:~$ ls -l /usr/share/man/man1/cow*
-rw-r--r--. 1 root root 3006 Aug  7 20:00 /usr/share/man/man1/cowsay.1.gz
lrwxrwxrwx. 1 root root   11 Aug  7 20:00 /usr/share/man/man1/cowthink.1.gz -> cowsay.1.gz
janke@fed39-test-as:~$ cowsay --version
/usr/bin/cowsay version 3.8.1 calling Getopt::Std::getopts (version 1.13),
janke@fed39-test-as:~$ which cowsay
/usr/bin/cowsay

FreeBSD 14.1 has them in section 1, for classic cowsay 3.04.

image
@apjanke apjanke added the enhancement Make stuff better! label Aug 21, 2024
@apjanke apjanke added this to the 3.9.0 milestone Aug 21, 2024
@apjanke apjanke self-assigned this Aug 21, 2024
@apjanke apjanke added this to Cowsay Aug 21, 2024
@apjanke
Copy link
Collaborator Author

apjanke commented Aug 21, 2024

Think I fixed that "ignoring bogus filename" warning in c1abdae.

@apjanke apjanke changed the title man page to section 6? man page to section 6 ("games")? Aug 21, 2024
@apjanke apjanke changed the title man page to section 6 ("games")? move man pages to section 6 ("games")? Aug 26, 2024
@apjanke apjanke changed the title move man pages to section 6 ("games")? Move man pages to section 6 ("games")? Aug 26, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement Make stuff better!
Projects
Status: Todo
Development

No branches or pull requests

1 participant