aboutsummaryrefslogtreecommitdiffstats
path: root/docs/components
diff options
context:
space:
mode:
authorOkhuomon Ajayi <okhuomonajayi54@gmail.com>2024-03-08 15:11:28 +0100
committerGitHub <noreply@github.com>2024-03-08 14:11:28 +0000
commit0327d4638bdb3c95315c143dfcc94d8195fb5fae (patch)
tree19d5b02c9906866de43bd1f3813e9046ee945428 /docs/components
parent7e8a1503ba6f3c4d99ffed90e65746d63a65ac8d (diff)
downloadservo-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.md10
-rw-r--r--docs/components/webxr.md22
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