--- trunk/man/gxemul.1	2007/10/08 16:18:22	9
+++ trunk/man/gxemul.1	2007/10/08 16:18:27	10
@@ -1,4 +1,4 @@
-.\" $Id: gxemul.1,v 1.21 2005/06/03 23:14:52 debug Exp $
+.\" $Id: gxemul.1,v 1.24 2005/06/26 10:05:02 debug Exp $
 .\"
 .\" Copyright (C) 2004-2005  Anders Gavare.  All rights reserved.
 .\"
@@ -47,12 +47,12 @@
 .Ar file Op Ar args ...
 .Sh DESCRIPTION
 .Nm
-is an experimental instruction-level machine emulator. It can be used 
-to run binary code for (among others) MIPS-based machines.
-Several emulation modes are available. For some emulation modes, processors
-and surrounding hardware components are emulated well enough to let
-unmodified operating systems (eg. NetBSD) run as if they were running on a
-real machine.
+is an experimental instruction-level machine emulator. It can be used to
+run binary code for (among others) MIPS-based machines, regardless of host
+platform. Several emulation modes are available. For some modes,
+processors and surrounding hardware components are emulated well enough to
+let unmodified operating systems (e.g. NetBSD) run as if they were running
+on a real machine.
 .Pp
 There are three ways to invoke the emulator. When emulating a 
 complete machine, settings can be entered directly on the command line, or
@@ -111,13 +111,9 @@
 Other options:
 .Bl -tag -width Ds
 .It Fl B
-Disable dynamic binary translation completely. By default, bintrans
-will be turned on if the host architecture supports it.
-However, in this release (0.3.X), there is no new bintrans system.
-If you want to enable binary translation, use
-.Fl "b".
-.It Fl b
-Use the OLD binary translation subsystem. (Alpha and i386 hosts only.)
+Disable dynamic binary translation. By default, bintrans
+will be turned on if the host+target architecture combination is 
+supported.
 .It Fl C Ar x
 Try to emulate a specific CPU type,
 .Ar "x".
@@ -180,8 +176,8 @@
 .It Fl j Ar n
 Set the name of the kernel to
 .Ar "n".
-When booting from an ISO9660 filesystem, the kernel will try to boot from 
-this file. (In some emulation modes, eg. DECstation, this name is passed 
+When booting from an ISO9660 filesystem, the emulator will try to boot 
+using this file. (In some emulation modes, eg. DECstation, this name is passed 
 along to the boot program. Useful names are "bsd" for OpenBSD/pmax, 
 or "vmunix" for Ultrix.)
 .It Fl M Ar m
@@ -302,11 +298,11 @@
 distribution.
 .Sh EXAMPLES
 The following command will start NetBSD/pmax on an emulated DECstation 
-5000/200 (3MAX), with the old bintrans system enabled:
+5000/200 (3MAX):
 .Pp
-.Dl "gxemul -E dec -e 3max -b -d netbsddisk.img"
+.Dl "gxemul -E dec -e 3max -d nbsd_pmax.img"
 .Pp
-netbsddisk.img should be a raw disk image containing a bootable 
+nbsd_pmax.img should be a raw disk image containing a bootable 
 NetBSD/pmax filesystem.
 .Pp
 The following command will start an emulation session based on settings in 
@@ -332,14 +328,13 @@
 .Nm
 source distribution, some are indirectly mentioned in the TODO file.
 .Pp
-There is no new bintrans system in this release, so you will need to add
-.Fl b
-to select the old bintrans system, if you want speed.
+The binary translation subsystem is really terrible, but it is less
+terrible than running without it.
 .Pp
 .Nm
 does not simulate individual pipe-line stages or penalties caused by
-branch-prediction misses, so it cannot be used for accurate performance 
-measurement.
+branch-prediction misses or cache misses, so it cannot be used for 
+accurate performance measurement.
 .Pp
 .Nm
 is not timing-accurate.