 @@ -1,14 +1,14 @@
-.\" $NetBSD: ctfmerge.1,v 1.4 2024/05/04 13:11:41 christos Exp $
+.\" $NetBSD: ctfmerge.1,v 1.5 2024/05/04 18:20:44 uwe Exp $
 .\"
 .\" Copyright (c) 2010 The FreeBSD Foundation
 .\" All rights reserved.
 .\"
 .\" This software was developed by Rui Paulo under sponsorship from the
 .\" FreeBSD Foundation.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 @@ -31,61 +31,65 @@
 .\"
 .Dd May 4, 2024
 .Dt CTFMERGE 1
 .Os
 .Sh NAME
 .Nm ctfmerge
 .Nd merge several CTF data sections into one
 .Sh SYNOPSIS
 .Nm
 .Op Fl fgstv
 .Fl l Ar label
 .Fl L Ar labelenv
 .Fl o Ar outfile
-file ...
+.Ar
 .Nm
 .Op Fl fgstv
 .Fl l Ar label
 .Fl L Ar labelenv
 .Fl o Ar outfile
 .Fl d Ar uniqfile
 .Op Fl g
 .Op Fl D Ar uniqlabel
-file ...
+.Ar
 .Nm
 .Op Fl fgstv
 .Fl l Ar label
 .Fl L Ar labelenv
 .Fl o Ar outfile
 .Fl w Ar withfile
-file ...
+.Ar
 .Nm
 .Op Fl g
 .Fl c Ar srcfile
 .Ar destfile
 .Sh DESCRIPTION
 The
 .Nm
 utility merges several CTF data sections from several files into one
 output file, unifying common data.
 .Pp
 The following options are available:
-.Bl -tag -width indent
+.Bl -tag -width Fl
 .It Fl f
 Match global symbols to global CTF data.
 .It Fl g
 Don't delete the original debugging sections.
 .It Fl s
-Use the .dynsym ELF section instead of the .symtab ELF section.
+Use the
 .Ql .dynsym
 ELF section instead of the
 .Ql .symtab
 ELF section.
 .It Fl t
 Make sure that all object files have a CTF section.
 .It Fl v
 Enable verbose mode.
 .It Fl l Ar label
 Sets the label as
 .Ar label .
 .It Fl L Ar labelenv
 Instructs
 .Nm
 to read the label from the environment variable
 .Ar labelenv .
 .It Fl o Ar outfile
 @@ -100,44 +104,52 @@ Uniquify against label
 .Ar uniqlabel
 .It Fl w Ar withfile
 Additive merge with
 .Ar withfile .
 .It Fl c Ar srcfile Ar destfile
 Copy CTF data from
 .Ar srcfile
 into
 .Ar destfile .
 .El
 .Sh ENVIRONMENT VARIABLES
 The following environment variables are used in
 .Nm :
-.Bl -tag -width x
+.Bl -tag -width Ev
-.It CTFMERGE_TERMINATE_NO_UNLINK
+.It Ev CTFMERGE_TERMINATE_NO_UNLINK
 Don't remove temporary files on exit, so that they can be examined
 for debugging.
-.It CTFMERGE_MAX_SLOTS
+.It Ev CTFMERGE_MAX_SLOTS
 Number of round-robin slots in the input queue that it is processed by
 worker threads.
-Each slot represents a file batch (default 5).
+Each slot represents a file batch
-.It CTFMERGE_PHASE1_BATCH_SIZE
+.Pq default 5 .
-Number of files in a slot that are needed before processing starts (default 8).
+.It Ev CTFMERGE_PHASE1_BATCH_SIZE
-.It CTFMERGE_NUM_THREADS
+Number of files in a slot that are needed before processing starts
 .Pq default 8 .
 .It Ev CTFMERGE_NUM_THREADS
 Set the number of worker threads.
 If the number of processors can be determined it defaults to
-min(processors * 3 / 2, nslots), if not it defaults to 2.
+.Fo min
-.It CTFMERGE_INPUT_THROTTLE
+.Fa "processors\|*\|3\|/\|2"
-Max queue size to queue (defaults to 10).
+.Fa "nslots"
-.It CTFMERGE_DEBUG_LEVEL
+.Fc
-Increase debugging verbosity (maximum is 3).
+if not it defaults to 2.
 .It Ev CTFMERGE_INPUT_THROTTLE
 Max queue size to queue
 .Pq defaults to 10 .
 .It Ev CTFMERGE_DEBUG_LEVEL
 Increase debugging verbosity
 .Pq maximum is 3 .
 .El
 .Sh EXIT STATUS
 .Ex -std
 .Sh SEE ALSO
 .Xr ctfconvert 1 ,
 .Xr ctfdump 1
 .Sh HISTORY
 The
 .Nm
 utility first appeared in
 .Fx 7.0 .
 .Sh AUTHORS
 The CTF utilities came from OpenSolaris.