Files
ZSNES/zsnes/docs/Linux/bugs.htm
2005-01-20 01:48:37 +00:00

114 lines
6.0 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head>
<title>ZSNES Documentation - Linux v1.42 - Bug Reports</title>
<link rel="stylesheet" type="text/css" href="style.css" />
</head>
<body id="zsnes-documentation">
<div id="header">
<h1><img src="images/zsneslogo.png" /></h1>
<div id="header_oslogo"><img src="images/linuxlogo.png" /></div>
<h2>ZSNES Linux v1.42</h2>
</div>
<div id="header_nav">
[<a href="about.htm">About</a>] [<a href="credits.htm">Credits</a>] [<a href="http://www.zsnes.com/">ZSNES.com</a>] [<a href="http://www.zsnes.com/?page=donate">Donate</a>] [<a href="license.txt">GPL</a>]
</div>
<div id="navigation">
<h1>Navigation</h1>
<ul>
<li><span class="list_head"><a href="readme.htm">Readme</a></span></li>
<li><a href="readme.htm#whats_new">What's New</a></li>
<li><a href="readme.htm#previous_updates">Previous Updates</a></li>
<li><a href="readme.htm#disclaimer">Disclaimer</a></li>
<li><a href="readme.htm#system_requirements">System Requirements</a></li>
<li><a href="readme.htm#things_to_know">Things to Know</a></li>
<li><a href="readme.htm#current_progress">Current Progress</a></li>
<li><a href="readme.htm#default_keys">ZSNES Default Keys</a></li>
<li><a href="readme.htm#f1_menu">F1 Menu</a></li>
<li><a href="readme.htm#configuration_file">Configuration File</a></li>
<li><a href="readme.htm#cheat_codes">Cheat Codes</a></li>
<li><a href="readme.htm#extra_features">Extra Features</a></li>
<li><a href="readme.htm#bugs">Bugs</a></li>
<li><a href="readme.htm#contact_information">Contact Information</a></li>
<li><a href="readme.htm#credits">Credits</a></li>
</ul>
<ul>
<li><span class="list_head"><a href="gui.htm">GUI</a></span></li>
<li><a href="gui.htm#game_menu">Game Menu</a></li>
<li><a href="gui.htm#quick_menu">Quick Menu</a></li>
<li><a href="gui.htm#config_menu">Config Menu</a></li>
<li><a href="gui.htm#cheat_menu">Cheat Menu</a></li>
<li><a href="gui.htm#netplay_menu">Netplay Menu</a></li>
<li><a href="gui.htm#misc_menu">Misc Menu</a></li>
</ul>
<ul>
<li><span class="list_head"><a href="netplay.htm">Netplay</a></span></li>
<li><a href="netplay.htm#system_recommendations">Recommendations</a></li>
<li><a href="netplay.htm#simple_instructions">Simple Instructions</a></li>
<li><a href="netplay.htm#getting_the_ip_address">Getting the IP</a></li>
<li><a href="netplay.htm#connecting">Connecting</a></li>
<li><a href="netplay.htm#loading_a_game">Loading A Game</a></li>
<li><a href="netplay.htm#configuring_chat_window_options">Configuring</a></li>
</ul>
<ul>
<li><span class="list_head"><a href="bugs.htm">Bug Reports</a></span></li>
<li><a href="bugs.htm#filing_a_bug_report">Filing A Bug Report</a></li>
</ul>
<ul>
<li><span class="list_head"><a href="faq.htm">FAQ</a></span></li>
</ul>
</div>
<div id="content">
<h1>Bug Reports</h1>
<div class="content_body">
<a id="filing_a_bug_report"></a>
</div>
<h2>Filing A Bug Report</h2>
<div class="content_body">
There are a few simple things you can do to help us deal with your bug report more effectively.<br />
<br />
Before reporting, check the <a href="readme.htm">Readme</a> to find out about unsupported chips. You should also check for any recent bug reports on the <a href="http://board.zsnes.com">ZSNES boards</a>, as well as on the bug tracker at the <a href="http://sourceforge.net/projects/zsnes">ZSNES Development Page</a>.<br />
<br />
First, make sure you are using the latest version of ZSNES. It isn't helpful for us to test a game that's "broken" if you are using an older version, and don't tell us that fact, because we may have fixed it in a newer release. You can always download the latest version at the <a href="http://www.zsnes.com">official website</a>.<br />
<br />
Second, report whether you are using the Win32, SDL, or DOS port. Rarely is a problem port specific, but reporting the port used up front makes it much easier to get
a person with the proper port to test.<br />
<br />
Third, a detailed name of the game is helpful. It is common for a game to act differently in different regions. If possible, download <a href="http://nsrt.edgeemu.com">NSRT</a> and see if your ROM is a valid dump; if it is, provide the ROM info log (see the NSRT readme for more details) along with your bug report. If it is a bad dump, first get a good copy and see if the problem persists. Some bad or hacked dumps can be fixed by NSRT (Metal Combat is a good example). We will not take bug reports for bad dumps seriously.<br />
<br />
Fourth, describe the problem in detail. Is it an emulation bug? If not, can you reproduce it? If it is an emulation bug, investigate. Does the game lock up? Or does the sound fail? Are the graphics wrong? Provide details. Toggle the backgrounds or sound channels, and see if you can find anything, such as corruption in background 3 or errors in offset-per-tile. Does the old gfx engine act the same? Is a particular sound channel sticking on?<br />
<br />
When the game starts, does ZSNES say "OK" in the checksum field?<br />
<br />
Finally, do other SNES emulators run the game correctly?<br />
<br />
If you have any additional information, such as a previous version of ZSNES that ran the game properly, or if you know of another game that acts similarly, please let us know.<br />
<br />
Thanks.<br />
<br />
System specs are also nice, but less essential.<br />
</div>
</div>
<div id="footer">
Best viewed with a real browser, like Firefox.<br />
<a href="http://www.spreadfirefox.com/?q=affiliates&amp;id=51657&amp;t=64" style="background-color:#ffffff;"><img style="border:0;margin-right:3px;" alt="Get Firefox!" title="Get Firefox!" src="images/safer.png" /><img style="border:0;margin-left:3px;" alt="Get Firefox!" title="Get Firefox!" src="images/get.png" /></a>
</div>
<div id="version">
ZSNES Documentation v2.0
</div>
</body>
</html>