Commit graph

234 commits

Author SHA1 Message Date
Timothy B. Terriberry
396c4e5e1e Rearrange Ogg Opus references.
Sort alphabetically, and move vorbis-trim to "Informative".
Also fix a misuse of "streams" instead of "channels" in the packet
 size limits exposition.
2012-07-16 13:43:10 -07:00
Timothy B. Terriberry
b3744613b7 Updates from mailing list and other small fixes.
* Bump the document date.
* Mandate that the ID header must complete on the first page (to
   remove any ambiguities about this requirement in RFC 3533).
* Remove reundant wording that rillian forgot to remove in 360a4117.
* Split the "Granule Position" section into subsections.
* Move the first paragraph of the "Other Implementation Notes"
   section into the "Granule Position" section, add general seeking
   implementation guidance, and be specific about the interaction
   between pre-roll and pre-skip.
* Retitle the remaining contents of the "Other Implementation Notes"
   section to "Packet Size Limits"
* Specify that all the header fields are REQUIRED (and add a
   description of the Channel Mapping Table as a whole, so we can
   say when it is REQUIRED).
* Specify that implementations MUST NOT reject headers with extra
   data if they have an unknown minor version number.
* Add a reference to RFC 3629 (UTF-8).
* Minor formatting adjustments to vorbis-trim and vorbis-mapping
   cites.
* Eliminate semicolons and terrible "Else, if" constructs.
2012-07-16 13:31:11 -07:00
Ralph Giles
3527f9d4c4 Oops, the tag is ENCODER not ENCODED-BY. 2012-07-16 14:14:45 -04:00
Ralph Giles
360a41172a Various small improvements.
Remove a redundant phrase from the previous commit.
Thanks to Tim for pointing this out.

Clarify what 'skipped' means.

Give a reference for the vorbis granulepos-trimming.

Commas and semicolons in the resampling decision list.

Capital SHOULD on treating unknown channel mapping families
as discrete.

Clarify why goes in the vendor string. Maybe needs an example?
'gstoggmux 1.0.12; libopus 1.2.3'

Remove a redundant word. 'could' already covers 'potential' and
the line is stronger without it.
2012-07-16 13:54:27 -04:00
Ralph Giles
0cf8628528 Define TOC sequence briefly.
Hopefully it's clear from this that the demuxer can parse the
TOC sequence to verify the equal-duration constraint.
2012-07-16 12:34:46 -04:00
Ralph Giles
19658bd2f7 Clarify how multistream Opus packets are packed into Ogg packets. 2012-07-16 12:34:04 -04:00
Ralph Giles
1a7c4ceb85 Bump the version number on the Ogg Opus draft. 2012-07-16 11:42:47 -04:00
Ralph Giles
1935025ef5 Add myself as an author. 2012-07-16 11:41:27 -04:00
Ralph Giles
e515687ed7 Ogg Opus wording - avoid repeated 'this' in the abstract. 2012-07-16 11:32:15 -04:00
Jean-Marc Valin
bdf87401da RTP draft fix
This is what got submitted as version 01
2012-07-11 15:54:55 -04:00
Timothy B. Terriberry
a7df963437 Typo fix.
Thanks to Ron Lee for pointing it out.
2012-07-05 14:26:02 -07:00
Timothy B. Terriberry
a2b2e0b88a Initial revision of Ogg Opus draft.
Adapted from http://wiki.xiph.org/OggOpus
2012-07-05 08:34:15 -07:00
Gregory Maxwell
0c9060781c Dos2unix, trailing whitespace on draft-spittka-payload-rtp-opus.xml. 2012-06-19 09:11:40 -04:00
Jean-Marc Valin
25aec47575 Adds a copy of the RTP payload XML 2012-06-14 10:56:12 -04:00
Ron
9a89d56d46 Include the doc dir in DIST_SUBDIRS instead of EXTRA_DIST
And explicitly specify what we want included in EXTRA_DIST of doc/Makefile.am,
otherwise make dist picks up whatever random junk you might have laying around
in that dir at the time you run it.

