cdtext.h: minor doxygen improvemtn

others: make "make distcheck" work again.

include/cdio/cdtext.h

@@ -1,5 +1,5 @@
 /*
-    $Id: cdtext.h,v 1.7 2004/09/04 23:49:47 rocky Exp $
+    $Id: cdtext.h,v 1.8 2004/09/05 13:03:46 rocky Exp $
 
     Copyright (C) 2004 Rocky Bernstein <rocky@panix.com>
     adapted from cuetools
@@ -44,6 +44,7 @@ extern "C" {
     char *field[MAX_CDTEXT_FIELDS];
   };
   
+  /*! \brief A list of all of the CD-Text fields */
   typedef enum {
     CDTEXT_ARRANGER   =  0,   /**< name(s) of the arranger(s) */
     CDTEXT_COMPOSER   =  1,   /**< name(s) of the composer(s) */
@@ -73,14 +74,16 @@ extern "C" {
   /*! Free memory assocated with cdtext*/
   void cdtext_destroy (cdtext_t *cdtext);
   
-  /*!  returns the CDTEXT value associated with key at the given track
+  /*! returns the string associated with the given field.  NULL is
-    number. NULL is returned if key is CDTEXT_INVALID or the field is
+    returned if key is CDTEXT_INVALID or the field is not set.
-    not set. 
+
+    @see cdio_get_cdtext to retrieve the cdtext structure used as
+    input here.
   */
   const char *cdtext_get (cdtext_field_t key, const cdtext_t *cdtext);
   
   /*!
-    returns enum of keyword if key is a CD-TEXT keyword, 
+    returns enum of keyword if key is a CD-Text keyword, 
     returns MAX_CDTEXT_FIELDS non-zero otherwise.
   */
   cdtext_field_t cdtext_is_keyword (const char *key);

test/Makefile.am

@@ -1,4 +1,4 @@
-#   $Id: Makefile.am,v 1.27 2004/07/11 02:33:18 rocky Exp $
+#   $Id: Makefile.am,v 1.28 2004/09/05 13:03:46 rocky Exp $
 #
 #    Copyright (C) 2003, 2004 Rocky Bernstein <rocky@panix.com>
 #
@@ -33,8 +33,12 @@ testassert_LDADD    = $(LIBCDIO_LIBS)
 testdefault_LDADD   = $(LIBCDIO_LIBS)
 testischar_LDADD    = $(LIBISO9660_LIBS) $(LIBCDIO_LIBS)
 testiso9660_LDADD   = $(LIBISO9660_LIBS) $(LIBCDIO_LIBS)
+
 testtoc_LDADD       = $(LIBCDIO_LIBS)
+testtoc_CFLAGS      = -DTEST_DIR=\"$(srcdir)\"
+
 testbincue_LDADD    = $(LIBCDIO_LIBS)
+testbincue_CFLAGS   = -DTEST_DIR=\"$(srcdir)\"
 
 check_SCRIPTS = check_nrg.sh  check_cue.sh  check_cd_read.sh \
                 check_iso.sh  check_opts.sh 
@@ -75,4 +79,6 @@ MOSTLYCLEANFILES = core.* *.dump
 # learning any more of this awful system than I need to.
 check-am:	make-executable
 make-executable: check_nrg.sh check_cue.sh
-	chmod +x *.sh
+	chmod +x *.sh
+	if test ! -f cdda.bin ; then $(LN_S) $(srcdir)/cdda.bin cdda.bin ; fi
+	if test ! -f isofs-m1.bin ; then $(LN_S) $(srcdir)/isofs-m1.bin isofs-m1.bin ; fi

test/testbincue.c

@@ -1,5 +1,5 @@
 /*
-  $Id: testbincue.c,v 1.2 2004/07/10 01:18:02 rocky Exp $
+  $Id: testbincue.c,v 1.3 2004/09/05 13:03:46 rocky Exp $
 
   Copyright (C) 2004 Rocky Bernstein <rocky@panix.com>
   
@@ -38,6 +38,10 @@
 #endif
 #include <string.h>
 
+#ifndef TEST_DIR
+#define TEST_DIR "."
+#endif
+
 #define NUM_GOOD_CUES 2
 #define NUM_BAD_CUES 7
 int
@@ -59,10 +63,15 @@ main(int argc, const char *argv[])
   };
   int ret=0;
   unsigned int i;
+  char psz_cuefile[500];
 
+  psz_cuefile[sizeof(psz_cuefile)-1] = '\0';
   cdio_loglevel_default = (argc > 1) ? CDIO_LOG_DEBUG : CDIO_LOG_INFO;
   for (i=0; i<NUM_GOOD_CUES; i++) {
-    if (!cdio_is_cuefile(cue_file[i])) {
+
+    snprintf(psz_cuefile, sizeof(psz_cuefile)-1,
+	     "%s/%s", TEST_DIR, cue_file[i]);
+    if (!cdio_is_cuefile(psz_cuefile)) {
       printf("Incorrect: %s doesn't parse as a CDRWin CUE file.\n", 
 	     cue_file[i]);
       ret=i+1;
@@ -70,16 +79,22 @@ main(int argc, const char *argv[])
       printf("Correct: %s parses as a CDRWin CUE file.\n", 
 	     cue_file[i]);
     }
+    free(psz_cuefile);
   }
 
   for (i=0; i<NUM_BAD_CUES; i++) {
-    if (!cdio_is_cuefile(badcue_file[i])) {
+
+    snprintf(psz_cuefile, sizeof(psz_cuefile)-1,
+	     "%s/%s", TEST_DIR, badcue_file[i]);
+    if (!cdio_is_cuefile(psz_cuefile)) {
       printf("Correct: %s doesn't parse as a CDRWin CUE file.\n", 
 	     badcue_file[i]);
+      free(psz_cuefile);
     } else {
       printf("Incorrect: %s parses as a CDRWin CUE file.\n", 
 	     badcue_file[i]);
       ret+=50*i+1;
+      free(psz_cuefile);
       break;
     }
   }

test/testtoc.c

@@ -1,5 +1,5 @@
 /*
-  $Id: testtoc.c,v 1.4 2004/07/11 02:33:18 rocky Exp $
+  $Id: testtoc.c,v 1.5 2004/09/05 13:03:47 rocky Exp $
 
   Copyright (C) 2004 Rocky Bernstein <rocky@panix.com>
   
@@ -38,6 +38,10 @@
 #endif
 #include <string.h>
 
+#ifndef TEST_DIR
+#define TEST_DIR "."
+#endif
+
 #define NUM_GOOD_TOCS 15
 #define NUM_BAD_TOCS 7
 int
@@ -72,10 +76,15 @@ main(int argc, const char *argv[])
   };
   int ret=0;
   unsigned int i;
+  char psz_tocfile[500];
+
+  psz_tocfile[sizeof(psz_tocfile)-1] = '\0';
   
   cdio_loglevel_default = (argc > 1) ? CDIO_LOG_DEBUG : CDIO_LOG_INFO;
   for (i=0; i<NUM_GOOD_TOCS; i++) {
-    if (!cdio_is_tocfile(toc_file[i])) {
+    snprintf(psz_tocfile, sizeof(psz_tocfile)-1,
+	     "%s/%s", TEST_DIR, toc_file[i]);
+    if (!cdio_is_tocfile(psz_tocfile)) {
       printf("Incorrect: %s doesn't parse as a cdrdao TOC file.\n", 
 	     toc_file[i]);
       ret=i+1;
@@ -83,16 +92,21 @@ main(int argc, const char *argv[])
       printf("Correct: %s parses as a cdrdao TOC file.\n", 
 	     toc_file[i]);
     }
+    free(psz_tocfile);
   }
 
   for (i=0; i<NUM_BAD_TOCS; i++) {
-    if (!cdio_is_tocfile(badtoc_file[i])) {
+    snprintf(psz_tocfile, sizeof(psz_tocfile)-1,
+	     "%s/%s", TEST_DIR, badtoc_file[i]);
+    if (!cdio_is_tocfile(psz_tocfile)) {
       printf("Correct: %s doesn't parse as a cdrdao TOC file.\n", 
 	     badtoc_file[i]);
+      free(psz_tocfile);
     } else {
       printf("Incorrect: %s parses as a cdrdao TOC file.\n", 
 	     badtoc_file[i]);
       ret+=50*i+1;
+      free(psz_tocfile);
       break;
     }
   }