05.12.2012 Views

Download the X-Plane 10 Manual - X-Plane.com

Download the X-Plane 10 Manual - X-Plane.com

Download the X-Plane 10 Manual - X-Plane.com

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

So, be sure to include proof that a characteristic of <strong>the</strong> simulator is wrong if you believe it to<br />

be so.<br />

Ano<strong>the</strong>r very <strong>com</strong>mon error is for people to install plug-ins that modify data in <strong>the</strong> simulator,<br />

third-party scenery packages that don’t quite follow <strong>the</strong> standards, or third-party airplanes that<br />

may have problems, and <strong>the</strong>n report it as a “bug” when something does not work correctly.<br />

We won’t be able to duplicate <strong>the</strong> problem if it is due to third-party modifications. So, be<br />

sure that starting from a freshly installed copy of X-<strong>Plane</strong> with <strong>the</strong> preferences (and any plug-ins)<br />

removed is <strong>the</strong> first item in your step-by-step walkthrough for recreating <strong>the</strong> problem. Build up<br />

from <strong>the</strong>re as needed, including each step in <strong>the</strong> checklist so that I can go through it and see <strong>the</strong><br />

same thing you see. Use only scenery and planes that <strong>com</strong>e with X-<strong>Plane</strong> if possible, so that I can<br />

duplicate <strong>the</strong> bug.<br />

Once again, be sure to:<br />

1. Use a checklist to explain what you are doing, starting with renaming <strong>the</strong> preferences.<br />

2. Include every step in <strong>the</strong> checklist that you send in your bug report.<br />

3. Use proper terminology. If you do not know <strong>the</strong> name of an instrument, <strong>the</strong>n go into <strong>Plane</strong><br />

Maker and click on it with <strong>the</strong> mouse. The X-<strong>Plane</strong> instrument name will be displayed at<br />

right. Alternatively, you can get <strong>the</strong> real name of <strong>the</strong> instrument by turning on <strong>the</strong> instrument<br />

instructions option (by going to <strong>the</strong> About menu, clicking Instructions, and checking <strong>the</strong> to<br />

get <strong>the</strong> Show instrument instructions in <strong>the</strong> cockpit box).<br />

4. Explain why you think <strong>the</strong> result you are seeing is wrong. Provide proof if you think <strong>the</strong><br />

simulator is not doing what <strong>the</strong> real plane would do.<br />

Remember, a bad report would say, “The pressure gauge does not work.” (Which pressure<br />

gauge? Why do you think it does not work? What do you expect it to show? What plane are you<br />

even flying?)<br />

A good report would say, “On a Mac running OS X Lion, I renamed <strong>the</strong> preferences and opened<br />

[an aircraft included with X-<strong>Plane</strong>] via <strong>the</strong> File menu, <strong>the</strong>n I set <strong>the</strong> controls as follows, <strong>the</strong>n<br />

I observed <strong>the</strong> manifold pressure gauge to indicate manifold pressure of zero as I advanced <strong>the</strong><br />

power, though in <strong>the</strong> real plane I would get 25 ′′ of manifold pressure in this plane, as I know from<br />

<strong>the</strong> following excerpt from <strong>the</strong> plane’s pilot’s operating handbook.”<br />

That report indicates what type of <strong>com</strong>puter you are using, what you do to get <strong>the</strong> problem<br />

(in a way that lets us perfectly mirror it), what you think <strong>the</strong> problem is, and it gives proof that<br />

what you believe about <strong>the</strong> plane is in fact true. That is enough info for me to work with!<br />

Also, be sure to send <strong>the</strong> log.txt file! This lists what type of <strong>com</strong>puter you have. Hardly anyone<br />

even thinks to mention whe<strong>the</strong>r <strong>the</strong>y are on Mac, Windows, or Linux!<br />

135

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!