C++ 98/11/14 manual pages for Linux/MacOS

I've tried to install cppman in Fedora 19 or Linux mint 15 and it installs successfully.

pip install cppman -> succesfully installed

But when I try to use it I get the error:

cppman cout -> output is

Python IOError: [Errno 13] Permission denied

trying sudo will not help.

I've installed it in Ubuntu 12.04 and had no problem.

I ran cppman -c and then cppman -m true but man and apropos still cannot find any cpp man pages. I have verified that the man pages are indeed in my filesystem (i.e. the cppman -c command worked).

When trying to double click, or press enter, on a function name in the page. The following error message is displayed in the vim buffer.

Error Message: error: [Errno 19] Operation not supported by device.

Relevant Software Versions:

• usr/local/bin/cppman Ver 0.4.6
• NVIM 0.1.1 (compiled Dec 27 2015 16:32:11)

Pressing q does not quit cppman as in man. Instead, the command :q!<CR> appears at the bottom of the screen. To quit, you must delete the <CR> part and press Enter. Tested with:

• cppman 0.4.5
• vim 7.4

Thanks for your attention.

I did the cppman -m true command to be able to use the man command to view c++ man pages. However, I noticed that some pages related to C have been replaced by the version coming from cplusplus.com

For example, the strtok "normal" man page is no longer available. With man strtok, I get the cplusplus.com version.

Is there a way to add only the man pages specific to C++, and keep the man pages of C functions as they were before ?

OS: Debian 7.4
Vim version: 7.4.444

%cppman std::vector
col: Invalid or incomplete multibyte or wide character
sed: couldn't write 568 items to stdout: Broken pipe

Vim: Reading from stdin...

Works alright when I change the pager to 'less'

$ cppman -s cppreference.com std::cout
Source set to `cppreference.com'.

$ cppman std::cout
error: bad escape \e at position 0

$ cppman -C
$ cppman -s cppreference.com -r
Source set to `cppreference.com'.

$ cppman -c -o 
By default, cppman fetches pages on-the-fly if corresponding page is not found in the cache. The "cache-all" option is only useful if you want to view man pages offline. Caching all contents will take several minutes, do you want to contin
ue [y/N]? y
Caching manpages from cppreference.com ...
Caching std::numeric_limits::round_error ...
Retrying ...
Retrying ...
Retrying ...
Error caching std::numeric_limits::round_error ...
Caching C++ concepts: Destructible ...
Retrying ...
Retrying ...
Retrying ...
Error caching C++ concepts: Destructible ...
Caching Move constructors ...
Retrying ...
Retrying ...
Retrying ...
Error caching Move constructors ...
Caching std::pow(std::valarray) ...
Retrying ...
Retrying ...
Retrying ...
Error caching std::pow(std::valarray) ...
Caching std::recursive_mutex::try_lock ...
Retrying ...
^C
Aborted.

It seems that cppman is having problems parsing pages from cppreference, my browser can access cppreference fairly quickly

$ ping en.cppreference.com                                                                                                                                                                                                   
PING en.cppreference.com (74.114.90.46) 56(84) bytes of data.
64 bytes from cppreference.com (74.114.90.46): icmp_seq=1 ttl=47 time=250 ms
64 bytes from cppreference.com (74.114.90.46): icmp_seq=2 ttl=47 time=181 ms
64 bytes from cppreference.com (74.114.90.46): icmp_seq=3 ttl=47 time=203 ms
64 bytes from cppreference.com (74.114.90.46): icmp_seq=4 ttl=47 time=227 ms
64 bytes from cppreference.com (74.114.90.46): icmp_seq=5 ttl=47 time=248 ms
64 bytes from cppreference.com (74.114.90.46): icmp_seq=6 ttl=47 time=170 ms
^C
--- en.cppreference.com ping statistics ---
6 packets transmitted, 6 received, 0% packet loss, time 5005ms
rtt min/avg/max/mdev = 169.600/213.190/250.107/31.174 ms

Edit:

$ cppman --version
/usr/bin/cppman Ver 0.4.9
Copyright (C) 2010 Wei-Ning Huang
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Written by Wei-Ning Huang (AZ) <[email protected]>.

cppman is not compatibility with python 3.3, there are two man issuses:

