man/weston-drm.man

@@ -43,6 +43,30 @@ section of
 .
 The DRM backend uses the following entries from
 .BR weston.ini .
+.SS Section core
+.TP
+\fBgbm-format\fR=\fIformat\fR
+Sets the default pixel format for DRM KMS framebuffers.
+.IR Format " can be"
+.BR xrgb8888 ", " xrgb2101010 ", " rgb565
+or others. Weston recognizes the names of most pixel formats defined by
+the kernel DRM subsystem in
+.B drm_fourcc.h
+header without the DRM_FORMAT_ prefix.
+The actually supported pixel formats depend on the DRM driver and hardware,
+and the renderer used. Using Pixman-renderer, DRM-backend supports only
+.BR xrgb8888 " and " rgb565 .
+The formats supported with GL-renderer depend on the EGL and OpenGL ES 2 or 3
+implementations. The names are case-insensitive.
+
+.RB "If not specified, " xrgb8888 " is used. See also " gbm-format " in"
+.BR output " section."
+.TP
+\fBpageflip-timeout\fR=\fImilliseconds\fR
+sets Weston's pageflip timeout in milliseconds.  This sets a timer to exit
+gracefully with a log message and an exit code of 1 in case the DRM driver is
+non-responsive.  Setting it to 0 disables this feature.
+
 .SS Section output
 .TP
 \fBname\fR=\fIconnector\fR
@@ -108,6 +132,12 @@ and possibly flipped. Possible values are
 .BR flipped ", " flipped-rotate-90 ", " flipped-rotate-180 ", and "
 .BR flipped-rotate-270 .
 .TP
+\fBgbm-format\fR=\fIformat\fR
+Set the DRM KMS framebuffer format for this specific output. If not set,
+.RB "the value from " gbm-format " option in " core " section is used."
+.RI "For the possible values for " format " see "
+.BR gbm-format " option in " core " section."
+.TP
 \fBpixman-shadow\fR=\fIboolean\fR
 If using the Pixman-renderer, use shadow framebuffers. Defaults to
 .BR true .

man/weston.ini.man

@@ -148,16 +148,6 @@ target vertical blank, increasing output latency. The default value is 7
 milliseconds. The allowed range is from -10 to 1000 milliseconds. Using a
 negative value will force the compositor to always miss the target vblank.
 .TP 7
-.BI "gbm-format="format
-sets the GBM format used for the framebuffer for the GBM backend. Can be
-.B xrgb8888,
-.B xrgb2101010,
-.B rgb565.
-By default, xrgb8888 is used.
-.RS
-.PP
-.RE
-.TP 7
 .BI "idle-time="seconds
 sets Weston's idle timeout in seconds. This idle timeout is the time
 after which Weston will enter an "inactive" mode and screen will fade to
@@ -177,11 +167,6 @@ set to 300 seconds.
 .BI "require-input=" true
 require an input device for launch
 .TP 7
-.BI "pageflip-timeout="milliseconds
-sets Weston's pageflip timeout in milliseconds.  This sets a timer to exit
-gracefully with a log message and an exit code of 1 in case the DRM driver is
-non-responsive.  Setting it to 0 disables this feature.
-.TP 7
 .BI "wait-for-debugger=" true
 Raises SIGSTOP before initializing the compositor. This allows the user to
 attach with a debugger and continue execution by sending SIGCONT. This is

man/weston.man

@@ -14,7 +14,7 @@ modesetting via DRM), as an X client, or inside another Wayland server
 instance.
 
 Weston supports fundamentally different graphical user interface paradigms via
-shell plugins. Two plugins are provided: the desktop shell, and the tablet
+shell plugins. Two plugins are provided: the desktop shell, and the kiosk
 shell.
 
 Weston also supports X clients via