Temporarily disabled the unfinished HP-PA PALO bootability preparations

libisofs/libisofs.h

@@ -2136,6 +2136,15 @@ int iso_write_opts_set_overwrite_buf(IsoWriteOpts *opts, uint8_t *overwrite);
  */
 int iso_write_opts_set_fifo_size(IsoWriteOpts *opts, size_t fifo_size);
 
+/*
+ * Release 1.3.6 contains an incomplete implementation of preparations for the
+ * HP-PA bootloader PALO. Its header version 5 is not completely defined yet.
+ * To enable the code for these preparations, you have to define the macro
+ *   Libisofs_enable_unreleased_hppa_palO
+ * and to insert into libisofs/libisofs.ver the lines
+ *   iso_image_set_hppa_palo;
+ *   iso_image_get_hppa_palo;
+ */
 /*
  * Attach 32 kB of binary data which shall get written to the first 32 kB 
  * of the ISO image, the ECMA-119 System Area. This space is intended for
@@ -2186,11 +2195,14 @@ int iso_write_opts_set_fifo_size(IsoWriteOpts *opts, size_t fifo_size);
  *                 This will overwrite the first 512 bytes of the submitted
  *                 data.
  *              4= HP-PA PALO boot sector version 4 for HP PA-RISC
- *                 @since 1.3.6
+ *                 <<< only ifdef Libisofs_enable_unreleased_hppa_palO
+ *                 @since 1.3.8
  *                 Suitable for older PALO of e.g. Debian 4 and 5. 
  *                 Submit all five parameters of iso_image_set_hppa_palo():
  *                   cmdline, bootloader, kernel_32, kernel_64, ramdisk
  *              5= HP-PA PALO boot sector version 5 for HP PA-RISC
+ *                 <<< only ifdef Libisofs_enable_unreleased_hppa_palO
+ *                 @since 1.3.8
  *                 Suitable for newer PALO, where PALOHDRVERSION in
  *                 lib/common.h is defined as 5.
  *                 Submit all five parameters of iso_image_set_hppa_palo():
@@ -3746,6 +3758,12 @@ int iso_image_set_sparc_core(IsoImage *img, IsoFile *sparc_core, int flag);
 int iso_image_get_sparc_core(IsoImage *img, IsoFile **sparc_core, int flag);
 
 
+#ifdef Libisofs_enable_unreleased_hppa_palO
+
+/* <<< This API call and the implementation of its consequences are not yet
+       stable. So it gets excluded from releases.
+*/
+
 /**
  * Define a command line and submit the paths of four mandatory files for
  * production of a HP-PA PALO boot sector for PA-RISC machines.
@@ -3772,7 +3790,7 @@ int iso_image_get_sparc_core(IsoImage *img, IsoFile **sparc_core, int flag);
  *               Else only the non-NULL parameters of this call have an effect
  * @return
  *        1 is success , <0 means error
- * @since 1.3.6
+ * @since 1.3.8
  */
 int iso_image_set_hppa_palo(IsoImage *img, char *cmdline, char *bootloader,
                             char *kernel_32, char *kernel_64, char *ramdisk,
@@ -3796,11 +3814,12 @@ int iso_image_set_hppa_palo(IsoImage *img, char *cmdline, char *bootloader,
  *        Will return the absolute path of the RAM disk file.
  * @return
  *        1 is success , <0 means error
- * @since 1.3.6
+ * @since 1.3.8
  */
 int iso_image_get_hppa_palo(IsoImage *img, char **cmdline, char **bootloader,
                             char **kernel_32, char **kernel_64, char **ramdisk);
 
+#endif /* Libisofs_enable_unreleased_hppa_palO */
 
 /**
  * Increments the reference counting of the given node.