NAME

       cppman - C++ manual page viewer / fetcher

SYNOPSIS

       cppman [ OPTIONS...  ] PAGE...

DESCRIPTION

       cppman  generates  C++ manual pages from cplusplus.com and provide a man-like interface to
       view man pages.

       By default, cppman fetches man pages on-the-fly, by running the command 'cppman  -c',  all
       available  manpages are cached, making offline browsing possible. This is also required if
       you want to use the system 'man' command.

   Browsing man pages
       cppman uses Vi Improved as a pager.
       Press 'q' to leave pager.  Press 'K' on an entry like 'vector::insert(3)' links you to the
       manual page of vector::insert, like a hyperlink.

   man compatibility
       cppman  automatically  adds  '~/.local/share/man' to '~/.manpath', so the cached man pages
       can also be viewed with 'man' command. Note that to view uncached  man  pages,  you  still
       need to run 'cppman'.

OPTIONS

       -s SOURCE, --source=SOURCE
              Select   source,   either   'cppreference.com'   or   'cplusplus.com'.  Default  is
              'cplusplus.com'.

       -c, --cache-all
              cache all available man pages from cplusplus.com to enable offline browsing

       -C, --clear-cache
              clear all cached files

       -f KEYWORD, --find-page=KEYWORD
              find man page

       -o, --force-update
              force cppman to update existing cache when '--cache-all' or browsing man pages that
              were already cached

       -m MANDB, --use-mandb=MANDB
              Accepts  'true'  or 'false'. If true, cppman adds manpage path to mandb so that you
              can view C++ manpages with `man' command. The default value is 'false'.

       -p PAGER, --pager=PAGER
              Select pager to use, accepts 'vim' or 'less'. The default value is 'vim'.

       -r, --rebuild-index
              rebuild index database from cplusplus.com

       -v, --version
              show version information

       -h, --help
              show this help message and exit

NOTE

       All contents should be cached  by  the  user,  cppman  does  not  contain  any  pre‐cached
       contents.

       Do not distribute the cached man pages without the permission of cplusplus.com.

BUGS

       Although  I  spend  a  lot  of  time checking the format, there are still pages that won't
       display correctly.
       Feel free to report bugs at:

       https://github.com/aitjcize/cppman/issues or
       mailto:aitjcize@gmail.com.

       Please include the page name in the bug report.

AUTHOR

       Wei‐Ning Huang (AZ) <aitjcize@gmail.com>