From 369f161543c05a81fef7e65d06f90776da1c351f Mon Sep 17 00:00:00 2001 From: Monty Date: Fri, 16 Jun 2000 06:50:16 +0000 Subject: [PATCH] Minor updates to docs, conversion to .png. Monty svn path=/trunk/vorbis/; revision=454 --- doc/framing.html | 51 ++++++++++++++++++++++++------------------------- doc/oggstream.html | 53 +++++++++++++++++++++++++-------------------------- doc/programming.html | 35 +++++++++++++++++----------------- doc/stream.gif | Bin 3409 -> 0 bytes doc/stream.png | Bin 0 -> 2327 bytes doc/vorbis.html | 47 ++++++++++++++++++++++----------------------- doc/vorbisword2.gif | Bin 1464 -> 0 bytes doc/vorbisword2.png | Bin 0 -> 1394 bytes doc/wait.gif | Bin 359 -> 0 bytes doc/wait.png | Bin 0 -> 455 bytes doc/white-ogg.gif | Bin 1232 -> 0 bytes doc/white-ogg.png | Bin 0 -> 1181 bytes doc/white-xifish.gif | Bin 943 -> 0 bytes doc/white-xifish.png | Bin 0 -> 965 bytes 14 files changed, 91 insertions(+), 95 deletions(-) delete mode 100644 doc/stream.gif create mode 100644 doc/stream.png delete mode 100644 doc/vorbisword2.gif create mode 100644 doc/vorbisword2.png delete mode 100644 doc/wait.gif create mode 100644 doc/wait.png delete mode 100644 doc/white-ogg.gif create mode 100644 doc/white-ogg.png delete mode 100644 doc/white-xifish.gif create mode 100644 doc/white-xifish.png diff --git a/doc/framing.html b/doc/framing.html index d5707c2..51054c7 100644 --- a/doc/framing.html +++ b/doc/framing.html @@ -1,27 +1,27 @@ -xiph.org: OggSquish Vorbis documentation +xiph.org: Ogg Vorbis documentation -

+

-OggSquish logical bitstream framing +Ogg logical bitstream framing

Last update to this document: July 15, 1999
-

OggSquish bitstreams

+

Ogg bitstreams

Vorbis encodes short-time blocks of PCM data into raw packets of bit-packed data. These raw packets may be used directly by transport mechanisms that provide their own framing and packet-seperation mechanisms (such as UDP datagrams). For stream based storage (such as files) and transport (such as TCP streams or pipes), Vorbis uses the -OggSquish bitstream format to provide framing/sync, sync recapture +Ogg bitstream format to provide framing/sync, sync recapture after error, landmarks during seeking, and enough information to properly seperate data back into packets at the original packet boundaries without relying on decoding to find packet boundaries.

-

Design constraints for OggSquish bitstreams

+

