From 9e2e1494a4db8dd75fc72333a45fb6252a09ce20 Mon Sep 17 00:00:00 2001 From: Alaska Date: Thu, 9 May 2024 13:10:58 +1200 Subject: [PATCH 01/38] Intial commit Setup some pages for guides on how to manually collect infomration Some images are missing, and Linux stuff is missing. But this is just to get general feedback --- .../collect_system_information.md | 15 +++++ .../linux_information.md | 14 ++++ .../macos_information.md | 44 +++++++++++++ .../windows_information.md | 65 +++++++++++++++++++ 4 files changed, 138 insertions(+) create mode 100644 docs/handbook/bug_reports/making_good_bug_reports/collect_system_information.md create mode 100644 docs/handbook/bug_reports/making_good_bug_reports/linux_information.md create mode 100644 docs/handbook/bug_reports/making_good_bug_reports/macos_information.md create mode 100644 docs/handbook/bug_reports/making_good_bug_reports/windows_information.md diff --git a/docs/handbook/bug_reports/making_good_bug_reports/collect_system_information.md b/docs/handbook/bug_reports/making_good_bug_reports/collect_system_information.md new file mode 100644 index 00000000..0205563b --- /dev/null +++ b/docs/handbook/bug_reports/making_good_bug_reports/collect_system_information.md @@ -0,0 +1,15 @@ +# Manually Collecting System Information + +When reporting a bug you will be asked to provide some system information +and your Blender version number. This information can be automatically +collected and filled out by selecteing `Help > Report a bug` from the +top of Blender. Or selecting `Report a bug` on the add-on you want +to report a bug on. + +However, sometimes Blender won't open, so you can't use these features. +In which case you will need to collect the information manually. +To do that, check the guide for your operating system below. + +- [Windows](windows_information.md) +- [macOS](macos_information.md) +- [Linux](linux_information.md) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md new file mode 100644 index 00000000..7ddbb3af --- /dev/null +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -0,0 +1,14 @@ +# Linux System Information + +## Operating System + +TODO: `uname -r` in terminal? + +## Graphics Card + +TODO: Investigate how to get this info + +## Blender Version + +TODO: Investigate how to get version info, and see if there's anything +special for Snap. diff --git a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md new file mode 100644 index 00000000..8d4a96a2 --- /dev/null +++ b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md @@ -0,0 +1,44 @@ +# macOS System Information + +## Operating System + +Select from the top bar of macOS `Apple Icon > About This Mac`. Here you will find +your macOS version beside the field `macOS`. + +Share the information on the report form like this: `macOS 14.4.1` + +![](../../../images/macOS_get_os_version.jpg) + +## Graphics Card + +Open Launchpad from the dock and search for `System Information` and open the app +that appears. You will be find your graphics card information in the section +`Hardware > Graphics/Display`. The information we're interested in is the +`Chipset Model` and the `Metal Support`. + +Combine these two details together and share them in your bug report form +like this: `Apple M1 Pro - Metal 3` + +![](../../../images/macOS_get_gpu_info.jpg) + +## Blender Version + +Follow one of the guides below to obtain your Blender version number then +share it on your bug reporting form like this: `Blender 4.1.1` + +### Downloaded from Blender Website + +Navigate to where Blender is installed and right click on it and select `Get Info`. +You will find the Blender version number in the field `General > Version`. + +![](../../../images/macOS_get_blender_version.jpg) + +### Downloaded from Steam + +If you installed Blender through Steam, then open Steam, right click +on Blender and select the option `Manage > Browse local files`. +A file browser will appear showing where Blender is installed. +Right click on Blender and select `Get Info`. You will find the +Blender version number in the field `General > Version`. + +TODO: ADD IMAGE FOR STEAM diff --git a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md new file mode 100644 index 00000000..e796e0fa --- /dev/null +++ b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md @@ -0,0 +1,65 @@ +# Windows System Information + +## Operating System + +To collect operating system information, open the Windows settings app, +and navigate to the `System > About` page. Here you will find the operating +system information you need. They are: + +- System Type (E.g. x64 or ARM64) +- Windows Editon (E.g. Windows 10, Windows 11) +- OS Build + +Combine these details together and share them in the bug report form like this: +`Windows 11 22631.3447 x64 processor` + +TODO: ADD IMAGE + +## Graphics Card + +To collect information about your graphics card, right click a empty spot on +your task bar and select `Task Manager`. In the window that appears, +expand it to show more details, and go to the `Performance` tab. +In the performance tab you should find one or more `GPUs` in the collum on +the left. Click on them, and you will find the graphics card name +in the top right and the driver version in the bottom right. + +Combine these details together and share them in your bug report form like this: +`NVIDIA GeForce RTX 4090 - Driver 31.0.15.5186` + +TODO: ADD IMAGE + +## Blender Version + +Follow one of the guides below to obtain your Blender version number then +share it on your bug reporting form like this: `Blender 4.1.1` + +### Downloaded from Blender Website + +Navigate to where Blender is installed, right click on the file `blender.exe` +and select the `Properties` option. In the new window that appears, select +the `Details` tab and you will find the Blender version in the field +called `File Version`. + +TODO: ADD IMAGE + +### Downloaded from Steam + +If you installed Blender through Steam, then open Steam, right click +on Blender and select the option `Manage > Browse local files`. +A file browser will appear showing where Blender is installed. +Right click on the file `blender.exe` and select the `Properties` option. +In the new window that appears, select the `Details` tab and you will find +the Blender version in the field called `File Version`. + +TODO: ADD IMAGE + +### Downloaded from Microsoft Store + +If you installed Blender through the Microsoft store, then click on the Windows +icon on the task bar and find Blender in your apps list. Once you've found it, +right click on Blender and select `More > App Settings`. The settings app will +open and you will find the Blender version in the field `Specifications` with +the name `Version`. + +TODO: ADD IMAGE -- 2.30.2 From a97906e35e99ab3c6317d8afba91a303d3bc2b4f Mon Sep 17 00:00:00 2001 From: Alaska Date: Thu, 9 May 2024 13:14:38 +1200 Subject: [PATCH 02/38] Add images --- docs/images/macOS_get_blender_version.jpg | 3 +++ docs/images/macOS_get_gpu_info.jpg | 3 +++ docs/images/macOS_get_os_version.jpg | 3 +++ 3 files changed, 9 insertions(+) create mode 100644 docs/images/macOS_get_blender_version.jpg create mode 100644 docs/images/macOS_get_gpu_info.jpg create mode 100755 docs/images/macOS_get_os_version.jpg diff --git a/docs/images/macOS_get_blender_version.jpg b/docs/images/macOS_get_blender_version.jpg new file mode 100644 index 00000000..9fa5412b --- /dev/null +++ b/docs/images/macOS_get_blender_version.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:967662f45baa4c8f0d3a6b27f66a408827dd01c8d9613dd67d1d34b6488c313f +size 108047 diff --git a/docs/images/macOS_get_gpu_info.jpg b/docs/images/macOS_get_gpu_info.jpg new file mode 100644 index 00000000..de623c8b --- /dev/null +++ b/docs/images/macOS_get_gpu_info.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:aadee68b159ef9a534f3dd904f9b612f5985061ca1f95ab888ce206361e426d0 +size 49965 diff --git a/docs/images/macOS_get_os_version.jpg b/docs/images/macOS_get_os_version.jpg new file mode 100755 index 00000000..249f8e3a --- /dev/null +++ b/docs/images/macOS_get_os_version.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:bccc04f8dd4a3d704eda5a65a652b89778a4e8406fcf0489ed7d1de6e98d90f8 +size 67864 -- 2.30.2 From 45609b4ad192f1f95b32ab5db104560518ec1620 Mon Sep 17 00:00:00 2001 From: Alaska Date: Thu, 9 May 2024 13:23:19 +1200 Subject: [PATCH 03/38] Reword macOS graphics --- .../bug_reports/making_good_bug_reports/macos_information.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md index 8d4a96a2..3fa24904 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md @@ -11,8 +11,8 @@ Share the information on the report form like this: `macOS 14.4.1` ## Graphics Card -Open Launchpad from the dock and search for `System Information` and open the app -that appears. You will be find your graphics card information in the section +Open Launchpad from the dock, then search for and open the`System Information` +app. You will be find your graphics card information in the section `Hardware > Graphics/Display`. The information we're interested in is the `Chipset Model` and the `Metal Support`. -- 2.30.2 From 436ae710318edbcacfea1550a241f843b12320e0 Mon Sep 17 00:00:00 2001 From: Alaska Date: Sat, 11 May 2024 13:22:59 +1200 Subject: [PATCH 04/38] Add macOS steam image --- .../bug_reports/making_good_bug_reports/macos_information.md | 4 ++-- docs/images/macos_get_blender_version_steam.jpg | 3 +++ 2 files changed, 5 insertions(+), 2 deletions(-) create mode 100755 docs/images/macos_get_blender_version_steam.jpg diff --git a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md index 3fa24904..333aafa7 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md @@ -11,7 +11,7 @@ Share the information on the report form like this: `macOS 14.4.1` ## Graphics Card -Open Launchpad from the dock, then search for and open the`System Information` +Open Launchpad from the dock, then search for and open the `System Information` app. You will be find your graphics card information in the section `Hardware > Graphics/Display`. The information we're interested in is the `Chipset Model` and the `Metal Support`. @@ -41,4 +41,4 @@ A file browser will appear showing where Blender is installed. Right click on Blender and select `Get Info`. You will find the Blender version number in the field `General > Version`. -TODO: ADD IMAGE FOR STEAM +![](../../../images/macos_get_blender_version_steam.jpg) diff --git a/docs/images/macos_get_blender_version_steam.jpg b/docs/images/macos_get_blender_version_steam.jpg new file mode 100755 index 00000000..1321313c --- /dev/null +++ b/docs/images/macos_get_blender_version_steam.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:eeb122de8f46524943dddf75cb643dd25775bcd7f0f3eba94c3e9c443f0276d2 +size 206496 -- 2.30.2 From fce590aee14066962a741138dc048a85224202f9 Mon Sep 17 00:00:00 2001 From: Alaska Date: Sat, 11 May 2024 13:30:09 +1200 Subject: [PATCH 05/38] Adjust punctuation --- .../bug_reports/making_good_bug_reports/macos_information.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md index 333aafa7..95153049 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md @@ -23,7 +23,7 @@ like this: `Apple M1 Pro - Metal 3` ## Blender Version -Follow one of the guides below to obtain your Blender version number then +Follow one of the guides below to obtain your Blender version number, then share it on your bug reporting form like this: `Blender 4.1.1` ### Downloaded from Blender Website -- 2.30.2 From 4faf54a6f4ca5a798f664e914a33453f435ee894 Mon Sep 17 00:00:00 2001 From: Alaska Date: Sat, 11 May 2024 14:13:15 +1200 Subject: [PATCH 06/38] Add windows images --- .../making_good_bug_reports/windows_information.md | 14 +++++++------- docs/images/windows_get_blender_version.jpg | 3 +++ ...windows_get_blender_version_microsoft_store.jpg | 3 +++ docs/images/windows_get_blender_version_steam.jpg | 3 +++ docs/images/windows_get_gpu_info.jpg | 3 +++ docs/images/windows_get_os_version.jpg | 3 +++ 6 files changed, 22 insertions(+), 7 deletions(-) create mode 100755 docs/images/windows_get_blender_version.jpg create mode 100644 docs/images/windows_get_blender_version_microsoft_store.jpg create mode 100644 docs/images/windows_get_blender_version_steam.jpg create mode 100644 docs/images/windows_get_gpu_info.jpg create mode 100644 docs/images/windows_get_os_version.jpg diff --git a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md index e796e0fa..5420caab 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md @@ -11,9 +11,9 @@ system information you need. They are: - OS Build Combine these details together and share them in the bug report form like this: -`Windows 11 22631.3447 x64 processor` +`Windows 11 22631.3447 x64` -TODO: ADD IMAGE +![](../../../images/windows_get_os_version.jpg) ## Graphics Card @@ -27,12 +27,12 @@ in the top right and the driver version in the bottom right. Combine these details together and share them in your bug report form like this: `NVIDIA GeForce RTX 4090 - Driver 31.0.15.5186` -TODO: ADD IMAGE +![](../../../images/windows_get_gpu_info.jpg) ## Blender Version Follow one of the guides below to obtain your Blender version number then -share it on your bug reporting form like this: `Blender 4.1.1` +share it on your bug reporting form like this: `Blender 4.1.1.0` ### Downloaded from Blender Website @@ -41,7 +41,7 @@ and select the `Properties` option. In the new window that appears, select the `Details` tab and you will find the Blender version in the field called `File Version`. -TODO: ADD IMAGE +![](../../../images/windows_get_blender_version.jpg) ### Downloaded from Steam @@ -52,7 +52,7 @@ Right click on the file `blender.exe` and select the `Properties` option. In the new window that appears, select the `Details` tab and you will find the Blender version in the field called `File Version`. -TODO: ADD IMAGE +![](../../../images/windows_get_blender_version_steam.jpg) ### Downloaded from Microsoft Store @@ -62,4 +62,4 @@ right click on Blender and select `More > App Settings`. The settings app will open and you will find the Blender version in the field `Specifications` with the name `Version`. -TODO: ADD IMAGE +![](../../../images/windows_get_blender_version_microsoft_store.jpg) diff --git a/docs/images/windows_get_blender_version.jpg b/docs/images/windows_get_blender_version.jpg new file mode 100755 index 00000000..78f2a12e --- /dev/null +++ b/docs/images/windows_get_blender_version.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:bcb927a7c2f32dab67356f2ca76692d60bc0dccf52966215ecfaf39b02e0fbc6 +size 102492 diff --git a/docs/images/windows_get_blender_version_microsoft_store.jpg b/docs/images/windows_get_blender_version_microsoft_store.jpg new file mode 100644 index 00000000..d1d4fd0d --- /dev/null +++ b/docs/images/windows_get_blender_version_microsoft_store.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0cd4b3ca7fce3237202edee0b5bacf9547fcbf3f03f2d1b1beb180522fd75852 +size 32038 diff --git a/docs/images/windows_get_blender_version_steam.jpg b/docs/images/windows_get_blender_version_steam.jpg new file mode 100644 index 00000000..990c2cd3 --- /dev/null +++ b/docs/images/windows_get_blender_version_steam.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:2568ce74fc5a589b51be835b33f88600997d9aa8ccb83b2e09e71aa4338e61fb +size 132856 diff --git a/docs/images/windows_get_gpu_info.jpg b/docs/images/windows_get_gpu_info.jpg new file mode 100644 index 00000000..cad8d539 --- /dev/null +++ b/docs/images/windows_get_gpu_info.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:33c770442cee10bc2b1a1f48eff7f74fc72a4f15322fb77f9ce74abc74ecd233 +size 42640 diff --git a/docs/images/windows_get_os_version.jpg b/docs/images/windows_get_os_version.jpg new file mode 100644 index 00000000..3bd83584 --- /dev/null +++ b/docs/images/windows_get_os_version.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:e66b9b4d040869f2b3f427d8a9783ac4384ab797affb9bb51a1aad194858fb1d +size 61348 -- 2.30.2 From 57f36fbbb4ab6b08bea052b7437cde6f466ce9d2 Mon Sep 17 00:00:00 2001 From: Alaska Date: Sat, 11 May 2024 14:22:40 +1200 Subject: [PATCH 07/38] Blur out extra details on macOS images --- docs/images/macOS_get_blender_version.jpg | 4 ++-- docs/images/macOS_get_gpu_info.jpg | 4 ++-- docs/images/macOS_get_os_version.jpg | 4 ++-- docs/images/macos_get_blender_version_steam.jpg | 4 ++-- 4 files changed, 8 insertions(+), 8 deletions(-) mode change 100755 => 100644 docs/images/macOS_get_os_version.jpg mode change 100755 => 100644 docs/images/macos_get_blender_version_steam.jpg diff --git a/docs/images/macOS_get_blender_version.jpg b/docs/images/macOS_get_blender_version.jpg index 9fa5412b..0ccf564f 100644 --- a/docs/images/macOS_get_blender_version.jpg +++ b/docs/images/macOS_get_blender_version.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:967662f45baa4c8f0d3a6b27f66a408827dd01c8d9613dd67d1d34b6488c313f -size 108047 +oid sha256:ae5732cd7cb1f04ad42b68e15d424eda3ae8e2c6089eab7ecad6dfa0a65f8b96 +size 99141 diff --git a/docs/images/macOS_get_gpu_info.jpg b/docs/images/macOS_get_gpu_info.jpg index de623c8b..2531868e 100644 --- a/docs/images/macOS_get_gpu_info.jpg +++ b/docs/images/macOS_get_gpu_info.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:aadee68b159ef9a534f3dd904f9b612f5985061ca1f95ab888ce206361e426d0 -size 49965 +oid sha256:ca0d4da054f49a7d37c8c92471a23f50ac76b8ec44203969f928012cca3ca10b +size 48127 diff --git a/docs/images/macOS_get_os_version.jpg b/docs/images/macOS_get_os_version.jpg old mode 100755 new mode 100644 index 249f8e3a..f5fef3e0 --- a/docs/images/macOS_get_os_version.jpg +++ b/docs/images/macOS_get_os_version.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:bccc04f8dd4a3d704eda5a65a652b89778a4e8406fcf0489ed7d1de6e98d90f8 -size 67864 +oid sha256:df50c5ed03cdd7e31c2dde01a07628260d2a95e831fda6aba59cc010b4bd8e0a +size 66778 diff --git a/docs/images/macos_get_blender_version_steam.jpg b/docs/images/macos_get_blender_version_steam.jpg old mode 100755 new mode 100644 index 1321313c..f948e35a --- a/docs/images/macos_get_blender_version_steam.jpg +++ b/docs/images/macos_get_blender_version_steam.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:eeb122de8f46524943dddf75cb643dd25775bcd7f0f3eba94c3e9c443f0276d2 -size 206496 +oid sha256:28e4da87fb905f6c809ff9315af8aa3b2506f6102c3e56965b7ddc6a4d80ba7c +size 195305 -- 2.30.2 From 20ff419ea260e04fe1800fdfffa55122bc040c46 Mon Sep 17 00:00:00 2001 From: Alaska Date: Sat, 11 May 2024 16:27:24 +1200 Subject: [PATCH 08/38] Intial Linux documentation --- .../linux_information.md | 60 ++++++++++++++++++- .../images/linux_get_os_info_architecture.jpg | 3 + .../linux_get_os_info_display_server.jpg | 3 + docs/images/linux_get_os_info_glibc.jpg | 3 + docs/images/linux_get_os_info_kernel.jpg | 3 + 5 files changed, 69 insertions(+), 3 deletions(-) create mode 100644 docs/images/linux_get_os_info_architecture.jpg create mode 100644 docs/images/linux_get_os_info_display_server.jpg create mode 100644 docs/images/linux_get_os_info_glibc.jpg create mode 100644 docs/images/linux_get_os_info_kernel.jpg diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index 7ddbb3af..b49c2e8a 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -2,7 +2,36 @@ ## Operating System -TODO: `uname -r` in terminal? +We need to collect a few pieces of information for the Operating System information +field. They are Linux kernel version, CPU architecture, glibc version, and display server type. + +Follow the steps below and combine them together in the bug report form like this: +`Linux-6.8.0-31-generic-x86_64-with-glibc23.9, wayland` + +#### Linux Kernel Version + +Run `uname -r` in a terminal. + +![](../../../images/linux_get_os_info_kernel.jpg) + +#### CPU Architecture + +Run `lscpu | grep Architecture` in a terminal. + +![](../../../images/linux_get_os_info_architecture.jpg) + +#### glibc + +Run `ldd --version` in a terminal and extract the glibc version from the +first line of the output. + +![](../../../images/linux_get_os_info_glibc.jpg) + +#### Display Server + +Run `echo $XDG_SESSION_TYPE` in a terminal. + +![](../../../images/linux_get_os_info_display_server.jpg) ## Graphics Card @@ -10,5 +39,30 @@ TODO: Investigate how to get this info ## Blender Version -TODO: Investigate how to get version info, and see if there's anything -special for Snap. +Follow one of the guides below to obtain your Blender version number then +share it on your bug reporting form like this: `Blender 4.1.1` + +### Downloaded from Blender Website + +Navigate to where Blender is installed and run `/path/to/blender --verison` +in a terminal. The Blender version can be found in the first line of the out. + +TODO: Does this work when Blender can't open? If this does work, then do we want to do this on Windows and macOS as well? + +### Downloaded from Steam + +Open Steam, right click on Blender and select the option +`Manage > Browse local files`. A file browser will open displaying the path +to where Blender is installed. Open a terminal and run /path/to/blender --verison`. +The Blender version can be found in the first line of the out. + +TODO: Add image + +### Downloaded from snap + +Open a terminal and run `snap list | grep blender`. In the output you will find +Blender with a version numbder listed beside it. + +TODO: Add image + + diff --git a/docs/images/linux_get_os_info_architecture.jpg b/docs/images/linux_get_os_info_architecture.jpg new file mode 100644 index 00000000..75f69693 --- /dev/null +++ b/docs/images/linux_get_os_info_architecture.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:10c887c2ed479b8ece294d00d5c243055fc984c0a158425ce9d028dcb3b5f569 +size 14922 diff --git a/docs/images/linux_get_os_info_display_server.jpg b/docs/images/linux_get_os_info_display_server.jpg new file mode 100644 index 00000000..5f24a86e --- /dev/null +++ b/docs/images/linux_get_os_info_display_server.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:b93840a2330608832adce3a2d25ef8b7fbc75ec716742978bbbbbee204a099a5 +size 10976 diff --git a/docs/images/linux_get_os_info_glibc.jpg b/docs/images/linux_get_os_info_glibc.jpg new file mode 100644 index 00000000..f32a45e2 --- /dev/null +++ b/docs/images/linux_get_os_info_glibc.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:b1f4317d51d8598ef2cc4bfc73c49e449165b1dbf5ffb5be684089d802caab76 +size 14585 diff --git a/docs/images/linux_get_os_info_kernel.jpg b/docs/images/linux_get_os_info_kernel.jpg new file mode 100644 index 00000000..d551b37d --- /dev/null +++ b/docs/images/linux_get_os_info_kernel.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:8a3bcde5f1759da3e99e3c4246518f833d523f631985ca912df7b8724994155e +size 9738 -- 2.30.2 From 0438854e0b54c9c5f7471a9eae3d024d50da5b47 Mon Sep 17 00:00:00 2001 From: Alaska Date: Sat, 11 May 2024 16:35:06 +1200 Subject: [PATCH 09/38] Adjust some wording --- .../linux_information.md | 2 +- .../macos_information.md | 9 ++++----- .../windows_information.md | 20 +++++++++---------- 3 files changed, 14 insertions(+), 17 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index b49c2e8a..ff85846a 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -47,7 +47,7 @@ share it on your bug reporting form like this: `Blender 4.1.1` Navigate to where Blender is installed and run `/path/to/blender --verison` in a terminal. The Blender version can be found in the first line of the out. -TODO: Does this work when Blender can't open? If this does work, then do we want to do this on Windows and macOS as well? +TODO: Does this work when Blender can't open (It likely does if the GPU is too old, but what if the glibc version is too old)? If this does work, then do we want to do this on Windows and macOS as well? Linux users are more like to be comfortable with using the terminal than the average Windows and macOS user. ### Downloaded from Steam diff --git a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md index 95153049..7d857180 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md @@ -35,10 +35,9 @@ You will find the Blender version number in the field `General > Version`. ### Downloaded from Steam -If you installed Blender through Steam, then open Steam, right click -on Blender and select the option `Manage > Browse local files`. -A file browser will appear showing where Blender is installed. -Right click on Blender and select `Get Info`. You will find the -Blender version number in the field `General > Version`. +Open Steam, right click on Blender and select the option +`Manage > Browse local files`. A file browser will appear showing where +Blender is installed. Right click on Blender and select `Get Info`. +You will find the Blender version number in the field `General > Version`. ![](../../../images/macos_get_blender_version_steam.jpg) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md index 5420caab..72c53a88 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md @@ -45,21 +45,19 @@ called `File Version`. ### Downloaded from Steam -If you installed Blender through Steam, then open Steam, right click -on Blender and select the option `Manage > Browse local files`. -A file browser will appear showing where Blender is installed. -Right click on the file `blender.exe` and select the `Properties` option. -In the new window that appears, select the `Details` tab and you will find -the Blender version in the field called `File Version`. +Open Steam, right click on Blender and select the option +`Manage > Browse local files`. A file browser will appear showing where +Blender is installed. Right click on the file `blender.exe` and select +the `Properties` option. In the new window that appears, select the `Details` +tab and you will find the Blender version in the field called `File Version`. ![](../../../images/windows_get_blender_version_steam.jpg) ### Downloaded from Microsoft Store -If you installed Blender through the Microsoft store, then click on the Windows -icon on the task bar and find Blender in your apps list. Once you've found it, -right click on Blender and select `More > App Settings`. The settings app will -open and you will find the Blender version in the field `Specifications` with -the name `Version`. +Click on the Windows icon on the task bar and find Blender in your apps list. +Once you've found it, right click on Blender and select `More > App Settings`. +The settings app will open and you will find the Blender version in the section +`Specifications` with in the field `Version`. ![](../../../images/windows_get_blender_version_microsoft_store.jpg) -- 2.30.2 From 2d9663c9d5125bbd9dcf2c6c3fc0637a8af768a2 Mon Sep 17 00:00:00 2001 From: Alaska Date: Sat, 11 May 2024 16:48:26 +1200 Subject: [PATCH 10/38] Add some images for Linux page --- .../linux_information.md | 20 ++++++++++++------- docs/images/linux_get_blender_version.jpg | 3 +++ .../images/linux_get_blender_version_snap.jpg | 3 +++ 3 files changed, 19 insertions(+), 7 deletions(-) create mode 100644 docs/images/linux_get_blender_version.jpg create mode 100644 docs/images/linux_get_blender_version_snap.jpg diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index ff85846a..7dc585f5 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -35,7 +35,12 @@ Run `echo $XDG_SESSION_TYPE` in a terminal. ## Graphics Card -TODO: Investigate how to get this info +TODO: Pick an option: `lspci -k | grep -EA3 'VGA|3D|Display'` or `glxinfo -B` +or something else? +`lspci` should be accessible on every Linux system, but the driver version is not +printed. `glxinfo` may need to be installed on some distros (Including Ubuntu), +but it prints GPU and driver version. `glxinfo` is usally proviede as part +of `mesa-utils`, so the vast majority of distros should offer it. ## Blender Version @@ -45,7 +50,9 @@ share it on your bug reporting form like this: `Blender 4.1.1` ### Downloaded from Blender Website Navigate to where Blender is installed and run `/path/to/blender --verison` -in a terminal. The Blender version can be found in the first line of the out. +in a terminal. The Blender version can be found in the first line of the output. + +![](../../../images/linux_get_blender_version.jpg) TODO: Does this work when Blender can't open (It likely does if the GPU is too old, but what if the glibc version is too old)? If this does work, then do we want to do this on Windows and macOS as well? Linux users are more like to be comfortable with using the terminal than the average Windows and macOS user. @@ -53,8 +60,9 @@ TODO: Does this work when Blender can't open (It likely does if the GPU is too o Open Steam, right click on Blender and select the option `Manage > Browse local files`. A file browser will open displaying the path -to where Blender is installed. Open a terminal and run /path/to/blender --verison`. -The Blender version can be found in the first line of the out. +to where Blender is installed. Open a terminal and run +`/path/to/blender --verison`. The Blender version can be found in the first line +of the output. TODO: Add image @@ -63,6 +71,4 @@ TODO: Add image Open a terminal and run `snap list | grep blender`. In the output you will find Blender with a version numbder listed beside it. -TODO: Add image - - +![](../../../images/linux_get_blender_version_snap.jpg) diff --git a/docs/images/linux_get_blender_version.jpg b/docs/images/linux_get_blender_version.jpg new file mode 100644 index 00000000..c6e00dab --- /dev/null +++ b/docs/images/linux_get_blender_version.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:e4ffd399e4e1d17b3f09e7f278881f08d4e9f3864002562f2e0b9c1fb5eb8cd3 +size 25852 diff --git a/docs/images/linux_get_blender_version_snap.jpg b/docs/images/linux_get_blender_version_snap.jpg new file mode 100644 index 00000000..49ec0cca --- /dev/null +++ b/docs/images/linux_get_blender_version_snap.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:95ce7ac927bbb1e918bde55d4771650300974dc490c01ddba50f42c56f4b23b4 +size 13251 -- 2.30.2 From 1311f9bbb1b4b2bc21d01c932b26d552ea0007c2 Mon Sep 17 00:00:00 2001 From: Alaska Date: Sun, 12 May 2024 01:40:37 +1200 Subject: [PATCH 11/38] Adjust wording in Linux page --- .../making_good_bug_reports/linux_information.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index 7dc585f5..d4683344 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -3,9 +3,11 @@ ## Operating System We need to collect a few pieces of information for the Operating System information -field. They are Linux kernel version, CPU architecture, glibc version, and display server type. +field. They are Linux kernel version, CPU architecture, glibc version, +and display server type. -Follow the steps below and combine them together in the bug report form like this: +Follow the steps below to collect the information and combine them together +in the bug report form like this: `Linux-6.8.0-31-generic-x86_64-with-glibc23.9, wayland` #### Linux Kernel Version @@ -64,7 +66,7 @@ to where Blender is installed. Open a terminal and run `/path/to/blender --verison`. The Blender version can be found in the first line of the output. -TODO: Add image +TODO: Add image? ### Downloaded from snap -- 2.30.2 From 425b21731eebf39ced5fc66b1f6c41feb01f1198 Mon Sep 17 00:00:00 2001 From: Alaska Date: Sun, 12 May 2024 16:33:42 +1200 Subject: [PATCH 12/38] Update Linux GPU comment --- .../making_good_bug_reports/linux_information.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index d4683344..b9040c86 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -40,9 +40,15 @@ Run `echo $XDG_SESSION_TYPE` in a terminal. TODO: Pick an option: `lspci -k | grep -EA3 'VGA|3D|Display'` or `glxinfo -B` or something else? `lspci` should be accessible on every Linux system, but the driver version is not -printed. `glxinfo` may need to be installed on some distros (Including Ubuntu), -but it prints GPU and driver version. `glxinfo` is usally proviede as part -of `mesa-utils`, so the vast majority of distros should offer it. +printed. Is this enough? `glxinfo` may need to be installed on some distros +(Ubuntu needs it installed), but it prints GPU and driver version. +But only of the active display GPU, which may not be the GPU the the user is +launching Blender with. `glxinfo` is usally provided as part of `mesa-utils`, so +the vast majority of distros should offer it. + +We can write guides for each GPU vendor, but this means we need to keep it +updated as new GPU vendors are introduced (which may become more common if the +Blender foundation makes a ARM on Linux version). ## Blender Version -- 2.30.2 From 23a72159fddcf83424216f84fc1c5043c68b3ab1 Mon Sep 17 00:00:00 2001 From: Alaska Date: Mon, 13 May 2024 20:23:07 +1200 Subject: [PATCH 13/38] Fix incorrect glib version in example --- .../bug_reports/making_good_bug_reports/linux_information.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index b9040c86..eb91c038 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -8,7 +8,7 @@ and display server type. Follow the steps below to collect the information and combine them together in the bug report form like this: -`Linux-6.8.0-31-generic-x86_64-with-glibc23.9, wayland` +`Linux-6.8.0-31-generic-x86_64-glibc2.39, wayland` #### Linux Kernel Version -- 2.30.2 From 91ca70fb51a40655a86e06b3f70bfeb1c9d858ba Mon Sep 17 00:00:00 2001 From: Alaska Date: Mon, 13 May 2024 20:39:00 +1200 Subject: [PATCH 14/38] Mention both ways of obtaining GPU information --- .../linux_information.md | 30 ++++++++++++------- 1 file changed, 19 insertions(+), 11 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index eb91c038..3346da45 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -37,18 +37,26 @@ Run `echo $XDG_SESSION_TYPE` in a terminal. ## Graphics Card -TODO: Pick an option: `lspci -k | grep -EA3 'VGA|3D|Display'` or `glxinfo -B` -or something else? -`lspci` should be accessible on every Linux system, but the driver version is not -printed. Is this enough? `glxinfo` may need to be installed on some distros -(Ubuntu needs it installed), but it prints GPU and driver version. -But only of the active display GPU, which may not be the GPU the the user is -launching Blender with. `glxinfo` is usally provided as part of `mesa-utils`, so -the vast majority of distros should offer it. +There are two main ways we recommend to collect GPU information on Linux. +`glxinfo`, or `lspci` if `glxinfo` isn't avaliable. -We can write guides for each GPU vendor, but this means we need to keep it -updated as new GPU vendors are introduced (which may become more common if the -Blender foundation makes a ARM on Linux version). +#### glxinfo + +Run `glxinfo -B` in a terminal (you may need to install glxinfo from your +package manager). This will provide you with the GPU name, driver type, and +driver version of the display GPU (the GPU usually used by Blender). +Combine these details together and include them on your bug report form like this: +`AMD Radeon RX 7800XT - Driver Mesa 24.1.0-devel` + +TODO: Add image + +#### lspci + +Run `lspci -k | grep -EA3 'VGA|3D|Display` in a terminal. +This will tell you which graphics cards you have. Collect the GPU name +and include it on your bug report form like this: `Radeon RX 7700 XT / 7800 XT` + +TODO: Add Image ## Blender Version -- 2.30.2 From c745c135f3f5cd81a9743c93eb12290e1eaef463 Mon Sep 17 00:00:00 2001 From: Alaska Date: Mon, 13 May 2024 21:24:18 +1200 Subject: [PATCH 15/38] Remove todo about checking if blender --version works if Blender can't open --- .../bug_reports/making_good_bug_reports/linux_information.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index 3346da45..fd25f0b4 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -70,8 +70,6 @@ in a terminal. The Blender version can be found in the first line of the output. ![](../../../images/linux_get_blender_version.jpg) -TODO: Does this work when Blender can't open (It likely does if the GPU is too old, but what if the glibc version is too old)? If this does work, then do we want to do this on Windows and macOS as well? Linux users are more like to be comfortable with using the terminal than the average Windows and macOS user. - ### Downloaded from Steam Open Steam, right click on Blender and select the option -- 2.30.2 From 0b41d1673d43fbf685957fbe2e4aee6d382dcb1d Mon Sep 17 00:00:00 2001 From: Alaska Date: Tue, 14 May 2024 23:07:06 +1200 Subject: [PATCH 16/38] Move images --- .../images/linux_get_blender_version.jpg | 0 .../images/linux_get_blender_version_snap.jpg | 0 .../images/linux_get_os_info_architecture.jpg | 0 .../images/linux_get_os_info_display_server.jpg | 0 .../images/linux_get_os_info_glibc.jpg | 0 .../images/linux_get_os_info_kernel.jpg | 0 .../images/macOS_get_blender_version.jpg | 0 .../images/macOS_get_blender_version_steam.jpg} | 0 .../images/macOS_get_gpu_info.jpg | 0 .../images/macOS_get_os_version.jpg | 0 .../images/windows_get_blender_version.jpg | 0 ...windows_get_blender_version_microsoft_store.jpg | 0 .../images/windows_get_blender_version_steam.jpg | 0 .../images/windows_get_gpu_info.jpg | 0 .../images/windows_get_os_version.jpg | 0 .../making_good_bug_reports/linux_information.md | 14 +++++++------- .../making_good_bug_reports/macos_information.md | 8 ++++---- .../making_good_bug_reports/windows_information.md | 10 +++++----- 18 files changed, 16 insertions(+), 16 deletions(-) rename docs/{ => handbook/bug_reports/making_good_bug_reports}/images/linux_get_blender_version.jpg (100%) rename docs/{ => handbook/bug_reports/making_good_bug_reports}/images/linux_get_blender_version_snap.jpg (100%) rename docs/{ => handbook/bug_reports/making_good_bug_reports}/images/linux_get_os_info_architecture.jpg (100%) rename docs/{ => handbook/bug_reports/making_good_bug_reports}/images/linux_get_os_info_display_server.jpg (100%) rename docs/{ => handbook/bug_reports/making_good_bug_reports}/images/linux_get_os_info_glibc.jpg (100%) rename docs/{ => handbook/bug_reports/making_good_bug_reports}/images/linux_get_os_info_kernel.jpg (100%) rename docs/{ => handbook/bug_reports/making_good_bug_reports}/images/macOS_get_blender_version.jpg (100%) rename docs/{images/macos_get_blender_version_steam.jpg => handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam.jpg} (100%) rename docs/{ => handbook/bug_reports/making_good_bug_reports}/images/macOS_get_gpu_info.jpg (100%) rename docs/{ => handbook/bug_reports/making_good_bug_reports}/images/macOS_get_os_version.jpg (100%) rename docs/{ => handbook/bug_reports/making_good_bug_reports}/images/windows_get_blender_version.jpg (100%) rename docs/{ => handbook/bug_reports/making_good_bug_reports}/images/windows_get_blender_version_microsoft_store.jpg (100%) rename docs/{ => handbook/bug_reports/making_good_bug_reports}/images/windows_get_blender_version_steam.jpg (100%) rename docs/{ => handbook/bug_reports/making_good_bug_reports}/images/windows_get_gpu_info.jpg (100%) rename docs/{ => handbook/bug_reports/making_good_bug_reports}/images/windows_get_os_version.jpg (100%) diff --git a/docs/images/linux_get_blender_version.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version.jpg similarity index 100% rename from docs/images/linux_get_blender_version.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version.jpg diff --git a/docs/images/linux_get_blender_version_snap.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version_snap.jpg similarity index 100% rename from docs/images/linux_get_blender_version_snap.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version_snap.jpg diff --git a/docs/images/linux_get_os_info_architecture.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_os_info_architecture.jpg similarity index 100% rename from docs/images/linux_get_os_info_architecture.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_os_info_architecture.jpg diff --git a/docs/images/linux_get_os_info_display_server.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_os_info_display_server.jpg similarity index 100% rename from docs/images/linux_get_os_info_display_server.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_os_info_display_server.jpg diff --git a/docs/images/linux_get_os_info_glibc.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_os_info_glibc.jpg similarity index 100% rename from docs/images/linux_get_os_info_glibc.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_os_info_glibc.jpg diff --git a/docs/images/linux_get_os_info_kernel.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_os_info_kernel.jpg similarity index 100% rename from docs/images/linux_get_os_info_kernel.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_os_info_kernel.jpg diff --git a/docs/images/macOS_get_blender_version.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version.jpg similarity index 100% rename from docs/images/macOS_get_blender_version.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version.jpg diff --git a/docs/images/macos_get_blender_version_steam.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam.jpg similarity index 100% rename from docs/images/macos_get_blender_version_steam.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam.jpg diff --git a/docs/images/macOS_get_gpu_info.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_gpu_info.jpg similarity index 100% rename from docs/images/macOS_get_gpu_info.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_gpu_info.jpg diff --git a/docs/images/macOS_get_os_version.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_os_version.jpg similarity index 100% rename from docs/images/macOS_get_os_version.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_os_version.jpg diff --git a/docs/images/windows_get_blender_version.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version.jpg similarity index 100% rename from docs/images/windows_get_blender_version.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version.jpg diff --git a/docs/images/windows_get_blender_version_microsoft_store.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_microsoft_store.jpg similarity index 100% rename from docs/images/windows_get_blender_version_microsoft_store.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_microsoft_store.jpg diff --git a/docs/images/windows_get_blender_version_steam.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_steam.jpg similarity index 100% rename from docs/images/windows_get_blender_version_steam.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_steam.jpg diff --git a/docs/images/windows_get_gpu_info.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_gpu_info.jpg similarity index 100% rename from docs/images/windows_get_gpu_info.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_gpu_info.jpg diff --git a/docs/images/windows_get_os_version.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_os_version.jpg similarity index 100% rename from docs/images/windows_get_os_version.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_os_version.jpg diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index fd25f0b4..cfaf7aac 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -14,26 +14,26 @@ in the bug report form like this: Run `uname -r` in a terminal. -![](../../../images/linux_get_os_info_kernel.jpg) +![](./images/linux_get_os_info_kernel.jpg) #### CPU Architecture Run `lscpu | grep Architecture` in a terminal. -![](../../../images/linux_get_os_info_architecture.jpg) +![](./images/linux_get_os_info_architecture.jpg) #### glibc Run `ldd --version` in a terminal and extract the glibc version from the first line of the output. -![](../../../images/linux_get_os_info_glibc.jpg) +![](./images/linux_get_os_info_glibc.jpg) #### Display Server Run `echo $XDG_SESSION_TYPE` in a terminal. -![](../../../images/linux_get_os_info_display_server.jpg) +![](./images/linux_get_os_info_display_server.jpg) ## Graphics Card @@ -46,7 +46,7 @@ Run `glxinfo -B` in a terminal (you may need to install glxinfo from your package manager). This will provide you with the GPU name, driver type, and driver version of the display GPU (the GPU usually used by Blender). Combine these details together and include them on your bug report form like this: -`AMD Radeon RX 7800XT - Driver Mesa 24.1.0-devel` +`AMD Radeon RX 7800XT radeonsi - Mesa 24.1.0-devel` TODO: Add image @@ -68,7 +68,7 @@ share it on your bug reporting form like this: `Blender 4.1.1` Navigate to where Blender is installed and run `/path/to/blender --verison` in a terminal. The Blender version can be found in the first line of the output. -![](../../../images/linux_get_blender_version.jpg) +![](./images/linux_get_blender_version.jpg) ### Downloaded from Steam @@ -85,4 +85,4 @@ TODO: Add image? Open a terminal and run `snap list | grep blender`. In the output you will find Blender with a version numbder listed beside it. -![](../../../images/linux_get_blender_version_snap.jpg) +![](./images/linux_get_blender_version_snap.jpg) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md index 7d857180..d6b0f07f 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md @@ -7,7 +7,7 @@ your macOS version beside the field `macOS`. Share the information on the report form like this: `macOS 14.4.1` -![](../../../images/macOS_get_os_version.jpg) +![](./images/macOS_get_os_version.jpg) ## Graphics Card @@ -19,7 +19,7 @@ app. You will be find your graphics card information in the section Combine these two details together and share them in your bug report form like this: `Apple M1 Pro - Metal 3` -![](../../../images/macOS_get_gpu_info.jpg) +![](./images/macOS_get_gpu_info.jpg) ## Blender Version @@ -31,7 +31,7 @@ share it on your bug reporting form like this: `Blender 4.1.1` Navigate to where Blender is installed and right click on it and select `Get Info`. You will find the Blender version number in the field `General > Version`. -![](../../../images/macOS_get_blender_version.jpg) +![](./images/macOS_get_blender_version.jpg) ### Downloaded from Steam @@ -40,4 +40,4 @@ Open Steam, right click on Blender and select the option Blender is installed. Right click on Blender and select `Get Info`. You will find the Blender version number in the field `General > Version`. -![](../../../images/macos_get_blender_version_steam.jpg) +![](./images/macOS_get_blender_version_steam.jpg) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md index 72c53a88..bdf51627 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md @@ -13,7 +13,7 @@ system information you need. They are: Combine these details together and share them in the bug report form like this: `Windows 11 22631.3447 x64` -![](../../../images/windows_get_os_version.jpg) +![](./images/windows_get_os_version.jpg) ## Graphics Card @@ -27,7 +27,7 @@ in the top right and the driver version in the bottom right. Combine these details together and share them in your bug report form like this: `NVIDIA GeForce RTX 4090 - Driver 31.0.15.5186` -![](../../../images/windows_get_gpu_info.jpg) +![](./images/windows_get_gpu_info.jpg) ## Blender Version @@ -41,7 +41,7 @@ and select the `Properties` option. In the new window that appears, select the `Details` tab and you will find the Blender version in the field called `File Version`. -![](../../../images/windows_get_blender_version.jpg) +![](./images/windows_get_blender_version.jpg) ### Downloaded from Steam @@ -51,7 +51,7 @@ Blender is installed. Right click on the file `blender.exe` and select the `Properties` option. In the new window that appears, select the `Details` tab and you will find the Blender version in the field called `File Version`. -![](../../../images/windows_get_blender_version_steam.jpg) +![](./images/windows_get_blender_version_steam.jpg) ### Downloaded from Microsoft Store @@ -60,4 +60,4 @@ Once you've found it, right click on Blender and select `More > App Settings`. The settings app will open and you will find the Blender version in the section `Specifications` with in the field `Version`. -![](../../../images/windows_get_blender_version_microsoft_store.jpg) +![](./images/windows_get_blender_version_microsoft_store.jpg) -- 2.30.2 From 70dd4eb4a62a9dad4ad222e48e591176a9e2da13 Mon Sep 17 00:00:00 2001 From: Alaska Date: Tue, 14 May 2024 23:12:25 +1200 Subject: [PATCH 17/38] Switch to dxdiag for Windows OS and GPU information --- .../images/windows_get_gpu_info.jpg | 4 ++-- .../images/windows_get_os_version.jpg | 4 ++-- .../windows_information.md | 21 ++++++------------- 3 files changed, 10 insertions(+), 19 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_gpu_info.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_gpu_info.jpg index cad8d539..046f8c46 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_gpu_info.jpg +++ b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_gpu_info.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:33c770442cee10bc2b1a1f48eff7f74fc72a4f15322fb77f9ce74abc74ecd233 -size 42640 +oid sha256:a4b1ad669d79bdf65e090524459cf4cbe2913d8591f62246b350a4ea8ed57435 +size 77409 diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_os_version.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_os_version.jpg index 3bd83584..eade4d7d 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_os_version.jpg +++ b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_os_version.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:e66b9b4d040869f2b3f427d8a9783ac4384ab797affb9bb51a1aad194858fb1d -size 61348 +oid sha256:c69f7cde80d2efd1148e4a79a0fee367c4d7046a6c322ca0dc948adcec797796 +size 94166 diff --git a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md index bdf51627..70e9d774 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md @@ -2,27 +2,18 @@ ## Operating System -To collect operating system information, open the Windows settings app, -and navigate to the `System > About` page. Here you will find the operating -system information you need. They are: +Click on the search icon on the task bar, then search for and open `dxdiag`. -- System Type (E.g. x64 or ARM64) -- Windows Editon (E.g. Windows 10, Windows 11) -- OS Build - -Combine these details together and share them in the bug report form like this: -`Windows 11 22631.3447 x64` +A DirectX Diagnostic Tool window will open. You will find the operating system +version visible in the `System` tab. Copy it onto your bug report form like this: +`Windows 11 Home 64-bit (1.0, Build 22631)`. ![](./images/windows_get_os_version.jpg) ## Graphics Card -To collect information about your graphics card, right click a empty spot on -your task bar and select `Task Manager`. In the window that appears, -expand it to show more details, and go to the `Performance` tab. -In the performance tab you should find one or more `GPUs` in the collum on -the left. Click on them, and you will find the graphics card name -in the top right and the driver version in the bottom right. +With `dxdiag`, navigate to the `Display` or `Render` tab and you will find +the `Device name` and `Driver version` of your graphics card. Combine these details together and share them in your bug report form like this: `NVIDIA GeForce RTX 4090 - Driver 31.0.15.5186` -- 2.30.2 From 0eccd530a075b8cf2c06c186270c2361442fef2c Mon Sep 17 00:00:00 2001 From: Alaska Date: Wed, 15 May 2024 00:06:45 +1200 Subject: [PATCH 18/38] Add images for missing Linux parts --- .../images/linux_get_blender_version_steam.jpg | 3 +++ .../images/linux_get_gpu_info_glxinfo.jpg | 3 +++ .../images/linux_get_gpu_info_lspci.jpg | 3 +++ .../making_good_bug_reports/linux_information.md | 14 +++++++------- 4 files changed, 16 insertions(+), 7 deletions(-) create mode 100644 docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version_steam.jpg create mode 100644 docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_gpu_info_glxinfo.jpg create mode 100644 docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_gpu_info_lspci.jpg diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version_steam.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version_steam.jpg new file mode 100644 index 00000000..429be356 --- /dev/null +++ b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version_steam.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:1114575695dea5a11bc37ec806744fdc585ab326c47ee21d221444cc76b118c2 +size 79322 diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_gpu_info_glxinfo.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_gpu_info_glxinfo.jpg new file mode 100644 index 00000000..6cb81212 --- /dev/null +++ b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_gpu_info_glxinfo.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:76e6ba601e6d362c4a3615b0e4e4cbd9bf8ee5864031e879aabe248ff60d7408 +size 62916 diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_gpu_info_lspci.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_gpu_info_lspci.jpg new file mode 100644 index 00000000..34a267a5 --- /dev/null +++ b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_gpu_info_lspci.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:7b5edc994c301fee475964560b16bb45537972a85049b8d887062eb0eb202a75 +size 51217 diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index cfaf7aac..6ca7c448 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -3,7 +3,7 @@ ## Operating System We need to collect a few pieces of information for the Operating System information -field. They are Linux kernel version, CPU architecture, glibc version, +field. They are the Linux kernel version, CPU architecture, glibc version, and display server type. Follow the steps below to collect the information and combine them together @@ -46,17 +46,17 @@ Run `glxinfo -B` in a terminal (you may need to install glxinfo from your package manager). This will provide you with the GPU name, driver type, and driver version of the display GPU (the GPU usually used by Blender). Combine these details together and include them on your bug report form like this: -`AMD Radeon RX 7800XT radeonsi - Mesa 24.1.0-devel` +`AMD Radeon RX 7800XT - Mesa 24.1.0-devel` -TODO: Add image +![](./images/linux_get_gpu_info_glxinfo.jpg) #### lspci Run `lspci -k | grep -EA3 'VGA|3D|Display` in a terminal. -This will tell you which graphics cards you have. Collect the GPU name -and include it on your bug report form like this: `Radeon RX 7700 XT / 7800 XT` +This will tell you which graphics cards you have. Copy the GPU name +and include it on your bug report form like this: `AMD Radeon RX 7700 XT / 7800 XT` -TODO: Add Image +![](./images/linux_get_gpu_info_lspci.jpg) ## Blender Version @@ -78,7 +78,7 @@ to where Blender is installed. Open a terminal and run `/path/to/blender --verison`. The Blender version can be found in the first line of the output. -TODO: Add image? +![](./images/linux_get_blender_version_steam.jpg) ### Downloaded from snap -- 2.30.2 From 3a342c9e553c663cc0389e3c63742e4b8663bf0b Mon Sep 17 00:00:00 2001 From: Alaska Date: Wed, 15 May 2024 00:09:12 +1200 Subject: [PATCH 19/38] Adjust background colour of microsoft store image --- .../images/windows_get_blender_version_microsoft_store.jpg | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_microsoft_store.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_microsoft_store.jpg index d1d4fd0d..7d973cfd 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_microsoft_store.jpg +++ b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_microsoft_store.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:0cd4b3ca7fce3237202edee0b5bacf9547fcbf3f03f2d1b1beb180522fd75852 -size 32038 +oid sha256:ece6da18c024b22de848e84e1b4c2d0555e6bd7e94b99a2a15fc627a26a93311 +size 31478 -- 2.30.2 From 36b6d85d0520f779abf3b27b0edc6e701dd06fec Mon Sep 17 00:00:00 2001 From: Alaska Date: Wed, 15 May 2024 15:38:28 +1200 Subject: [PATCH 20/38] Adjust some macOS wording --- docs/handbook/bug_reports/making_good_bug_reports/index.md | 4 ++-- .../bug_reports/making_good_bug_reports/macos_information.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/index.md b/docs/handbook/bug_reports/making_good_bug_reports/index.md index 9e01bc23..7bd4852d 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/index.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/index.md @@ -49,8 +49,8 @@ Or, if this is a bug in an Addon, use the corresponding button in the ![](../../../images/BugReport-blender-addon.png) -Alternatively, you can also do this from within Gitea (without the -relevant information pre-filled though) +Alternatively, you can also do this from within Gitea, but you'll need +to fill out system information [manually](./collect_system_information.md). Click the `New Issue` button in the corresponding repository: diff --git a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md index d6b0f07f..eb509caa 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md @@ -14,7 +14,7 @@ Share the information on the report form like this: `macOS 14.4.1` Open Launchpad from the dock, then search for and open the `System Information` app. You will be find your graphics card information in the section `Hardware > Graphics/Display`. The information we're interested in is the -`Chipset Model` and the `Metal Support`. +`Chipset Model` and `Metal Support`. Combine these two details together and share them in your bug report form like this: `Apple M1 Pro - Metal 3` -- 2.30.2 From bf362ee8da4c14ed5fd48932b58b54c0dc69e482 Mon Sep 17 00:00:00 2001 From: Alaska Date: Wed, 15 May 2024 15:40:06 +1200 Subject: [PATCH 21/38] Space out Linux OS information to be easier to understand --- .../bug_reports/making_good_bug_reports/linux_information.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index 6ca7c448..0663e6b9 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -8,7 +8,7 @@ and display server type. Follow the steps below to collect the information and combine them together in the bug report form like this: -`Linux-6.8.0-31-generic-x86_64-glibc2.39, wayland` +`Linux-6.8.0-31-generic - x86_64 - glibc2.39 - wayland` #### Linux Kernel Version -- 2.30.2 From 013d4facc6c63edff27aa722f26167d7fb7f73e4 Mon Sep 17 00:00:00 2001 From: Alaska Date: Wed, 15 May 2024 15:42:22 +1200 Subject: [PATCH 22/38] Adjust some wording on the Linux page --- .../making_good_bug_reports/linux_information.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index 0663e6b9..5f2a0e47 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -60,8 +60,8 @@ and include it on your bug report form like this: `AMD Radeon RX 7700 XT / 7800 ## Blender Version -Follow one of the guides below to obtain your Blender version number then -share it on your bug reporting form like this: `Blender 4.1.1` +Follow the guide below based on how you installed Blender to obtain your Blender version +number then share it on your bug reporting form like this: `Blender 4.1.1` ### Downloaded from Blender Website @@ -83,6 +83,6 @@ of the output. ### Downloaded from snap Open a terminal and run `snap list | grep blender`. In the output you will find -Blender with a version numbder listed beside it. +Blender with a version number listed beside it. ![](./images/linux_get_blender_version_snap.jpg) -- 2.30.2 From d9f4ccef223df55b6143a2a5cd63629d2fd155df Mon Sep 17 00:00:00 2001 From: Alaska Date: Wed, 15 May 2024 15:44:53 +1200 Subject: [PATCH 23/38] Adjust some wording on the Windows page --- .../making_good_bug_reports/windows_information.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md index 70e9d774..73249c39 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md @@ -6,7 +6,7 @@ Click on the search icon on the task bar, then search for and open `dxdiag`. A DirectX Diagnostic Tool window will open. You will find the operating system version visible in the `System` tab. Copy it onto your bug report form like this: -`Windows 11 Home 64-bit (1.0, Build 22631)`. +`Windows 11 Home 64-bit (10.0, Build 22631)`. ![](./images/windows_get_os_version.jpg) @@ -49,6 +49,6 @@ tab and you will find the Blender version in the field called `File Version`. Click on the Windows icon on the task bar and find Blender in your apps list. Once you've found it, right click on Blender and select `More > App Settings`. The settings app will open and you will find the Blender version in the section -`Specifications` with in the field `Version`. +`Specifications` in the field `Version`. ![](./images/windows_get_blender_version_microsoft_store.jpg) -- 2.30.2 From 24dce8a1bed6b27fd19b654225bc0e76c70ab161 Mon Sep 17 00:00:00 2001 From: Alaska Date: Wed, 15 May 2024 15:45:55 +1200 Subject: [PATCH 24/38] Adjust some macOS wording --- .../making_good_bug_reports/macos_information.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md index eb509caa..82dec703 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md @@ -16,7 +16,7 @@ app. You will be find your graphics card information in the section `Hardware > Graphics/Display`. The information we're interested in is the `Chipset Model` and `Metal Support`. -Combine these two details together and share them in your bug report form +Combine these details together and share them in your bug report form like this: `Apple M1 Pro - Metal 3` ![](./images/macOS_get_gpu_info.jpg) @@ -29,7 +29,7 @@ share it on your bug reporting form like this: `Blender 4.1.1` ### Downloaded from Blender Website Navigate to where Blender is installed and right click on it and select `Get Info`. -You will find the Blender version number in the field `General > Version`. +You will find the Blender version number in the section `General > Version`. ![](./images/macOS_get_blender_version.jpg) @@ -38,6 +38,6 @@ You will find the Blender version number in the field `General > Version`. Open Steam, right click on Blender and select the option `Manage > Browse local files`. A file browser will appear showing where Blender is installed. Right click on Blender and select `Get Info`. -You will find the Blender version number in the field `General > Version`. +You will find the Blender version number in the section `General > Version`. ![](./images/macOS_get_blender_version_steam.jpg) -- 2.30.2 From 69ad2864734d48b8564e81d33825922f67240097 Mon Sep 17 00:00:00 2001 From: Alaska Date: Thu, 16 May 2024 13:18:33 +1200 Subject: [PATCH 25/38] Adjust some wording --- .../bug_reports/making_good_bug_reports/linux_information.md | 4 ++-- .../making_good_bug_reports/windows_information.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index 5f2a0e47..8f33c1de 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -60,8 +60,8 @@ and include it on your bug report form like this: `AMD Radeon RX 7700 XT / 7800 ## Blender Version -Follow the guide below based on how you installed Blender to obtain your Blender version -number then share it on your bug reporting form like this: `Blender 4.1.1` +Follow one of the guides below to obtain your Blender version +number, then share it on your bug reporting form like this: `Blender 4.1.1` ### Downloaded from Blender Website diff --git a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md index 73249c39..ef6567fa 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md @@ -38,7 +38,7 @@ called `File Version`. Open Steam, right click on Blender and select the option `Manage > Browse local files`. A file browser will appear showing where -Blender is installed. Right click on the file `blender.exe` and select +Blender is installed. Right click on `blender.exe` and select the `Properties` option. In the new window that appears, select the `Details` tab and you will find the Blender version in the field called `File Version`. -- 2.30.2 From 1520b0f0f44b4dcdcfb0039d83e048c8c9b8452a Mon Sep 17 00:00:00 2001 From: Alaska Date: Fri, 17 May 2024 15:03:13 +1200 Subject: [PATCH 26/38] Add command line instrucitons to Windows page --- ...ndows_get_blender_version_command_line.jpg | 3 + ...pg => windows_get_blender_version_gui.jpg} | 0 ...get_blender_version_steam_command_line.jpg | 3 + ...windows_get_blender_version_steam_gui.jpg} | 0 .../windows_information.md | 63 +++++++++++++++++-- 5 files changed, 64 insertions(+), 5 deletions(-) create mode 100644 docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_command_line.jpg rename docs/handbook/bug_reports/making_good_bug_reports/images/{windows_get_blender_version.jpg => windows_get_blender_version_gui.jpg} (100%) create mode 100644 docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_steam_command_line.jpg rename docs/handbook/bug_reports/making_good_bug_reports/images/{windows_get_blender_version_steam.jpg => windows_get_blender_version_steam_gui.jpg} (100%) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_command_line.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_command_line.jpg new file mode 100644 index 00000000..6586c49f --- /dev/null +++ b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_command_line.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:b5a60f9acb663244609a1970f1c800a724d1d749ffc4d532104db1a175b0d49d +size 30864 diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_gui.jpg similarity index 100% rename from docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_gui.jpg diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_steam_command_line.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_steam_command_line.jpg new file mode 100644 index 00000000..f72f3ed8 --- /dev/null +++ b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_steam_command_line.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:6bf092ce365383389ddeabc3ead866d867a7b177010d90642836a75307b55a08 +size 57701 diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_steam.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_steam_gui.jpg similarity index 100% rename from docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_steam.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/windows_get_blender_version_steam_gui.jpg diff --git a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md index ef6567fa..b7d80f73 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md @@ -23,32 +23,85 @@ Combine these details together and share them in your bug report form like this: ## Blender Version Follow one of the guides below to obtain your Blender version number then -share it on your bug reporting form like this: `Blender 4.1.1.0` +share it on your bug reporting form. ### Downloaded from Blender Website +There are two main ways we recommend collecting Blender version. Through the +command line, or through a GUI. + +#### Command line + +Open up a command prompt or terminal and run the command +`/path/to/blender.exe --version`. You will find the Blender version, +commit date, hash, and branch *(Blender 4.2+)*. Combine these details together +and include them on your report form like this: +`Blender 4.2.0 - branch: main - commit date: 2024-05-17 00:32 - hash: 05617ed07d2b` + +![](./images/windows_get_blender_version_command_line.jpg) + +#### GUI + Navigate to where Blender is installed, right click on the file `blender.exe` and select the `Properties` option. In the new window that appears, select the `Details` tab and you will find the Blender version in the field -called `File Version`. +called `File Version`. Include this on your bug report form like this: +`Blender 4.1.1.0` -![](./images/windows_get_blender_version.jpg) +![](./images/windows_get_blender_version_gui.jpg) ### Downloaded from Steam +There are two main ways we recommend collecting Blender version. Through the +command line, or through a GUI. + +#### Command line + +Open Steam, right click on Blender and select the option +`Manage > Browse local files`. A file browser will appear showing where +Blender is installed. Knowing where Blender is now installed, open a command +prompt or terminal and run the command `/path/to/blender.exe --version` +You will find the Blender version, commit date, hash, and branch *(Blender 4.2+)*. +Combine these details together and include them on your report form like this: +`Blender 4.2.0 - branch: main - commit date: 2024-05-17 00:32 - hash: 05617ed07d2b` + +![](./images/windows_get_blender_version_steam_command_line.jpg) + +#### GUI + Open Steam, right click on Blender and select the option `Manage > Browse local files`. A file browser will appear showing where Blender is installed. Right click on `blender.exe` and select the `Properties` option. In the new window that appears, select the `Details` tab and you will find the Blender version in the field called `File Version`. +Include this on your bug report form like this: `Blender 4.1.1.0` -![](./images/windows_get_blender_version_steam.jpg) +![](./images/windows_get_blender_version_steam_gui.jpg) ### Downloaded from Microsoft Store +There are two main ways we recommend collecting Blender version. Through the +command line, or through a GUI. + +#### Command line + +Open up a command prompt or terminal and run the command +`/path/to/blender.exe --version`. You will find the Blender version, +commit date, hash, and branch *(Blender 4.2+)*. Combine these details together +and include them on your report form like this: +`Blender 4.2.0 - branch: main - commit date: 2024-05-17 00:32 - hash: 05617ed07d2b` + +The path to Blender is usually: +`C:\Program Files\WindowsApps\BlenderFoundation.EXTRA_DETAILS\Blender\blender.exe` + +![](./images/windows_get_blender_version_command_line.jpg) + +#### GUI + Click on the Windows icon on the task bar and find Blender in your apps list. Once you've found it, right click on Blender and select `More > App Settings`. The settings app will open and you will find the Blender version in the section -`Specifications` in the field `Version`. +`Specifications` in the field `Version`. Include this on your bug report form +like this: `Blender 4.1.1.0` ![](./images/windows_get_blender_version_microsoft_store.jpg) -- 2.30.2 From 915039957927da9baf46d23106c511098ae4cd68 Mon Sep 17 00:00:00 2001 From: Alaska Date: Fri, 17 May 2024 15:09:33 +1200 Subject: [PATCH 27/38] Add comment about Vulkan info on Linux --- .../bug_reports/making_good_bug_reports/linux_information.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index 8f33c1de..cc1fe075 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -40,6 +40,8 @@ Run `echo $XDG_SESSION_TYPE` in a terminal. There are two main ways we recommend to collect GPU information on Linux. `glxinfo`, or `lspci` if `glxinfo` isn't avaliable. +[comment]: <> (Use `vulkaninfo` instead of glxinfo once Blender uses Vulkan) + #### glxinfo Run `glxinfo -B` in a terminal (you may need to install glxinfo from your -- 2.30.2 From 74d1ebe9230c0ff8eeacddc3de88c5d73cdafcf1 Mon Sep 17 00:00:00 2001 From: Alaska Date: Fri, 17 May 2024 16:03:02 +1200 Subject: [PATCH 28/38] Update command line instructions and image for Linux --- .../images/linux_get_blender_version.jpg | 4 ++-- .../images/linux_get_blender_version_snap.jpg | 4 ++-- .../linux_get_blender_version_steam.jpg | 4 ++-- .../linux_information.md | 19 +++++++++++-------- 4 files changed, 17 insertions(+), 14 deletions(-) mode change 100644 => 100755 docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version_snap.jpg mode change 100644 => 100755 docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version_steam.jpg diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version.jpg index c6e00dab..365f8678 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version.jpg +++ b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:e4ffd399e4e1d17b3f09e7f278881f08d4e9f3864002562f2e0b9c1fb5eb8cd3 -size 25852 +oid sha256:0d7cd5ae29300b4d981cd708e5aac306415fb0174ec0910a7d5df948a681f130 +size 52055 diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version_snap.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version_snap.jpg old mode 100644 new mode 100755 index 49ec0cca..c7ebf668 --- a/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version_snap.jpg +++ b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version_snap.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:95ce7ac927bbb1e918bde55d4771650300974dc490c01ddba50f42c56f4b23b4 -size 13251 +oid sha256:927ef245a21642da46a18ac2408d975afbdc76c52daa0c7704b12f2d208b64bf +size 49865 diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version_steam.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version_steam.jpg old mode 100644 new mode 100755 index 429be356..accc2475 --- a/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version_steam.jpg +++ b/docs/handbook/bug_reports/making_good_bug_reports/images/linux_get_blender_version_steam.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:1114575695dea5a11bc37ec806744fdc585ab326c47ee21d221444cc76b118c2 -size 79322 +oid sha256:e735b02a6371e8cfd1bb226fc6db657ca6669926a92a63c51d34d68ab4a108ae +size 97763 diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index cc1fe075..4f64a5ce 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -62,13 +62,16 @@ and include it on your bug report form like this: `AMD Radeon RX 7700 XT / 7800 ## Blender Version -Follow one of the guides below to obtain your Blender version -number, then share it on your bug reporting form like this: `Blender 4.1.1` +Follow one of the guides below to obtain Blender version information, +The information we're intereted in are Blender version, commit date, hash, +and branch *(Blender 4.2+)*. Collect this information and share it on your +bug report form like this: +`Blender 4.2.0 - branch: main - commit date: 2024-05-16 20:40 - hash: 1558bc7cb428` ### Downloaded from Blender Website -Navigate to where Blender is installed and run `/path/to/blender --verison` -in a terminal. The Blender version can be found in the first line of the output. +Run `/path/to/blender --verison` in a terminal. The Blender version information +will be visible in the output. ![](./images/linux_get_blender_version.jpg) @@ -77,14 +80,14 @@ in a terminal. The Blender version can be found in the first line of the output. Open Steam, right click on Blender and select the option `Manage > Browse local files`. A file browser will open displaying the path to where Blender is installed. Open a terminal and run -`/path/to/blender --verison`. The Blender version can be found in the first line -of the output. +`/path/to/blender --verison`. The Blender version information +will be visible in the output. ![](./images/linux_get_blender_version_steam.jpg) ### Downloaded from snap -Open a terminal and run `snap list | grep blender`. In the output you will find -Blender with a version number listed beside it. +Open a terminal and run `blender -version`. The Blender version information +will be visible in the output. ![](./images/linux_get_blender_version_snap.jpg) -- 2.30.2 From 7946a1b22f5eee25cde8d26425c94cc60d589239 Mon Sep 17 00:00:00 2001 From: Alaska Date: Fri, 17 May 2024 19:59:47 +1200 Subject: [PATCH 29/38] Add command line details for macOS --- ...macOS_get_blender_version_command_line.jpg | 3 ++ ....jpg => macOS_get_blender_version_gui.jpg} | 0 ...get_blender_version_steam_command_line.jpg | 3 ++ ...> macOS_get_blender_version_steam_gui.jpg} | 0 .../macos_information.md | 50 +++++++++++++++---- 5 files changed, 47 insertions(+), 9 deletions(-) create mode 100644 docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_command_line.jpg rename docs/handbook/bug_reports/making_good_bug_reports/images/{macOS_get_blender_version.jpg => macOS_get_blender_version_gui.jpg} (100%) create mode 100644 docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam_command_line.jpg rename docs/handbook/bug_reports/making_good_bug_reports/images/{macOS_get_blender_version_steam.jpg => macOS_get_blender_version_steam_gui.jpg} (100%) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_command_line.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_command_line.jpg new file mode 100644 index 00000000..404900ad --- /dev/null +++ b/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_command_line.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:34828300eaad2c3ca25f1d524315af0723ae6f2617769476841235f599dfdff0 +size 66350 diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_gui.jpg similarity index 100% rename from docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_gui.jpg diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam_command_line.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam_command_line.jpg new file mode 100644 index 00000000..d35d60d0 --- /dev/null +++ b/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam_command_line.jpg @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:459e4a5ec73cc948fa74d22e32e9d77dc983d84cdc9f6148a4ed49ec6bdf523b +size 172473 diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam_gui.jpg similarity index 100% rename from docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam.jpg rename to docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam_gui.jpg diff --git a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md index 82dec703..e1eca9a2 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md @@ -24,20 +24,52 @@ like this: `Apple M1 Pro - Metal 3` ## Blender Version Follow one of the guides below to obtain your Blender version number, then -share it on your bug reporting form like this: `Blender 4.1.1` +share it on your bug reporting form. ### Downloaded from Blender Website -Navigate to where Blender is installed and right click on it and select `Get Info`. -You will find the Blender version number in the section `General > Version`. +#### Command Line -![](./images/macOS_get_blender_version.jpg) +Open a terminal and run the command `/path/to/blender --version`. In the output +you will find the information we're interested in. They are Blender version, +commit date, hash, and branch *(Blender 4.2+)*. Combine these details together +and put them on your report form like this: +`Blender 4.2.0 - branch: main - commit date: 2024-05-16 20:40 - hash: 1558bc7cb428` + +The path to Blender is typically `/Applications/Blender.app/Contents/MacOS/Blender` + +![](./images/macOS_get_blender_version_command_line.jpg) + +#### GUI + +Navigate to where Blender is installed and right click on it and select `Get Info`. +You will find the Blender version number in the section `General > Version`. Share +this information on your bug reporting form like this: `Blender 4.1.1 2024-04-16` + +![](./images/macOS_get_blender_version_gui.jpg) ### Downloaded from Steam -Open Steam, right click on Blender and select the option -`Manage > Browse local files`. A file browser will appear showing where -Blender is installed. Right click on Blender and select `Get Info`. -You will find the Blender version number in the section `General > Version`. +#### Command Line -![](./images/macOS_get_blender_version_steam.jpg) +Open Steam, right click on Blender and select the option +`Manage > Browse local files`. Finder will open showing where +Blender is installed. Right click on Blender and select `Show Package Contents` +then navigate to the folder `/Contents/MacOS/`. Here you will find the Blender +executable we want to run in a terminal with the `--version` launch argument. +Like this: `/path/to/blender --version`. The output of the command will include the +Blender version, commit date, hash, and branch *(Blender 4.2+)*. Combine these +together and put them on your report form like this: +`Blender 4.2.0 - branch: main - commit date: 2024-05-16 20:40 - hash: 1558bc7cb428` + +![](./images/macOS_get_blender_version_steam_command_line.jpg) + +#### GUI + +Open Steam, right click on Blender and select the option +`Manage > Browse local files`. Finder will open showing where +Blender is installed. Right click on Blender and select `Get Info`. +You will find the Blender version number in the section `General > Version`. Share +this information on your bug reporting form like this: `Blender 4.1.1 2024-04-16` + +![](./images/macOS_get_blender_version_steam_gui.jpg) -- 2.30.2 From 1018ab63380c1e6aec4318fd260d920034785e46 Mon Sep 17 00:00:00 2001 From: Alaska Date: Fri, 17 May 2024 22:50:10 +1200 Subject: [PATCH 30/38] Add missing Commandline and GUI options on macOS page --- .../making_good_bug_reports/macos_information.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md index e1eca9a2..d2a84270 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md @@ -28,6 +28,9 @@ share it on your bug reporting form. ### Downloaded from Blender Website +There are two main ways we recommend collecting Blender version. +Through the command line, or through a GUI. + #### Command Line Open a terminal and run the command `/path/to/blender --version`. In the output @@ -50,6 +53,9 @@ this information on your bug reporting form like this: `Blender 4.1.1 2024-04-16 ### Downloaded from Steam +There are two main ways we recommend collecting Blender version. +Through the command line, or through a GUI. + #### Command Line Open Steam, right click on Blender and select the option -- 2.30.2 From afc5aed278c56fe538663b44b4c59e9a66465909 Mon Sep 17 00:00:00 2001 From: Alaska Date: Sat, 18 May 2024 02:46:19 +1200 Subject: [PATCH 31/38] Remove extra space --- .../bug_reports/making_good_bug_reports/linux_information.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index 4f64a5ce..58954636 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -46,7 +46,7 @@ There are two main ways we recommend to collect GPU information on Linux. Run `glxinfo -B` in a terminal (you may need to install glxinfo from your package manager). This will provide you with the GPU name, driver type, and -driver version of the display GPU (the GPU usually used by Blender). +driver version of the display GPU (the GPU usually used by Blender). Combine these details together and include them on your bug report form like this: `AMD Radeon RX 7800XT - Mesa 24.1.0-devel` -- 2.30.2 From 7f4b0a59aee3244ac038ead3606afa47ce948fec Mon Sep 17 00:00:00 2001 From: Alaska Date: Sat, 18 May 2024 02:47:12 +1200 Subject: [PATCH 32/38] Fix -version for snap --- .../bug_reports/making_good_bug_reports/linux_information.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index 58954636..761a5fd4 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -87,7 +87,7 @@ will be visible in the output. ### Downloaded from snap -Open a terminal and run `blender -version`. The Blender version information +Open a terminal and run `blender --version`. The Blender version information will be visible in the output. ![](./images/linux_get_blender_version_snap.jpg) -- 2.30.2 From 10e0d99b4ab399da676171726a21b10dccbb40f4 Mon Sep 17 00:00:00 2001 From: Alaska Date: Wed, 7 Aug 2024 11:17:02 +0200 Subject: [PATCH 33/38] Remove mention of the addon report a bug button. This is no longer in 4.2. --- .../making_good_bug_reports/collect_system_information.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/collect_system_information.md b/docs/handbook/bug_reports/making_good_bug_reports/collect_system_information.md index 0205563b..6957143e 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/collect_system_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/collect_system_information.md @@ -3,8 +3,7 @@ When reporting a bug you will be asked to provide some system information and your Blender version number. This information can be automatically collected and filled out by selecteing `Help > Report a bug` from the -top of Blender. Or selecting `Report a bug` on the add-on you want -to report a bug on. +top of Blender. However, sometimes Blender won't open, so you can't use these features. In which case you will need to collect the information manually. -- 2.30.2 From a9a4015d1f06975bbfee185e091a584cb0d057c4 Mon Sep 17 00:00:00 2001 From: Alaska Date: Wed, 7 Aug 2024 11:22:43 +0200 Subject: [PATCH 34/38] Adjust wording on Windows page Adjustments are to make it clearer, or just to fit a different format. --- .../windows_information.md | 22 +++++++++---------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md index b7d80f73..d215e90b 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/windows_information.md @@ -12,7 +12,7 @@ version visible in the `System` tab. Copy it onto your bug report form like this ## Graphics Card -With `dxdiag`, navigate to the `Display` or `Render` tab and you will find +With `dxdiag` open, navigate to the `Display` or `Render` tab and you will find the `Device name` and `Driver version` of your graphics card. Combine these details together and share them in your bug report form like this: @@ -27,24 +27,24 @@ share it on your bug reporting form. ### Downloaded from Blender Website -There are two main ways we recommend collecting Blender version. Through the -command line, or through a GUI. +There are two main ways we recommend finding the Blender version. +Through the command line, or through a GUI. #### Command line -Open up a command prompt or terminal and run the command +Open command prompt or terminal and run the command `/path/to/blender.exe --version`. You will find the Blender version, commit date, hash, and branch *(Blender 4.2+)*. Combine these details together and include them on your report form like this: -`Blender 4.2.0 - branch: main - commit date: 2024-05-17 00:32 - hash: 05617ed07d2b` +`Blender 4.2.0, branch: main, commit date: 2024-05-17 00:32, hash: 05617ed07d2b` ![](./images/windows_get_blender_version_command_line.jpg) #### GUI Navigate to where Blender is installed, right click on the file `blender.exe` -and select the `Properties` option. In the new window that appears, select -the `Details` tab and you will find the Blender version in the field +and select the `Properties` option. In the Properties window that appears, +select the `Details` tab and you will find the Blender version in the field called `File Version`. Include this on your bug report form like this: `Blender 4.1.1.0` @@ -52,18 +52,18 @@ called `File Version`. Include this on your bug report form like this: ### Downloaded from Steam -There are two main ways we recommend collecting Blender version. Through the -command line, or through a GUI. +There are two main ways we recommend finding the Blender version. +Through the command line, or through a GUI. #### Command line Open Steam, right click on Blender and select the option `Manage > Browse local files`. A file browser will appear showing where -Blender is installed. Knowing where Blender is now installed, open a command +Blender is installed. Knowing where Blender is now installed, open command prompt or terminal and run the command `/path/to/blender.exe --version` You will find the Blender version, commit date, hash, and branch *(Blender 4.2+)*. Combine these details together and include them on your report form like this: -`Blender 4.2.0 - branch: main - commit date: 2024-05-17 00:32 - hash: 05617ed07d2b` +`Blender 4.2.0, branch: main, commit date: 2024-05-17 00:32, hash: 05617ed07d2b` ![](./images/windows_get_blender_version_steam_command_line.jpg) -- 2.30.2 From 34758e61f0ad121b936049cffcf643ffd4af5faa Mon Sep 17 00:00:00 2001 From: Alaska Date: Wed, 7 Aug 2024 11:36:35 +0200 Subject: [PATCH 35/38] Update text on macOS page Mostly small changes, but there is a larger change in the "Steam Command line" section --- .../macos_information.md | 23 ++++++++++--------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md index d2a84270..621dce1a 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/macos_information.md @@ -28,16 +28,16 @@ share it on your bug reporting form. ### Downloaded from Blender Website -There are two main ways we recommend collecting Blender version. +There are two main ways we recommend finding the Blender version. Through the command line, or through a GUI. #### Command Line -Open a terminal and run the command `/path/to/blender --version`. In the output +Open the terminal app and run the command `/path/to/blender --version`. In the output you will find the information we're interested in. They are Blender version, commit date, hash, and branch *(Blender 4.2+)*. Combine these details together and put them on your report form like this: -`Blender 4.2.0 - branch: main - commit date: 2024-05-16 20:40 - hash: 1558bc7cb428` +`Blender 4.2.0, branch: main, commit date: 2024-05-16 20:40. hash: 1558bc7cb428` The path to Blender is typically `/Applications/Blender.app/Contents/MacOS/Blender` @@ -45,7 +45,7 @@ The path to Blender is typically `/Applications/Blender.app/Contents/MacOS/Blend #### GUI -Navigate to where Blender is installed and right click on it and select `Get Info`. +Navigate to where Blender is installed, right click on it, and select `Get Info`. You will find the Blender version number in the section `General > Version`. Share this information on your bug reporting form like this: `Blender 4.1.1 2024-04-16` @@ -53,20 +53,21 @@ this information on your bug reporting form like this: `Blender 4.1.1 2024-04-16 ### Downloaded from Steam -There are two main ways we recommend collecting Blender version. +There are two main ways we recommend finding the Blender version. Through the command line, or through a GUI. #### Command Line -Open Steam, right click on Blender and select the option +Open Steam, right click on Blender, and select the option `Manage > Browse local files`. Finder will open showing where Blender is installed. Right click on Blender and select `Show Package Contents` then navigate to the folder `/Contents/MacOS/`. Here you will find the Blender -executable we want to run in a terminal with the `--version` launch argument. -Like this: `/path/to/blender --version`. The output of the command will include the -Blender version, commit date, hash, and branch *(Blender 4.2+)*. Combine these -together and put them on your report form like this: -`Blender 4.2.0 - branch: main - commit date: 2024-05-16 20:40 - hash: 1558bc7cb428` +executable. Open the terminal app and run the command `/path/to/blender --version`, +using the Blender executable found earlier. In the output you will find the +information we're interested in. They are Blender version, commit date, hash, +and branch *(Blender 4.2+)*. Combine these details together +and put them on your report form like this: +`Blender 4.2.0, branch: main, commit date: 2024-05-16 20:40, hash: 1558bc7cb428` ![](./images/macOS_get_blender_version_steam_command_line.jpg) -- 2.30.2 From ab2d645d1829c0ca84a2a1a0fe44d64f4c314de3 Mon Sep 17 00:00:00 2001 From: Alaska Date: Wed, 7 Aug 2024 11:39:18 +0200 Subject: [PATCH 36/38] Update Linux information Blender version format Just a small change to align with every other page --- .../bug_reports/making_good_bug_reports/linux_information.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md index 761a5fd4..01fc1d0b 100644 --- a/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md +++ b/docs/handbook/bug_reports/making_good_bug_reports/linux_information.md @@ -66,7 +66,7 @@ Follow one of the guides below to obtain Blender version information, The information we're intereted in are Blender version, commit date, hash, and branch *(Blender 4.2+)*. Collect this information and share it on your bug report form like this: -`Blender 4.2.0 - branch: main - commit date: 2024-05-16 20:40 - hash: 1558bc7cb428` +`Blender 4.2.0, branch: main, commit date: 2024-05-16 20:40, hash: 1558bc7cb428` ### Downloaded from Blender Website -- 2.30.2 From 2ddc5e965d2a16b3db55c0b7eb73f440fcc74bb9 Mon Sep 17 00:00:00 2001 From: Alaska Date: Wed, 7 Aug 2024 21:58:17 +1200 Subject: [PATCH 37/38] Adjust Steam commandline macOS image --- .../images/macOS_get_blender_version_steam_command_line.jpg | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) mode change 100644 => 100755 docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam_command_line.jpg diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam_command_line.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam_command_line.jpg old mode 100644 new mode 100755 index d35d60d0..a361d29c --- a/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam_command_line.jpg +++ b/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam_command_line.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:459e4a5ec73cc948fa74d22e32e9d77dc983d84cdc9f6148a4ed49ec6bdf523b -size 172473 +oid sha256:668ef35cda59504774bff7ef6d74e20284f02b6d93d7258da60ebb26647e454f +size 232411 -- 2.30.2 From 4b15bd2550681b5b67b1fa58b91228f8ad53b699 Mon Sep 17 00:00:00 2001 From: Alaska Date: Wed, 7 Aug 2024 22:06:57 +1200 Subject: [PATCH 38/38] Fix wrong macOS Steam commandline image --- .../images/macOS_get_blender_version_steam_command_line.jpg | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam_command_line.jpg b/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam_command_line.jpg index a361d29c..7939b262 100755 --- a/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam_command_line.jpg +++ b/docs/handbook/bug_reports/making_good_bug_reports/images/macOS_get_blender_version_steam_command_line.jpg @@ -1,3 +1,3 @@ version https://git-lfs.github.com/spec/v1 -oid sha256:668ef35cda59504774bff7ef6d74e20284f02b6d93d7258da60ebb26647e454f -size 232411 +oid sha256:02b503ed36b4ee337dc89c0380cff932ad7b09d24d319953134f27c52f63da77 +size 216434 -- 2.30.2