BSD 3 development
[unix-history] / usr / man / man1 / adb.1
index 6e032c3..b98c5a9 100644 (file)
@@ -1,15 +1,15 @@
+.TH ADB 1 "VAX/11"
+.SH NAME
+adb \- debugger
+.SH SYNOPSIS
+.B adb
+[\fB\-w\fR] [ objfil [ corfil ] ]
 .ds TW \v'.25m'\s+2~\s-2\v'-.25m'
 .ds ST \v'.25m'*\v'-.25m'
 .ds IM \v'.1m'=\v'-.1m'\s-2\h'-.1m'>\h'.1m'\s+2
 .ds LE \(<=
 .ds LT \s-2<\s+2
 .ds GT \s-2>\s+2
 .ds TW \v'.25m'\s+2~\s-2\v'-.25m'
 .ds ST \v'.25m'*\v'-.25m'
 .ds IM \v'.1m'=\v'-.1m'\s-2\h'-.1m'>\h'.1m'\s+2
 .ds LE \(<=
 .ds LT \s-2<\s+2
 .ds GT \s-2>\s+2
-.TH ADB 1 
-.SH NAME
-adb \- debugger
-.SH SYNOPSIS
-.B adb
-[\fB\-w\fR] [ objfil [ corfil ] ]
 .SH DESCRIPTION
 .I Adb
 is a general purpose debugging program.
 .SH DESCRIPTION
 .I Adb
 is a general purpose debugging program.
@@ -119,12 +119,17 @@ The last
 typed.
 .TP 7.2n
 .I integer
 typed.
 .TP 7.2n
 .I integer
-An octal number if
-.I integer
-begins with a 0;
-a hexadecimal number if preceded by
-.BR # ;
-otherwise a decimal number.
+A number.  The prefixes 0o and 0O (``zero oh'') force interpretation
+in octal radix; the prefixes 0t and 0T force interpretation in
+decimal radix; the prefixes 0x and 0X force interpretation in
+hexadecimal radix.  Thus 0o20 = 0t16 = 0x10 = sixteen.
+If no prefix appears, then the
+.I default\ radix
+is used; see the $d command.  The default radix is initially hexadecimal.
+The hexadecimal digits are 0123456789abcdefABCDEF with the obvious
+values.  Note that a hexadecimal number whose most significant
+digit would otherwise be an alphabetic character must have a 0x
+(or 0X) prefix (or a leading zero if the default radix is hexadecimal).
 .TP 7.2n
 .IB integer . fraction
 A 32 bit floating point number.
 .TP 7.2n
 .IB integer . fraction
 A 32 bit floating point number.
@@ -149,7 +154,7 @@ the value of the register is obtained from
 the system header in
 .IR corfil .
 The register names are
 the system header in
 .IR corfil .
 The register names are
-.BR "r0 ... r5 sp pc ps" "."
+those printed by the $r command.
 .TP 7.2n
 .I symbol
 A
 .TP 7.2n
 .I symbol
 A
@@ -259,6 +264,8 @@ in
 .I  objfil
 are printed according to the format
 .IR f .
 .I  objfil
 are printed according to the format
 .IR f .
+.I dot
+is incremented by the sum of the increments for each format letter (q.v.).
 .TP
 .RI / f
 Locations starting at
 .TP
 .RI / f
 Locations starting at
@@ -266,7 +273,10 @@ Locations starting at
 in
 .I  corfil
 are printed according to the format
 in
 .I  corfil
 are printed according to the format
-.IR f .
+.I f
+and
+.I dot
+is incremented as for `?'.
 .TP
 .RI  = f
 The value of
 .TP
 .RI  = f
 The value of
@@ -287,7 +297,7 @@ Each format character may be preceded by a decimal integer
 that is a repeat count for the format character.
 While stepping through a format
 .I dot
 that is a repeat count for the format character.
 While stepping through a format
 .I dot
-is incremented temporarily
+is incremented
 by the amount given for each format letter.
 If no format is given then the last format is used.
 The format letters available are as follows.
 by the amount given for each format letter.
 If no format is given then the last format is used.
 The format letters available are as follows.
@@ -327,6 +337,16 @@ Print long decimal.
 .br
 .ns
 .TP
 .br
 .ns
 .TP
+.BR r " 2"
+Print in default radix.
+.br
+.ns
+.TP
+.BR R " 4"
+Print long default radix.
+.br
+.ns
+.TP
 .BR x "        2"
 Print 2 bytes in hexadecimal.
 .br
 .BR x "        2"
 Print 2 bytes in hexadecimal.
 .br
@@ -474,9 +494,6 @@ Nothing is printed.
 .RE
 .TP
 newline
 .RE
 .TP
 newline
-If the previous command temporarily incremented
-.IR dot ,
-make the increment permanent.
 Repeat the previous command with a
 .I count
 of 1.
 Repeat the previous command with a
 .I count
 of 1.
@@ -569,16 +586,6 @@ is set to \fBpc\fR.
 .br
 .ns
 .TP
 .br
 .ns
 .TP
-.B f
-Print the floating registers in
-single or double length.
-If the floating point status of
-.B ps
-is set to double (0200 bit)
-then double length is used anyway.
-.br
-.ns
-.TP
 .B b
 Print all breakpoints
 and their associated counts and commands.
 .B b
 Print all breakpoints
 and their associated counts and commands.
@@ -619,6 +626,18 @@ frames are printed.
 .br
 .ns
 .TP
 .br
 .ns
 .TP
+.B d
+Set the default radix to
+.I address
+and report the new value.
+Note that
+.I address
+is interpreted in the (old) current radix.
+Thus ``10$d'' never changes the default radix.
+To make decimal the default radix, use ``0t10$d''.
+.br
+.ns
+.TP
 .B e
 The names and values of
 external variables are printed.
 .B e
 The names and values of
 external variables are printed.