Source-Changes-HG archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[src/trunk]: src/external/bsd/elftoolchain/dist/libdwarf Sync libdwarf's manu...



details:   https://anonhg.NetBSD.org/src/rev/46e3ce440d77
branches:  trunk
changeset: 363903:46e3ce440d77
user:      jkoshy <jkoshy%NetBSD.org@localhost>
date:      Mon Mar 14 20:50:48 2022 +0000

description:
Sync libdwarf's manual pages with upstream [r3964].

diffstat:

 external/bsd/elftoolchain/dist/libdwarf/dwarf.3                            |  14 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_comp_dir.3            |  26 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_const_value_string.3  |  29 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_dataref.3             |  31 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_flag.3                |  30 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_location_expr.3       |  34 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_name.3                |  26 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_producer.3            |  26 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_ref_address.3         |  30 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_reference.3           |  30 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_signed_const.3        |  33 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_string.3              |  32 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_targ_address.3        |  32 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_arange.3                 |  40 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_die_to_debug.3           |  24 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_directory_decl.3         |  24 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_expr_addr.3              |  26 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_expr_gen.3               |  30 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_fde_inst.3               |  32 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_file_decl.3              |  36 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_frame_cie.3              |  34 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_frame_fde.3              |  72 ++++----
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_funcname.3               |  28 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_line_entry.3             |  36 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_pubname.3                |  28 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_typename.3               |  28 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_varname.3                |  28 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_weakname.3               |  28 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_attr.3                       |  36 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_attrlist.3                   |  38 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_attroffset.3                 |  24 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_attrval_signed.3             |  56 +++---
 external/bsd/elftoolchain/dist/libdwarf/dwarf_child.3                      |  68 ++++----
 external/bsd/elftoolchain/dist/libdwarf/dwarf_dealloc.3                    |  16 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_def_macro.3                  |  33 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_die_abbrev_code.3            |   8 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_die_link.3                   |  52 +++---
 external/bsd/elftoolchain/dist/libdwarf/dwarf_diename.3                    |  23 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_dieoffset.3                  |  78 +++++----
 external/bsd/elftoolchain/dist/libdwarf/dwarf_end_macro_file.3             |  20 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_errmsg.3                     |   8 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_errno.3                      |   6 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_expand_frame_instructions.3  |  40 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_expr_current_offset.3        |  20 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_expr_into_block.3            |  24 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_fde_cfa_offset.3             |  28 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_find_macro_value_start.3     |  17 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_finish.3                     |  12 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_formaddr.3                   |  28 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_formblock.3                  |  28 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_formexprloc.3                |  32 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_formflag.3                   |  28 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_formref.3                    |  38 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_formsig8.3                   |  28 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_formstring.3                 |  28 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_formudata.3                  |  34 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_AT_name.3                |  10 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_abbrev.3                 |  40 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_abbrev_children_flag.3   |  24 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_abbrev_code.3            |  24 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_abbrev_entry.3           |  38 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_abbrev_tag.3             |  24 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_address_size.3           |  27 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_arange.3                 |  34 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_arange_info.3            |  34 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_aranges.3                |  32 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_cie_index.3              |  17 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_cie_info.3               |  54 +++---
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_cie_of_fde.3             |  24 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_cu_die_offset.3          |  27 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_die_infotypes_flag.3     |  12 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_elf.3                    |  12 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_at_pc.3              |  30 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_info_for_all_regs.3  |  34 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_info_for_all_regs3.3 |  34 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_info_for_cfa_reg3.3  |  64 ++++---
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_info_for_reg.3       |  54 +++---
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_info_for_reg3.3      |  68 ++++----
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_instr_bytes.3        |  30 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_list.3               |  30 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_n.3                  |  30 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_fde_range.3              |  48 +++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_form_class.3             |  12 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_funcs.3                  |  50 +++---
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_globals.3                |  47 +++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_loclist_entry.3          |  48 +++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_macro_details.3          |  42 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_pubtypes.3               |  49 +++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_ranges.3                 |  48 +++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_relocation_info.3        |  36 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_relocation_info_count.3  |  28 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_section_bytes.3          |  34 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_section_max_offsets.3    |  42 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_str.3                    |  38 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_types.3                  |  49 +++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_vars.3                   |  47 +++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_get_weaks.3                  |  49 +++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_hasattr.3                    |  24 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_hasform.3                    |  54 +++---
 external/bsd/elftoolchain/dist/libdwarf/dwarf_highpc.3                     |  41 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_init.3                       |  40 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_lineno.3                     |  54 +++---
 external/bsd/elftoolchain/dist/libdwarf/dwarf_lne_end_sequence.3           |  24 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_lne_set_address.3            |  26 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_loclist.3                    |  47 +++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_loclist_from_expr.3          |  44 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_new_die.3                    |  52 +++---
 external/bsd/elftoolchain/dist/libdwarf/dwarf_new_expr.3                   |  20 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_new_fde.3                    |  20 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_next_cu_header.3             |  77 +++++----
 external/bsd/elftoolchain/dist/libdwarf/dwarf_next_types_section.3         |  13 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_object_init.3                |  39 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_producer_init.3              |  35 ++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_producer_set_isa.3           |  24 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_reset_section_bytes.3        |   6 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_set_frame_cfa_value.3        |  10 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_set_reloc_application.3      |   8 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_seterrarg.3                  |  44 +++--
 external/bsd/elftoolchain/dist/libdwarf/dwarf_srcfiles.3                   |  30 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_srclines.3                   |  32 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_start_macro_file.3           |  24 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_tag.3                        |  20 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_transform_to_disk_form.3     |  20 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_undef_macro.3                |  26 +-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_vendor_ext.3                 |  30 ++-
 external/bsd/elftoolchain/dist/libdwarf/dwarf_whatattr.3                   |  20 +-
 126 files changed, 2180 insertions(+), 1916 deletions(-)

