You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
323 lines
5.3 KiB
323 lines
5.3 KiB
3 years ago
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||
|
|
<HTML
|
||
|
|
><HEAD
|
||
|
|
><TITLE
|
||
|
|
>Feedback and Support</TITLE
|
||
|
|
><META
|
||
|
|
NAME="GENERATOR"
|
||
|
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||
|
|
REL="HOME"
|
||
|
|
TITLE="Bochs User Manual"
|
||
|
|
HREF="index.html"><LINK
|
||
|
|
REL="PREVIOUS"
|
||
|
|
TITLE="Text-mode is broken in some ancient DOS program"
|
||
|
|
HREF="textmode-problems.html"><LINK
|
||
|
|
REL="NEXT"
|
||
|
|
TITLE="Mailing Lists"
|
||
|
|
HREF="mailinglist.html"></HEAD
|
||
|
|
><BODY
|
||
|
|
CLASS="CHAPTER"
|
||
|
|
BGCOLOR="#FFFFFF"
|
||
|
|
TEXT="#000000"
|
||
|
|
LINK="#0000FF"
|
||
|
|
VLINK="#840084"
|
||
|
|
ALINK="#0000FF"
|
||
|
|
><DIV
|
||
|
|
CLASS="NAVHEADER"
|
||
|
|
><TABLE
|
||
|
|
SUMMARY="Header navigation table"
|
||
|
|
WIDTH="100%"
|
||
|
|
BORDER="0"
|
||
|
|
CELLPADDING="0"
|
||
|
|
CELLSPACING="0"
|
||
|
|
><TR
|
||
|
|
><TH
|
||
|
|
COLSPAN="3"
|
||
|
|
ALIGN="center"
|
||
|
|
>Bochs User Manual</TH
|
||
|
|
></TR
|
||
|
|
><TR
|
||
|
|
><TD
|
||
|
|
WIDTH="10%"
|
||
|
|
ALIGN="left"
|
||
|
|
VALIGN="bottom"
|
||
|
|
><A
|
||
|
|
HREF="textmode-problems.html"
|
||
|
|
ACCESSKEY="P"
|
||
|
|
>Prev</A
|
||
|
|
></TD
|
||
|
|
><TD
|
||
|
|
WIDTH="80%"
|
||
|
|
ALIGN="center"
|
||
|
|
VALIGN="bottom"
|
||
|
|
></TD
|
||
|
|
><TD
|
||
|
|
WIDTH="10%"
|
||
|
|
ALIGN="right"
|
||
|
|
VALIGN="bottom"
|
||
|
|
><A
|
||
|
|
HREF="mailinglist.html"
|
||
|
|
ACCESSKEY="N"
|
||
|
|
>Next</A
|
||
|
|
></TD
|
||
|
|
></TR
|
||
|
|
></TABLE
|
||
|
|
><HR
|
||
|
|
ALIGN="LEFT"
|
||
|
|
WIDTH="100%"></DIV
|
||
|
|
><DIV
|
||
|
|
CLASS="CHAPTER"
|
||
|
|
><H1
|
||
|
|
><A
|
||
|
|
NAME="FEEDBACK-SUPPORT"
|
||
|
|
></A
|
||
|
|
>Chapter 7. Feedback and Support</H1
|
||
|
|
><DIV
|
||
|
|
CLASS="SECTION"
|
||
|
|
><H1
|
||
|
|
CLASS="SECTION"
|
||
|
|
><A
|
||
|
|
NAME="SF-PROJECT-PAGE"
|
||
|
|
>7.1. The Bochs project on SourceForge</A
|
||
|
|
></H1
|
||
|
|
><P
|
||
|
|
>The <A
|
||
|
|
HREF="http://sourceforge.net/projects/bochs"
|
||
|
|
TARGET="_top"
|
||
|
|
>Bochs project page</A
|
||
|
|
>
|
||
|
|
on SourceForge provides these features:
|
||
|
|
<P
|
||
|
|
></P
|
||
|
|
><UL
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>Project summary page with screenshots and download statistics</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>Download area for Bochs release packages and disk images</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
><A
|
||
|
|
HREF="mailinglist.html"
|
||
|
|
>Mailing list</A
|
||
|
|
> archives</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>Source code browser</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>Tickets section (bug reports, patches, feature requests etc.)</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>Discussion boards (e.g. "Help" and "Open Discussion")</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>Project news page (used for release announcements)</P
|
||
|
|
></LI
|
||
|
|
></UL
|
||
|
|
></P
|
||
|
|
><DIV
|
||
|
|
CLASS="SECTION"
|
||
|
|
><H2
|
||
|
|
CLASS="SECTION"
|
||
|
|
><A
|
||
|
|
NAME="SF-TRACKERS"
|
||
|
|
>7.1.1. SourceForge tickets section (bug and patch trackers)</A
|
||
|
|
></H2
|
||
|
|
><P
|
||
|
|
>There are some requirements when submitting bug reports, patches and feature
|
||
|
|
requests for Bochs to make it easier to reproduce bugs and test patches.</P
|
||
|
|
><DIV
|
||
|
|
CLASS="SECTION"
|
||
|
|
><H3
|
||
|
|
CLASS="SECTION"
|
||
|
|
><A
|
||
|
|
NAME="AEN3326"
|
||
|
|
>7.1.1.1. Reporting errors from Bochs compilation</A
|
||
|
|
></H3
|
||
|
|
><P
|
||
|
|
>When reporting errors while building Bochs to the <A
|
||
|
|
HREF="mailinglist.html#BOCHS-DEVELOPERS"
|
||
|
|
>bochs-developers mailing list</A
|
||
|
|
> or the SF bug
|
||
|
|
tracker for the Bochs project, this information is required to fix the issue:
|
||
|
|
<P
|
||
|
|
></P
|
||
|
|
><UL
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>host platorm / build environment</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>Bochs release version or SVN revision</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>configure options used</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>full error message</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>config.log output if configure failure</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>source file name and line number if compile error</P
|
||
|
|
></LI
|
||
|
|
></UL
|
||
|
|
></P
|
||
|
|
><P
|
||
|
|
>Before reporting us the issue, make sure that a similar one hasn't been already
|
||
|
|
reported or someone created a patch to fix it. If you are familiar with C++
|
||
|
|
and you can write some code to fix your problem, you can post it in the <A
|
||
|
|
HREF="mailinglist.html#BOCHS-DEVELOPERS"
|
||
|
|
>bochs-developers mailing list</A
|
||
|
|
>
|
||
|
|
or submit the patch in SF patch tracker for Bochs.</P
|
||
|
|
></DIV
|
||
|
|
><DIV
|
||
|
|
CLASS="SECTION"
|
||
|
|
><H3
|
||
|
|
CLASS="SECTION"
|
||
|
|
><A
|
||
|
|
NAME="AEN3345"
|
||
|
|
>7.1.1.2. Reporting Bochs runtime issues</A
|
||
|
|
></H3
|
||
|
|
><P
|
||
|
|
>If Bochs does not work properly (e.g. panic, segfault, malfunction of emulated device)
|
||
|
|
we need some information to find out what's going on:
|
||
|
|
<P
|
||
|
|
></P
|
||
|
|
><UL
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>Bochs version used (version number if binary release / SVN revision
|
||
|
|
if self-compiled)</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>host platorm / build environment (if self-compiled)</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>bochsrc options used</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>error message (if panic or program termination)</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>log file output (related section only if too big)</P
|
||
|
|
></LI
|
||
|
|
></UL
|
||
|
|
></P
|
||
|
|
></DIV
|
||
|
|
><DIV
|
||
|
|
CLASS="SECTION"
|
||
|
|
><H3
|
||
|
|
CLASS="SECTION"
|
||
|
|
><A
|
||
|
|
NAME="AEN3359"
|
||
|
|
>7.1.1.3. Submitting a patch for Bochs</A
|
||
|
|
></H3
|
||
|
|
><P
|
||
|
|
>Patches for Bochs should be provided in the "unified diff" format. In addition
|
||
|
|
to the patch file and a detailed description this information is required:
|
||
|
|
<P
|
||
|
|
></P
|
||
|
|
><UL
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>patch applies to Bochs release version / SVN revision</P
|
||
|
|
></LI
|
||
|
|
><LI
|
||
|
|
><P
|
||
|
|
>test case (if required)</P
|
||
|
|
></LI
|
||
|
|
></UL
|
||
|
|
></P
|
||
|
|
><P
|
||
|
|
>When you are are interested in writing a patch to fix bugs or add new features,
|
||
|
|
you should have a look at the <A
|
||
|
|
HREF="../development/about-the-code.html"
|
||
|
|
TARGET="_top"
|
||
|
|
>developer documentation</A
|
||
|
|
>.
|
||
|
|
For some parts of the Bochs code we have already written some basic information.</P
|
||
|
|
></DIV
|
||
|
|
></DIV
|
||
|
|
></DIV
|
||
|
|
></DIV
|
||
|
|
><DIV
|
||
|
|
CLASS="NAVFOOTER"
|
||
|
|
><HR
|
||
|
|
ALIGN="LEFT"
|
||
|
|
WIDTH="100%"><TABLE
|
||
|
|
SUMMARY="Footer navigation table"
|
||
|
|
WIDTH="100%"
|
||
|
|
BORDER="0"
|
||
|
|
CELLPADDING="0"
|
||
|
|
CELLSPACING="0"
|
||
|
|
><TR
|
||
|
|
><TD
|
||
|
|
WIDTH="33%"
|
||
|
|
ALIGN="left"
|
||
|
|
VALIGN="top"
|
||
|
|
><A
|
||
|
|
HREF="textmode-problems.html"
|
||
|
|
ACCESSKEY="P"
|
||
|
|
>Prev</A
|
||
|
|
></TD
|
||
|
|
><TD
|
||
|
|
WIDTH="34%"
|
||
|
|
ALIGN="center"
|
||
|
|
VALIGN="top"
|
||
|
|
><A
|
||
|
|
HREF="index.html"
|
||
|
|
ACCESSKEY="H"
|
||
|
|
>Home</A
|
||
|
|
></TD
|
||
|
|
><TD
|
||
|
|
WIDTH="33%"
|
||
|
|
ALIGN="right"
|
||
|
|
VALIGN="top"
|
||
|
|
><A
|
||
|
|
HREF="mailinglist.html"
|
||
|
|
ACCESSKEY="N"
|
||
|
|
>Next</A
|
||
|
|
></TD
|
||
|
|
></TR
|
||
|
|
><TR
|
||
|
|
><TD
|
||
|
|
WIDTH="33%"
|
||
|
|
ALIGN="left"
|
||
|
|
VALIGN="top"
|
||
|
|
>Text-mode is broken in some ancient DOS program</TD
|
||
|
|
><TD
|
||
|
|
WIDTH="34%"
|
||
|
|
ALIGN="center"
|
||
|
|
VALIGN="top"
|
||
|
|
> </TD
|
||
|
|
><TD
|
||
|
|
WIDTH="33%"
|
||
|
|
ALIGN="right"
|
||
|
|
VALIGN="top"
|
||
|
|
>Mailing Lists</TD
|
||
|
|
></TR
|
||
|
|
></TABLE
|
||
|
|
></DIV
|
||
|
|
></BODY
|
||
|
|
></HTML
|
||
|
|
>
|