Design constraints for Ogg bitstreams

  1. True streaming; we must not need to seek to build a 100% complete bitstream. @@ -41,21 +41,21 @@ boundaries without relying on decoding to find packet boundaries.

    Logical and Physical Bitstreams

    -A logical OggSquish bitstream is a contiguous stream of +A logical Ogg bitstream is a contiguous stream of sequential pages belonging only to the logical bitstream. A -physical OggSquish bitstream is constructed from one or more -than one logical OggSquish bitstream (the simplest physical bitstream +physical Ogg bitstream is constructed from one or more +than one logical Ogg bitstream (the simplest physical bitstream is simply a single logical bitstream). We describe below the exact -formatting of an OggSquish logical bitstream. Combining logical +formatting of an Ogg logical bitstream. Combining logical bitstreams into more complex physical bitstreams is described in the -OggSquish bitstream overview. The exact +Ogg bitstream overview. The exact mapping of raw Vorbis packets into a valid Ogg Vorbis physical bitstream is described in Vorbis bitstream mapping.

    Bitstream structure

    -An OggSquish stream is structured by dividing incoming packets into +An Ogg stream is structured by dividing incoming packets into segments of up to 255 bytes and then wrapping a group of contiguous packet segments into a variable length page preceeded by a page header. Both the header size and page size are variable; the page @@ -126,7 +126,7 @@ consists of nothing more than a lacing value of zero in the header.

    Packets are not resticted to beginning and ending within a page, although individual segments are, by definition, required to do so. Packets are not restricted to a maximum size, although excessively -large packets in the data stream are discouraged; the OggSquish +large packets in the data stream are discouraged; the Ogg bitstream specification strongly recommends nominal page size of approximately 4-8kB (large packets are forseen as being useful for initialization data at the beginning of a logical bitstream).

    @@ -230,7 +230,7 @@ buffered packet segments.

    PCM absolute position

    - (This is packed in the same way the rest of OggSquish data is packed; + (This is packed in the same way the rest of Ogg data is packed; LSb of LSB first. Note that the 'position' data specifies a 'sample' number (eg, in a CD quality sample is four octets, 16 bits for left and 16 bits for right; in video it would be the frame number). The @@ -257,7 +257,7 @@ buffered packet segments.

    stream serial number

    - OggSquish allows for seperate logical bitstreams to be mixed at page + Ogg allows for seperate logical bitstreams to be mixed at page granularity in a physical bitstream. The most common case would be sequential arrangement, but it is possible to interleave pages for two seperate bitstreams to be decoded concurrently. The serial @@ -353,32 +353,31 @@ stereo encodings.

    - + -OggSquish is a Xiphophorus effort to +Ogg is a Xiphophorus effort to protect essential tenets of Internet multimedia from corporate hostage-taking; Open Source is the net's greatest tool to keep everyone honest. See About Xiphophorus for details.

    -Ogg Vorbis is the first OggSquish audio CODEC. Anyone may -freely use and distribute the OggSquish and Vorbis specification, +Ogg Vorbis is the first Ogg audio CODEC. Anyone may +freely use and distribute the Ogg and Vorbis specification, whether in a private, public or corporate capacity. However, Xiphophorus and the Ogg project (xiph.org) reserve the right to set the Ogg/Vorbis specification and certify specification compliance.

    -Xiphophorus's Vorbis software CODEC implementation (libvorbis and the -vorbis encode/decode/playback utility) are distributed under the GNU -Public License. This does not restrict third parties from -distributing independent implementations of Vorbis software under -other licenses.

    +Xiphophorus's Vorbis software CODEC implementation is distributed +under the Lessr/Library GNU Public License. This does not restrict +third parties from distributing independent implementations of Vorbis +software under other licenses.

    OggSquish, Vorbis, Xiphophorus and their logos are trademarks (tm) of Xiphophorus. These pages are -copyright (C) 1994-1999 Xiphophorus. All rights reserved.

    +copyright (C) 1994-2000 Xiphophorus. All rights reserved.

    diff --git a/doc/oggstream.html b/doc/oggstream.html index 2980c6d..46a221c 100644 --- a/doc/oggstream.html +++ b/doc/oggstream.html @@ -1,18 +1,18 @@ -xiph.org: OggSquish Vorbis documentation +xiph.org: Ogg Vorbis documentation -

    +

    -OggSquish logical and physical bitstream overview +Ogg logical and physical bitstream overview

    Last update to this document: July 18, 1999
    -

    OggSquish bitstreams

    +

    Ogg bitstreams

    -OggSquish codecs use octet vectors of raw, compressed data +Ogg codecs use octet vectors of raw, compressed data (packets). These compressed packets do not have any high-level structure or boundary information; strung together, they appear to be streams of random bytes with no landmarks.

    @@ -21,7 +21,7 @@ Raw packets may be used directly by transport mechanisms that provide their own framing and packet-seperation mechanisms (such as UDP datagrams). For stream based storage (such as files) and transport (such as TCP streams or pipes), Vorbis and other future Ogg codecs use -the OggSquish bitstream format to provide framing/sync, sync recapture +the Ogg bitstream format to provide framing/sync, sync recapture after error, landmarks during seeking, and enough information to properly seperate data back into packets at the original packet boundaries without relying on decoding to find packet boundaries.

    @@ -46,17 +46,17 @@ pages in order fromt he physical bitstream and redirecting them into the appropriate logical decoding entitiy. The simplest physical bitstream is a single, unmultiplexed logical bitstream.

    -OggSquish Logical Bitstream Framing discusses -the page format of an OggSquish bitstream, the packet coding process +Ogg Logical Bitstream Framing discusses +the page format of an Ogg bitstream, the packet coding process and logical bitstreams in detail. The remainder of this document -specifies requirements for constructing finished, physical OggSquish +specifies requirements for constructing finished, physical Ogg bitstreams.

    Mapping Restrictions

    Logical bitstreams may not be mapped/multiplexed into physical bitstreams without restriction. Here we discuss design restrictions -on OggSquish physical bitstreams in general, mostly to introduce +on Ogg physical bitstreams in general, mostly to introduce design rationale. Each 'media' format defines its own (generally more restrictive) mapping. An 'Ogg Vorbis Audio Bitstream', for example, has a In addition to the header flag marking the first and last pages of a -logical bitstream, the first page of an OggSquish bitstream obeys +logical bitstream, the first page of an Ogg bitstream obeys additional restrictions. Each individual media mapping specifies its own implementation details regarding these restrictions.

    -The first page of a logical OggSquish bitstream consists of a single, +The first page of a logical Ogg bitstream consists of a single, small 'initial header' packet that includes sufficient information to identify the exact CODEC type and media requirements of the logical bitstream. The intent of this restriction is to simplify identifying the bitstream type and content; for a given media type (or across all -OggSquish media types) we can know that we only need a small, fixed +Ogg media types) we can know that we only need a small, fixed amount of data to uniquely identify the bitstream type.

    As an example, Ogg Vorbis places the name and revision of the Vorbis @@ -112,13 +112,13 @@ Whole pages from multiple logical bitstreams are mixed together.

    The initial pages of each logical bitstream must appear first; the media mapping specifies the order of the initial pages. For example, -Ogg A/V will eventually specify an OggSquish video bitstream with +Ogg A/V will eventually specify an Ogg video bitstream with audio. The mapping may specify that the physical bitstream must begin with the initial page of a logical video bitstream, followed by the initial page of an audio stream. Unlike initial pages, terminal pages for the logical bitstreams need not all occur contiguously (although a specific media mapping may require this; it is not mandated by the -generic OggSquish stream spec). Terminal pages may be 'nil' pages, +generic Ogg stream spec). Terminal pages may be 'nil' pages, that is, pages containing no content but simply a page header with position information and the 'last page of bitstream' flag set in the page header.

    @@ -138,7 +138,7 @@ bitstream.

    Below, we present an example of a grouped and chained bitstream:

    -

    +

    In this example, we see pages from five total logical bitstreams multiplexed into a physical bitstream. Note the following @@ -161,32 +161,31 @@ where decode requires more information).

    - + -OggSquish is a Xiphophorus effort to +Ogg is a Xiphophorus effort to protect essential tenets of Internet multimedia from corporate hostage-taking; Open Source is the net's greatest tool to keep everyone honest. See About Xiphophorus for details.

    -Ogg Vorbis is the first OggSquish audio CODEC. Anyone may -freely use and distribute the OggSquish and Vorbis specification, +Ogg Vorbis is the first Ogg audio CODEC. Anyone may +freely use and distribute the Ogg and Vorbis specification, whether in a private, public or corporate capacity. However, Xiphophorus and the Ogg project (xiph.org) reserve the right to set the Ogg/Vorbis specification and certify specification compliance.

    -Xiphophorus's Vorbis software CODEC implementation (libvorbis and the -vorbis encode/decode/playback utility) are distributed under the GNU -Public License. This does not restrict third parties from -distributing independent implementations of Vorbis software under -other licenses.

    +Xiphophorus's Vorbis software CODEC implementation is distributed +under the Lesser/Library GNU Public License. This does not restrict +third parties from distributing independent implementations of Vorbis +software under other licenses.

    OggSquish, Vorbis, Xiphophorus and their logos are trademarks (tm) of Xiphophorus. These pages are -copyright (C) 1994-1999 Xiphophorus. All rights reserved.

    +copyright (C) 1994-2000 Xiphophorus. All rights reserved.

    diff --git a/doc/programming.html b/doc/programming.html index a396d3d..7f6e62f 100644 --- a/doc/programming.html +++ b/doc/programming.html @@ -1,6 +1,6 @@ -xiph.org: OggSquish Vorbis documentation +xiph.org: Ogg Vorbis documentation -

    +

    @@ -13,7 +13,7 @@ Programming with Xiphophorus libvorbis Libvorbis is Xiphophorus's portable Ogg Vorbis CODEC implemented as a programmatic library. Libvorbis provides primitives to handle framing -and manipulation of OggSquish bitstreams (used by the Vorbis for +and manipulation of Ogg bitstreams (used by the Vorbis for streaming), a full analysis (encoding) interface as well as packet decoding and synthesis for playback.

    @@ -41,7 +41,7 @@ steps:

    Framing

    -An OggSquish bitstream is logically arranged into pages, but to decode +An Ogg bitstream is logically arranged into pages, but to decode the pages, we have to find them first. The raw bitstream is first fed into an ogg_sync_state buffer using ogg_sync_buffer() and ogg_sync_wrote(). After each block we submit to the sync @@ -84,9 +84,9 @@ using ogg_stream_packetout.

    Reassembling data segments

    -

    OggSquish Bitstream Manipulation Structures

    +

    Ogg Bitstream Manipulation Structures

    -Two of the OggSquish bitstream data structures are intended to be +Two of the Ogg bitstream data structures are intended to be transparent to the developer; the fields should be used directly.

    ogg_packet

    @@ -151,7 +151,7 @@ Note that although the header and body pointers do not necessarily point into a single contiguous page vector, the page body must immediately follow the header in the bitstream.

    -

    OggSquish Bitstream Manipulation Functions

    +

    Ogg Bitstream Manipulation Functions

    int ogg_page_bos(ogg_page *og); @@ -224,7 +224,7 @@ int ogg_page_serialno(ogg_page *og); Returns the serial number of the given Ogg page. The serial number is used as a handle to distinguish various logical bitstreams in a -physical OggSquish bitstresm. Every logical bitstream within a +physical Ogg bitstresm. Every logical bitstream within a physical bitstream must use a unique (within the scope of the physical bitstream) serial number, which is stamped on all bitstream pages.

    @@ -472,32 +472,31 @@ when the number of bytes written were larger than the buffer.

    - + -OggSquish is a Xiphophorus effort to +Ogg is a Xiphophorus effort to protect essential tenets of Internet multimedia from corporate hostage-taking; Open Source is the net's greatest tool to keep everyone honest. See About Xiphophorus for details.

    -Ogg Vorbis is the first OggSquish audio CODEC. Anyone may -freely use and distribute the OggSquish and Vorbis specification, +Ogg Vorbis is the first Ogg audio CODEC. Anyone may +freely use and distribute the Ogg and Vorbis specification, whether in a private, public or corporate capacity. However, Xiphophorus and the Ogg project (xiph.org) reserve the right to set the Ogg/Vorbis specification and certify specification compliance.

    -Xiphophorus's Vorbis software CODEC implementation (libvorbis and the -vorbis encode/decode/playback utility) are distributed under the GNU -Public License. This does not restrict third parties from -distributing independent implementations of Vorbis software under -other licenses.

    +Xiphophorus's Vorbis software CODEC implementation is distributed +under the Lesser/Library GNU Public License. This does not restrict +third parties from distributing independent implementations of Vorbis +software under other licenses.

    OggSquish, Vorbis, Xiphophorus and their logos are trademarks (tm) of Xiphophorus. These pages are -copyright (C) 1994-1999 Xiphophorus. All rights reserved.

    +copyright (C) 1994-2000 Xiphophorus. All rights reserved.

    diff --git a/doc/stream.gif b/doc/stream.gif deleted file mode 100644 index 6cb7caee43fbd12654429d29042539e7104d9c1f..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 3409 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 literal 0 HcmV?d00001 diff --git a/doc/vorbis.html b/doc/vorbis.html index ce14fbe..27e3a5b 100644 --- a/doc/vorbis.html +++ b/doc/vorbis.html @@ -1,17 +1,17 @@ -xiph.org: OggSquish Vorbis documentation +xiph.org: Ogg Vorbis documentation -

    +

    -OggSquish Vorbis encoding format documentation +Ogg Vorbis encoding format documentation

    Last update to this document: July 15, 1999
    Last update to Vorbis documentation: July 21, 1999

    - + As of writing, not all the below document links are live. They will be populated as we complete the @@ -31,9 +31,9 @@ documents.
  2. The Vorbis bitpacker

    -

  3. OggSquish bitstream overview -
  4. OggSquish logical bitstream and framing spec -
  5. Vorbis packet->OggSquish bitstream +
  6. Ogg bitstream overview +
  7. Ogg logical bitstream and framing spec +
  8. Vorbis packet->Ogg bitstream mapping

  9. Programming with libvorbis

    @@ -46,8 +46,8 @@ at moderate fixed and variable bitrates (40-80 kb/s/channel). This places Vorbis in the same class as audio representations including MPEG-1 audio layer 3, MPEG-4 audio (AAC and TwinVQ), and PAC.

    -Vorbis is the first of a planned family of OggSquish multimedia coding -formats being developed as part of Xiphophorus's OggSquish multimedia +Vorbis is the first of a planned family of Ogg multimedia coding +formats being developed as part of Xiphophorus's Ogg multimedia project. See http://www.xiph.org/ for more information. @@ -141,52 +141,51 @@ storage, Vorbis packets are encoded into an Ogg bitstream.

    - + -OggSquish is a Xiphophorus effort to +Ogg is a Xiphophorus effort to protect essential tenets of Internet multimedia from corporate hostage-taking; Open Source is the net's greatest tool to keep everyone honest. See About Xiphophorus for details.

    -Ogg Vorbis is the first OggSquish audio CODEC. Anyone may -freely use and distribute the OggSquish and Vorbis specification, +Ogg Vorbis is the first Ogg audio CODEC. Anyone may +freely use and distribute the Ogg and Vorbis specification, whether in a private, public or corporate capacity. However, Xiphophorus and the Ogg project (xiph.org) reserve the right to set the Ogg/Vorbis specification and certify specification compliance.

    -Xiphophorus's Vorbis software CODEC implementation (libvorbis and the -vorbis encode/decode/playback utility) are distributed under the GNU -Public License. This does not restrict third parties from -distributing independent implementations of Vorbis software under -other licenses.

    +Xiphophorus's Vorbis software CODEC implementation is distributed +under the Lesser/Library GNU Public License. This does not restrict +third parties from distributing independent implementations of Vorbis +software under other licenses.

    OggSquish, Vorbis, Xiphophorus and their logos are trademarks (tm) of Xiphophorus. These pages are -copyright (C) 1994-1999 Xiphophorus. All rights reserved.

    +copyright (C) 1994-2000 Xiphophorus. All rights reserved.

    diff --git a/doc/vorbisword2.gif b/doc/vorbisword2.gif deleted file mode 100644 index 204a7de2b547661b44ce13ebaaa0df5acda61c41..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1464 zcmb8p30sl}007_*{QLwYCBiaB3Lba_Wv$H27NJ;{6j`aMTexA~jmjCCD?lwlQPM;W zBOuE&G;IyZ6w|Em&gPYs8J16(TI;k8xBY~@zu?^#;P16DvIk%S82|u>gJ<*edU|^` z*J^@;_sz^qS5#K^jCOT&w0nE|q^73W*%5v`#F;ToPfQqfy6X%76Uk)7jO0WSkH;p( z5Vr*|Spew^2txrFfCBvMzXf1!B0A-AVihq}nuOQQTuN_J;!~bxHf?r6ujFp0;PdX4 z9lf96eX*}1X~)&D+Tohy&Nrzo<8{2iRr21c>#5y`Z$6#VrtPYIH2b;fWbf?P1-?L- zo{@R_OqNKTog>N3lb+2lI9Hf&bru1kU`f_!r3zLowgk!na4iBvm4(4oN>u#?R)rRT zTpG)(Xjagb$~9IM$nc8|PLK-4f{+!K5LDYGFGoTMU$A)%qzyBmQRdFDo;_`rl!+O} z({_)J(F2J3$K>Bwu!^riX$=g{lhw905m9?KSY8kvQfa8yEXGSvd$H-ZNlSL(#JNgD zvnx>_c`Ki6dU3~Bpqw}>NwgJ?{-WknpyhjU(%5bWER3`>Ym-f11{`462UmAE3|Gh1 zvc;k2-)E$kVuaK??#35pxGhn?Qb}yS0D$ZW{JI7iA8TQNY>Di|&^+hU2aK6rubLuI zJ2BGaxMjj*M^A4radw#K4tToX=^5Wc1MW}v(tf!??o&E~X|l`wrG601+n44sx|~|# z!0>?h^oZ%o@}-!+LPDn!%za^E57z{kpjG=(o{jKsZ!z%ferA{RwI+}(UfA=b+UToxtMb{CB-W)CJW0b{EmL5U+T zr1N~DhBnOa$gv&Y>>B8Pu_#FR+1A|=K2K7lV~-F+tiLOWDX9;9QQ;~zsHczt&F^*} z;swQ)i_;X!Xk_F3GDom=@(Qhz#=5JoapDdk^He#7e=vtke9kVK+_n+U0I43zI)$N} zbD`9PIxJA{T8~}@5=PqcROr;9Ky<#yD0I$pp@*ydVx6y0AA81Wn`U-sG^Nlcx^8Kh zOn%d6Dtv(X)r&ixS+>Se{~Zl<)K}6A7iAQe{H* z&)5?Mp&opc;E3))0R4>IAtGF-hFCTXdi=)&Y?S{uqbb%1_WA~AoCpsO@tux8O#Kp1 za^H9){Cx|U&05(RNIn$H+i&+)Is7?ydF}3UH)7(V))KXFgk1AIxABOaR(x6Q-uIrx zwA>mg9Fwr$GD|^r<0RCjvz;tDXyOl<2=g^`5!p)_V$j{_MvtuOaLv8kbSrV(+Y9dY zMX>3$V@iBuFMK}Xo}$#SvQUL~iL^w|hrFx)eOhtU*DZQJP5DXsJjQOz$cb4iRpZ}1 ztZL~G&;6gJ5ZtfX$U7C{_+w*b*vSpMf}QQ6Ss%6-v+#q-r>x`On6iU=>K6MLlJ1`b zG4f#9ZN0vqvjnkk6uGWdf0;!F7E_4WrYkK^qVlNP*DH9GesH#19T(CNb_0J~Hjv|z z861x>ZJ#ppWPs*j4d&Nz`j(?UZ2mfeaF82RFfg6IzCn*~k=eA912qSS>PRtDFVSYj zWk3*zFF!xkj+vqCSof!^{em_NoSn0x{)E$`0=}iM)xDK)b1o5HZolh2`Zkx>b;<4% KA_D^eoBjbgW~oU4 diff --git a/doc/vorbisword2.png b/doc/vorbisword2.png new file mode 100644 index 0000000000000000000000000000000000000000..12e3d316219ec45f71dd4163cfb9ae1df2d0d585 GIT binary patch literal 1394 zcmV-&1&#WNP)T`tIy`!Mc^)1dVrFFS z{_Nu7kE00202MObuGZ)S9NVRB^vSXLlbWpZSuRRjpsom(@dadVzFI9?`n0GjS%) z#F;n~XW~qpi8FB~&cvBG6KCT56&!l{?;AkzD>!cBCZ368m!qi@NQHC>M=}dC(Bm(O z4cdG4<%0zFY#1F6uUBxqY0zIlx_G3)di=fxNGl3}$9%vHJgUxcz%RxH9H!BHDZazw zy~ef^vSSabU$BnxK9<(3g;NoC3FXUc(n;DfTAx zIAE<}%CI0N5;KkEbr7R2xukNS1O_A=zCafYqaiq3fOX;HLu4FNrBRiHz+@M!oY9Aw z1rfBEjmNL>_DVzYyVhuD7{?K3IJj$84tcwZ);lMC&jPp5bi4)6lfyKskiiK6Q2w+1o^#L#+?RdW{IG%18Y*H8_x2;VO

    |kqM ztK^%zI3*X?T#GUf;fOBL#MtR^;0#B0g%0tj=?&7D>Ml+hUvw}iIGS-B*9vvO6H%pI z3YfslB?G@4`q<&c^(M6I{$n^h*tprCQJfIzrp-H$;zUNi=s+nc>9&+eQ(Jw^iyy=} zemx{oOQTgmyJ^dG6ugiXc|%!$i{UHOH`^3*C^B8Z!5f@C77aLx;~E?)wut*}Z-!ne zn!2c&j&0^@_nW-*fU*fw{Me4-P!k4_W-5Kkck*b}c%N>BIr`|lJhrA z#7*8&RT5rCaRLEU+c)g@bjcBU@9pkxvi%}1x8l&wRh_zEkaBFR0<=}_H@>+R?dE#h zbL61l1~Pha-RbD;WTy7T+A_soY!^Hq}ovzdBo6{%))=t}!zw)ycWHEJAV*0}P<~|{l>h($07*qoM6N<$g6eyV AdH?_b literal 0 HcmV?d00001 diff --git a/doc/wait.gif b/doc/wait.gif deleted file mode 100644 index a0da80f7f3a16e55f914904dc55e8375cd59fe0b..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 359 zcmZ?wbhEHbRANwKc+9}?L&SlBfuW&=;m03_4Owc6x=<10~i#4vM_Qn@H6ND%>kOJ#K6Gv@54#Y>>UeVolO@wtdJ7Bla(b< zL^E?=hSai_-$jOk=ic^S-Yt9fS@n~qgNcDfE^5{LmVJ)gEz5gjjhJ=7v{@|7-P5!r zN@8DdN?1uacr-p#2nk-&?Cj`pUzUZn)+V$(r;dq*iG!V;qoc+n&aJIoiIanaQ(?kH zTX`eDdPOGAS&N(el^K~?gDVT_=gje2E52skqV=0rIBuPv;jy!;Z+Wn$^5g}Mi)wn# z?8$67c_6pHvZQ~{B%di&XJ@Q$3~{-0Dz9e7jQZlzOHv6*OFwa@W!%m-ivGoR@yU-X v>)zEaeB!cz)8_HC3WXc~iHfPbvUXe2-II2Tis~9QHv2s0!lvI6;X0X`wF zK)RuY;m03_4O&nam-{(fU+gmllrfs~d^7*-E zymZa%aK~5w57Z0Kx)3@-Qk-Qp^x+Ti`0eZ(vYHr*#KW4J5N~x~b6Td56 zM|j-agRZzt-W2IB(zhvh%K1G8{O8`>Z9RGOZg@scc;e-wm-pS)o8>pRICl9%6D48p z^38Zp0r2494ciq-(vUdB&{RHL;0>$({p6=B}Bwf zBw8+vlJ&(+h5K-w(BopO*5z=OYU?6-aOsP?>yNnC@2}_ey!-?GJUpYFfedFVIy-?H2mu7U9>;$+L#1=hFO^J}$5|6vf** zfwRq`@Z@1>=$?0b7SrUrI@aH~rR-R^qA3XDzO_3f+BBsf+^E|C{%5RL$inE@I8H{w z;dqXJpil&?mmv%Q9N_q+{N)lLE8gV?0vs(*4PHziO5S{aR7JCCcW!<3#_ZAz;b!DU zk7QP5(@U4t&*oH@$hnejvMpZh59cKQ{1rKyk;h0qwj&wJLy&^P?1Lo;`BY#iRE&@a z5F24s3qskom24&jkFUDmQ_Mj41QnBcxt&8+^T{_zbqQ&jD=G>^xIhH=l!6{sRyB>r zVhxY@kXow|KO_S^wVArq{^svLY+a(=+)>&WMJ4r?{QaNfgt)uL z?^p9zxRmQC%OJU0g3F^wL&i0;b=`@S2au~+(V}a4IM-v`r``Z^nfu~qMngyg9lBdw zm1k0XXQKxuzcfQRor5PlQIs~>mFc>lOgCv;-P;~S{k-o*y_lBP-C}i{Lzf@jInw-c zzW5Cl$%U-h*(7E1?+LvZuZJ9*4Td)v@09K`x~i9jFYcV^JK}`qVDf;^ltb6vq@AOn zw-PT-v87jzb-W;*|5}+bk2R~I8B?APTTx|>@40iBX3ys)3Ks`-o80W(U)$GV7ySDd z=e4pp(ftOmLL2JIyOUYSr-~e$1+A*<Y>`1FQ&ynz4iB+a1vD`p4mv%|wcn=Sw z9V9{dFfKjBK~nqqm^YM3;Rb9B<{KA?$Yk4AdA#h=)w?j(DofNz4fo@q5jWlZz6*J! zollfuovkqnN(7)E)HYx5s3h5iDNWfGL z1xFnLh|ahEIL-_Au_geHAe^z-%hZR$vr9bh`_4fnhW2BeZ)OEXwz~CDtPip5AwA#R oa@-}UeV`9rN;Kti98ZfQ-AX?faf5#Bw|Mqj#LM>#9spbZ1q)o*l>h($ diff --git a/doc/white-ogg.png b/doc/white-ogg.png new file mode 100644 index 0000000000000000000000000000000000000000..45dc0acd3c88dd307c632243fd02761a73a07eb2 GIT binary patch literal 1181 zcmV;O1Y-M%P)1N8;! zrflx$;hb+q_WSf6w-1uV>IGcGYOVIUw z0x@3&#`#!i#eFdz_rg)dJ1eC*T1t$pZI!dmnWNP=h!{Y$R>zRIGsW+ewymYXe$pO1q0KzW)z%J((NO4?EvYMjFWs90g=g0jMX6n>OHhI;u*~EEo2}j zz{z|E$w8%OE+H+bNWYC-*aTh_B-*6ftTV7ide&>@-1Lg9I&F|9LOIhnzHRaFeK>sVOj9+rY>fJBku9L?Zm*9mcN+j~=y3WnZY zp>QqhyU7}3L@d8Clv^+ zm;-}WUbk3T4f)Sar$L7|A_cr)b+K*MyAtk4B}j5k$x1x8@UxTkP2FyEuqtwY!N9iP`n-x^DS8ESa)1E05wk=UODP8Jcixki z42K@Otg`wE;fo5H8Ge`U^Jy7^!V?_21)9D+gv2f;_eVYx{7YG!G>5({s4ErOxBTGu zi$aK=lK$`~j~VIdSbX)BWWc=NC)z*mkm0vG2{{%3000McNliru&;}3&A2FG_W~KlD v02XvbSad^gZEa<4bO23ZWMv?CX>@2HM@dakeq|k%00000NkvXXu0mjf*J1a#wF(p-@JhLQ2!QIn0fI;ym3nLeU0)q|%5P*Ei!1m8! zLV<^lRR4)3MV)&rW?aa)e6Yf6eSrGbuD5=&(d){2E;UJJ82-$%TYfb=?e^bo$EFrn z{hfE__4gXrx^#io{DPV~S$PgFhJG#dY>9GgOOo>0;5Z&(t)6Z?V8Mj5)Kd6&Sqv6wp~5BQ%k&usX>{~szf0`|BzmuXx_Us;*N=I)q)2MOWi^w43*EyF>>4taMWY9 z7I!n4V7z=Udq2yZC1PDC+I;6RF-V*&X!PHj#j8_cQ0i#RwC2~wEr%H!EIHkNGR?E8 zWW2pf^4UJ4tT#-|3@mc)%VHL6dAXI_=!0&9aZ~G}g>sU+7?PNc;{SZ{+GpKi1kkjZqER*NQw_8&YC z1TvUB7IQMWD6#jdi!2GgCv?`*yie=#kyNGNR*@nxmBj@Lu9MG2b~-37%K5Z_VUbFB z>Qph;gHIJRO_ZiZrqA2?L?U}rr`w#0Nypvi<~-9(SJ--UX50Kzj9M)7n}1oVFX$-i ze7>knX_oquHnyr0i>E3Drq7v@R`o)W@mm0FX}&D^yrcAc9b3xhQP DM#HTk diff --git a/doc/white-xifish.png b/doc/white-xifish.png new file mode 100644 index 0000000000000000000000000000000000000000..ab25cc8f94358cddab1990722c655c92ecfbd930 GIT binary patch literal 965 zcmV;$13LVPP)E#n{#gze7qGDeOKzJ3 zad48c$9|9$Gfs2(`2_>~`F^5o1hB33_VrEvuf){gLYiD}aU(u%G^n`7i<6dbi<)A- zWKUK%|NsAe>EeF?00202MObuGZ)S9NVRB^vSXLlbWpZcX@O}K zhV4d{x&N!&q@0z`Xdd+k_>$zyp}_as2B{l;^DfdiRr4OwH%*mdAVn~eU?4>Za?U`C zh{!1eDPls-7)TK_a>780SdeE1QbbcZ=S~?oCx#IX02t+-88{?@u;qcF>xjDEXz#raXf{s=23F!`nyv@vI<#I)7n=yoAP%g|4(TO{J4aP@oe?C+ z7ZyL6k{T&x#uX7CSfHfRHOA|Uzj&*C5o0U4I&)$zEJ!m9iZj5m7vjQ+cFq}+#t#ACNKY5;C!SMY9y!o)Dp@yC z!A#Gd#$Oq(ghS~~{^0#__L-4&hv=N*aM)BVUbN1|2p z2>rB^=?tNtH$Oci^xOGDj|lyKiqR3FSI$b>BlOydOdCS4p8K>Q^!nSy+&lEnJB;*b zf=Iq8@eZMP-^VCLeE$ba2HedGZ1vgz000McNliru&;}3&AQoh9`SAb%02XvbSad^g nZEa<4bO23ZWMv?CX>@2HM@dakeq|k%00000NkvXXu0mjf0&k%@ literal 0 HcmV?d00001 -- 2.7.4