Updated formatting to work better under man 2.3.0 (SuSE 7.1), and

hopefully other versions of man. I also added reference to Bryce's new
Linux getting started guide.
This commit is contained in:
Timothy R.Butler 2001-06-03 22:35:07 +00:00
parent 2c66148a10
commit aa982d8e7e
4 changed files with 94 additions and 52 deletions

View File

@ -1,5 +1,5 @@
.\Document Author: Timothy R. Butler - tbutler@uninetsolutions.com
.TH bochs-dlx 1 "The Bochs Project bochs-dlx 2 Jun 2001"
.TH bochs-dlx 1 "The Bochs Project bochs-dlx 3 Jun 2001"
.\"SKIP_SECTION"
.SH NAME
bochs-dlx \- Runs DLX-Linux under the Bochs x86 Emulator
@ -37,6 +37,9 @@ bochs(1), bochsrc(1), bximage(1)
.nf
The Bochs IA-32 Emulator site on the World Wide Web:
http://bochs.sourceforge.net
The Getting Started Guide for Bochs on Linux:
/usr/local/bochs/@VERSION@/DOC-linux.html
.fi
.\"SKIP_SECTION"
.SH BUGS

View File

@ -51,6 +51,9 @@ bochsrc(1), bochs-dlx(1), bximage(1)
.nf
The Bochs IA-32 Emulator site on the World Wide Web:
http://bochs.sourceforge.net
The Getting Started Guide for Bochs on Linux:
/usr/local/bochs/@VERSION@/DOC-linux.html
.fi
.\"SKIP_SECTION"
.SH AUTHORS

View File

