Commit Graph

407 Commits

Author SHA1 Message Date
Claudio Saavedra
f3de7ca743
docs: replace fgrep with grep -F
It's been deprecated for decades and in Debian system it's starting
to print warnings. Just use grep -F instead.

Signed-off-by: Ralph Giles <giles@thaumas.net>
2023-04-20 15:13:19 -07:00
Xavier Claessens
d2f6805c3f
Meson: Fix doc build when opus is a subproject
meson.source_root() and meson.build_root() have been deprecated in
latest Meson release because they are a trap. They point to the root of
parent project instead of root of current subproject. Meson 0.56.0 added
meson.project_source/build_root() but it is just as easy to use
meson.current_source/build_dir() in the root meson.build file and avoids
bumping required meson version.

Signed-off-by: Ralph Giles <giles@thaumas.net>
2020-11-26 11:20:44 -08:00
Tim-Philipp Müller
c2b542b6c0 Add support for Meson build system
Tested on:
 - Linux/x86* with gcc
 - Android armv7 arm64 x86 x86_64 with clang
 - Windows x86 x86_64 with Visual Studio 2017
 - Windows x86 x86_64 with MinGW
 - macOS x86_64 with clang
 - iOS arm64 x86_64 with clang

Co-authored by: Nirbheek Chauhan <nirbheek@centricular.com>

https://gitlab.xiph.org/xiph/opus/-/merge_requests/13
2020-10-28 22:29:08 +05:30
willson-chen
3cb71dbefd fix doc/build_draft.sh run error
Add newer source directories to the destdir file tree so we
can include all sources referenced from opus_sources.mk.

Signed-off-by: Ralph Giles <giles@thaumas.net>
2020-06-13 13:39:04 -07:00
willson-chen
86e9bfc8bb opus draft: fix run failed under dash
[[ ]], the compound command is not supported by all
shell interpreter. [ ], the buildin command is more
common.

Signed-off-by: Ralph Giles <giles@thaumas.net>
2020-06-13 13:37:38 -07:00
Marcus Asteborg
fad505e8ed
Update Doxygen config file, header and footer to Doxygen 1.8.18
Signed-off-by: Ralph Giles <giles@thaumas.net>
2020-06-08 17:32:08 -07:00
Ralph Giles
fefcad3797
trivial_example: Check the return value of fread().
Silence a gcc warning by checking the return value of the fread()
call instead of the feof() guard. This prevents an infinite loop
in the case of a read error. Otherwise, when end-of-file is reached
fread() will certainly return a smaller number of elements read
than requested, so both cases are handled now.

Add a comment to clarify that we're dropping a partial frame on
purpose to keep the code simple.

Also add more braces around conditional bodies for less error-prone
style.

Signed-off-by: Mark Harris <mark.hsj@gmail.com>
2020-06-01 00:48:49 -07:00
Ralph Giles
1168a29ecd
trivial_example: open raw pcm files in binary mode.
The simple codec round-trip example file in the doc directory
opens an input and output pcm file. It was working fine on
POSIX systems, but not on Windows, which treats text files
differently.

This is confusing in a example, so it's better to add an
explicit binary flag to the fopen() calls. This does nothing
on unix-like systems, but should make the example work for
developers on Windows.

Thanks to Wavesonics who reported this on irc.

Signed-off-by: Mark Harris <mark.hsj@gmail.com>
2020-06-01 00:48:45 -07:00
Mark Harris
8aa7767207
Repository moved to gitlab.xiph.org 2020-05-10 15:42:59 -07:00
Ralph Giles
f689e05227
Update ISO Base Media Format draft to version 0.8.1.
- Switch to 'Opus' file type identification.
- Revise channel mapping to better support ambisonics.
2018-09-12 18:47:23 -07:00
Jean-Marc Valin
95c48711f6
update draft version -10 2017-09-19 14:29:54 -04:00
Jean-Marc Valin
ca3cb32341
More fixes for IESG 2017-08-19 21:16:59 -04:00
Jean-Marc Valin
d772eb966a
update draft: addressing IETF LC comments 2017-08-17 14:28:33 -04:00
Jean-Marc Valin
3fe744ea04
Update draft: addressing AD comments 2017-07-26 00:59:05 -04:00
Jean-Marc Valin
047c11b5bc
Update links, fix bits, add security considerations 2017-07-16 16:32:20 -04:00
Jean-Marc Valin
acfa035bf7
Prevent update draft from expiring 2017-06-20 16:37:25 -04:00
Ralph Giles
4de224e234
Update release checklist for website move to git. 2017-06-16 09:17:15 -07:00
Jean-Marc Valin
159bb6df00
update draft: oops, fixes use of "above" 2016-12-19 16:15:23 -05:00
Jean-Marc Valin
4a48ce899c
Update draft: addressing WGLC comments 2016-12-19 14:48:35 -05:00
Ricardo Constantino
8fe210f14b
genversion.bat: generate same version as update_version
Remove version.mk and references to it in the repo.

genversion.bat will now generate the same version strings as
update_version script, i.e. without 'v' prefix and without a
fallback if git archive is used.

If run from a release tarball it'll use package_version,
like configure. If run from a git repo, it will use the same
'git describe' with '-dirty' as update_version.

Signed-off-by: Ralph Giles <giles@thaumas.net>
2016-11-17 13:28:58 -08:00
Ralph Giles
76fa939bde Make use of dot optional in generating documentation.
Different distributions of doxygen have different default
values of HAVE_DOT setting, so we need to pick a specific
setting to avoid 'missing dot' warnings on some platforms.