1. print is function in python 3.3.
2. except XXError, e: and except (XXError, YYError), e: should be change to except XXError as e: except (XXError, YYError) as e:

$ cppman --version
/usr/local/bin/cppman Ver 0.4.9
Copyright (C) 2010 Wei-Ning Huang
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Written by Wei-Ning Huang (AZ) <[email protected]>.
$ cppman override
No manual entry for override
$ cppman final
No manual entry for final

Currently, cppman fails on Windows (I use MSYS2) with the following error:

Traceback (most recent call last):
  File "C:/msys64/mingw64/bin/cppman", line 40, in <module>
    from cppman.main import Cppman
  File "C:/msys64/mingw64/lib/python3.7/site-packages\cppman\main.py", line 36, in <module>
    from cppman import util
  File "C:/msys64/mingw64/lib/python3.7/site-packages\cppman\util.py", line 25, in <module>
    import fcntl
ModuleNotFoundError: No module named 'fcntl'

This answer on StackOverflow mentions a cross-platform module that could be used instead of fcntl, and could therefore make cppman compatible (or at least more compatible) with Windows (and by extension MSYS2).

Is there a way to point cppman to an offline version of cppreference locally? You can download offline archives via here : http://en.cppreference.com/w/Cppreference:Archives so that I don't have to cache all pages , and it works offline too.

Hi, all of a sudden I started getting broken pipe errors:

/opt/homebrew/bin/cppman Ver 0.5.4
Copyright (C) 2010 Wei-Ning Huang
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Written by Wei-Ning Huang (AZ) <[email protected]>.

From this command for example:

 cppman std::list

gzip: stdout: Broken pipe

I'm on MacOS 13.0.1 (22A400) on an M2 macbook

Just downloaded and found that I was getting empty pages for everything. The solution was to switch to less for the pager. Apparently this has happened before, e.g. #32, #103. Because vim/neovim are a lot more complicated than less, not even counting all the plugins that may be installed, I think it would make more sense to use less by default, like man does. Unless there was a specific reason why vim was chosen as the default pager?

Some info about my setup where I was getting empty pages:

/bin/cppman Ver 0.5.3
Copyright (C) 2010 Wei-Ning Huang
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Written by Wei-Ning Huang (AZ) <[email protected]>.

My vim was aliased to neovim:

NVIM v0.8.1
Build type: Release
LuaJIT 2.1.0-beta3
Compiled by void-buildslave@a-fsn-de

Features: +acl +iconv +tui
See ":help feature-compile"

   system vimrc file: "$VIM/sysinit.vim"
  fall-back for $VIM: "/usr/share/nvim"

Run :checkhealth for more info

occurs with two files (>255 characters) :

• cppreference.com/std::experimental::ranges::input_iterator_tag, std::experimental::ranges::output_iterator_tag, std::experimental::ranges::forward_iterator_tag, std::experimental::ranges::bidirectional_iterator_tag, std::experimental::ranges::random_access_iterator_tag.3.gz
• cppreference.com/std::filesystem::path::has_root_path, std::filesystem::path::has_root_name, std::filesystem::path::has_root_directory, std::filesystem::path::has_relative_path, std::filesystem::path::has_parent_path, std::filesystem::path::has_filename, std::filesystem::path::has_stem, std::filesystem::path::has_extension.3.gz

I installed on Ubuntu 20.04 via apt-get. I noticed that man -k --regex '[Ss]ame' didn't find std::same_as or std::Same, while man std::Same worked. So there may be something weird about my installation. In any case man std::ostream work as expected, cppman std::ostream did not. The name is an exact match, but I assume some kind of fuzzy matching or completion went wrong. Can anyone reproduce this?

cppman doesn't work in debian:

$ cppman -v
/usr/bin/cppman Ver 0.5.3
Copyright (C) 2010 Wei-Ning Huang
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

Written by Wei-Ning Huang (AZ) <[email protected]>.

$ cppman -c
By default, cppman fetches pages on-the-fly if corresponding page is not found in the cache. The "cache-all" option is only useful if you want to view man pages offline. Caching all contents will take several minutes, do you want to continue [y/N]? y
Caching manpages from cppreference.com ...
error: no such column: title