| 8 | | To report an error in JOSM or to request a new feature please use always the |
| 9 | | [wikitr:/Help/Action/ReportBug Report bug] form. |
| 10 | | It can be invoked in the Help menu or with the [[Image(source:trunk/images/bug.png,middle,link=)]] button in this dialog. |
| 11 | | This includes all needed technical information in the ticket. |
| 12 | | Bug reports and feature request are called ''tickets'' in JOSM. |
| | 8 | Tip: starting with JOSM r17637, a status report can also be obtained from the [wikitr:/Help/CommandLineOptions command line] using `--status-report` |
| | 9 | |
| | 10 | **To report an error in JOSM or to request a new feature please use ''always'' the [wikitr:/Help/Action/ReportBug Report bug] form.** \\ |
| | 11 | It can be invoked in the Help menu or with the [[JOSMImage(bug)]] button in this dialog. This includes all needed technical information in the ticket. Bug reports and feature request are called ''tickets'' in JOSM. |
| 16 | | ||= Section =||= Description =||= Presence =||= '''Required in a bug report''' =|| |
| 17 | | || 1 Release || JOSM version details || Always || Yes || |
| 18 | | || [#a2System 2 System] || Operating system, Java, memory usage, screen size and [wikitr:/Help/CommandLineOptions command line options] || Always || Yes || |
| 19 | | || 3 Dataset consistency || Consistency of the [wikitr:/Help/Menu/OSMLayer current data layer] || If available || Yes, if available || |
| 20 | | || 4 Plugins || Installed [wikitr:/Plugins] || If available || Yes, if available || |
| 21 | | || 5 Tagging presets || Installed [wikitr:/Presets] || If available || Yes, if available || |
| 22 | | || 6 Map paint styles || Installed [wikitr:/Styles] || If available || Yes, if available || |
| 23 | | || 7 Validator Rules || Installed [wikitr:/Rules] || If available || Yes, if available || |
| 24 | | || 8 Last errors/warnings || Overview of last shown or hidden code errors/warnings of JOSM || If available || Yes, if available || |
| 25 | | || 9 Crash & Stack || Detailed info about the last JOSM code error || If available || Yes, if available || |
| 26 | | || [#a10Preference 10 Preferences] || Current settings || Always || No || |
| | 16 | ||= Section =||= Description =||= Status Report \\ Presence =||= Bug Report \\ Presence =||= **Required in a \\ bug report** =|| |
| | 17 | || [#a1Release 1 Release] || JOSM version details || Always || Always || Yes || |
| | 18 | || [#a2System 2 System] || Operating system, Java, memory usage, screen size and [wikitr:/Help/CommandLineOptions command line options] || Always || Always || Yes || |
| | 19 | || [#a3DatasetCons 3 Dataset consistency] || Consistency of the [wikitr:/Help/Menu/OSMLayer current data layer] || If available || If available || Yes, if available || |
| | 20 | || 4 Plugins || Installed [wikitr:/Plugins Plugins] || If available || If available || Yes, if available || |
| | 21 | || 5 Tagging presets || Installed [wikitr:/Presets Presets] || If available || If available || Yes, if available || |
| | 22 | || 6 Map paint styles || Installed [wikitr:/Styles Styles] || If available || If available || Yes, if available || |
| | 23 | || 7 Validator Rules || Installed [wikitr:/Rules Rules] || If available || If available || Yes, if available || |
| | 24 | || [#a8LastErrorsWarnings 8 Last errors/warnings] || Overview of last shown or hidden code errors/warnings of JOSM || If available || If available || Yes, if available || |
| | 25 | || [#a9CrashStack 9 Crash & Stack] || Detailed info about the last JOSM code error || No || If available || Yes, if available || |
| | 26 | || [#a10Threads 10 Threads] || All stack traces || No || Optional || Optional || |
| | 27 | || [#a11Preferences 11 Preferences] || Current settings || Always || No || **No** || |
| 35 | | === 10 Preferences === |
| | 47 | == 2 System == #a2System |
| | 48 | Memory Usage:: The first value is the size of the total memory currently used by the Java Virtual Machine (JVM) including JOSM and garbage. The second value is the max. memory the JVM will try to use, a limit can be the -Xmx option. At last, the third value is the free memory in the JVM. |
| | 49 | |
| | 50 | **Example**: |
| | 51 | {{{ |
| | 52 | Identification: JOSM/1.5 (16812 en) Linux Arch Linux |
| | 53 | Memory Usage: 387 MB / 3844 MB (191 MB allocated, but free) |
| | 54 | Java version: 11.0.8+10, N/A, OpenJDK 64-Bit Server VM |
| | 55 | Look and Feel: javax.swing.plaf.metal.MetalLookAndFeel |
| | 56 | Screen: :0.0 3840x2160 (scaling 1.0x1.0) |
| | 57 | Maximum Screen Size: 3840x2160 |
| | 58 | Best cursor sizes: 16x16 -> 16x16, 32x32 -> 32x32 |
| | 59 | VM arguments: [-Djosm.home=<josm.pref>] |
| | 60 | }}} |
| | 61 | |
| | 62 | == 3 Dataset consistency == #a3DatasetCons |
| | 63 | Only one line without separation to the System paragraph. |
| | 64 | |
| | 65 | **Example**: |
| | 66 | {{{ |
| | 67 | Dataset consistency test: No problems found |
| | 68 | }}} |
| | 69 | |
| | 70 | == 8 Last errors/warnings == #a8LastErrorsWarnings |
| | 71 | |
| | 72 | **Example**: |
| | 73 | {{{ |
| | 74 | Last errors/warnings: |
| | 75 | - E: java.nio.file.NoSuchFileException: ${HOME}/b.osm |
| | 76 | - E: Error - <html>Could not read file 'b.osm'.<br>Error is:<br>${HOME}/b.osm</html> |
| | 77 | }}} |
| | 78 | |
| | 79 | == 9 Crash & Stack == #a9CrashStack |
| | 80 | Only present after an error in the Report Bug dialog. |
| | 81 | |
| | 82 | == 10 Threads == #a10Threads |
| | 83 | Full stack traces of all running threads. Optionally available through check box in Report Bug dialog. |
| | 84 | |
| | 85 | == 11 Preferences == #a11Preferences |
| | 86 | **Not needed in tickets** |
