jeaye / stdman

Formatted C++20 stdlib man pages (cppreference)

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

No manual entry for member functions

heirish opened this issue · comments

Hi, i have a problem when using stdman.
I can only get man page of the class,
and get "no manual entry" message for all the member functions.

~$ man std::string::c_str
No manual entry for std::string::c_str

I refered to issue #22, and followed the Troubleshooting in README file.
still can not get it work. Could you help to check it?

  • os
~$ lsb_release -a
No LSB modules are available.
Distributor ID:	Ubuntu
Description:	Ubuntu 16.04.2 LTS
Release:	16.04
Codename:	xenial
  • the last few lines of man std::string
    image
  • files in install dir
~$ ls -ltr /usr/local/share/man/man3 | grep "std::string"
-rw-r--r-- 1 root root  534 Apr 11 22:04 std::hash(std::string_view,std::wstring_view,std::u16string_view,std::u32string_view).3.gz
-rw-r--r-- 1 root root  767 Apr 11 22:04 std::hash(std::string,std::wstring,std::u16string,std::u32string,std::pmr::string,.3.gz
-rw-r--r-- 1 root root 2603 Apr 11 22:04 std::string.3.gz
-rw-r--r-- 1 root root 2946 Apr 11 22:04 std::stringstream.3.gz
-rw-r--r-- 1 root root 2195 Apr 11 22:04 std::stringbuf.3.gz
-rw-r--r-- 1 root root  529 Apr 11 22:04 std::stringstream::operator=.3.gz
-rw-r--r-- 1 root root  319 Apr 11 22:04 std::stringstream::rdbuf.3.gz
-rw-r--r-- 1 root root  464 Apr 11 22:04 std::stringstream::swap.3.gz
  • configure in .bashrc
~$ cat ~/.bashrc | tail -n 2
export MANPAGER="/bin/sh -c \"col -b | vim -c 'set ft=man ts=8 nomod nolist nonu noma' -\""
export MANPATH=/usr/local/man:/usr/local/share/man:/usr/share/man:/usr/man
commented

I also encountered the same problem, this is because there is only template class in the newly generated man file, and std::string is an alias of std::basic_string<CharT,Traits,Allocator>. So you can try man 'std::basic_string<CharT,Traits,Allocator>::find'.
I renamed these man files with a script and put them in my own branch. With my changes everything became normal.

@jeaye
Will you accept my method, if so, I will submit a pull request

I'm up for supporting the aliases. Note that I don't use C++ or stdman anymore, which is why there've been no updates from me in this repo. It's great to have people willing to contribute, though, so please do make the man pages as user friendly as they can be.

I'm up for supporting the aliases. Note that I don't use C++ or stdman anymore, which is why there've been no updates from me in this repo. It's great to have people willing to contribute, though, so please do make the man pages as user friendly as they can be.

I don't have any idea of how creating manpages but it would be nice to find a volunteer with knowledge to maintain this project maybe, what do you think?

I don't think a fork is necessary. If you're making regular PRs, I can add you as a contributor. We already have a lot of people coming to this repo and splitting that audience isn't going to help.

By that I mean, there are no open PRs right now. The PRs which have come in have been merged. If you want to fork and make some changes, why not just make some PRs to start and then I can add you as a contributor if things pick up?

I haven't abandoned the project, I'm just not actively developing it anymore. I would certainly still like to see it succeed.

commented

Glad to see that you haven't abandoned it. I will hide the fork project now.