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:
Michael Froman 2023-04-24 18:00:46 -05:00
Родитель 35ba4c983d
Коммит 9109171796
40 изменённых файлов: 104 добавлений и 121 удалений

3
third_party/libwebrtc/README.moz-ff-commit поставляемый
Просмотреть файл

@ -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

2
third_party/libwebrtc/README.mozilla поставляемый
Просмотреть файл

@ -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.

7
third_party/libwebrtc/api/README.md поставляемый
Просмотреть файл

@ -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 wont 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

4
third_party/libwebrtc/api/g3doc/index.md поставляемый
Просмотреть файл

@ -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
third_party/libwebrtc/g3doc.lua поставляемый
Просмотреть файл

@ -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

6
third_party/libwebrtc/g3doc/field-trials.md поставляемый
Просмотреть файл

@ -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

20
third_party/libwebrtc/g3doc/g3doc.lua поставляемый
Просмотреть файл

@ -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

6
third_party/libwebrtc/g3doc/index.md поставляемый
Просмотреть файл

@ -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

5
third_party/libwebrtc/g3doc/sitemap.md поставляемый
Просмотреть файл

@ -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)

6
third_party/libwebrtc/g3doc/style-guide.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

6
third_party/libwebrtc/p2p/g3doc/ice.md поставляемый
Просмотреть файл

@ -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

4
third_party/libwebrtc/pc/g3doc/rtp.md поставляемый
Просмотреть файл

@ -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

4
third_party/libwebrtc/pc/g3doc/srtp.md поставляемый
Просмотреть файл

@ -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

4
third_party/libwebrtc/stats/g3doc/stats.md поставляемый
Просмотреть файл

@ -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

4
third_party/libwebrtc/video/g3doc/stats.md поставляемый
Просмотреть файл

@ -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