diffs (truncated from 11428 to 300 lines):

diff -r 25577b5222b5 -r 46e3ce440d77 external/bsd/elftoolchain/dist/libdwarf/dwarf.3
--- a/external/bsd/elftoolchain/dist/libdwarf/dwarf.3   Mon Mar 14 20:25:26 2022 +0000
+++ b/external/bsd/elftoolchain/dist/libdwarf/dwarf.3   Mon Mar 14 20:50:48 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: dwarf.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
+.\"    $NetBSD: dwarf.3,v 1.5 2022/03/14 20:50:48 jkoshy Exp $
 .\"
 .\" Copyright (c) 2011 Joseph Koshy.  All rights reserved.
 .\"
@@ -23,7 +23,7 @@
 .\" out of the use of this software, even if advised of the possibility of
 .\" such damage.
 .\"
-.\" Id: dwarf.3 3644 2018-10-15 19:55:01Z jkoshy
+.\" Id: dwarf.3 3929 2021-03-07 21:43:46Z jkoshy
 .\"
 .Dd December 21, 2014
 .Dt DWARF 3
@@ -144,11 +144,13 @@
 that specifies a location to store an error descriptor in
 case of an error.
 If an error occurs during the execution on an API, and if this
-parameter is non-NULL, then an error descriptor is written to the
-location specified.
+parameter is
+.No non- Ns Dv NULL ,
+then an error descriptor is written to the location specified.
 .It
-Otherwise, if the error parameter was NULL, but if an error handler
-was defined for the debug context in use using
+Otherwise, if the error parameter was
+.Dv NULL ,
+but if an error handler was defined for the debug context in use using
 .Xr dwarf_init 3
 or
 .Xr dwarf_seterrhand 3 ,
diff -r 25577b5222b5 -r 46e3ce440d77 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_comp_dir.3
--- a/external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_comp_dir.3   Mon Mar 14 20:25:26 2022 +0000
+++ b/external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_comp_dir.3   Mon Mar 14 20:50:48 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: dwarf_add_AT_comp_dir.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
+.\"    $NetBSD: dwarf_add_AT_comp_dir.3,v 1.5 2022/03/14 20:50:48 jkoshy Exp $
 .\"
 .\" Copyright (c) 2011 Kai Wang
 .\" All rights reserved.
