Small spelling corrections and wording

changes.
	modified:   libdwarf.dox
	modified:   ../src/lib/libdwarf/libdwarf.h

Author: davea42

doc/libdwarf.dox

@@ -755,7 +755,7 @@
     dwarfdump output.
 
     Sections that are part of an Elf COMDAT GROUP are
-    asigned a group number > 2.  There can be many
+    assigned a group number > 2.  There can be many
     such COMDAT groups in an object file (but none
     in an executable or shared object).  Each such
     COMDAT group will have a small set of sections
@@ -967,6 +967,33 @@
 
     We list these with newest first.
 
+    <b>Changes 0.8.0 to 0.8.1</b>
+
+    Changes were required to support Mach-O universal binaries,
+    which were not readable by earlier versions of the library.
+
+    We have new library functions 
+    dwarf_init_path_a(),
+    dwarf_init_path_dl_a(), and 
+    dwarf_get_universalbinary_count().
+
+    The first two allow a caller to specify which
+    (numbering from zero) object file to
+    report on by adding a new argument dw_universalnumber.
+    Passing zero as the dw_universalnumber argument
+    is always safe.
+
+    The third lets callers retrieve the number
+    being used.
+    
+    These new calls do not replace anything so existing
+    code should work fine.  Applying the previously
+    existing calls dwarf_init_path() dwarf_init_path_dl()
+    to a Mach-O universal binary works, but the library
+    will return data on the first (index zero)
+    as a default since there is no dw_universalnumber
+    argument possible.
+
     <b>Changes 0.7.0 to 0.8.0</b>
 
     v0.8.0 released 2023-09-20 
@@ -1107,7 +1134,7 @@
     DWARF would, in 0.5.0 and earlier, result in
     libdwarf reporting erroneous data.  A copy-paste
     error in libdwarf/dwarf_util.c was noticed
-    and fixed 24 Januarly 2023 for 0.6.0.
+    and fixed 24 January 2023 for 0.6.0.
     Bug <b>DW202301-001</b>.
 
     <b>Changes 0.4.2 to 0.5.0</b>

src/lib/libdwarf/libdwarf.h

@@ -1405,6 +1405,10 @@ typedef struct Dwarf_Rnglists_Head_s * Dwarf_Rnglists_Head;
 /*! @brief Initialization based on path, the most common
     initialization.
 
+    On a Mach-O universal binary this function can
+    only return information about the first (zero index)
+    object in the universal binary. 
+
     @param dw_path
     Pass in the path to the object file to open.
     @param dw_true_path_out_buffer
@@ -1450,6 +1454,8 @@ typedef struct Dwarf_Rnglists_Head_s * Dwarf_Rnglists_Head;
     @see dwarf_init_path_dl dwarf_init_b
     @see exampleinit
 */
+
+
 DW_API int dwarf_init_path(const char * dw_path,
     char *            dw_true_path_out_buffer,
     unsigned int      dw_true_path_bufferlen,
@@ -1459,6 +1465,18 @@ DW_API int dwarf_init_path(const char * dw_path,
     Dwarf_Debug*      dw_dbg,
     Dwarf_Error*      dw_error);
 
+/*! @brief Initialization based on path
+
+    This identical to dwarf_init_path() except that it
+    adds a new argument, dw_universalnumber,
+    with which you can specify which object in
+    a Mach-O universal binary you wish to open. 
+
+    It is always safe and appropriate to pass
+    zero as the dw_universalnumber.
+    Elf and PE and (non-universal) Mach-O object
+    files ignore the value of dw_universalnumber.
+*/
 DW_API int dwarf_init_path_a(const char * dw_path,
     char *            dw_true_path_out_buffer,
     unsigned int      dw_true_path_bufferlen,
@@ -1537,6 +1555,22 @@ DW_API int dwarf_init_path_dl(const char * dw_path,
     unsigned char   * dw_dl_path_source,
     Dwarf_Error*      dw_error);
 
+/*! @brief Initialization based on path with debuglink
+
+    This identical to dwarf_init_path_dl() except that it
+    adds a new argument, dw_universalnumber,
+    with which you can specify which object in
+    a Mach-O universal binary you wish to open.
+
+    It is always safe and appropriate to pass
+    zero as the dw_universalnumber.
+    Elf and PE and (non-universal) Mach-O object
+    files ignore the value of dw_universalnumber.
+
+    Mach-O objects do not contain or use debuglink
+    data.
+*/
+
 DW_API int dwarf_init_path_dl_a(const char * dw_path,
     char *            dw_true_path_out_buffer,
     unsigned int      dw_true_path_bufferlen,