search

pyproj4 / pyproj

Python interface to PROJ (cartographic projections and coordinate transformations library)
https://pyproj4.github.io/pyproj
MIT License
1.04k stars 211 forks source link

DOC: 3.4.0: sphinx warnings `reference target not found` #1146

Open kloczek opened 1 year ago

kloczek commented 1 year ago

First of all currently it is not possible to use straight sphinx-build command to build documentation out of source tree

```console + /usr/bin/sphinx-build -n -T -b man docs build/sphinx/man Running Sphinx v5.1.1 Traceback (most recent call last): File "/usr/lib/python3.8/site-packages/sphinx/config.py", line 347, in eval_config_file exec(code, namespace) File "/home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/conf.py", line 39, in version = release = importlib.metadata.version("pyproj") File "/usr/lib64/python3.8/importlib/metadata.py", line 530, in version return distribution(distribution_name).version File "/usr/lib64/python3.8/importlib/metadata.py", line 503, in distribution return Distribution.from_name(distribution_name) File "/usr/lib64/python3.8/importlib/metadata.py", line 177, in from_name raise PackageNotFoundError(name) importlib.metadata.PackageNotFoundError: pyproj The above exception was the direct cause of the following exception: Traceback (most recent call last): File "/usr/lib/python3.8/site-packages/sphinx/cmd/build.py", line 272, in build_main app = Sphinx(args.sourcedir, args.confdir, args.outputdir, File "/usr/lib/python3.8/site-packages/sphinx/application.py", line 201, in __init__ self.config = Config.read(self.confdir, confoverrides or {}, self.tags) File "/usr/lib/python3.8/site-packages/sphinx/config.py", line 169, in read namespace = eval_config_file(filename, tags) File "/usr/lib/python3.8/site-packages/sphinx/config.py", line 360, in eval_config_file raise ConfigError(msg % traceback.format_exc()) from exc sphinx.errors.ConfigError: There is a programmable error in your configuration file: Traceback (most recent call last): File "/usr/lib/python3.8/site-packages/sphinx/config.py", line 347, in eval_config_file exec(code, namespace) File "/home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/conf.py", line 39, in version = release = importlib.metadata.version("pyproj") File "/usr/lib64/python3.8/importlib/metadata.py", line 530, in version return distribution(distribution_name).version File "/usr/lib64/python3.8/importlib/metadata.py", line 503, in distribution return Distribution.from_name(distribution_name) File "/usr/lib64/python3.8/importlib/metadata.py", line 177, in from_name raise PackageNotFoundError(name) importlib.metadata.PackageNotFoundError: pyproj Configuration error: There is a programmable error in your configuration file: Traceback (most recent call last): File "/usr/lib/python3.8/site-packages/sphinx/config.py", line 347, in eval_config_file exec(code, namespace) File "/home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/conf.py", line 39, in version = release = importlib.metadata.version("pyproj") File "/usr/lib64/python3.8/importlib/metadata.py", line 530, in version return distribution(distribution_name).version File "/usr/lib64/python3.8/importlib/metadata.py", line 503, in distribution return Distribution.from_name(distribution_name) File "/usr/lib64/python3.8/importlib/metadata.py", line 177, in from_name raise PackageNotFoundError(name) importlib.metadata.PackageNotFoundError: pyproj ```

This can be fixed by patch like below:

--- a/docs/conf.py
+++ b/docs/conf.py
@@ -1,5 +1,7 @@
 import importlib.metadata
+import sys
 import os
