Skip to content

Commit

Permalink
[WIP][RFC] gnome: minor changes
Browse files Browse the repository at this point in the history
  • Loading branch information
@not-chicken
not-chicken committed May 10, 2020
1 parent 9bc1942 commit 4bfd62a
Showing 1 changed file with 32 additions and 14 deletions.
46 changes: 32 additions & 14 deletions src/config/graphical-session/gnome.md
View file
Expand Up @@ -2,30 +2,48 @@

## Pre-installation

Install the `dbus` package, ensure the `dbus` service is enabled, and reboot for
the changes to take effect.
Install the `mesa-dri` and `dbus` packages, ensure the `dbus` service is

This comment has been minimized.

Sign in to view

Copy link
@flexibeast

flexibeast May 10, 2020

mesa-dri was not required in my VM-based testing of setting up GNOME, and it's not currently listed as a dependency in the 3.36 update?

This comment has been minimized.

Sign in to view

Copy link
@not-chicken

not-chicken May 10, 2020

Author Owner

In my testing mesa-dri was needed for using wayland session, without it I get:

mutter-WARNING **: 05:17:30.000: Failed to create backend: Failed to initialize renderer: Failed to create gbm device: No such file or directory, EGL is not initialized, or could not be initialized, for the specified EGL display connection

Though I think we should rather point to Wayland and Xorg setup section here.

This comment has been minimized.

Sign in to view

Copy link
@flexibeast

flexibeast May 11, 2020

If it's now a hard dependency of 3.36, where it wasn't in 3.32 (which is what i was doing my testing with when writing the Handbook page), then that should be addressed in packaging.

This comment has been minimized.

Sign in to view

Copy link
@not-chicken

not-chicken May 11, 2020

Author Owner

If it's now a hard dependency of 3.36, where it wasn't in 3.32 (which is what i was doing my testing with when writing the Handbook page), then that should be addressed in packaging.

It's pulled in by xorg meta package, perhaps that's why you didn't notice it during your testing.

This comment has been minimized.

Sign in to view

Copy link
@flexibeast

flexibeast May 11, 2020

Ah okay - yes, probably. So it's basically a dependency if one is using Wayland instead of Xorg? If so, this needs to be fixed in packaging.
enabled, and reboot for the changes to take effect.

## Installation

Install the `gnome` package for a GNOME environment which includes GNOME
applications.
Install the `gnome` package which includes the base GNOME desktop and a subset
of GNOME applications. If you want a more rich GNOME experience, install
additional applications via the `gnome-apps` package.

This comment has been minimized.

Sign in to view

Copy link
@flexibeast

flexibeast May 10, 2020

"Install the `gnome` package for a GNOME environment which includes the base GNOME desktop and a subset of GNOME applications. Additional applications are available via the `gnome-apps` package."

i'd like to avoid the docs having marketing-speak phrases such as "rich GNOME experience".

A minimal GNOME environment can be created by installing the `gnome-session`,
`gdm` and `adwaita-icon-theme` packages. (Note, however, that not all GNOME
features may be present or functional.) `gdm` defaults to providing a Wayland
session, via the `mutter` window manager. For an Xorg session, install the
`xorg` package, then select 'GNOME on Xorg' at the GDM login screen, or start
`gnome-session` via `~/.xinitrc`. GNOME applications can be installed via the
`gnome-apps` package.
A minimal GNOME environment can be created by installing the `gdm` package.

This comment has been minimized.

Sign in to view

Copy link
@flexibeast

flexibeast May 10, 2020

"A minimal GNOME environment is available via the `gdm` package."
(Note, however, that not all GNOME features may be present or functional.)

If you require [ZeroConf](http://www.zeroconf.org/) support, install the `avahi`
package and enable the `avahi-daemon` service.

## Display Manager
## Starting GNOME

To use a graphical display manager for logging in to GNOME, enable the `gdm`
service. Test the `gdm` service before enabling it:
### From Display Manager

`gdm` is the display manager included in GNOME. Test the `gdm` service before
enabling it:

```
# runsv /etc/sv/gdm
```

`gdm` defaults to providing a Wayland session, via the `mutter` window manager.
For an Xorg session, install the `xorg` package, then select 'GNOME on Xorg' at
the `gdm` login screen.

### From Console

A Wayland session can be launched with:

```
$ XDG_SESSION_TYPE=wayland gnome-session
```

For a Xorg session, run `startx` command after adding to the `~/.xinitrc` file:

This comment has been minimized.

Sign in to view

Copy link
@flexibeast

flexibeast May 10, 2020

"For an Xorg session, add the following to your `~/.xinitrc` file:

```
export XDG_SESSION_TYPE=x11
export GDK_BACKEND=x11
exec gnome-session
```

This comment has been minimized.

Sign in to view

Copy link
@flexibeast

flexibeast May 10, 2020

Add:

"Then call `startx`."

We should try to list operations in the order in which they need to be performed.

2 comments on commit 4bfd62a

@not-chicken
Copy link
Owner Author

Choose a reason for hiding this comment

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

@flexibeast Applied the changes at the void-linux#271
Thanks a lot for your feedback!

@flexibeast
Copy link

Choose a reason for hiding this comment

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

@not-chicken: Thanks! You're welcome. :-)

Please sign in to comment.