- Can install and uninstall a simple package with manual pages on Linux.
- Not tested on macOS or Windows.
- Tests not updated yet.

A function call to expose_resources_globally with a duplicate argument.

- Add a new MAN_SECTIONS constant.
- Loop over MAN_SECTIONS instead of range(1, 10) when iterating man sections.
- _dfs_package_resources and get_resources now return a nested list for apps
  and man pages together.

This fixes something which might be a small bug in the original code, but also
affecting the man pages exposition. Post-installation, pipx prints "These apps
are now globally available", followed by a list of app names. However, if all
of the apps are unavailable (`exposed_binary_names` is empty and
`unavailable_binary_names` is non-empty), "These apps are now globally
available" is not printed, when it probably should. In this case, the list of
unavailable apps is printed regardless and appears somewhat out of context.
The same issue affects printing of exposed and unavailable man pages.

When symbolic links are not available (e.g. on Windows),
`get_exposed_man_paths_for_package` failed to produce results because it called
`get_exposed_paths_for_package` with an incorrect list of man pages. Items in
this list errornously included the `man<i>` path prefix.

This is to satisfy the linter. The new functions are:

- get_apps_from_entry_points
- get_resources_from_dist_files
- get_resources_from_inst_files

get_resources simply collectes the results from the above functions. The
functionality is unchanged.

The man pages code used the str.removeprefix method which does not exist in
older Python versions.

can_symlink could prevously be called without the directory existing yet,
resulting in an error. Also the symlink check was performed on the "man"
directory instead of individually on the "man/man<i>" subdirectories.

_copy_package_resources is now _copy_package_resource and called per path from
expose_resources_globally.

_symlink_package_resources is removed, and instead _symlink_package_resource
is called per path directly from expose_resources_globally.

expose_resources_globally creates the destination directory before calling
can_symlink, which fixes the error.

can_symlink is called in _get_venv_resource_paths on local_resource_dir which
might not exist. Test first if the directory exists.

Co-authored-by: Tzu-ping Chung <[email protected]>

- Add new bullet points to the "How it Works" section.
- Add description of how to use data_files with manual pages in setup.py to the
  "Developing for pipx" section.
- Add description to the pipx install command help.

Co-authored-by: chrysle <[email protected]>

Co-authored-by: chrysle <[email protected]>

Co-authored-by: chrysle <[email protected]>

Co-authored-by: chrysle <[email protected]>

Mention that --include-apps also exposes manual pages.

- pipx output was not correctly parsed now that a list of manual pages is also
  printed.
- LOCAL_MAN_DIR was not monkey patched. As a result, manual pages were
  installed under ~/.local instead of a temporary directory.

For now this is only enabled for the packages pycowsay and youtube-dl.

Also update remaining pycowsay references to version 0.0.0.2.

This is to fix tests on Windows.

These have been introduced accidentaly.

2.1.10 fails under macos.