Skip to content

Conversation

@abilashini593
Copy link

@abilashini593 abilashini593 commented Dec 26, 2025

User description

Added a Linux FAQ entry explaining that JabRef uses JavaFX and requires XWayland on Wayland-based systems.
This documents the solution discussed in issue #11489.


PR Type

Documentation


Description

  • Added FAQ entry documenting Wayland/XWayland requirement

  • Explains JavaFX dependency and XWayland necessity

  • Provides solution for startup failures on Wayland systems


Diagram Walkthrough

flowchart LR
  A["Linux FAQ"] -->|"Add new section"| B["Wayland startup issue"]
  B -->|"Explains"| C["JavaFX requires XWayland"]
  C -->|"Solution"| D["Install XWayland"]
Loading

File Walkthrough

Relevant files
Documentation
linux.md
Add Wayland/XWayland FAQ entry                                                     

en/faq/linux.md

  • Added new FAQ section addressing Wayland startup failures
  • Explains that JabRef uses JavaFX which requires XWayland
  • Documents that missing XWayland causes startup failures
  • Provides solution: install XWayland to resolve the issue
+11/-0   

@qodo-free-for-open-source-projects
Copy link

qodo-free-for-open-source-projects bot commented Dec 26, 2025

PR Compliance Guide 🔍

Below is a summary of compliance checks for this PR:

Security Compliance
🟢
No security concerns identified No security vulnerabilities detected by AI analysis. Human verification advised for critical code.
Ticket Compliance
🎫 No ticket provided
  • Create ticket/issue
Codebase Duplication Compliance
Codebase context is not defined

Follow the guide to enable codebase context checks.

Custom Compliance
🟢
Generic: Comprehensive Audit Trails

Objective: To create a detailed and reliable record of critical system actions for security analysis
and compliance.

Status: Passed

Learn more about managing compliance generic rules or creating your own custom rules

Generic: Meaningful Naming and Self-Documenting Code

Objective: Ensure all identifiers clearly express their purpose and intent, making code
self-documenting

Status: Passed

Learn more about managing compliance generic rules or creating your own custom rules

Generic: Robust Error Handling and Edge Case Management

Objective: Ensure comprehensive error handling that provides meaningful context and graceful
degradation

Status: Passed

Learn more about managing compliance generic rules or creating your own custom rules

Generic: Secure Error Handling

Objective: To prevent the leakage of sensitive system information through error messages while
providing sufficient detail for internal debugging.

Status: Passed

Learn more about managing compliance generic rules or creating your own custom rules

Generic: Secure Logging Practices

Objective: To ensure logs are useful for debugging and auditing without exposing sensitive
information like PII, PHI, or cardholder data.

Status: Passed

Learn more about managing compliance generic rules or creating your own custom rules

Generic: Security-First Input Validation and Data Handling

Objective: Ensure all data inputs are validated, sanitized, and handled securely to prevent
vulnerabilities

Status: Passed

Learn more about managing compliance generic rules or creating your own custom rules

  • Update
Compliance status legend 🟢 - Fully Compliant
🟡 - Partial Compliant
🔴 - Not Compliant
⚪ - Requires Further Human Verification
🏷️ - Compliance label

@qodo-free-for-open-source-projects
Copy link

qodo-free-for-open-source-projects bot commented Dec 26, 2025

PR Code Suggestions ✨

No code suggestions found for the PR.

@abilashini593
Copy link
Author

Hi!
This PR documents the Wayland/XWayland startup issue discussed in #11489 by adding a short Linux FAQ entry.
Please let me know if you’d like the wording adjusted or the entry placed elsewhere.
Thanks!

Copy link
Member

@koppor koppor left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The sentences should form a paragraph. Remove the empty lines inbetween.

Is there a nice link to xwayland which can be put?

Clarified the requirements for running JabRef on Wayland by explaining the need for XWayland and providing a solution.
@abilashini593
Copy link
Author

Hi, this PR documents the Wayland/XWayland requirement discussed in #11489.
Kindly review when you have time. Thanks!

@subhramit
Copy link
Member

Hi, this PR documents the Wayland/XWayland requirement discussed in #11489. Kindly review when you have time. Thanks!

You are not assigned to the issue. Please go through our contributing guidelines.

@koppor
Copy link
Member

koppor commented Dec 27, 2025

@abilashini593 look at this and fix it

image

@abilashini593
Copy link
Author

Hi, thanks for the review.
I’ve updated newentryfromplaintext.md to clarify the explanation before the example.
Please let me know if further changes are needed.

@koppor
Copy link
Member

koppor commented Dec 28, 2025

AI incoming 😢

@koppor koppor closed this Dec 28, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants