From 1114df52a28d5140233348b38701aab1a7b3d658 Mon Sep 17 00:00:00 2001
From: Adam Heins <mail@adamheins.com>
Date: Mon, 4 Mar 2024 12:00:07 -0500
Subject: [PATCH] Update docs and bump to v0.4.0.

---
 docs/src/conf.py         | 2 +-
 package.xml              | 2 +-
 pyproject.toml           | 2 +-
 src/xacrodoc/packages.py | 8 +++++++-
 4 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/docs/src/conf.py b/docs/src/conf.py
index 3dd62fc..443390f 100644
--- a/docs/src/conf.py
+++ b/docs/src/conf.py
@@ -25,7 +25,7 @@
 author = 'Adam Heins'
 
 # The short X.Y version
-version = '0.3.0'
+version = '0.4.0'
 # The full version, including alpha/beta/rc tags
 release = version
 
diff --git a/package.xml b/package.xml
index 67acea0..0329fbf 100644
--- a/package.xml
+++ b/package.xml
@@ -2,7 +2,7 @@
 <!-- Dummy package.xml so that ROS tools can identify this as a package. -->
 <package format="2">
   <name>xacrodoc</name>
-  <version>0.3.0</version>
+  <version>0.4.0</version>
   <description>Programmatically compile xacro files.</description>
   <maintainer email="mail@adamheins.com">Adam Heins</maintainer>
   <author>Adam Heins</author>
diff --git a/pyproject.toml b/pyproject.toml
index 3218ff2..613beea 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -3,7 +3,7 @@ line-length = 80
 
 [tool.poetry]
 name = "xacrodoc"
-version = "0.3.0"
+version = "0.4.0"
 description = "Programmatically compile xacro files."
 authors = ["Adam Heins <mail@adamheins.com>"]
 license = "MIT"
diff --git a/src/xacrodoc/packages.py b/src/xacrodoc/packages.py
index 5fe861d..1c1204e 100644
--- a/src/xacrodoc/packages.py
+++ b/src/xacrodoc/packages.py
@@ -4,6 +4,7 @@
 
 
 class PackageNotFoundError(Exception):
+    """Raised when a package could not be found."""
     pass
 
 
@@ -229,9 +230,14 @@ def get_file_path(pkg, relative_path):
 def update_package_cache(pkgpaths):
     """Update the package cache.
 
+    This allows the user to manually specify the location of packages on the
+    filesystem. The path does not actually need to be a proper ROS package,
+    meaning that there is no need to have a package.xml file there.
+
     Parameters
     ----------
     pkgpaths : dict
-        Map from package names to absolute package paths as strings.
+        Map from package names to package paths. The paths are resolved,
+        made absolute, and converted to strings.
     """
     _finder.update_package_cache(pkgpaths)