Hi,
This patch adds a man page for ar86 and objdump86. The latter is also
for size86 and nm86, and the patch to debian/rules make sure that
works.
Cheers!
Shyamal
diff -ruN linux86-0.16.14/debian/changelog linux86-0.16.14-patch/debian/changelog
--- linux86-0.16.14/debian/changelog 2006-05-28 16:37:50.000000000 -0700
+++ linux86-0.16.14-patch/debian/changelog 2006-05-28 16:27:38.000000000 -0700
@@ -1,3 +1,10 @@
+linux86 (0.16.14-patch-1) unstable; urgency=low
+
+ * Added man pages for ar86, objdump86, size86 and nm86 with patch
+ from Shyamal Prasad <[EMAIL PROTECTED]> (Closes: #138042)
+
+ -- Shyamal Prasad <[EMAIL PROTECTED]> Sun, 28 May 2006 16:27:25 -0700
+
linux86 (0.16.14-1.2) unstable; urgency=high
* NMU
diff -ruN linux86-0.16.14/debian/rules linux86-0.16.14-patch/debian/rules
--- linux86-0.16.14/debian/rules 2006-05-28 16:37:50.000000000 -0700
+++ linux86-0.16.14-patch/debian/rules 2006-05-28 18:34:00.000000000 -0700
@@ -81,6 +81,9 @@
rm -f debian/tmp-bin86/usr/bin/{size86,objdump86}
ln debian/tmp-bin86/usr/bin/nm86 debian/tmp-bin86/usr/bin/size86
ln debian/tmp-bin86/usr/bin/nm86 debian/tmp-bin86/usr/bin/objdump86
+ rm -f debian/tmp-bin86/usr/share/man/man1/{size86.1.gz,nm86.1.gz}
+ ln debian/tmp-bin86/usr/share/man/man1/objdump86.1.gz debian/tmp-bin86/usr/share/man/man1/nm86.1.gz
+ ln debian/tmp-bin86/usr/share/man/man1/objdump86.1.gz debian/tmp-bin86/usr/share/man/man1/size86.1.gz
cp -p debian/changelog debian/tmp-bin86/usr/share/doc/bin86/changelog.Debian
gzip -9f debian/tmp-bin86/usr/share/doc/bin86/*
install -d debian/tmp-bin86/usr/share/doc/bin86/examples
diff -ruN linux86-0.16.14/man/ar86.1 linux86-0.16.14-patch/man/ar86.1
--- linux86-0.16.14/man/ar86.1 1969-12-31 16:00:00.000000000 -0800
+++ linux86-0.16.14-patch/man/ar86.1 2006-05-28 16:33:59.000000000 -0700
@@ -0,0 +1,153 @@
+.TH ar86 1 "May, 2006"
+.BY Shyamal Prasad <[EMAIL PROTECTED]>
+.nh
+.SH NAME
+ar86 \- Create, modify, and extract from archive file
+.SH SYNOPSIS
+.B ar86
+.I operation
+.B archive
+.RI [ file... ]
+.PP
+.BR ar86
+.I positional\-op
+.B member
+.B archive
+.RI [ file ...]
+
+.SH DESCRIPTION
+The
+.B ar86
+program is used to create, examine and modify archive files produced
+by the Dev86/ELKS toolchain.
+.SH OPTIONS
+The
+.B ar86
+command requires that the operation to be performed on the archive be
+specified as the first option. If the operation is positional then the
+next option is the archive member marking the position. This is
+followed by the archive file name and any list of file names.
+.PP
+.SS Operations
+One of the following operations can be specified
+.TP
+.B d
+\fIdelete\fR the listed files from the archive.
+.TP
+.B m
+\fImove\fR the named files. By default files are moved to the end of
+the archive unless a positional modifier is present.
+.TP
+.B p
+\fIprint\fP the contents of archive members to standard out. If a file
+list is included only those members are printed. If the \fBv\fR
+modifier is present each file's contents are preceeded by a new line,
+a line with the string \fBmember\fR, a space character, the member
+name, and two following newlines.
+.TP
+.B q
+.I quickly
+add the files to the end of the archive without checking
+to see if they already exist in the archive. This operation will
+ignore any positional modifiers. Creates the archive file if it does
+not exist.
+.TP
+.B r
+\fIreplace\fR archive members with the files listed. If the file name
+is not present in the archive it is added to the end of the archive
+(or to any explicitly specified position). Creates the archive file if
+it does not exist.
+.TP
+.B t
+\fItable\fR; list the file names of archive members. If a file list is
+present only those files that are present in the archive are listed.
+The \fBv\fR modifier prints member attributes.
+.TP
+.B x
+\fIextract\fR the named files from the archive into the current
+directory. If no files are specified all the archive members will be
+extracted.
+.P
+.SS Modifiers
+The following modifiers may be used with the operations
+.TP
+.B o
+\fIoriginal\fR time stamps from the archive are preserved for
+extracted files when possible.
+.TP
+.B s
+\fIsymbol\fR update; this option may be used by itself to force an
+update to the symbol definition section of the archive (the
+.B __.SYMDEF
+member). If any files are specified they will be replaced as if the
+.B r
+operation had been specified. If no symbol definition section exists
+one is created. This option will also creates the archive file if it
+does not exist.
+.TP
+.B u
+\fIupdate\fR files in the archive during a
+.B r
+.RI ( replace )
+operation. The files are added to the archive in exactly the same
+manner as
+.I replace
+except that an existing archive member will be retained (in its
+original position) if it has a modified more recently than the file
+being added. Note that this modifier acts as if a
+.B r
+operation has been specified (even it has not), and will actually
+override any other previously specified operation.
+.TP
+.B v
+\fIverbose\fR; print additional diagnostic messages while processing
+the archive.
+.SS Positional Modifiers
+The following modifiers specify where in the archive files are moved
+to or added. If any of these modifiers are specified then the second
+option to
+.B ar86
+must be the name of an archive member.
+.TP
+.B a
+\fIafter\fR; files are placed after the specified archive member.
+.TP
+.B b
+\fIbefore\fR; files are placed before the specified archive member.
+.TP
+.B i
+same as
+.BR b .
+.SH EXAMPLES
+To see the contents of an archive
+.IP
+ar86 tv libfile.a
+.PP
+To add some files to an archive
+.IP
+ar86 r libfile.a file1.o file2.o
+.PP
+to add some files after a member named mem.o and to update the symbol
+table
+.IP
+ar86 rsa mem.o libfile.a file1.o file2.o
+.SH BUGS
+A
+.B l
+modifier will be accepted but ignored.
+.SH RESTRICTIONS
+This command is intended for use only with object files created using
+the Dev86/ELKS toolchain.
+.SH "SEE ALSO"
+.BR as86 (1),
+.BR bcc (1),
+.BR ld86 (1)
+.SH AUTHORS
+\(co 1988, 1990 Free Software Foundation Inc. Changes for
+.B ar86
+by Greg Haerr <[EMAIL PROTECTED]>.
+.SH COPYRIGHT
+The manual page was written for Debian GNU/Linux, \(co 2006 Shyamal
+Prasad <[EMAIL PROTECTED]>. It is distributed under the terms of
+the GNU General Public License version 2 (or any later version
+released by the Free Software Foundation).
diff -ruN linux86-0.16.14/man/Makefile linux86-0.16.14-patch/man/Makefile
--- linux86-0.16.14/man/Makefile 1998-07-31 06:03:30.000000000 -0700
+++ linux86-0.16.14-patch/man/Makefile 2006-05-28 16:53:23.000000000 -0700
@@ -1,6 +1,6 @@
MANDIR=/usr/man
-MAN1PG=as86.1 bcc.1 elks.1 elksemu.1 ld86.1
+MAN1PG=as86.1 bcc.1 elks.1 elksemu.1 ld86.1 ar86.1 objdump86.1
MAN1DIR=$(MANDIR)/man1
all:
diff -ruN linux86-0.16.14/man/objdump86.1 linux86-0.16.14-patch/man/objdump86.1
--- linux86-0.16.14/man/objdump86.1 1969-12-31 16:00:00.000000000 -0800
+++ linux86-0.16.14-patch/man/objdump86.1 2006-05-28 16:34:08.000000000 -0700
@@ -0,0 +1,72 @@
+.TH objdump86 1 "May, 2006"
+.BY Shyamal Prasad <[EMAIL PROTECTED]>
+.nh
+.SH NAME
+objdump86, size86, nm86 \- Examine object, archive or executable files
+.SH SYNOPSIS
+.BI objdump86
+.RI [ file ...]
+.PP
+.B size86
+.RI [ file ...]
+.PP
+.BI nm86
+.RI [ file ...]
+
+.SH DESCRIPTION
+These commands are used to examine the contents of object files. They
+may also be used to examine archive or executable files. When archive
+files are examined each module in the archive will be processed in
+sequence.
+.PP
+.B nm86
+prints the symbol table in each of the specified files.
+.PP
+.B size86
+displays a summary of the sizes of the segments in each of the files.
+.PP
+.B objdump86
+decodes and displays the contents of the object files specified. This
+includes the section headers, symbols tables, segment sizes, and
+segment contents.
+.SH OPTIONS
+The programs are not designed to accept any options.
+.PP
+It should be noted that all three of
+.BR objdump86 ,
+.BR size86 ,
+and
+.B nm86
+are implemented as links to the same executable file (called
+.BR objdump86
+in the source distribution). The result of running this executable is
+determined by the file name actually used to execute it.
+.PP
+It is possible to force a specific behavior irrespective of the
+invocation file name using one of the options below
+.TP
+.B -s
+Behave like
+.BR size86 .
+.TP
+.B -n
+Behave like
+.BR nm86 .
+.SH RESTRICTIONS
+These commands are intended for use only with the Dev86/ELKS
+toolchain.
+.SH "SEE ALSO"
+.BR as86 (1),
+.BR bcc (1),
+.BR ld86 (1)
+.SH AUTHORS
+.BR objdump86 ,
+.BR size86 ,
+and
+.B nm86
+\(co 1999 Greg Haerr <[EMAIL PROTECTED]>.
+.SH COPYRIGHT
+The manual page was written for Debian GNU/Linux, \(co 2006 Shyamal
+Prasad <[EMAIL PROTECTED]>. It is distributed under the terms of
+the GNU General Public License version 2 (or any later version
+released by the Free Software Foundation).
