From 7e69ef57ce1e1b66a2dfd44b9a5c0d43dfd41c3b Mon Sep 17 00:00:00 2001 From: Austin Schaefer Date: Wed, 18 Sep 2024 13:57:15 +0200 Subject: [PATCH] Add more OS-dependent context to panel freeze dev documentation. (#11781) After discussing, it was decided that the text section didn't precisely name how a "working password manager" could be checked. The problem is, is that this is OS dependent, and the knowledge isn't quite fully assembled yet. Therefore, a partial description was made. --- .../trouble-shooting.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/getting-into-the-code/guidelines-for-setting-up-a-local-workspace/trouble-shooting.md b/docs/getting-into-the-code/guidelines-for-setting-up-a-local-workspace/trouble-shooting.md index 5591392cea5..a264643f888 100644 --- a/docs/getting-into-the-code/guidelines-for-setting-up-a-local-workspace/trouble-shooting.md +++ b/docs/getting-into-the-code/guidelines-for-setting-up-a-local-workspace/trouble-shooting.md @@ -88,4 +88,10 @@ java.lang.UnsupportedClassVersionError: org/javamodularity/moduleplugin/ModuleSy This is likely caused by improper integration of your OS or Desktop Environment with your password prompting program or password manager. Ensure that these are working properly, then restart your machine and attempt to run the program. -For reference, see issue [#11766](https://github.com/JabRef/jabref/issues/11766). +In an ideal scenario, a password prompt should appear when the program starts, provided the keyring your OS uses has not already been unlocked. However, the implementation details vary depending on the operating system, which makes troubleshooting more complex. + +For Windows and macOS users, specific configurations may differ based on the password management tools and settings used, so ensure your OS's password management system is properly set up and functioning. + +For Linux users, ensure that your [xdg-desktop-portal](https://wiki.archlinux.org/title/XDG_Desktop_Portal) settings refer to active and valid portal implementations installed on your system. However, there might be other factors involved, so additional research or guidance specific to your distribution may be necessary. + +For reference, see the discussion at issue [#11766](https://github.com/JabRef/jabref/issues/11766).