Add guides on how to manually collect bug report system information #58

Merged
Alaska merged 39 commits from Alaska/blender-developer-docs:manual-system-information into main 2024-08-07 14:17:21 +02:00
Showing only changes of commit 34758e61f0 - Show all commits

View File

@ -28,16 +28,16 @@ share it on your bug reporting form.
### Downloaded from Blender Website ### 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. Through the command line, or through a GUI.
#### Command Line #### 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, 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 commit date, hash, and branch *(Blender 4.2+)*. Combine these details together
and put them on your report form like this: 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` 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 #### 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 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` 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 ### 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. Through the command line, or through a GUI.
#### Command Line #### 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 `Manage > Browse local files`. Finder will open showing where
Blender is installed. Right click on Blender and select `Show Package Contents` 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 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. executable. Open the terminal app and run the command `/path/to/blender --version`,
Like this: `/path/to/blender --version`. The output of the command will include the using the Blender executable found earlier. In the output you will find the
Blender version, commit date, hash, and branch *(Blender 4.2+)*. Combine these information we're interested in. They are Blender version, commit date, hash,
together and put them on your report form like this: and branch *(Blender 4.2+)*. Combine these details together
`Blender 4.2.0 - branch: main - commit date: 2024-05-16 20:40 - hash: 1558bc7cb428` 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) ![](./images/macOS_get_blender_version_steam_command_line.jpg)