X-Git-Url: https://git.distorted.org.uk/~mdw/disorder/blobdiff_plain/e7eb3a2744aa45179daea235800753d3d1955338..7f97fda7b59bd9d3beb9bd4591a4e6dea9efccab:/lib/trackname.h

diff --git a/lib/trackname.h b/lib/trackname.h
index 31c7df8..56f933e 100644
--- a/lib/trackname.h
+++ b/lib/trackname.h
@@ -15,7 +15,9 @@
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
-
+/** @file lib/trackname.h
+ * @brief Track name calculation
+ */
 #ifndef TRACKNAME_H
 #define TRACKNAME_H
 
@@ -49,7 +51,14 @@ int compare_path_raw(const unsigned char *ap, size_t an,
 /* Comparison function for path names that groups all entries in a directory
  * together */
 
-/* Convenient wrapper for compare_path_raw */
+/** @brief Compare two paths
+ * @param ap First path
+ * @param bp Second path
+ * @return -ve, 0 or +ve for ap <, = or > bp
+ *
+ * Sorts files within a directory together.
+ * A wrapper around compare_path_raw().
+ */
 static inline int compare_path(const char *ap, const char *bp) {
   return compare_path_raw((const unsigned char *)ap, strlen(ap),
 			  (const unsigned char *)bp, strlen(bp));