@@ -24,7 +24,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" Id: dwarf_add_AT_comp_dir.3 3640 2018-10-14 14:09:13Z jkoshy
+.\" Id: dwarf_add_AT_comp_dir.3 3961 2022-03-12 15:13:22Z jkoshy
 .\"
 .Dd September 4, 2011
 .Dt DWARF_ADD_AT_COMP_DIR 3
@@ -49,24 +49,25 @@
 .Dv DW_AT_comp_dir
 attribute descriptor and attaches it to the debugging information
 entry referenced by argument
-.Ar die .
+.Fa die .
 The created attribute will have DWARF form
 .Dv DW_FORM_strp .
 .Pp
 Argument
-.Ar die
+.Fa die
 should reference a debugging information entry allocated using
 .Xr dwarf_new_die 3 .
 .Pp
 Argument
-.Ar dir
+.Fa dir
 should point to a NUL-terminated string which will become the value of
 the created attribute.
 .Pp
 If argument
-.Ar err
-is not NULL, it will be used to store error information in case
-of an error.
+.Fa err
+is not
+.Dv NULL ,
+it will be used to store error information in case of an error.
 .Sh RETURN VALUES
 On success, function
 .Fn dwarf_add_AT_comp_dir
@@ -76,7 +77,7 @@
 returns
 .Dv DW_DLV_BADADDR
 and sets the argument
-.Ar err .
+.Fa err .
 .Sh ERRORS
 Function
 .Fn dwarf_add_AT_comp_dir
@@ -84,10 +85,11 @@
 .Bl -tag -width ".Bq Er DW_DLE_ARGUMENT"
 .It Bq Er DW_DLE_ARGUMENT
 Either of the arguments
-.Ar die
+.Fa die
 or
-.Ar dir
-was NULL.
+.Fa dir
+was
+.Dv NULL .
 .It Bq Er DW_DLE_MEMORY
 An out of memory condition was encountered during the execution of the
 function.
diff -r 25577b5222b5 -r 46e3ce440d77 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_const_value_string.3
--- a/external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_const_value_string.3 Mon Mar 14 20:25:26 2022 +0000
+++ b/external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_const_value_string.3 Mon Mar 14 20:50:48 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: dwarf_add_AT_const_value_string.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
+.\"    $NetBSD: dwarf_add_AT_const_value_string.3,v 1.5 2022/03/14 20:50:48 jkoshy Exp $
 .\"
 .\" Copyright (c) 2011 Kai Wang
 .\" All rights reserved.
@@ -24,7 +24,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" Id: dwarf_add_AT_const_value_string.3 3640 2018-10-14 14:09:13Z jkoshy
+.\" Id: dwarf_add_AT_const_value_string.3 3961 2022-03-12 15:13:22Z jkoshy
 .\"
 .Dd September 4, 2011
 .Dt DWARF_ADD_AT_CONST_VALUE_STRING 3
@@ -61,10 +61,10 @@
 .Dv DW_AT_const_value
 attribute descriptor and attach it to the debugging information entry
 referenced by argument
-.Ar die .
+.Fa die .
 .Pp
 Argument
-.Ar die
+.Fa die
 should reference a debugging information entry allocated using
 .Xr dwarf_new_die 3 .
 .Pp
@@ -73,7 +73,7 @@
 creates a
 .Dv DW_AT_const_value
 attribute descriptor containing the signed value specified by argument
-.Ar value .
+.Fa value .
 The created attribute descriptor will have DWARF form
 .Dv DW_FORM_sdata .
 .Pp
@@ -83,7 +83,7 @@
 .Dv DW_AT_const_value
 attribute descriptor containing the unsigned value specified by
 argument
-.Ar value .
+.Fa value .
 The created attribute descriptor will have DWARF form
 .Dv DW_FORM_udata .
 .Pp
@@ -93,29 +93,32 @@
 .Dv DW_AT_const_value
 attribute descriptor containing the string pointed to by the
 NUL-terminated argument
-.Ar str .
+.Fa str .
 The created attribute descriptor will have DWARF form
 .Dv DW_FORM_strp .
 .Pp
 If argument
-.Ar err
-is not NULL, it will be used by these functions to store error
+.Fa err
+is not
+.Dv NULL ,
+it will be used by these functions to store error
 information in case of an error.
 .Sh RETURN VALUES
 On success, these functions return the created attribute descriptor.
 In case of an error, these functions return
 .Dv DW_DLV_BADADDR
 and set the argument
