diff options
author | Okhuomon Ajayi <okhuomonajayi54@gmail.com> | 2024-03-08 15:11:28 +0100 |
---|---|---|
committer | GitHub <noreply@github.com> | 2024-03-08 14:11:28 +0000 |
commit | 0327d4638bdb3c95315c143dfcc94d8195fb5fae (patch) | |
tree | 19d5b02c9906866de43bd1f3813e9046ee945428 /docs/components | |
parent | 7e8a1503ba6f3c4d99ffed90e65746d63a65ac8d (diff) | |
download | servo-0327d4638bdb3c95315c143dfcc94d8195fb5fae.tar.gz servo-0327d4638bdb3c95315c143dfcc94d8195fb5fae.zip |
Adjust the language used in some of the documentation (#31583)
* fixed a typo in the Android setup command
* Fix typo in documentation for command-line arguments
* Fix style and formatting issues in the Shell Scripts section of the documentation
* Update style.md
* Fixed various inconsistencies
* Fixed various inconsistencies
* Update webxr.md
* Update style.md
* Update COMMAND_LINE_ARGS.md
* Update README.md
Co-authored-by: Martin Robinson <mrobinson@igalia.com>
* Update docs/COMMAND_LINE_ARGS.md
---------
Co-authored-by: Martin Robinson <mrobinson@igalia.com>
Diffstat (limited to 'docs/components')
-rw-r--r-- | docs/components/style.md | 10 | ||||
-rw-r--r-- | docs/components/webxr.md | 22 |
2 files changed, 16 insertions, 16 deletions
diff --git a/docs/components/style.md b/docs/components/style.md index d8d54124fab..12da45f8672 100644 --- a/docs/components/style.md +++ b/docs/components/style.md @@ -1,15 +1,15 @@ # Servo's style system overview -This needs to be filled more extensively. Meanwhile, you can also take a look at -the [style doc comments][style-doc], or the [Styling -Overview][wiki-styling-overview] in the wiki, a conversation between +This document provides an overview of Servo's style system. For more extensive details, +refer to the [style doc comments][style-doc], or the [Styling +Overview][wiki-styling-overview] in the wiki, which includes a conversation between Boris Zbarsky and Patrick Walton about how style sharing works. <a name="selector-impl"></a> ## Selector Implementation -In order to be sharable and compatible with Stylo (a project that aims -to integrate Servo's style system into Gecko), the style must be consistent. +To ensure compatibility with Stylo (a project integrating Servo's style system into Gecko), +selectors must be consistent. The consistency is implemented in [selectors' SelectorImpl][selector-impl], containing the logic related to parsing pseudo-elements and other pseudo-classes diff --git a/docs/components/webxr.md b/docs/components/webxr.md index 9b614ba9d16..f366b069886 100644 --- a/docs/components/webxr.md +++ b/docs/components/webxr.md @@ -2,22 +2,22 @@ ## Terminology -There are three main components involved in Servo's WebXR implementation: -1. the script thread (runs all JS for a page) -2. the WebGL thread (maintains WebGL canvas data and invokes GL operations corresponding to [WebGL APIs](https://registry.khronos.org/webgl/specs/latest/1.0/)) -3. the compositor (AKA the main thread) +Servo's WebXR implementation involves three main components: +1. The script thread (runs all JS for a page) +2. The WebGL thread (maintains WebGL canvas data and invokes GL operations corresponding to [WebGL APIs](https://registry.khronos.org/webgl/specs/latest/1.0/)) +3. The compositor (AKA the main thread) Additionally, there are a number of WebXR-specific concepts: -* the [discovery object](https://doc.servo.org/webxr_api/trait.DiscoveryAPI.html) (ie. how Servo discovers if a device can provide a WebXR session) -* the [WebXR registry](https://doc.servo.org/webxr_api/struct.MainThreadRegistry.html) (the compositor's interface to WebXR) -* the [layer manager](https://doc.servo.org/webxr_api/layer/trait.LayerManagerAPI.html) (manages WebXR layers for a given session and frame operations on those layers) -* ths [layer grand manager](https://doc.servo.org/webxr_api/layer/trait.LayerGrandManagerAPI.html) (manages all layer managers for WebXR sessions) +* The [discovery object](https://doc.servo.org/webxr_api/trait.DiscoveryAPI.html) (ie. how Servo discovers if a device can provide a WebXR session) +* The [WebXR registry](https://doc.servo.org/webxr_api/struct.MainThreadRegistry.html) (the compositor's interface to WebXR) +* The [layer manager](https://doc.servo.org/webxr_api/layer/trait.LayerManagerAPI.html) (manages WebXR layers for a given session and frame operations on those layers) +* The [layer grand manager](https://doc.servo.org/webxr_api/layer/trait.LayerGrandManagerAPI.html) (manages all layer managers for WebXR sessions) Finally, there are graphics-specific concepts that are important for the low-level details of rendering with WebXR: * [surfman](https://github.com/servo/webxr/blob/main/webxr/glwindow/mod.rs#L448-L452) is a crate that abstracts away platform-specific details of OpenGL hardware-accelerated rendering -* a [surface](https://doc.servo.org/surfman/platform/unix/default/surface/type.Surface.html) is a hardware buffer that are tied to a specific OpenGL context -* a [surface texture](https://doc.servo.org/surfman/platform/unix/default/surface/type.SurfaceTexture.html) is an OpenGL texture that wraps a surface. Surface textures can be shared between OpenGL contexts. -* a [surfman context](https://doc.servo.org/surfman/platform/unix/default/context/type.Context.html) represents a particular OpenGL context, and is backed by platform-specific implementations (such as EGL on Unix-based platforms) +* [surface](https://doc.servo.org/surfman/platform/unix/default/surface/type.Surface.html) is a hardware buffer that are tied to a specific OpenGL context +* [surface texture](https://doc.servo.org/surfman/platform/unix/default/surface/type.SurfaceTexture.html) is an OpenGL texture that wraps a surface. Surface textures can be shared between OpenGL contexts. +* [surfman context](https://doc.servo.org/surfman/platform/unix/default/context/type.Context.html) represents a particular OpenGL context, and is backed by platform-specific implementations (such as EGL on Unix-based platforms) * [ANGLE](https://github.com/servo/mozangle/) is an OpenGL implementation on top of Direct3D which is used in Servo to provide a consistent OpenGL backend on Windows-based platforms ## How Servo's compositor starts |