+sys.path.insert(0, os.path.abspath(".."))

 # Sphinx extensions
 extensions = [

This patch fixes what is in the comment and that can of fix is suggested in sphinx example copy.py https://www.sphinx-doc.org/en/master/usage/configuration.html#example-of-configuration-file This patch allows build documentation without have pyproj module installed ad it guarantees as well that documentation will be generated out of module from source tree and not from installed module (which may be in different version).

Than .. looks like in conf.py is only entry to generate pyproj(1) man page so I've added below patch to generate module documentation as well

--- a/docs/conf.py
+++ b/docs/conf.py
@@ -64,4 +65,19 @@
.
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
-man_pages = [("cli", "pyproj", "pyproj CLI", [author], 1)]
+man_pages = [
+    (
+        "cli",
+        "pyproj",
+        "pyproj CLI",
+        author,
+        1,
+    ),
+    (
+        "index",
+        "pyproj",
+        "pyproj Python Module Documentation",
+        author,
+        3,
+    )
+]

Than .. on building my packages I'm using sphinx-build command with -n switch which shows warmings about missing references. These are not critical issues.

Here is the output with warnings:

```console + /usr/bin/sphinx-build -n -T -b man docs build/sphinx/man Running Sphinx v5.1.1 making output directory... done loading intersphinx inventory from https://numpy.org/doc/stable/objects.inv... loading intersphinx inventory from https://pandas.pydata.org/docs/objects.inv... loading intersphinx inventory from https://proj.org/objects.inv... loading intersphinx inventory from https://docs.python.org/3/objects.inv... loading intersphinx inventory from https://shapely.readthedocs.io/en/stable/objects.inv... loading intersphinx inventory from https://docs.xarray.dev/en/stable/objects.inv... building [mo]: targets for 0 po files that are out of date building [man]: all manpages updating environment: [new config] 33 added, 0 changed, 0 removed reading sources... [100%] transformation_grids WARNING: autodoc: failed to import class 'aoi.AreaOfInterest' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'aoi.AreaOfUse' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'aoi.BBox' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.CoordinateOperation' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class '_crs.Param' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class '_crs.Grid' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.AlbersEqualAreaConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.AzimuthalEquidistantConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.EquidistantCylindricalConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.GeostationarySatelliteConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.LambertAzimuthalEqualAreaConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.LambertConformalConic1SPConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.LambertConformalConic2SPConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.LambertCylindricalEqualAreaConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.LambertCylindricalEqualAreaScaleConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.MercatorAConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.MercatorBConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.HotineObliqueMercatorBConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.OrthographicConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.PlateCarreeConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.PolarStereographicAConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.PolarStereographicBConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.SinusoidalConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.StereographicConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.UTMConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.TransverseMercatorConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.VerticalPerspectiveConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.RotatedLatitudeLongitudeConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.PoleRotationNetCDFCFConversion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_operation.ToWGS84Transformation' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.CoordinateSystem' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class '_crs.Axis' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_system.Ellipsoidal2DCS' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_system.Ellipsoidal3DCS' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_system.Cartesian2DCS' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.coordinate_system.VerticalCS' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.CRS' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.GeographicCRS' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.DerivedGeographicCRS' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.GeocentricCRS' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.ProjectedCRS' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.VerticalCRS' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.BoundCRS' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.CompoundCRS' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.CustomConstructorCRS' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'crs.is_wkt' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'crs.is_proj' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.Datum' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.datum.CustomDatum' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.Ellipsoid' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.datum.CustomEllipsoid' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.PrimeMeridian' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.datum.CustomPrimeMeridian' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.enums.DatumType' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.enums.CoordinateOperationType' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.enums.Cartesian2DCSAxis' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.enums.Ellipsoidal2DCSAxis' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.enums.Ellipsoidal3DCSAxis' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'crs.enums.VerticalCSAxis' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'database.get_units_map' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'database.Unit' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'database.get_authorities' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'database.get_codes' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'database.query_crs_info' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'database.CRSInfo' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'database.query_utm_crs_info' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'database.get_database_metadata' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'datadir.get_data_dir' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'datadir.set_data_dir' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'datadir.append_data_dir' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'datadir.get_user_data_dir' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'enums.WktVersion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'enums.ProjVersion' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'enums.TransformDirection' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'enums.PJType' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'enums.GeodIntermediateFlag' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import module 'exceptions' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'Geod' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'geod.GeodIntermediateReturn' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'set_use_global_context' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'list.get_proj_operations_map' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'list.get_ellps_map' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'list.get_prime_meridians_map' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'network.set_network_enabled' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'network.is_network_enabled' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'network.set_ca_bundle_path' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'Proj' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'proj.Factors' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'show_versions' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'sync.get_transform_grid_list' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'sync.get_proj_endpoint' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'transformer.Transformer' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import class 'transformer.TransformerGroup' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'transformer.transform' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' WARNING: autodoc: failed to import function 'transformer.itransform' from module 'pyproj'; the following exception was raised: No module named 'pyproj._network' /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/cli.rst:4: ERROR: Failed to import "parser" from "pyproj.__main__". No module named 'pyproj._network' looking for now-outdated files... none found pickling environment... done checking consistency... done writing... pyproj.1 { } python-pyproj.3 { installation examples transformation_grids gotchas api/index api/crs/index api/crs/crs api/crs/coordinate_system api/crs/coordinate_operation api/crs/datum api/crs/enums api/transformer api/geod api/proj api/database api/list api/datadir api/network api/sync api/global_context api/enums api/aoi api/exceptions api/show_versions cli advanced_examples build_crs build_crs_cf crs_compatibility optimize_transformations history past_versions } /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/examples.rst:14: WARNING: py:class reference target not found: pyproj.crs.CRS /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/examples.rst:19: WARNING: py:class reference target not found: pyproj.crs.CRS /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/examples.rst:130: WARNING: py:class reference target not found: pyproj.crs.CRS /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/examples.rst:236: WARNING: py:class reference target not found: pyproj.crs.CRS /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/examples.rst:285: WARNING: py:class reference target not found: pyproj.transformer.Transformer /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/examples.rst:285: WARNING: py:meth reference target not found: pyproj.crs.CRS.from_user_input /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/examples.rst:285: WARNING: py:class reference target not found: pyproj.transformer.Transformer /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/examples.rst:395: WARNING: py:class reference target not found: pyproj.Geod /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/examples.rst:401: WARNING: py:class reference target not found: pyproj.Geod /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/examples.rst:401: WARNING: py:class reference target not found: pyproj.crs.CRS /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/examples.rst:418: WARNING: py:meth reference target not found: pyproj.Geod.line_length /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/examples.rst:432: WARNING: py:meth reference target not found: pyproj.Geod.geometry_length /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/examples.rst:448: WARNING: py:meth reference target not found: pyproj.Geod.polygon_area_perimeter /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/examples.rst:463: WARNING: py:meth reference target not found: pyproj.Geod.geometry_area_perimeter /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/transformation_grids.rst:88: WARNING: py:obj reference target not found: pyproj.crs.CRS /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/transformation_grids.rst:88: WARNING: py:obj reference target not found: pyproj.Geod /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/transformation_grids.rst:100: WARNING: py:class reference target not found: pyproj.transformer.TransformerGroup /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/gotchas.rst:73: WARNING: py:class reference target not found: pyproj.Proj /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/gotchas.rst:73: WARNING: py:class reference target not found: pyproj.transformer.Transformer /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/gotchas.rst:99: WARNING: py:class reference target not found: pyproj.transformer.Transformer /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/gotchas.rst:128: WARNING: py:class reference target not found: pyproj.Proj /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/gotchas.rst:199: WARNING: py:meth reference target not found: pyproj.crs.CRS.to_epsg /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/gotchas.rst:199: WARNING: py:meth reference target not found: pyproj.crs.CRS.to_authority /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/gotchas.rst:257: WARNING: py:func reference target not found: pyproj.datadir.get_data_dir /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/gotchas.rst:258: WARNING: py:func reference target not found: pyproj.datadir.get_data_dir /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/gotchas.rst:260: WARNING: py:func reference target not found: pyproj.datadir.set_data_dir /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/gotchas.rst:268: WARNING: py:class reference target not found: pyproj.transformer.Transformer /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/gotchas.rst:268: WARNING: py:class reference target not found: pyproj.crs.CRS /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/gotchas.rst:268: WARNING: py:class reference target not found: pyproj.Proj /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/gotchas.rst:268: WARNING: py:meth reference target not found: pyproj.transformer.transform /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/gotchas.rst:276: WARNING: py:meth reference target not found: pyproj.transformer.transform /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/gotchas.rst:276: WARNING: py:meth reference target not found: pyproj.transformer.itransform /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/api/transformer.rst:14: WARNING: py:class reference target not found: pyproj.crs.CRS /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/api/transformer.rst:14: WARNING: py:class reference target not found: pyproj.transformer.Transformer /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/api/global_context.rst:16: WARNING: py:func reference target not found: pyproj.set_use_global_context /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/advanced_examples.rst:17: WARNING: py:class reference target not found: pyproj.transformer.Transformer /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/advanced_examples.rst:30: WARNING: py:func reference target not found: pyproj.transformer.transform /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/advanced_examples.rst:38: WARNING: py:class reference target not found: pyproj.transformer.Transformer /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/advanced_examples.rst:58: WARNING: py:class reference target not found: pyproj.transformer.TransformerGroup /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/advanced_examples.rst:180: WARNING: py:class reference target not found: pyproj.crs.CRS /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/advanced_examples.rst:181: WARNING: py:class reference target not found: pyproj.transformer.Transformer /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/advanced_examples.rst:226: WARNING: py:class reference target not found: pyproj.transformer.Transformer /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/advanced_examples.rst:226: WARNING: py:class reference target not found: pyproj.crs.CRS /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/build_crs.rst:11: WARNING: py:meth reference target not found: pyproj.transformer.Transformer.from_crs /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/build_crs.rst:11: WARNING: py:class reference target not found: pyproj.crs.CRS /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/build_crs_cf.rst:25: WARNING: py:meth reference target not found: pyproj.crs.CRS.to_cf /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/build_crs_cf.rst:49: WARNING: py:meth reference target not found: pyproj.crs.CRS.cs_to_cf /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/crs_compatibility.rst:4: WARNING: py:class reference target not found: pyproj.crs.CRS /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/crs_compatibility.rst:193: WARNING: py:meth reference target not found: pyproj.crs.CRS.from_user_input /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:9: WARNING: py:class reference target not found: TransformerGroup /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:10: WARNING: py:class reference target not found: TransformerGroup /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:11: WARNING: py:meth reference target not found: Transformer.from_crs /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:12: WARNING: py:meth reference target not found: Transformer.get_last_used_operation /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:13: WARNING: py:meth reference target not found: CRS.from_cf /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:14: WARNING: py:meth reference target not found: CRS.to_dict /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:15: WARNING: py:class reference target not found: MercatorAConversion /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:28: WARNING: py:func reference target not found: pyproj.datadir.get_data_dir /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:29: WARNING: py:meth reference target not found: pyproj.crs.CRS.to_wkt /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:29: WARNING: py:meth reference target not found: pyproj.crs.CRS.to_proj4 /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:29: WARNING: py:meth reference target not found: pyproj.crs.CRS.to_json /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:31: WARNING: py:class reference target not found: pyproj.transformer.Transformer /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:39: WARNING: py:meth reference target not found: pyproj.transformer.Transformer.transform_bounds /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:41: WARNING: py:meth reference target not found: pyproj.transformer.Transformer.transform_bounds /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:42: WARNING: py:attr reference target not found: pyproj.transformer.Transformer.source_crs /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:42: WARNING: py:attr reference target not found: pyproj.transformer.Transformer.target_crs /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:43: WARNING: py:class reference target not found: pyproj.crs.coordinate_operation.PoleRotationNetCDFCFConversion /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:44: WARNING: py:func reference target not found: pyproj.database.get_database_metadata /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:45: WARNING: py:func reference target not found: pyproj.show_versions /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:51: WARNING: py:attr reference target not found: pyproj.crs.CRS.list_authority /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:61: WARNING: py:attr reference target not found: pyproj.crs.CRS.is_derived /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:62: WARNING: py:attr reference target not found: pyproj.crs.GeocentricCRS /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:63: WARNING: py:attr reference target not found: pyproj.crs.CRS.list_authority /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:64: WARNING: py:meth reference target not found: pyproj.transformer.Transformer.transform /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:68: WARNING: py:class reference target not found: pyproj.crs.coordinate_operation.AzimuthalEquidistantConversion /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:68: WARNING: py:class reference target not found: pyproj.crs.coordinate_operation.LambertAzimuthalEqualAreaConversion /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:71: WARNING: py:func reference target not found: pyproj.database.query_utm_crs_info /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:72: WARNING: py:class reference target not found: pyproj.enums.GeodIntermediateFlag /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:75: WARNING: py:meth reference target not found: pyproj.crs.CRS.is_exact_same /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:87: WARNING: py:meth reference target not found: pyproj.transformer.Transformer.to_proj4 /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:88: WARNING: py:meth reference target not found: pyproj.transformer.Transformer.from_crs /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:89: WARNING: py:meth reference target not found: pyproj.transformer.Transformer.from_pipeline /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:90: WARNING: py:meth reference target not found: pyproj.crs.CRS.to_3d /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:91: WARNING: py:meth reference target not found: pyproj.transformer.Transformer.transform_bounds /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:92: WARNING: py:attr reference target not found: pyproj.crs.CRS.is_compound /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:93: WARNING: py:meth reference target not found: pyproj.Geod.npts /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:94: WARNING: py:meth reference target not found: pyproj.Geod.inv_intermediate /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:94: WARNING: py:meth reference target not found: pyproj.Geod.fwd_intermediate /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:114: WARNING: py:func reference target not found: pyproj.datadir.get_user_data_dir /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:115: WARNING: py:attr reference target not found: pyproj.transformer.Transformer.is_network_enabled /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:116: WARNING: py:meth reference target not found: pyproj.transformer.TransformerGroup.download_grids /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:117: WARNING: py:func reference target not found: pyproj.database.get_units_map /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:117: WARNING: py:func reference target not found: pyproj.database.get_codes /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:127: WARNING: py:func reference target not found: pyproj.database.query_crs_info /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:128: WARNING: py:func reference target not found: pyproj.database.query_utm_crs_info /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:137: WARNING: py:meth reference target not found: pyproj.crs.CRS.from_cf /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:141: WARNING: py:meth reference target not found: pyproj.Proj.get_factors /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:146: WARNING: py:meth reference target not found: pyproj.Proj.get_factors /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:149: WARNING: py:attr reference target not found: pyproj.crs.CRS.axis_info /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:150: WARNING: py:meth reference target not found: pyproj.transformer.Transform.__eq__ /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:151: WARNING: py:attr reference target not found: pyproj.crs.CRS.utm_zone /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:160: WARNING: py:meth reference target not found: pyproj.crs.CRS.equals /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:161: WARNING: py:meth reference target not found: pyproj.crs.CoordinateSystem.from_json /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:161: WARNING: py:meth reference target not found: pyproj.crs.CoordinateSystem.from_json_dict /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:161: WARNING: py:meth reference target not found: pyproj.crs.CoordinateSystem.from_string /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:162: WARNING: py:class reference target not found: pyproj.crs.CoordinateSystem /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:163: WARNING: py:meth reference target not found: pyproj.crs.CoordinateSystem.from_user_input /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:163: WARNING: py:meth reference target not found: pyproj.crs.CoordinateOperation.from_user_input /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:163: WARNING: py:meth reference target not found: pyproj.crs.Datum.from_user_input /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:163: WARNING: py:meth reference target not found: pyproj.crs.PrimeMeridian.from_user_input /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:163: WARNING: py:meth reference target not found: pyproj.crs.Ellipsoid.from_user_input /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:164: WARNING: py:meth reference target not found: pyproj.crs.CoordinateSystem.from_name /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:164: WARNING: py:meth reference target not found: pyproj.crs.CoordinateOperation.from_name /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:164: WARNING: py:meth reference target not found: pyproj.crs.Datum.from_name /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:164: WARNING: py:meth reference target not found: pyproj.crs.PrimeMeridian.from_name /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:164: WARNING: py:meth reference target not found: pyproj.crs.Ellipsoid.from_name /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:165: WARNING: py:attr reference target not found: pyproj.crs.Ellipsoid.semi_minor_metre /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:173: WARNING: py:meth reference target not found: pyproj.crs.CRS.to_proj4 /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:181: WARNING: py:meth reference target not found: pyproj.crs.CRS.from_cf /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:181: WARNING: py:meth reference target not found: pyproj.crs.CRS.to_cf /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:194: WARNING: py:func reference target not found: pyproj.get_authorities /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:194: WARNING: py:func reference target not found: pyproj.get_codes /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:210: WARNING: py:meth reference target not found: pyproj.Geod.polygon_area_perimeter /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:210: WARNING: py:meth reference target not found: pyproj.Geod.line_length /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:210: WARNING: py:meth reference target not found: pyproj.Geod.line_lengths /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:213: WARNING: py:meth reference target not found: pyproj.Geod.geometry_area_perimeter /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:213: WARNING: py:meth reference target not found: pyproj.Geod.geometry_length /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:217: WARNING: py:class reference target not found: pyproj.transformer.TransformerGroup /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:218: WARNING: py:meth reference target not found: pyproj.transformer.Transformer.from_crs /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:218: WARNING: py:meth reference target not found: pyproj.transformer.Transformer.from_proj /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:218: WARNING: py:class reference target not found: pyproj.transformer.TransformerGroup /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:220: WARNING: py:attr reference target not found: pyproj.transformer.Transformer.area_of_use /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:221: WARNING: py:attr reference target not found: pyproj.crs.CoordinateOperation.area_of_use /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:232: WARNING: py:meth reference target not found: pyproj.crs.is_proj /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:233: WARNING: py:meth reference target not found: pyproj.crs.CRS.to_dict /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:233: WARNING: py:meth reference target not found: pyproj.crs.CRS.to_proj4 /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:237: WARNING: py:meth reference target not found: pyproj.crs.CRS.to_cf /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:241: WARNING: py:meth reference target not found: pyproj.show_versions /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:254: WARNING: py:meth reference target not found: pyproj.crs.CRS.to_cf /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:254: WARNING: py:meth reference target not found: pyproj.crs.CRS.from_cf /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:256: WARNING: py:meth reference target not found: pyproj.crs.CRS.to_dict /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:257: WARNING: py:meth reference target not found: pyproj.crs.CRS.to_authority /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:258: WARNING: py:attr reference target not found: pyproj.crs.CRS.is_vertical /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:258: WARNING: py:attr reference target not found: pyproj.crs.CRS.is_engineering /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:259: WARNING: py:attr reference target not found: pyproj.crs.CRS.target_crs /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:260: WARNING: py:attr reference target not found: pyproj.crs.CRS.to_wkt /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:261: WARNING: py:attr reference target not found: pyproj.crs.CRS.is_geographic /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:261: WARNING: py:attr reference target not found: pyproj.crs.CRS.is_projected /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:262: WARNING: py:attr reference target not found: pyproj.crs.CRS.is_geocentric /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:263: WARNING: py:meth reference target not found: pyproj.crs.CRS.from_user_input /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:267: WARNING: py:meth reference target not found: pyproj.crs.CRS.to_epsg /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:274: WARNING: py:meth reference target not found: pyproj.transformer.Transformer.transform /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:276: WARNING: py:meth reference target not found: pyproj.transformer.Transformer.to_wkt /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:277: WARNING: py:meth reference target not found: pyproj.transformer.Transformer.from_crs /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:279: WARNING: py:class reference target not found: pyproj.Proj /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:302: WARNING: py:func reference target not found: pyproj.transformer.transform /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:302: WARNING: py:func reference target not found: pyproj.transformer.itransform /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:309: WARNING: py:class reference target not found: pyproj.transformer.Transformer /home/tkloczko/rpmbuild/BUILD/pyproj-3.4.0/docs/history.rst:311: WARNING: py:meth reference target not found: pyproj.transformer.Transformer.from_pipeline done build succeeded, 254 warnings. ```

First part of the warnings about missing pyproj._network module can be skipped because on that stage I have no installed yet pyproj module with its DSOs. However other warningsa are affecting mainly html outpu (I'm interested only man page so I'm not affected)

You can peak on fixes that kind of issues in other projects https://github.com/latchset/jwcrypto/pull/289 https://github.com/click-contrib/sphinx-click/commit/abc31069 https://github.com/latchset/jwcrypto/pull/289 https://github.com/RDFLib/rdflib-sqlalchemy/issues/95 https://github.com/sissaschool/elementpath/commit/bf869d9e https://github.com/jaraco/cssutils/issues/21 https://github.com/pywbem/pywbem/pull/2895 https://github.com/sissaschool/xmlschema/commit/42ea98f2 https://github.com/RDFLib/rdflib/pull/2036 https://github.com/frostming/unearth/issues/14 https://github.com/pypa/distlib/commit/98b9b89f

pyproj(1) man page seems is not finished becaue it contains only

PYPROJ(1)                                                                        pyproj                                                                       PYPROJ(1)

NAME
       pyproj - pyproj CLI

AUTHOR
       Jeffrey Whitaker

COPYRIGHT
       2006-2018, Jeffrey Whitaker; 2019-2022, Open source contributors

3.4.0                                                                         Sep 16, 2022                                                                    PYPROJ(1)
snowman2 commented 1 year ago

With pyproj installed the man pages look correct man ./pyproj.1:

PYPROJ(1)                           pyproj                           PYPROJ(1)

NAME
       pyproj - pyproj CLI

       pyproj version: 3.4.1.dev0 [PROJ version: 9.1.0]

          usage: pyproj [-h] [-v] {sync} ...

OPTIONS
       -v, --verbose
              Show verbose debugging version information.

              Default: False

SUB-COMMANDS:
   sync
       Tool for synchronizing PROJ datum and transformation support data.

          pyproj sync [-h] [--bbox BBOX] [--spatial-test {intersects,contains}]
                      [--source-id SOURCE_ID] [--area-of-use AREA_OF_USE] [--file FILE]
                      [--exclude-world-coverage] [--include-already-downloaded]
                      [--list-files] [--all] [--system-directory]
                      [--target-directory TARGET_DIRECTORY] [-v]

   options
       --bbox Specify  an  area of interest to restrict the resources to down‐
              load. The area of interest is specified as a bounding  box  with
              geographic  coordinates,  expressed in degrees in an unspecified
              geographic  CRS.  west_long  and  east_long  should  be  in  the
              [-180,180]  range,  and south_lat and north_lat in the [-90,90].
              west_long is generally lower than east_long, except in the  case
              where the area of interest crosses the antimeridian.
...

I am not sure there is a good way to get around not installing pyproj.

I've added below patch to generate module documentation as well

Interesting. I only thought that it would be valuable for the CLI.

kloczek commented 1 year ago

I am not sure there is a good way to get around not installing pyproj.

As on build stage pyproj script does not exist yes maybe it is possible to replace somehow call pyproj.__main__.main? 🤔 As that my patch adds sys.path.insert(0, os.path.abspath("..")) it should be possible to call thet. I'm not sure how to implement that in .rst files ..