-.Ar err .
+.Fa err .
 .Sh ERRORS
 These functions can fail with:
 .Bl -tag -width ".Bq Er DW_DLE_ARGUMENT"
 .It Bq Er DW_DLE_ARGUMENT
 Either of the arguments
-.Ar die
+.Fa die
 or
-.Ar str
-was NULL.
+.Fa str
+was
+.Dv NULL .
 .It Bq Er DW_DLE_MEMORY
 An out of memory condition was encountered during execution.
 .El
diff -r 25577b5222b5 -r 46e3ce440d77 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_dataref.3
--- a/external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_dataref.3    Mon Mar 14 20:25:26 2022 +0000
+++ b/external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_dataref.3    Mon Mar 14 20:50:48 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: dwarf_add_AT_dataref.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
+.\"    $NetBSD: dwarf_add_AT_dataref.3,v 1.5 2022/03/14 20:50:48 jkoshy Exp $
 .\"
 .\" Copyright (c) 2011 Kai Wang
 .\" All rights reserved.
@@ -24,7 +24,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" Id: dwarf_add_AT_dataref.3 3644 2018-10-15 19:55:01Z jkoshy
+.\" Id: dwarf_add_AT_dataref.3 3961 2022-03-12 15:13:22Z jkoshy
 .\"
 .Dd September 4, 2011
 .Dt DWARF_ADD_AT_DATAREF 3
@@ -50,7 +50,7 @@
 .Fn dwarf_add_AT_dataref
 creates an attribute descriptor for a relocatable address and attaches
 it to the debugging information entry referenced by argument
-.Ar die .
+.Fa die .
 .Pp
 If flag
 .Dv DW_DLC_SIZE_64
@@ -60,33 +60,35 @@
 .Dv DW_FORM_data4 .
 .Pp
 Argument
-.Ar dbg
+.Fa dbg
 should reference a DWARF producer instance allocated using
 .Xr dwarf_producer_init 3
 or
 .Xr dwarf_producer_init_b 3 .
 .Pp
 Argument
-.Ar die
+.Fa die
 should reference a debugging information entry allocated using
 .Xr dwarf_new_die 3 .
 .Pp
 Argument
-.Ar attr
+.Fa attr
 specifies the attribute code of the created attribute descriptor.
 .Pp
 Argument
-.Ar pc_value
+.Fa pc_value
 specifies the value of the relocatable address.
 .Pp
 Argument
-.Ar sym_index
+.Fa sym_index
 specifies the ELF symbol index of the symbol to be used for
 relocation.
 .Pp
 If argument
-.Ar err
-is not NULL, it will be used to store error information in case
+.Fa err
+is not
+.Dv NULL ,
+it will be used to store error information in case
 of an error.
 .Sh RETURN VALUES
 On success, function
@@ -97,7 +99,7 @@
 returns
 .Dv DW_DLV_BADADDR
 and sets the argument
-.Ar err .
+.Fa err .
 .Sh ERRORS
 Function
 .Fn dwarf_add_AT_dataref
@@ -105,10 +107,11 @@
 .Bl -tag -width ".Bq Er DW_DLE_ARGUMENT"
 .It Bq Er DW_DLE_ARGUMENT
 Either of the arguments
-.Ar dbg
+.Fa dbg
 or
-.Ar die
-was NULL.
+.Fa die
+was
+.Dv NULL .
 .It Bq Er DW_DLE_MEMORY
 An out of memory condition was encountered during the execution of the
 function.
diff -r 25577b5222b5 -r 46e3ce440d77 external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_flag.3
--- a/external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_flag.3       Mon Mar 14 20:25:26 2022 +0000
+++ b/external/bsd/elftoolchain/dist/libdwarf/dwarf_add_AT_flag.3       Mon Mar 14 20:50:48 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: dwarf_add_AT_flag.3,v 1.4 2020/11/26 22:51:35 jkoshy Exp $
+.\"    $NetBSD: dwarf_add_AT_flag.3,v 1.5 2022/03/14 20:50:48 jkoshy Exp $
 .\"



Home | Main Index | Thread Index | Old Index