Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Debian install instructions #27

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions docs/developer/workflow/providing-backtraces.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,27 @@ A debug symbol is a special kind of symbol that attaches additional information
In the case of Budgie Desktop, this helps us identify various parts of the Budgie Desktop codebase across its range of components that may affect any issue that requires a backtrace.

<Tabs>
<TabItem label="Debian" value="Debian">
Debian 11 and above can automatically retrive debug symbols from the Internet by export the following environment variable:
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Debian 11 and above can automatically retrive debug symbols from the Internet by export the following environment variable:
Debian 11 and above can automatically retrieve debug symbols from the Internet by exporting the following environment variable:

<CodeBlock language="bash">export DEBUGINFOD_URLS="https://debuginfod.debian.net"</CodeBlock>
<hr />
To manually install debug symbols, make sure you have <code>debian-debug</code> archive in <code>/etc/apt/sources.list</code>:
<CodeBlock>
deb http://deb.debian.org/debian-debug/ $RELEASE-debug main
<br />
# for security updates
<br />
deb http://deb.debian.org/debian-debug/ $RELEASE-proposed-updates-debug main
</CodeBlock>
If you are unsure what <code>$RELEASE</code> is for you, you can find the codename here:
<CodeBlock language="bash">lsb_release -rcs</CodeBlock>
Debug symbols are ready to install now:
<CodeBlock language="bash">
sudo apt update
<br />
sudo apt install budgie-core-dbgsym
</CodeBlock>
</TabItem>
<TabItem label="Fedora" value="Fedora">
<CodeBlock language="bash">sudo dnf debuginfo-install budgie-desktop</CodeBlock>
</TabItem>
Expand Down
31 changes: 26 additions & 5 deletions src/data/supportList.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -40,15 +40,36 @@ export const SupportListData: SupportInfo[] = [
},
{
budgieAvailablePostInstall: null,
budgieVersion: "10.5.2",
budgieVersion: "10.7.1",
name: "Debian",
showInGrid: false,
installationInfo: () => (
<Admonition icon="🚧" type="note" title="Coming Soon">
Installation instructions coming soon!
</Admonition>
<>
Install Budgie Desktop and a LightDM greeter:
<CodeBlock language="bash">
sudo apt install budgie-desktop slick-greeter
</CodeBlock>
<Admonition type="info">
You will be prompted to select a default display manager if you already have one installed. We recommend LightDM for the best experience. You can always change your choice later by running:
<CodeBlock language="bash">
sudo dpkg-reconfigure lightdm
</CodeBlock>
</Admonition>
It is recommended to install the default GTK and icon theme:
<CodeBlock language="bash">
sudo apt install arc-theme papirus-icon-theme
Copy link
Member

Choose a reason for hiding this comment

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

Materia is recommended over Arc.

</CodeBlock>
Ubuntu Budgie applets are also available on Debian. They are optional, but can enhance your experience:
<CodeBlock language="bash">
sudo apt install budgie*applet
</CodeBlock>
Copy link
Member

Choose a reason for hiding this comment

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

The steps should be for Budgie Desktop specifically, not Ubuntu Budgie applets, so this should be removed.

Restart your display manager to log into Budgie:
<CodeBlock language="bash">
sudo systemctl restart display-manager
</CodeBlock>
</>
),
website: "https://debian.org",
website: "https://www.debian.org",
},
{
budgieAvailablePostInstall: "10.7.2",
Expand Down