summaryrefslogtreecommitdiff
path: root/system/d52/d52.pod
diff options
context:
space:
mode:
Diffstat (limited to 'system/d52/d52.pod')
-rw-r--r--system/d52/d52.pod143
1 files changed, 143 insertions, 0 deletions
diff --git a/system/d52/d52.pod b/system/d52/d52.pod
new file mode 100644
index 0000000000..8f2502ebc6
--- /dev/null
+++ b/system/d52/d52.pod
@@ -0,0 +1,143 @@
+# pod source for d52 man page
+# pod2man -s1 -r3.4.1 --stderr -nD52 -cSlackBuilds.org < d52.pod > d52.1
+
+=pod
+
+=head1 NAME
+
+d52 - disassembler for Intel 8052/8051/8031/etc
+
+d48 - disassembler for Intel 8048 and 8041
+
+dz80 - disassembler for Zilog Z80, Intel 8080 and 8085
+
+=head1 SYNOPSIS
+
+d52 I<options> B<filename>
+
+=head1 DESCRIPTION
+
+Full documentation may be found in I</usr/doc/d52-3.4.1/d52manual.html>
+and I</usr/doc/d52-3.4.1/dz80-d48addendum.html>.
+
+=head1 OPTIONS
+
+Options may be entered Unix style (-d) or DOS style (/b).
+
+Options may be entered in a freeform fashion as long as a dash (-) or
+a slash (/) precedes any option that precedes the filename.
+Examples:
+
+ d52 filename bd
+ d52 -d filename x100
+ d52 /h filename d -x100
+
+=head2 Common Options
+
+These options are supported by d52, d48, and dz80.
+
+=over
+
+=item B<-b>
+
+disassemble file with .bin extension.
+
+=item B<-h>
+
+disassemble file with .hex extension. If neither 'b' nor 'h' is specified, first search for a .hex file, and if not found, then a .bin file
+
+=item B<-a>
+
+use ascii macro instead of db/defb for text.
+
+=item B<-d>
+
+include address and data in the comment field.
+
+=item B<-n>
+
+use C style for hexadecimal operands
+
+=item B<-p>
+
+put dot '.' at beginning of pseudo ops
+
+=item B<-s>
+
+use 'defb' and 'defw' instead of 'db' and 'dw' for binary data.
+
+=item B<-u>
+
+output labels, symbols, and mnemonics in upper case.
+
+=back
+
+=head2 D52 Options
+
+=over
+
+=item B<-i>
+
+put statement in output file to include 'sfr52.inc'.
+
+=item B<-k>
+
+disassemble for Keil A51 (obsolete).
+
+=item B<-x>
+
+add a hexadecimal offset to file addresses.
+
+=item B<-z[filename]>
+
+read cycle count file. Cycle count files are installed to /usr/share/d52/ in this build.
+See /usr/doc/d52-3.4.1/cycle_counting.htm for more information.
+
+=item B<-t>
+
+trace and analyze code before disassembly. will overwrite any existing ctl file for the file being disassembled.
+
+=back
+
+=head2 D48 Options
+
+=over
+
+=item B<-1>
+
+disassemble 8041 code (note, this is the numeral one, not the lowercase letter L).
+
+=back
+
+=head2 DZ80 Options
+
+=over
+
+=item B<-c>
+
+disassemble CP/M .com file (implies -x100).
+
+=item B<-t>
+
+trace and analyze code before disassembly. will overwrite any existing ctl file for the file being disassembled.
+
+=item B<-x>
+
+add a hexadecimal offset to file addresses.
+
+=item B<-80>
+
+generate 8080 mnemonics.
+
+=item B<-85>
+
+generate 8085 mnemonics.
+
+=back
+
+=head1 AUTHOR
+
+d52, d48, and dz80 are copyright (C) 1995-2007 by J. L. Post.
+
+This man page was written by B. Watson for the SlackBuilds.org project. It
+may be used by anyone.