Tweak the top level delegation targets, because this means distclean will be
run in the doc dir by default now without our help.
2012-06-11 15:33:57 -04:00
Jean-Marc Valin
99aaff5233 opus_compare.m was outdated 2012-06-11 14:37:44 -04:00
Ron
783ecbff0c Don't bark scary warnings at compile time about no doxygen
We already report whether or not the docs will be built in the summary box
at the end of the configure run.
2012-06-11 14:24:18 -04:00
Gregory Maxwell
91b56f6542 Fixup paths in doc/ 2012-06-11 13:33:35 -04:00
Gregory Maxwell
595b334f26 Pretty up the HTML doxygen output. 2012-06-11 01:42:32 -04:00
Gregory Maxwell
1f65ce89b0 Correct documentation in opus_custom.h. 2012-06-10 21:15:02 -04:00
Gregory Maxwell
daa416700c Fix doxygen docs wrt OPUS_WARN_UNUSED_RESULT and OPUS_ARG_NONNULL.
Also get the subname rigtht.
2012-06-02 23:17:29 -04:00
Ron
b2b0391e56 Actually install the documentation with make install
Instead of just its build stamp :)
2012-05-21 23:14:50 +09:30
Jean-Marc Valin
8858cac6bc Sync with draft -14 2012-05-17 19:45:10 -04:00
Jean-Marc Valin
7143b2d0ff Merge branch 'tmp_draft'
Conflicts:
	README
2012-05-16 00:36:19 -04:00
Gregory Maxwell
87003d5b59 Remove trailing whitespace from draft-ietf-codec-opus.xml. 2012-05-15 19:52:44 -04:00
Kat Walsh
1ed596f486 commas 2012-05-15 18:44:08 -04:00
Jean-Marc Valin
3c321e3107 Table title capitalization 2012-05-15 18:05:49 -04:00
Kat Walsh
56de780e2a draft copyediting 2012-05-15 18:01:38 -04:00
Jean-Marc Valin
14d14998c2 misc draft fixes 2012-05-15 16:51:22 -04:00
Timothy B. Terriberry
53e6782ea5 More minor gen-art part 2 edits.
Includes the addition of a band-layout table.
2012-05-15 16:47:16 -04:00
Jean-Marc Valin
e249b0b205 Apparently the tar compatibility option has compatibility problems! 2012-05-15 16:31:50 -04:00
Gregory Maxwell
981a2804ea Alt. compile instructions in the draft should match the Makefile. 2012-05-15 16:18:55 -04:00
Jean-Marc Valin
4e66c2c012 Gen-art (bit allocation work).
Also, make the archive work with older versions of tar
2012-05-15 16:15:12 -04:00
Jean-Marc Valin
2599dc5931 Gen-art part2 2012-05-15 14:46:21 -04:00
Jean-Marc Valin
2b0806d474 Gen-art update 2012-05-15 12:22:12 -04:00
Timothy B. Terriberry
df39d65c83 Gen-art part2 2012-05-15 10:51:59 -04:00
Jean-Marc Valin
2cb95f5285 draft: reference for LSP stability 2012-05-15 10:49:41 -04:00
Jean-Marc Valin
1a113a1489 Gen-art sync 2012-05-14 18:30:48 -04:00
Jean-Marc Valin
f2ed58bd8c More on Gen-art part2 2012-05-14 17:56:26 -04:00
Jean-Marc Valin
e6c2aad1b6 Some Gen-art part2 changes 2012-05-14 16:28:33 -04:00
Timothy B. Terriberry
3fe9cca1fb Gen-art changes 2012-05-13 22:16:44 -04:00
Jean-Marc Valin
e134dc4785 Minor genart update 2012-05-12 00:29:13 -04:00
Jean-Marc Valin
250c026890 More Gen-art changes 2012-05-11 16:31:54 -04:00
Jean-Marc Valin
22757c390a More Gen-art changes 2012-05-11 16:00:45 -04:00
Jean-Marc Valin
e8c437c432 First set of changes for Gen-art review 2012-05-11 13:41:41 -04:00
Jean-Marc Valin
329112075e Addressing the remaining comments from Robert Sparks 2012-05-10 16:01:45 -04:00
Jean-Marc Valin
ab5a049705 Merge commit '390c89225d' 2012-04-24 13:39:22 -04:00
Jean-Marc Valin
390c89225d Adds some references, bumps version number 2012-04-24 00:57:04 -04:00
Timothy B. Terriberry
e4689464eb Addressing AD issues
Including a description of the PVQ encoder and decoder
2012-04-24 00:37:04 -04:00
Timothy B. Terriberry
fa2750bee2 More changes addressing Robert Sparks' review 2012-04-20 15:47:37 -04:00