Doxygen uses it to generate inclusion graphs for our various
header files, which is somewhat useful, but not essential.
We therefore enable dot if it's present (usually through
the parent graphviz package) but disable it if it's not
available, silencing the warning, but not giving uniform
results.
2016-10-27 10:53:27 -07:00
Jean-Marc Valin
4667b6992a
updating update draft 2016-10-21 03:48:37 -04:00
Jean-Marc Valin
f25b46a303
misc fixes to update draft 2016-09-02 02:36:16 -04:00
Jean-Marc Valin
cf0e557a6d
minor fix to update draft 2016-09-01 14:33:54 -04:00
Jean-Marc Valin
f9a575547e
Adds two integer wrap-around issues to the update draft 2016-09-01 14:19:56 -04:00
Mark Harris
58dbcf23f3 Update URLs 2016-07-06 14:17:51 -07:00
Ralph Giles
b15172a34e Fix typo.
Thanks to RiCON for reporting this.
2016-07-06 13:00:54 -07:00
Ralph Giles
8801655c3a Update links in release checklist. 2016-07-06 12:45:08 -07:00
Jean-Marc Valin
e30e9a7609 Fix folding bug in draft too 2016-07-04 15:44:30 -04:00
Jean-Marc Valin
1b0d40fc34 update draft fixes 2016-07-04 10:42:45 -04:00
Jean-Marc Valin
f6f8487b76 minor update draft update 2016-07-01 16:09:19 -04:00
Jean-Marc Valin
4a4bc08031 Adding hybrid folding section and new testvectors to the update draft 2016-06-30 18:01:04 -04:00
Ralph Giles
e26abfaca8 Update ISO Base Media Format draft to version 0.6.8. 2016-06-02 14:13:32 -07:00
Ricardo Constantino (:RiCON)
165e11c94d
Clean doxygen_sqlite3.db
Generated by newer versions of Doxygen when built with sqlite3.
2016-05-18 21:20:35 +01:00
Timothy B. Terriberry
c43b1bc8c0 oggopus: Update version and date for -14 2016-02-22 18:22:08 -08:00
Timothy B. Terriberry
2d5b5ddead oggopus: Address Barry Leiba's IESG comments.
Thanks to Barry for proposing specific text for the changes.
2016-02-17 18:26:43 -08:00
Timothy B. Terriberry
c2c6007254 oggopus: Fix page numbers in example diagram.
Ralph Giles correctly points out that the sequence number field in
 Ogg pages starts couting at 0, so counting from 1 in the diagram
 might be confusing.
2016-02-17 18:26:40 -08:00
Timothy B. Terriberry
fcdaef55d6 oggopus: Update Wikipedia URLs.
For RFC 6716, the RFC Editor converted our Wikipedia URLs into
 stable ones that would always point at the same version of the
 page.
We're close enough to the end that we can go ahead and do that in
 advance (and also update the dates to reflect the most recent
 version).
2016-02-17 18:26:38 -08:00
Ralph Giles
b9dff4b300 oggopus: Fix typo. 2016-02-17 02:13:23 -08:00
Timothy B. Terriberry
f26c353064 oggopus: Address Stephen Farrell's IESG comments.
- Clarify that 125,829,120 is just 120 MB.
- Add a figure to Section 3 of an example logical stream.
- Add a reference for Q notation.
- Refer to the downmixing figures in the text.
- Clarify that user comments are UTF-8.
- Clarify that the -573 and 111 gain values are examples.
- Add specific advice to implementors on areas that have security
   implications.
2016-02-16 18:05:10 -08:00
Timothy B. Terriberry
81bb160d17 oggopus: Update version and date for -13
Apparently the IETF does not like having the BSD copyright in the
 .xml source (despite the CODEC WG's IPR advisor saying this was
 okay), so we need a new version.
2016-02-12 13:07:16 -08:00
Ralph Giles
5d09366104 Remove unused patch file.
It looks like this was included accidentally.

Thanks to mark4o for pointing out I'd missed this in the previous
removal.
2016-02-09 09:49:48 -08:00
Ralph Giles
288bd59f48 Remove unused patch file.
It looks like this was included accidentally.
2016-02-03 12:36:17 -08:00
Ralph Giles
ae1807f117 Remove generation date from docs.
The improves the reproducibilit of the build. The date
was nice to have, but there's a version string at the
top which should identify the release correctly.

The copyright date could actually be incorrect, since
it is based on the build date and not the last-changed
date.
2016-02-03 12:32:00 -08:00
Ralph Giles
3270d1e744 Clean up footer.html.
Use https urls.
Indent nesting levels and add missing </td>.
2016-02-03 12:28:22 -08:00
Timothy B. Terriberry
96591ca05a oggopus: Additional minor rewording.
Hopefully this is even clearer.
Thanks again to Mark Harris for the suggestion.
2016-02-03 05:42:22 -08:00
Timothy B. Terriberry
8271935581 oggopus: Update version and date for -12 2016-02-02 22:18:56 -08:00
Timothy B. Terriberry
bb054b5918 oggopus: Minor rewording.
This avoids the claim that all possible Opus implementations would
 run at rates that divide 48 kHz.
Thanks to Mark Harris for raising the issue.
2016-02-02 22:18:54 -08:00
Timothy B. Terriberry
e7913558d4 oggopus: Update the acknowledgements. 2016-02-02 22:18:51 -08:00
Timothy B. Terriberry
b3cec8789a oggopus: Add a BSD license header.
This also removes the request for an additional grant from the IETF
 Trust on the final RFC.
I believe this is sufficient to exercise our ability to allow
 downstream modifications as proposed in RFC 5377 Section 4.4.
See the discussion at
 <https://www.ietf.org/mail-archive/web/codec/current/msg03169.html>
 for details.
2016-02-02 22:18:48 -08:00