[xiph-commits] r12860 - experimental/giles/rogg

[giles at svn.xiph.org]

Author: giles
Date: 2007-04-14 00:48:34 -0700 (Sat, 14 Apr 2007)
New Revision: 12860

Added:
   experimental/giles/rogg/README
Modified:
   experimental/giles/rogg/Makefile
Log:
Add a README.


Modified: experimental/giles/rogg/Makefile
===================================================================
--- experimental/giles/rogg/Makefile	2007-04-14 07:30:36 UTC (rev 12859)
+++ experimental/giles/rogg/Makefile	2007-04-14 07:48:34 UTC (rev 12860)
@@ -11,6 +11,8 @@
 
 all : librogg.a $(rogg_UTILS)
 
+EXTRA_DIST = Makefile README
+
 librogg.a : rogg.o
 	$(AR) cr $@ $^
 	ranlib $@
@@ -51,6 +53,7 @@
 	if test -d $(distdir); then rm -rf $(distdir); fi
 	-rm -rf $(PACKAGE)-$(VERSION)
 	mkdir $(distdir)
-	cp *.c *.h Makefile $(distdir)/
+	cp *.c *.h $(distdir)/
+	cp $(EXTRA_DIST) $(distdir)/
 	tar czf $(distdir).tar.gz $(distdir)
 	rm -rf $(distdir)

Added: experimental/giles/rogg/README
===================================================================
--- experimental/giles/rogg/README	                        (rev 0)
+++ experimental/giles/rogg/README	2007-04-14 07:48:34 UTC (rev 12860)
@@ -0,0 +1,19 @@
+== rogg - Raw Ogg file library and utilities ==
+
+rogg is a small library I wrote for manipulating Ogg streams in memory.
+
+This makes it convenient to write certain quick scripts for checking
+and fixing simple bitstream errors in mmap()'d files. 
+
+Examples:
+
+  rogg_aspect will dump and optionally set the pixel aspect ratio
+  stored in an Ogg Theora stream.
+
+  rogg_eosfix will set the end_of_stream flag on the last page
+  of a stream. This is often unset in downloads truncated from
+  an icecast stream.
+
+  rogg_pagedump dumps some basic header information for each page
+  in a stream.
+