diff --git a/Troubleshooting.md b/Troubleshooting.md index d13a490..58d926c 100644 --- a/Troubleshooting.md +++ b/Troubleshooting.md @@ -226,17 +226,30 @@ If your configuration has been corrupted, or badly set, such that you can't run -- # Reporting a problem -Please report a problem as a new GitHub [issue](https://github.com/EDCD/EDMarketConnector/issues/new?assignees=&labels=bug%2C+unconfirmed&template=bug_report.md&title=) -. Please wait for the error to occur and zip up and attach this app's log file to the new issue: +Please report a problem as a new GitHub [issue](https://github.com/EDCD/EDMarketConnector/issues/new?assignees=&labels=bug%2C+unconfirmed&template=bug_report.md&title=). +. -Mac: +## 4.1.0 and later (including betas) +If you are using 4.1.0, or later (including betas of 4.1.0) then there is a new +set of rotated logfiles in the location: -* `$TMPDIR/EDMarketConnector.log` +* Windows: `%TMP%\EDMarketConnector\EDMarketConnector.log` +* Mac: `$TMPDIR/EDMarketConnector/EDMarketConnector.log` +* Linux: `$TMPDIR/EDMarketConnector/EDMarketConnector.log` -Windows: +These are *not* truncated on a new run, so there will be no need to re-create +the bug. They are, however, rotated (to `EDMarketConnector.log.1` and onwards) +if they reach 1 MiB in size. So check timestamps and contents to be sure you +upload the correct file! -* `%TMP%\EDMarketConnector.log` +These files also *always* contain DEBUG output, +whereas the file detailed below only contains raw `print()` output and anything +logged at the level you have configured. -**NB: This file is truncated (overwritten from the start) each time you -run the appication. So if you encounter an error make a copy of this -file *immediately*.** +## Pre-4.1.0 +Prior to EDMC 4.1.0 the only logfile is re-created on each run of the program. +As such you will need to re-create the issue and then make a copy of the file: + +* Windows: `%TMP%\EDMarketConnector.log` +* Mac: `$TMPDIR/EDMarketConnector.log` +* Linux: `$TMPDIR/EDMarketConnector.log`