RGBCube/serenity
1
Fork 0
mirror of https://github.com/RGBCube/serenity synced 2025-07-27 03:17:35 +00:00
Code Issues Activity Actions

Base: Add manpages for new layout system

Browse source 
This is far from explaining all implications of the new layout system,
but it covers the basics.
This commit is contained in:
FrHun 2022-05-11 01:25:18 +02:00 • committed by Sam Atkins
parent 1d6d074536
commit a78f84645c
5 changed files with 85 additions and 38 deletions
Download patch file Download diff file Expand all files Collapse all files

3
Base/usr/share/man/man5/GML-Syntax.md
View file

@ -90,6 +90,7 @@ A property's `value` is required to be either a JSON value or another object. Ob
Among the supported JSON values, these types can be further distinguished:
- `int`: Regular JSON integer, note that JSON floats are not currently used.
- `ui_dimension`: either positive integers, that work just like `int`, or special meaning values as JSON strings; see [UI Dimensions](help://man/5/GML-UI-Dimensions)
- `bool`: Regular JSON boolean, may be enclosed in quotes but this is discouraged.
- `string`: JSON string, also used as a basis for other types.
- `readonly_string`: String-valued property that cannot be changed from C++ later.
@ -99,6 +100,7 @@ Among the supported JSON values, these types can be further distinguished:
- `text_wrapping`: Special case of `enum` for `Gfx::TextWrapping`. One of `Wrap` or `DontWrap`.
- `rect`: A JSON object of four `int`s specifying a rectangle. The keys are `x`, `y`, `width`, `height`.
- `size`: A JSON array of two `int`s specifying two sizes in the format `[width, height]`.
- `ui_size`: A JSON array of two `ui_dimension`s specifying two sizes in the format `[width, height]`
- `margins`: A JSON array or object specifying four-directional margins as `int`s. If this is a JSON object, the four keys `top`, `right`, `bottom`, `left` are used. If this is a JSON array, there can be one to four integers. These have the following meaning (see also `GUI::Margins`):
- `[ all_four_margins ]`
- `[ top_and_bottom, right_and_left ]`
@ -232,3 +234,4 @@ GML files can be found in the SerenityOS source tree with the `*.gml` extension.
}
}
```