@ -19,10 +19,12 @@ home directory.
.TP
.I "romimage:"
You need to load a ROM BIOS into F0000-FFFFF.
The BIOS controls what the PC does when it first powers on. Normally, you can
use a precompiled BIOS in the
The BIOS controls what the PC does when it
first powers on. Normally, you can use a
precompiled BIOS in the
.B bios/
directory, named BIOS-bochs-latest.
directory, named
BIOS-bochs-latest.
Example:
romimage: file=bios/BIOS-bochs-970717
@ -34,7 +36,8 @@ memory you want to emulate. You may also pass
the
.B 'megs:N'
option to bochs. The default
is 32MB, since most OS's won't need more than that.
is 32MB, since most OS's won't need more than
that.
Example:
megs: 32
@ -48,13 +51,19 @@ Example:
vgaromimage: bios/VGABIOS-elpin-2.40
.TP
.I "floppya/floppyb:"
Point this to the pathname of a floppy image file or device. Floppya is the
first drive, and floppyb is the second drive. If you're booting from a floppy,
floppya should point to a bootable disk.
.I "floppya:"
or
.I "floppyb:"
You can set the initial status of the media to 'ejected' or 'inserted'.
Usually you will probably want 'inserted'.
Point this to the pathname of a floppy image
file or device. Floppya is the first drive,
and floppyb is the second drive. If you're
booting from a floppy, floppya should point to
a bootable disk.
You can set the initial status of the media to
'ejected' or 'inserted'. Usually you will want
to use 'inserted'.
Example:
@ -71,7 +80,10 @@ Example:
floppya: 720k=path, status=inserted
.TP
.I "diskc/diskd:"
.I "diskc:"
or
.I "diskd:"
Point this at the disk image you want to use
as for a hard disk. If you use bximage(1) to
create the image, it will give you the
@ -133,18 +145,24 @@ Example:
.TP
.I "panic:"
If Bochs reaches a condition where it cannot emulate correctly, it does a
panic. This can be a configuration problem (like a misspelled bochsrc line) or
an emulation problem (like an unsupported video mode). The "panic" setting in
bochsrc tells Bochs how to respond to a panic. You can set this to fatal
(terminate the session), report (print information to the console), or
ignore (do nothing).
If Bochs reaches a condition where it cannot
emulate correctly, it does a panic. This can
be a configuration problem (like a misspelled
bochsrc line) or an emulation problem (like an
unsupported video mode). The "panic" setting
in bochsrc tells Bochs how to respond to a
panic. You can set this to fatal (terminate
the session), report (print information to
the console), or ignore (do nothing).
The safest setting is action=fatal. If you are getting panics, you can try
action=report instead. If you allow Bochs to continue after a panic, don't be
surprised if you get strange behavior or crashes if a panic occurs. Please
report panic messages unless it is just a configuration problem like "could not
find hard drive image."
The safest setting is action=fatal. If you are
getting panics, you can try action=report
instead. If you allow Bochs to continue after
a panic, don't be surprised if you get strange
behavior or crashes if a panic occurs. Please
report panic messages unless it is just a
configuration problem like "could not find
hard drive image."
Example:
panic: action=fatal
@ -152,38 +170,48 @@ Example:
.TP
.I "error:"
Bochs produces an an error message when it finds a condition that really
shouldn't happen, but doesn't endanger the simulation. An example of an
error might be if the emulated software produces an illegal disk command.
Bochs produces an error message when it finds
a condition that really shouldn't happen, but
doesn't endanger the simulation. An example of
an error might be if the emulated software
produces an illegal disk command.
The "error:" setting tells Bochs how to respond to an error condition. You
can set this to fatal (terminate the session) , report (print information to
the console), or ignore (do nothing).
The "error" setting tells Bochs how to respond
to an error condition . You can set this to
fatal (terminate the session), report (print
information to the console), or ignore (do
nothing).
Example:
error: action=report
.TP
.I "info:"
This setting tells Bochs what to do when an event occurs that generates
informational messages. You can set this to fatal (that would not be very
smart though), report (print information to the console), or ignore (do
nothing). For general usage, the "report" option is probably a good choice.
This setting tells Bochs what to do when an
event occurs that generates informational
messages. You can set this to fatal (that
would not be very smart though), report (print
information to the console), or ignore (do
nothing). For general usage, the "report"
option is probably a good choice.
Example:
info: action=report
.TP
.I "debug:"
This setting tells Bochs what to do with messages intended to assist in
debugging. You can set this to fatal (but you shouldn't), report (print
information to the console), or ignore (do nothing). You should
generally set this to ignore, unless you are trying to diagnose a particular
problem.
This setting tells Bochs what to do with
messages intended to assist in debugging. You
can set this to fatal (but you shouldn't),
report (print information to the console), or
ignore (do nothing). You should generally set
this to ignore, unless you are trying to
diagnose a particular problem.
.B NOTE:
When action=report, Bochs may spit out thousands of debug messages per
second, which can impact performance and fill up your disk.
When action=report, Bochs may spit out
thousands of debug messages per second, which
can impact performance and fill up your disk.
Example:
debug: action=ignore
@ -304,9 +332,11 @@ using instructions included in config.h (in
the source code), to find your workstation's
capability.
IPS is used to calibrate many time-dependent events within the bochs
simulation. For example, changing IPS affects the frequency of VGA updates, the
duration of time before a key starts to autorepeat, and the measurement of
IPS is used to calibrate many time-dependent
events within the bochs simulation. For
example, changing IPS affects the frequency of
VGA updates, the duration of time before a key
starts to autorepeat, and the measurement of
BogoMips and other benchmarks.
Example Specifications[1]
@ -370,6 +400,9 @@ bochs(1), bochs-dlx(1), bximage(1)
.nf
The Bochs IA-32 Emulator site on the World Wide Web:
http://bochs.sourceforge.net
The Getting Started Guide for Bochs on Linux:
/usr/local/bochs/@VERSION@/DOC-linux.html
.fi
.\"SKIP_SECTION"
.SH AUTHORS

View File

@ -1,5 +1,5 @@
.\Document Author: Timothy R. Butler - tbutler@uninetsolutions.com
.TH bximage 1 "The Bochs Project bximage 2 Jun 2001"
.TH bximage 1 "The Bochs Project bximage 3 Jun 2001"
.\"SKIP_SECTION"
.SH NAME
bximage \- Interactive Disk Image Creator for Bochs
@ -31,11 +31,14 @@ bochs(1), bochsrc(1), bochs-dlx(1)
.nf
The Bochs IA-32 Emulator site on the World Wide Web:
http://bochs.sourceforge.net
The Getting Started Guide for Bochs on Linux:
/usr/local/bochs/@VERSION@/DOC-linux.html
.fi
.\"SKIP_SECTION"
.SH AUTHORS
Bximage was written by Bryce Denney, based on several similar
tools from the bochs-developers list.
Bximage was written by Bryce Denney, based on several
similar tools from the bochs-developers list.
.\"SKIP_SECTION"
.SH BUGS
Please report all bugs to the bug tracker on our web