зеркало из https://github.com/mozilla/gecko-dev.git
Bug 1828517 - Vendor libwebrtc from 3eceaf4669
Upstream commit: https://webrtc.googlesource.com/src/+/3eceaf46695518f25bef43f155f82ed174827197 Migrate WebRTC documentation to new renderer Bug: b/258408932 Change-Id: Ib96f39fe0c3912f9746bcc09d079097a145d6115 Reviewed-on: https://webrtc-review.googlesource.com/c/src/+/290987 Reviewed-by: Harald Alvestrand <hta@webrtc.org> Commit-Queue: Artem Titov <titovartem@webrtc.org> Cr-Commit-Position: refs/heads/main@{#39205}
This commit is contained in:
Родитель
35ba4c983d
Коммит
9109171796
|
@ -21231,3 +21231,6 @@ cfbb247f6d
|
|||
# MOZ_LIBWEBRTC_SRC=/home/mfroman/mozilla/moz-central/.moz-fast-forward/moz-libwebrtc MOZ_LIBWEBRTC_BRANCH=mozpatches bash dom/media/webrtc/third_party_build/fast-forward-libwebrtc.sh
|
||||
# base of lastest vendoring
|
||||
94d5f6af62
|
||||
# MOZ_LIBWEBRTC_SRC=/home/mfroman/mozilla/moz-central/.moz-fast-forward/moz-libwebrtc MOZ_LIBWEBRTC_BRANCH=mozpatches bash dom/media/webrtc/third_party_build/fast-forward-libwebrtc.sh
|
||||
# base of lastest vendoring
|
||||
3eceaf4669
|
||||
|
|
|
@ -14176,3 +14176,5 @@ libwebrtc updated from /home/mfroman/mozilla/moz-central/.moz-fast-forward/moz-l
|
|||
libwebrtc updated from /home/mfroman/mozilla/moz-central/.moz-fast-forward/moz-libwebrtc commit mozpatches on 2023-04-24T22:49:10.327954.
|
||||
# ./mach python dom/media/webrtc/third_party_build/vendor-libwebrtc.py --from-local /home/mfroman/mozilla/moz-central/.moz-fast-forward/moz-libwebrtc --commit mozpatches libwebrtc
|
||||
libwebrtc updated from /home/mfroman/mozilla/moz-central/.moz-fast-forward/moz-libwebrtc commit mozpatches on 2023-04-24T22:58:59.449291.
|
||||
# ./mach python dom/media/webrtc/third_party_build/vendor-libwebrtc.py --from-local /home/mfroman/mozilla/moz-central/.moz-fast-forward/moz-libwebrtc --commit mozpatches libwebrtc
|
||||
libwebrtc updated from /home/mfroman/mozilla/moz-central/.moz-fast-forward/moz-libwebrtc commit mozpatches on 2023-04-24T23:00:33.335426.
|
||||
|
|
|
@ -1,6 +1,9 @@
|
|||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'hta' reviewed: '2021-01-01'} *-->
|
||||
|
||||
# How to write code in the `api/` directory
|
||||
|
||||
Mostly, just follow the regular [style guide](../g3doc/style-guide.md), but:
|
||||
Mostly, just follow the regular [style guide](/g3doc/style-guide.md), but:
|
||||
|
||||
* Note that `api/` code is not exempt from the “`.h` and `.cc` files come in
|
||||
pairs” rule, so if you declare something in `api/path/to/foo.h`, it should be
|
||||
|
@ -17,7 +20,7 @@ it from a `.cc` file, so that users of our API headers won’t transitively
|
|||
|
||||
For headers in `api/` that need to refer to non-public types, forward
|
||||
declarations are often a lesser evil than including non-public header files. The
|
||||
usual [rules](../g3doc/style-guide.md#forward-declarations) still apply, though.
|
||||
usual [rules](/g3doc/style-guide.md#forward-declarations) still apply, though.
|
||||
|
||||
`.cc` files in `api/` should preferably be kept reasonably small. If a
|
||||
substantial implementation is needed, consider putting it with our non-public
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
<?% config.freshness.owner = 'hta' %?>
|
||||
<?% config.freshness.reviewed = '2021-04-12' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'hta' reviewed: '2021-04-12'} *-->
|
||||
|
||||
# The WebRTC API
|
||||
|
||||
|
|
|
@ -1,5 +1,6 @@
|
|||
<?% config.freshness.owner = 'hta' %?>
|
||||
<?% config.freshness.reviewed = '2021-04-12' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'hta' reviewed: '2021-04-12'} *-->
|
||||
|
||||
# API Threading Design considerations
|
||||
|
||||
The header files in this directory form the API to the WebRTC library
|
||||
|
|
|
@ -1 +0,0 @@
|
|||
return require(this.dirname..'g3doc/g3doc.lua')
|
|
@ -1,7 +1,7 @@
|
|||
# Using Abseil in WebRTC
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'danilchap' reviewed: '2021-05-12'} *-->
|
||||
|
||||
<?% config.freshness.owner = 'danilchap' %?>
|
||||
<?% config.freshness.reviewed = '2021-05-12' %?>
|
||||
# Using Abseil in WebRTC
|
||||
|
||||
You may use a subset of the utilities provided by the [Abseil][abseil]
|
||||
library when writing WebRTC C++ code. Below, we list the explicitly
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
# How to get tryjob access or become WebRTC committer
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'titovartem' reviewed: '2021-10-26'} *-->
|
||||
|
||||
<?% config.freshness.owner = 'titovartem' %?>
|
||||
<?% config.freshness.reviewed = '2021-10-26' %?>
|
||||
# How to get tryjob access or become WebRTC committer
|
||||
|
||||
## Overview
|
||||
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
# Field trials
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'lndmrk' reviewed: '2022-06-23'} *-->
|
||||
|
||||
<?% config.freshness.owner = 'lndmrk' %?>
|
||||
<?% config.freshness.reviewed = '2022-06-23' %?>
|
||||
# Field trials
|
||||
|
||||
WebRTC provides some means to alter its default behavior during run-time,
|
||||
colloquially known as *field trials*. This is foremost used for A/B testing new
|
||||
|
|
|
@ -1,20 +0,0 @@
|
|||
return {
|
||||
theme = {
|
||||
'@builtins/theme/ng.md',
|
||||
-- We don't want to have more than h3 headings in the Table Of Content.
|
||||
toc_level = 3,
|
||||
},
|
||||
|
||||
site = {
|
||||
name = 'WebRTC C++ library',
|
||||
home = this.dirname..'index.md',
|
||||
logo = this.dirname..'logo.svg',
|
||||
map = this.dirname..'sitemap.md',
|
||||
-- Ensure absolute links are rewritten correctly.
|
||||
root = this.dirname..'..'
|
||||
},
|
||||
|
||||
visibility = { '/...' },
|
||||
|
||||
freshness = {}
|
||||
}
|
|
@ -1,7 +1,7 @@
|
|||
# How to write WebRTC documentation
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'titovartem' reviewed: '2023-01-16'} *-->
|
||||
|
||||
<?% config.freshness.owner = 'titovartem' %?>
|
||||
<?% config.freshness.reviewed = '2021-03-01' %?>
|
||||
# How to write WebRTC documentation
|
||||
|
||||
## Audience
|
||||
|
||||
|
@ -15,7 +15,7 @@ documentation can skip some edge cases in favor of clarity. The main point
|
|||
is to impart understanding.
|
||||
|
||||
Conceptual documentation often cannot be embedded directly within the source
|
||||
code because it usually describes multiple APIs and entites, so the only
|
||||
code because it usually describes multiple APIs and entities, so the only
|
||||
logical place to document such complex behavior is through a separate
|
||||
conceptual document.
|
||||
|
||||
|
@ -28,7 +28,14 @@ usage and leave rare ones or side effects for class/function level comments.
|
|||
In the WebRTC repo, conceptual documentation is located in `g3doc` subfolders
|
||||
of related components. To add a new document for the component `Foo` find a
|
||||
`g3doc` subfolder for this component and create a `.md` file there with
|
||||
desired documentation. If there is no `g3doc` subfolder, create a new one;
|
||||
desired documentation. If there is no `g3doc` subfolder, create a new one.
|
||||
|
||||
Please put the following file header into any created documentation file as the
|
||||
first line:
|
||||
|
||||
```markdown
|
||||
<!-- go/cmark -->
|
||||
```
|
||||
|
||||
When you want to specify a link from one page to another - use the absolute
|
||||
path:
|
||||
|
@ -42,17 +49,7 @@ keeping this documentation updated, by adding the next lines at the beginning
|
|||
of your `.md` file immediately after page title:
|
||||
|
||||
```markdown
|
||||
<?\% config.freshness.owner = '<user name>' %?>
|
||||
<?\% config.freshness.reviewed = '<last review date in format yyyy-mm-dd>' %?>
|
||||
```
|
||||
|
||||
If you want to configure the owner for all pages under a directory, create a
|
||||
`g3doc.lua` file in that directory with the content:
|
||||
|
||||
```lua
|
||||
config = super()
|
||||
config.freshness.owner = '<user name>'
|
||||
return config
|
||||
<!--* freshness: {owner: '<user name>' reviewed: '<last review date in format yyyy-mm-dd>' *-->
|
||||
```
|
||||
|
||||
After the document is ready you should add it into `/g3doc/sitemap.md`, so it
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
<?% config.freshness.owner = 'hta' %?>
|
||||
<?% config.freshness.reviewed = '2021-05-31' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'hta' reviewed: '2021-05-31'} *-->
|
||||
|
||||
# Basic concepts and primitives
|
||||
|
||||
|
|
|
@ -1,6 +1,6 @@
|
|||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'titovartem' reviewed: '2021-03-01'} *-->
|
||||
|
||||
# WebRTC C++ library
|
||||
|
||||
<?% config.freshness.owner = 'titovartem' %?>
|
||||
<?% config.freshness.reviewed = '2021-03-01' %?>
|
||||
|
||||
This is a home page for WebRTC C++ library documentation
|
||||
|
|
|
@ -2,9 +2,14 @@
|
|||
* How to contribute
|
||||
* Code
|
||||
* [Style guide](/g3doc/style-guide.md)
|
||||
* [`.h` and `.cc` files come in pairs](g3doc/style-guide/h-cc-pairs.md)
|
||||
* [How to write code in the `api/` directory](/api/README.md)
|
||||
* [Using Abseil in WebRTC](/g3doc/abseil-in-webrtc.md)
|
||||
* [Code of conduct](/CODE_OF_CONDUCT.md)
|
||||
* [Documentation](/g3doc/how_to_write_documentation.md)
|
||||
* [Become a committer](/g3doc/become_a_committer.md)
|
||||
* [Public C++ API](/api/g3doc/index.md)
|
||||
* [API header files](/native-api.md)
|
||||
* [Threading](/api/g3doc/threading_design.md)
|
||||
* Implementation
|
||||
* [Basic concepts](/g3doc/implementation_basics.md)
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
# WebRTC coding style guide
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'danilchap' reviewed: '2022-01-17'} *-->
|
||||
|
||||
<?% config.freshness.owner = 'danilchap' %?>
|
||||
<?% config.freshness.reviewed = '2022-01-17' %?>
|
||||
# WebRTC coding style guide
|
||||
|
||||
## General advice
|
||||
|
||||
|
|
|
@ -1,9 +1,9 @@
|
|||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'danilchap' reviewed: '2021-05-12'} *-->
|
||||
|
||||
# `.h` and `.cc` files come in pairs
|
||||
|
||||
<?% config.freshness.owner = 'danilchap' %?>
|
||||
<?% config.freshness.reviewed = '2021-05-12' %?>
|
||||
|
||||
This is an overflow page for [this](../style-guide.md#h-cc-pairs)
|
||||
This is an overflow page for [this](/g3doc/style-guide.md#h-cc-pairs)
|
||||
style rule.
|
||||
|
||||
## Example violations
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
# WebRTC supported plaftorms and compilers
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'mbonadei' reviewed: '2021-06-25'} *-->
|
||||
|
||||
<?% config.freshness.owner = 'mbonadei' %?>
|
||||
<?% config.freshness.reviewed = '2021-06-25' %?>
|
||||
# WebRTC supported plaftorms and compilers
|
||||
|
||||
## Operating systems and CPUs
|
||||
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
# RTC event log
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'terelius' reviewed: '2021-06-02'} *-->
|
||||
|
||||
<?% config.freshness.owner = 'terelius' %?>
|
||||
<?% config.freshness.reviewed = '2021-06-02' %?>
|
||||
# RTC event log
|
||||
|
||||
## Overview
|
||||
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
<?% config.freshness.owner = 'minyue' %?>
|
||||
<?% config.freshness.reviewed = '2021-04-13' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'hlundin' reviewed: '2021-04-13'} *-->
|
||||
|
||||
# The WebRTC Audio Coding Module
|
||||
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
<?% config.freshness.reviewed = '2021-04-13' %?>
|
||||
<?% config.freshness.owner = 'jakobi' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'jakobi' reviewed: '2021-04-13'} *-->
|
||||
|
||||
# NetEq
|
||||
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
# Audio Device Module (ADM)
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'henrika' reviewed: '2021-04-12'} *-->
|
||||
|
||||
<?% config.freshness.owner = 'henrika' %?>
|
||||
<?% config.freshness.reviewed = '2021-04-12' %?>
|
||||
# Audio Device Module (ADM)
|
||||
|
||||
## Overview
|
||||
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
<?% config.freshness.owner = 'alessiob' %?>
|
||||
<?% config.freshness.reviewed = '2021-04-21' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'alessiob' reviewed: '2021-04-21'} *-->
|
||||
|
||||
# The WebRTC Audio Mixer Module
|
||||
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
# Audio Processing Module (APM)
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'peah' reviewed: '2021-04-13'} *-->
|
||||
|
||||
<?% config.freshness.owner = 'peah' %?>
|
||||
<?% config.freshness.reviewed = '2021-04-13' %?>
|
||||
# Audio Processing Module (APM)
|
||||
|
||||
## Overview
|
||||
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
<?% config.freshness.reviewed = '2021-04-12' %?>
|
||||
<?% config.freshness.owner = 'sprang' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'sprang' reviewed: '2021-04-12'} *-->
|
||||
|
||||
# Paced Sending
|
||||
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
<?% config.freshness.owner = 'brandtr' %?>
|
||||
<?% config.freshness.reviewed = '2021-04-15' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'brandtr' reviewed: '2021-04-15'} *-->
|
||||
|
||||
# Video coding in WebRTC
|
||||
|
||||
|
|
|
@ -1,7 +1,7 @@
|
|||
# ICE
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'jonaso' reviewed: '2021-04-12'} *-->
|
||||
|
||||
<?% config.freshness.owner = 'jonaso' %?>
|
||||
<?% config.freshness.reviewed = '2021-04-12' %?>
|
||||
# ICE
|
||||
|
||||
## Overview
|
||||
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
<?% config.freshness.reviewed = '2021-05-07' %?>
|
||||
<?% config.freshness.owner = 'hta' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'hta' reviewed: '2021-05-07'} *-->
|
||||
|
||||
## Overview
|
||||
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
<?% config.freshness.reviewed = '2021-05-07' %?>
|
||||
<?% config.freshness.owner = 'hta' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'hta' reviewed: '2021-05-07'} *-->
|
||||
|
||||
# PeerConnection and friends
|
||||
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
<?% config.freshness.reviewed = '2021-06-03' %?>
|
||||
<?% config.freshness.owner = 'hta' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'hta' reviewed: '2021-06-03'} *-->
|
||||
|
||||
# RTP in WebRTC
|
||||
|
||||
|
|
|
@ -1,6 +1,5 @@
|
|||
|
||||
<?% config.freshness.reviewed = '2021-04-13' %?>
|
||||
<?% config.freshness.owner = 'hta' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'hta' reviewed: '2021-04-13'} *-->
|
||||
|
||||
# SctpTransport
|
||||
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
<?% config.freshness.reviewed = '2021-05-13' %?>
|
||||
<?% config.freshness.owner = 'hta' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'hta' reviewed: '2021-05-13'} *-->
|
||||
|
||||
# SRTP in WebRTC
|
||||
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
<?% config.freshness.reviewed = '2022-10-01' %?>
|
||||
<?% config.freshness.owner = 'hta' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'hta' reviewed: '2022-10-01'} *-->
|
||||
|
||||
# getStats in WebRTC
|
||||
|
||||
|
|
|
@ -1,5 +0,0 @@
|
|||
config = super()
|
||||
|
||||
config.freshness.owner = 'titovartem'
|
||||
|
||||
return config
|
|
@ -1,6 +1,7 @@
|
|||
# Network Emulation Framework
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'titovartem' reviewed: '2021-03-01'} *-->
|
||||
|
||||
<?% config.freshness.reviewed = '2021-03-01' %?>
|
||||
# Network Emulation Framework
|
||||
|
||||
[TOC]
|
||||
|
||||
|
|
|
@ -1,4 +1,5 @@
|
|||
<?% config.freshness.reviewed = '2021-04-12' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'titovartem' reviewed: '2021-04-12'} *-->
|
||||
|
||||
# PeerConnection level framework fixture architecture
|
||||
|
||||
|
|
|
@ -1,4 +1,5 @@
|
|||
<?% config.freshness.reviewed = '2021-02-21' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'titovartem' reviewed: '2021-02-21'} *-->
|
||||
|
||||
# DefaultVideoQualityAnalyzer
|
||||
|
||||
|
|
|
@ -1,5 +0,0 @@
|
|||
config = super()
|
||||
|
||||
config.freshness.owner = 'titovartem'
|
||||
|
||||
return config
|
|
@ -1,4 +1,5 @@
|
|||
<?% config.freshness.reviewed = '2021-04-12' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'titovartem' reviewed: '2021-04-12'} *-->
|
||||
|
||||
# PeerConnection Level Framework
|
||||
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
<?% config.freshness.reviewed = '2021-04-13' %?>
|
||||
<?% config.freshness.owner = 'eshr' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'eshr' reviewed: '2021-04-13'} *-->
|
||||
|
||||
# Video Adaptation
|
||||
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
<?% config.freshness.reviewed = '2021-04-14' %?>
|
||||
<?% config.freshness.owner = 'asapersson' %?>
|
||||
<!-- go/cmark -->
|
||||
<!--* freshness: {owner: 'asapersson' reviewed: '2021-04-14'} *-->
|
||||
|
||||
# Video stats
|
||||
|
||||
|
|
Загрузка…
Ссылка в новой задаче