Rename function to create burn_source.

demo/iso.c

@@ -79,7 +79,7 @@ int main(int argc, char **argv)
         return 1;
     }
     
-    result = iso_image_create(image, &opts, &burn_src);
+    result = iso_image_create_burn_source(image, &opts, &burn_src);
     if (result < 0) {
         printf ("Cant create image, error %d\n", result);
         return 1;

demo/iso_modify.c

@@ -101,7 +101,7 @@ int main(int argc, char **argv)
     }
     
     /* generate a new image with both previous and added contents */
-    result = iso_image_create(image, &opts, &burn_src);
+    result = iso_image_create_burn_source(image, &opts, &burn_src);
     if (result < 0) {
         printf ("Cant create image, error %d\n", result);
         return 1;

demo/iso_ms.c

@@ -104,7 +104,7 @@ int main(int argc, char **argv)
     /* generate a multisession image with new contents */
     opts.ms_block = atoi(argv[2]);
     opts.appendable = 1;
-    result = iso_image_create(image, &opts, &burn_src);
+    result = iso_image_create_burn_source(image, &opts, &burn_src);
     if (result < 0) {
         printf ("Cant create image, error %d\n", result);
         return 1;

src/ecma119.c

@@ -926,8 +926,8 @@ int bs_set_size(struct burn_source *bs, off_t size)
     return 1;
 }
 
-int iso_image_create(IsoImage *image, Ecma119WriteOpts *opts,
-                     struct burn_source **burn_src)
+int iso_image_create_burn_source(IsoImage *image, Ecma119WriteOpts *opts,
+                                 struct burn_source **burn_src)
 {
     int ret;
     struct burn_source *source;

src/libisofs.h

@@ -316,11 +316,20 @@ struct iso_read_image_features
 int iso_image_new(const char *name, IsoImage **image);
 
 /**
- * TODO we should have two "create" methods, one for grow images, another
- * for images from scratch. Or we can just have a flag in Ecma119WriteOpts.
+ * Create a burn_source to actually write the image. That burn_source can be 
+ * used with libburn as a data source for a track.
+ * 
+ * @param image
+ *     The image to write.
+ * @param opts
+ *     The options for image generation.
+ * @param burn_src
+ *     Location where the pointer to the burn_source will be stored
+ * @return
+ *     1 on success, < 0 on error 
  */
-int iso_image_create(IsoImage *image, Ecma119WriteOpts *opts,
-                     struct burn_source **burn_src);
+int iso_image_create_burn_source(IsoImage *image, Ecma119WriteOpts *opts,
+                                 struct burn_source **burn_src);
 
 /**
  * Import a previous session or image, for growing or modify.