Bug 262873 - The FreeBSD GNOME Project: page and sidebar update
Summary: The FreeBSD GNOME Project: page and sidebar update
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Website (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: Sergio Carlavilla Delgado
URL: https://github.com/freebsd/freebsd-do...
Keywords:
Depends on:
Blocks:
 
Reported: 2022-03-28 01:07 UTC by Graham Perrin
Modified: 2022-07-15 01:17 UTC (History)
5 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin freebsd_committer freebsd_triage 2022-03-28 01:07:46 UTC
<https://www.freebsd.org/gnome/>

All end of life: 

> … 11.1, 11-STABLE, and 10.4, … 12.0-CURRENT …

The port is no longer GNOME 3; and installation instructions are outdated.
Comment 1 Graham Perrin freebsd_committer freebsd_triage 2022-03-28 01:11:17 UTC
https://reviews.freebsd.org/D33959
Comment 2 Graham Perrin freebsd_committer freebsd_triage 2022-06-01 05:16:53 UTC
Display
=======

Add a hint that it's commonplace to also install x11/xorg.

There's no dependency: 

% pkg info -x gnome-42 xorg-7.7_3
gnome-42
xorg-7.7_3
% pkg_tree -v gnome | grep xorg-7
% 

Food for thought, from a topic that was primarily about MATE: <https://forums.freebsd.org/posts/569598>. 


Resources, related projects
===========================

MATE Project and Cinnamon Project should be moved: 

* from Resources
* to   Related projects
Comment 3 Charlie Li freebsd_committer freebsd_triage 2022-06-02 15:42:46 UTC
Commonplace, but GNOME uses Wayland by default, thus the lack of dependency link is correct.
Comment 4 Graham Perrin freebsd_committer freebsd_triage 2022-06-02 15:50:33 UTC
(In reply to Charlie Li from comment #3)

Ah, thank you, I never knowingly used Wayland. 

Now I see, 

pkg_tree -v gnome | grep wayland-

– many matches.
Comment 5 Jan Beich freebsd_committer freebsd_triage 2022-06-05 03:46:22 UTC
(In reply to Charlie Li from comment #3)
> GNOME uses Wayland by default,

On FreeBSD GNOME cannot use Wayland at all due to bug 258042 and https://gitlab.gnome.org/GNOME/mutter/-/issues/1800
If one doesn't need GNOME itself then various GNOME applications (e.g., gnome-calendar) work fine under Wayland.

Most FreeBSD contributors interested in Wayland focus on wlroots nowadays:
- licensed under MIT thus similar to BSD in spirit (important for proprietary vendors or anyone with GNU allergy)
- inclusive upstream that tries hard to be portable and doesn't cheat POSIX via `-D_GNU_SOURCE` or `-D__BSD_VISIBLE`
- no single stakeholder: sway, wayfire, gamescope, phoc, kwinft, river, labwc, cage, cagebreak, dwl, etc.
- flexible architecture, see also https://wayfire.org/2019/02/24/X11-WLC-Libweston-Wlroots.html and https://subdiff.org/blog/2021/wlroots-in-kwinft/
- avoids DE-centric bloat like DBus, see also https://blogs.kde.org/2020/10/11/linux-desktop-shell-ipc-wayland-vs-d-bus-and-lack-agreement-when-use-them
- like Xorg you still need a window manager
- like Xorg has many protocol extensions (some are shared with KDE and Mir)
- like Xorg has simple API (wlr_scene since 0.15.0)
- large actively developed ecosystem (e.g., unlike weston, swc)
- supports modern features like Variable Refresh Rate, Vulkan renderer, DRM leasing

> thus the lack of dependency link is correct.

Likely because the Handbook already describes installing Xorg in a separate subchapter, preceeding GNOME. For examples, xorg-minimal is suggested as a smaller alternative.
Curiously, kde5 meta-package does pull xorg-server via plasma5-plasma-desktop via xf86-input-libinput.

(In reply to Graham Perrin from comment #4)
> pkg_tree -v gnome | grep wayland-

Since bug 227509 binary packages for desktop stuff almost always have wayland as an indirect dependency. Try testing Wayland support from Xorg comfort zone:

  $ pkg install cage firefox
  $ : ${XDG_RUNTIME_DIR:=$(mktemp -dt .run)}
  $ cage -d env -u DISPLAY firefox about:support
  [...]
  Window Protocol: wayland
  [...]
  $ sockstat -u
  USER     COMMAND    PID   FD PROTO  LOCAL ADDRESS         FOREIGN ADDRESS
  root     Xorg       1111  4  stream /tmp/.X11-unix/X0
  [...]
  foo      cage       2222  8  stream -> /tmp/.X11-unix/X0
  foo      cage       2222  25 stream /tmp/.run.XXXX/wayland-0
  [...]
  foo      firefox    3333  8  stream -> /tmp/.run.XXXX/wayland-0
  [...]
Comment 6 Graham Perrin freebsd_committer freebsd_triage 2022-06-05 04:56:50 UTC
Thanks, the insight and details are greatly appreciated. 

(In reply to Jan Beich from comment #5)

> … the Handbook already describes installing Xorg …

True, although this bug report is for an independent page that: 

* offers the "easiest way of installing" 
* does not direct the reader to the FreeBSD Handbook. 

I'll expand the report to include: 

* the sidebar

– but not the content of pages linked from the sidebar (most pages that are found are outdated). 


State of the port
=================

This section of the page should mention bug 253746, of which bug 257810 may be a duplicate. 


Sidebar
=======

Documentation is self-referencing (does not lead to documentation). 

Installation Instructions, Upgrade Instructions, Available Applications, FAQ are not found. 

HAL FAQ should have been removed more than a year ago. 

2.30 to 2.32 Upgrade FAQ and Known Issues are duplicates of Upgrade Instructions (not found).
Comment 7 Neel Chauhan freebsd_committer freebsd_triage 2022-06-11 23:21:32 UTC
I don't work on the web-facing stuff, but just by browsing the FreeBSD GNOME website is wayyy out-of-date. I don't normally check that site, since I cam remember the information on the top of my head for some reason.

https://www.freebsd.org/gnome/docs/porting/ is stuck in the GNOME 2 days.

https://www.freebsd.org/gnome/screenshots/ shows a GNOME 3.16 screenshot, but GNOME 40+ looks slightly different than GNOME 3.16 (e.g. flatter). Although looking at this makes me miss non-HiDPI displays while pixelated they ran X11 apps perfectly.

https://www.freebsd.org/gnome/contact/ is outdated.

And there are dead links:

 * https://www.freebsd.org/ports/gnome/

 * https://www.freebsd.org/gnome/docs/faq232/

 * https://www.freebsd.org/gnome/docs/faq2/

Honestly, I'd just nuke the https://www.freebsd.org/gnome site and just rely on the wiki. That's more likely to get updated than a poorly-maintained website section.

I know many people may still want it there, and that's fine with me if people prefer.
Comment 8 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2022-06-24 07:36:22 UTC
(In reply to Neel Chauhan from comment #7)
I'm gonna upgrade the information of this page and remove the stale links.
Comment 9 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2022-06-24 07:57:23 UTC
I created this review: https://reviews.freebsd.org/D35587
Comment 10 commit-hook freebsd_committer freebsd_triage 2022-07-14 18:28:59 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=1baae08217d9ece8fece839dd273e229c8170b71

commit 1baae08217d9ece8fece839dd273e229c8170b71
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2022-07-14 18:23:07 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2022-07-14 18:27:55 +0000

    Upgrade Gnome desktop information

    * Upgrade Gnome sidenav
    * Upgrade Gnome install instructions in the website
    * Remove Gnome stale documentation

    PR:                     262873
    Approved by:            bapt@
    Reviewed by:            grahamperrin@, ygy@

 website/content/en/gnome/_index.adoc               |  22 +--
 website/content/en/gnome/docs/bugging.adoc (gone)  |  39 ----
 website/content/en/gnome/docs/develfaq.adoc (gone) |  77 --------
 .../en/gnome/docs/example-makefile.adoc (gone)     |  60 ------
 .../en/gnome/docs/gnome1_porting.adoc (gone)       |  35 ----
 .../en/gnome/docs/gnome2_porting.adoc (gone)       |  77 --------
 .../en/gnome/docs/gnome_porting.adoc (gone)        |  28 ---
 website/content/en/gnome/docs/halfaq.adoc (gone)   | 207 ---------------------
 website/content/en/gnome/docs/porting.adoc (gone)  | 199 --------------------
 .../content/en/gnome/docs/volunteer.adoc (gone)    |  23 ---
 .../themes/beastie/layouts/partials/sidenav.html   |   6 +-
 11 files changed, 12 insertions(+), 761 deletions(-)
Comment 11 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2022-07-14 18:30:00 UTC
Fixed. We also need to upgrade the contact information. But we can handle this in another PR.
Comment 12 John Hein 2022-07-14 20:07:09 UTC
(In reply to Sergio Carlavilla Delgado from comment #11)
The links under 'Documentation' in the sidebar are all broken after the commit.
Comment 13 Sergio Carlavilla Delgado freebsd_committer freebsd_triage 2022-07-14 20:40:21 UTC
(In reply to John Hein from comment #12)

Fixed. Thanks for this!
Comment 14 commit-hook freebsd_committer freebsd_triage 2022-07-14 20:40:24 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=00b86ae3ebfd4c66a06f4d4c175a4a9ec7bdc7d0

commit 00b86ae3ebfd4c66a06f4d4c175a4a9ec7bdc7d0
Author:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
AuthorDate: 2022-07-14 20:37:53 +0000
Commit:     Sergio Carlavilla Delgado <carlavilla@FreeBSD.org>
CommitDate: 2022-07-14 20:37:53 +0000

    Remove stale gnome sidenav links

    Broken after 1baae082

    Reported by:            John Hein <jcfyecrayz (AT) liamekaens.com>
    PR:                     262873

 website/themes/beastie/layouts/partials/sidenav.html | 11 -----------
 1 file changed, 11 deletions(-)