aboutsummaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorMax Kellermann <max@duempel.org>2013-10-17 00:36:35 +0200
committerMax Kellermann <max@duempel.org>2013-10-17 00:36:35 +0200
commite132d10aec524962c5b5cbe135930aaabccba810 (patch)
treea31fd362cec6942bf75cde1e5d577139b9073299 /src
parent3dbda2dda2268f5cb213b18d4e42a889d52c16ec (diff)
downloadmpd-e132d10aec524962c5b5cbe135930aaabccba810.tar.gz
mpd-e132d10aec524962c5b5cbe135930aaabccba810.tar.xz
mpd-e132d10aec524962c5b5cbe135930aaabccba810.zip
ArchiveLookup: move API documentation to header
Diffstat (limited to 'src')
-rw-r--r--src/ArchiveLookup.cxx18
-rw-r--r--src/ArchiveLookup.hxx19
2 files changed, 15 insertions, 22 deletions
diff --git a/src/ArchiveLookup.cxx b/src/ArchiveLookup.cxx
index 771c8fec6..8cd87f5ec 100644
--- a/src/ArchiveLookup.cxx
+++ b/src/ArchiveLookup.cxx
@@ -29,24 +29,6 @@
#include <unistd.h>
#include <errno.h>
-/**
- *
- * archive_lookup is used to determine if part of pathname refers to an regular
- * file (archive). If so then its also used to split pathname into archive file
- * and path used to locate file in archive. It also returns suffix of the file.
- * How it works:
- * We do stat of the parent of input pathname as long as we find an regular file
- * Normally this should never happen. When routine returns true pathname modified
- * and split into archive, inpath and suffix. Otherwise nothing happens
- *
- * For example:
- *
- * /music/path/Talco.zip/Talco - Combat Circus/12 - A la pachenka.mp3
- * is split into archive: /music/path/Talco.zip
- * inarchive pathname: Talco - Combat Circus/12 - A la pachenka.mp3
- * and suffix: zip
- */
-
bool archive_lookup(char *pathname, char **archive, char **inpath, char **suffix)
{
char *pathdupe;
diff --git a/src/ArchiveLookup.hxx b/src/ArchiveLookup.hxx
index 6e7669cb0..62ebbc0c5 100644
--- a/src/ArchiveLookup.hxx
+++ b/src/ArchiveLookup.hxx
@@ -20,12 +20,23 @@
#ifndef MPD_ARCHIVE_LOOKUP_HXX
#define MPD_ARCHIVE_LOOKUP_HXX
-/*
- * This is the public API which is used by archive plugins to
- * provide transparent archive decompression layer for mpd
+/**
+ *
+ * archive_lookup is used to determine if part of pathname refers to an regular
+ * file (archive). If so then its also used to split pathname into archive file
+ * and path used to locate file in archive. It also returns suffix of the file.
+ * How it works:
+ * We do stat of the parent of input pathname as long as we find an regular file
+ * Normally this should never happen. When routine returns true pathname modified
+ * and split into archive, inpath and suffix. Otherwise nothing happens
*
+ * For example:
+ *
+ * /music/path/Talco.zip/Talco - Combat Circus/12 - A la pachenka.mp3
+ * is split into archive: /music/path/Talco.zip
+ * inarchive pathname: Talco - Combat Circus/12 - A la pachenka.mp3
+ * and suffix: zip
*/
-
bool archive_lookup(char *pathname, char **archive, char **inpath, char **suffix);
#endif