$OpenBSD: patch-binutils_doc_objcopy_1,v 1.3 2010/06/27 20:58:10 ckuethe Exp $
--- binutils/doc/objcopy.1.orig	Sat Jun 26 11:22:42 2010
+++ binutils/doc/objcopy.1	Sat Jun 26 11:31:17 2010
@@ -202,6 +202,8 @@ objcopy [\fB\-F\fR \fIbfdname\fR|\fB\-\-target=\fR\fIb
         [\fB\-\-readonly\-text\fR]
         [\fB\-\-pure\fR]
         [\fB\-\-impure\fR]
+ 	[\fB\-\-change\-pathname\fR \fIold\fR=\fInew\fR]
+ 	[\fB\-\-basename\fR]
         [\fB\-\-file\-alignment=\fR\fInum\fR]
         [\fB\-\-heap=\fR\fIsize\fR]
         [\fB\-\-image\-base=\fR\fIaddress\fR]
@@ -885,6 +887,23 @@ This option is used to build a \fI.sym\fR file for a V
 It can also be a useful way of reducing the size of a \fB\-\-just\-symbols\fR
 linker input file.
 .RE
+.IP "\fB\-\-change\-pathname\fR \fIold\fR=\fInew\fR" 4
+.IX Item "--change-pathname old=new"
+When converting debugging information using \fB\-\-debugging\fR, for
+every pathname that starts with \fIold\fR, replace the matching part
+by \fInew\fR.  This is intented to map pathnames between different
+debugging tools, or when parts of the object file(s) had their
+pathnames recorded in a different build environment.  Note that only
+leading directory name components might be changed that way, since the
+trailing filename could be recorded elsewhere as well (depending on the
+debugging format of the input file).
+.IP "\fB\-\-basename\fR"
+.IX Item "--basename"
+When converting debugging information using \fB\-\-debugging\fR, for
+every pathname, strip all leading directory information.  This option
+takes precedence over any \fB\-\-change\-pathname\fR option.  For some
+debugging formats that cannot handle long filenames, this options is
+implied (notably, some COFF debugging formats).
 .IP "\fB\-V\fR" 4
 .IX Item "-V"
 .PD 0
