fixup! Add display server.
This commit is contained in:
parent
485e932deb
commit
7afc8f50df
|
@ -9,6 +9,7 @@ CFLAGS?=$(OPTLEVEL)
|
||||||
CFLAGS:=$(CFLAGS) -Wall -Wextra
|
CFLAGS:=$(CFLAGS) -Wall -Wextra
|
||||||
|
|
||||||
PROGRAM=display
|
PROGRAM=display
|
||||||
|
MANPAGES1 = display.1
|
||||||
|
|
||||||
OBJS=\
|
OBJS=\
|
||||||
connection.o \
|
connection.o \
|
||||||
|
@ -29,6 +30,8 @@ install: all
|
||||||
mkdir -p $(DESTDIR)$(SYSCONFDIR)/default
|
mkdir -p $(DESTDIR)$(SYSCONFDIR)/default
|
||||||
printf '#!sh\nexec terminal\n' > $(DESTDIR)$(SYSCONFDIR)/default/displayrc
|
printf '#!sh\nexec terminal\n' > $(DESTDIR)$(SYSCONFDIR)/default/displayrc
|
||||||
chmod +x $(DESTDIR)$(SYSCONFDIR)/default/displayrc
|
chmod +x $(DESTDIR)$(SYSCONFDIR)/default/displayrc
|
||||||
|
mkdir -p $(DESTDIR)$(MANDIR)/man1
|
||||||
|
install $(MANPAGES1) $(DESTDIR)$(MANDIR)/man1
|
||||||
|
|
||||||
$(PROGRAM): $(OBJS)
|
$(PROGRAM): $(OBJS)
|
||||||
$(CC) -std=gnu11 $(CFLAGS) $(CPPFLAGS) $(OBJS) -o $@ $(LIBS)
|
$(CC) -std=gnu11 $(CFLAGS) $(CPPFLAGS) $(OBJS) -o $@ $(LIBS)
|
||||||
|
|
|
@ -0,0 +1,146 @@
|
||||||
|
.Dd June 11, 2023
|
||||||
|
.Dt DISPLAY 8
|
||||||
|
.Os
|
||||||
|
.Sh NAME
|
||||||
|
.Nm display
|
||||||
|
.Nd desktop environment
|
||||||
|
.Sh SYNOPSIS
|
||||||
|
.Nm
|
||||||
|
.Op Ar session ...
|
||||||
|
.Sh DESCRIPTION
|
||||||
|
.Nm
|
||||||
|
is a desktop environment and windowing system compositor.
|
||||||
|
Applications talk to the
|
||||||
|
.Nm
|
||||||
|
server process to receive user input and show their graphical user interfaces
|
||||||
|
in windows.
|
||||||
|
.Pp
|
||||||
|
The user's preferred startup applications are launched on startup by launching
|
||||||
|
the
|
||||||
|
.Xr session
|
||||||
|
program (if set) or otherwise the
|
||||||
|
.Xr displayrc 5
|
||||||
|
script in the background.
|
||||||
|
.Pp
|
||||||
|
.Nm
|
||||||
|
exits when Control + Alt + Delete is pressed.
|
||||||
|
.Pp
|
||||||
|
The keyboard shortcuts are as follows:
|
||||||
|
.Bl -tag -width "Control + Alt + Delete"
|
||||||
|
.It Alt + F4
|
||||||
|
Quit the current window.
|
||||||
|
.It Alt + F10
|
||||||
|
Maximize (or restore) the current window.
|
||||||
|
.It Alt + Tab
|
||||||
|
Switch to the next window.
|
||||||
|
.It Alt + Click + Drag
|
||||||
|
Drag the current window.
|
||||||
|
.It Control + Alt + Delete
|
||||||
|
Exit the desktop environment.
|
||||||
|
.It Control + Alt + T
|
||||||
|
Launch the
|
||||||
|
.Xr terminal 1
|
||||||
|
application.
|
||||||
|
.It Super + Left
|
||||||
|
Tile the current window leftwards.
|
||||||
|
.It Super + Right
|
||||||
|
Tile the current window rightwards.
|
||||||
|
.It Super + Up
|
||||||
|
Tile the current window upwards.
|
||||||
|
.It Super + Down
|
||||||
|
Tile the current window downwards.
|
||||||
|
.It F11
|
||||||
|
Grab input for the current window.
|
||||||
|
.It F12
|
||||||
|
Release the input grab on the current window.
|
||||||
|
.El
|
||||||
|
.Pp
|
||||||
|
Windows can be resized by dragging their edges.
|
||||||
|
Windows can be tiled by dragging them to the left, right, top, and bottom edges.
|
||||||
|
.Pp
|
||||||
|
The keyboard layout can be changed with the
|
||||||
|
.Xr chkblayout 1
|
||||||
|
program.
|
||||||
|
The display resolution can be changed with the
|
||||||
|
.Xr chvideomode 1
|
||||||
|
program.
|
||||||
|
.Sh ENVIRONMENT
|
||||||
|
.Bl -tag -width "HISTFILE"
|
||||||
|
.It Ev DISPLAY_SOCKET
|
||||||
|
.Nm
|
||||||
|
sets
|
||||||
|
.Ev DISPLAY_SOCKET
|
||||||
|
to the path of the
|
||||||
|
.Xr unix 4
|
||||||
|
socket where it listens for connections from applications.
|
||||||
|
Applications use
|
||||||
|
.Ev DISPLAY_SOCKET
|
||||||
|
to connect to
|
||||||
|
.Nm
|
||||||
|
or
|
||||||
|
.Pa /run/display
|
||||||
|
by default.
|
||||||
|
.El
|
||||||
|
.Sh FILES
|
||||||
|
.Bl -tag -width 12345678 -compact
|
||||||
|
.It Pa ~/.displayrc , /etc/displayrc , /etc/default/displayrc
|
||||||
|
.Xr displayrc 5
|
||||||
|
script that spawns the user's preferred startup applications.
|
||||||
|
.It Pa /run/display
|
||||||
|
.Xr unix 4
|
||||||
|
socket where
|
||||||
|
.Nm
|
||||||
|
listens for connections from applications, as advertised in the
|
||||||
|
.Ev DISPLAY_SOCKET
|
||||||
|
environment variable.
|
||||||
|
.El
|
||||||
|
.Sh ASYNCHRONOUS EVENTS
|
||||||
|
.Bl -tag -width "SIGTERM"
|
||||||
|
.It Dv SIGTERM
|
||||||
|
Request daemon termination.
|
||||||
|
.El
|
||||||
|
.Sh EXIT STATUS
|
||||||
|
.Nm
|
||||||
|
runs as a
|
||||||
|
.Xr daemon 7
|
||||||
|
until stopped by
|
||||||
|
.Dv SIGTERM ,
|
||||||
|
the user explicitly exits the desktop environment, or an application asks
|
||||||
|
it to exit.
|
||||||
|
.Nm
|
||||||
|
signals readiness on the
|
||||||
|
.Ev READYFD
|
||||||
|
file descriptor when the display server is ready to receive connections from
|
||||||
|
applications.
|
||||||
|
.Nm
|
||||||
|
will exit non-zero on any fatal startup error.
|
||||||
|
.Sh EXAMPLES
|
||||||
|
.Nm
|
||||||
|
can be selected as the user's graphical user interface with this executable
|
||||||
|
.Pa ~/.session
|
||||||
|
script:
|
||||||
|
.Bd -literal -offset indent
|
||||||
|
#!/bin/sh
|
||||||
|
exec display
|
||||||
|
.Ed
|
||||||
|
.Pp
|
||||||
|
.Xr chkblayout 1 ,
|
||||||
|
.Xr chvideomode 1 ,
|
||||||
|
.Xr display 1
|
||||||
|
will run the
|
||||||
|
.Xr displayrc 5
|
||||||
|
script on startup, which can be used to start applications.
|
||||||
|
.Sh SEE ALSO
|
||||||
|
.Xr terminal 1 ,
|
||||||
|
.Xr displayrc 5 ,
|
||||||
|
.Xr session 5
|
||||||
|
.Sh BUGS
|
||||||
|
The following features are not yet implemented:
|
||||||
|
.Bl -bullet -compact
|
||||||
|
.It
|
||||||
|
Windows cannot be minimized.
|
||||||
|
.It
|
||||||
|
Applications cannot receive mouse events.
|
||||||
|
.It
|
||||||
|
The wallpaper is random and cannot be controlled.
|
||||||
|
.El
|
|
@ -50,7 +50,7 @@ exec display
|
||||||
.Xr display 1
|
.Xr display 1
|
||||||
will run the
|
will run the
|
||||||
.Xr displayrc 5
|
.Xr displayrc 5
|
||||||
script on startup, which can be used to start programs.
|
script on startup, which can be used to start applications.
|
||||||
.Ss Trianglix
|
.Ss Trianglix
|
||||||
.Xr trianglix 1
|
.Xr trianglix 1
|
||||||
can be selected as the user's triangle environment with this executable
|
can be selected as the user's triangle environment with this executable
|
||||||
|
|
|
@ -527,6 +527,7 @@ fragment instead.
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr chkblayout 1 ,
|
.Xr chkblayout 1 ,
|
||||||
.Xr chvideomode 1 ,
|
.Xr chvideomode 1 ,
|
||||||
|
.Xr display 1 ,
|
||||||
.Xr man 1 ,
|
.Xr man 1 ,
|
||||||
.Xr fstab 5 ,
|
.Xr fstab 5 ,
|
||||||
.Xr group 5 ,
|
.Xr group 5 ,
|
||||||
|
|
|
@ -14,26 +14,34 @@ The installation process is covered in
|
||||||
Bootable cdrom releases will offer the options of running a live environment,
|
Bootable cdrom releases will offer the options of running a live environment,
|
||||||
installing the operating system, or upgrading an existing installation.
|
installing the operating system, or upgrading an existing installation.
|
||||||
.Pp
|
.Pp
|
||||||
You will be presented a with standard Unix command line environment upon login or
|
You will be presented with a graphical Unix-like command line environment upon
|
||||||
booting the live environment.
|
login or booting the live environment.
|
||||||
.Ss Shutdown
|
.Ss Desktop Environment
|
||||||
.Xr init 8
|
The
|
||||||
spawns a session after boot.
|
.Xr display 1
|
||||||
This is
|
desktop environment is automatically started when booting the live environment
|
||||||
.Xr login 8
|
or after logging into an installation.
|
||||||
if the system is booted in multi-user mode.
|
|
||||||
This is a root shell if booted in single-user mode.
|
|
||||||
.Pp
|
.Pp
|
||||||
To power off the computer login as user
|
The desktop environment can be exited by pressing Control + Alt + Delete,
|
||||||
.Sy poweroff
|
which will return to the login screen (in installations) or power off the
|
||||||
or run
|
computer (in the live environment).
|
||||||
|
.Pp
|
||||||
|
A new
|
||||||
|
.Xr terminal 1
|
||||||
|
can be launched by pressing Control + Alt + F1.
|
||||||
|
.Pp
|
||||||
|
See
|
||||||
|
.Xr display 1
|
||||||
|
for all the available keyboard shortcuts.
|
||||||
|
.Ss Shutdown
|
||||||
|
To power off the computer, run
|
||||||
.Xr poweroff 8
|
.Xr poweroff 8
|
||||||
after logging in.
|
or login as
|
||||||
To reboot the computer login as user
|
.Sy poweroff .
|
||||||
.Sy reboot
|
To reboot the computter, run
|
||||||
or run
|
|
||||||
.Xr reboot 8
|
.Xr reboot 8
|
||||||
after logging in.
|
or login as
|
||||||
|
.Sy reboot .
|
||||||
.Ss Keyboard Layout
|
.Ss Keyboard Layout
|
||||||
The kernel has a default US keyboard layout compiled into it.
|
The kernel has a default US keyboard layout compiled into it.
|
||||||
.Pp
|
.Pp
|
||||||
|
|
Loading…
Reference in New Issue