[vorbis-dev] encoding documentation

[Erik Kruus]

Kenneth Arnold wrote:
> 
> On Thu, Sep 13, 2001 at 06:28:41AM -0700, Nilton Ramos wrote:
> > Hello,
> >   I'm an Electrical Engineering student. I'm doing a
> > research job about audio compressing.
> >   I'm looking for documentation about Vorbis analysis,
> > synthesis, coding and decoding. I took a look at Xiph
> > page documentation section, but it's not complete yet.
> >   There's this site about encoding, but i only found
> > information about Vorbis windowing:
> >
> > http://www.mathdogs.com/vorbis-illuminated/x62.html
> 
> http://vorbis.on2.com/ has some very good information, and is a great
> help if you're browsing the source code and wondering how it works,
> because Erik already did that for you. (Erik, are you maintaining this
> document? Perhaps we could add it (in sections, of course) to the CVS,
> not as official documentation, but just so others can easily
> contribute?) Of course the best documentation is the source code,
> which you can find at vorbis.com (for released code) or xiph.org/ogg/
> for CVS with latest changes.

vorbis.on2.com hasn't been maintained in quite a while.  I did put up
some rc-whatever branch a month or so ago, too curious to wait before
browsing the channel-coupling diffs.

Mike and I have both discussed the development of, say, a vorbis book,
but now Mike has a real job, and I'm borrowing from my parents to stay
afloat, so vorbis doc/dev is yet again pushed back for us... (sigh)

This said, there should be a mechanism for folks to rewrite sections
and reorganize, or at least send in corrections.  I guess you can just
send them to me and I can update the encoder docs for now. 

Perhaps the encoder notes source could be moved to some obscure cvs tree
at xiph.org?  This way folks could download the complete source (figures,
.lyx source, ...) and get the encoder doc back into shape for everybody. 
I'd be willing to maintain such a tree and fold in folks' diffs and upload 
the diffs to vorbis.on2.com .

Hmmm. Problem with having a -completely- working local copy is that that
hyperlinking to the source assumes you've got my modified lxr
installed, which can be a source of tedium.  The other tedium is that
at some point the 'glimpse' license changed, and it might be difficult
to find a sufficiently old version that'll install nicely nowadays (??)

Guess having the server is still somewhat useful.

Erik.

> 
> If you need help with one particular area, there are people on this
> list or the #vorbis channel on irc.openprojects.net that are familiar
> with the code, or for more general questions, the vorbis mailing lists
> (vorbis-dev probably more appropriate for questions about codec
> internals) are read by many helpful people. I am also researching the
> format and trying to get a sense of anything I could do to make it
> better.
> 
> --
> Kenneth Arnold <ken at arnoldnet.net> / kcarnold / Linux user #180115
> http://arnoldnet.net/~kcarnold/
> 
>   ------------------------------------------------------------------------------------------------------------------------------------
>    Part 1.2Type: application/pgp-signature

--- >8 ----
List archives:  http://www.xiph.org/archives/
Ogg project homepage: http://www.xiph.org/ogg/
To unsubscribe from this list, send a message to 'vorbis-dev-request at xiph.org'
containing only the word 'unsubscribe' in the body.  No subject is needed.
Unsubscribe messages sent to the list will be ignored/filtered.