[xiph-cvs] r6791 - in websites-ngen: . news xiph.org/contribute xiph.org/speex xiph.org/speex/roadmap xiph.org/vorbis

comatoast at xiph.org comatoast at xiph.org
Sat May 29 23:37:33 PDT 2004 


Author: comatoast
Date: 2004-05-30 02:37:32 -0400 (Sun, 30 May 2004)
New Revision: 6791

Modified:
   websites-ngen/news/options.ini
   websites-ngen/style.txt
   websites-ngen/xiph.org/contribute/index.markdown
   websites-ngen/xiph.org/speex/index.markdown
   websites-ngen/xiph.org/speex/roadmap/index.markdown
   websites-ngen/xiph.org/vorbis/beforecontent.inherit
   websites-ngen/xiph.org/vorbis/index.markdown
Log:
* fixed all the blasted \r thingies in news\options.ini.
* Now, use unlimited-length lines. Watch diff now work only on the paragraph level, not the line level.
* Some files changed to reflect this new style.
* /speex/roadmap/ slightly changed, admonishing would-be helpers to donate money and/or implement things on jm's to-do list.

<p>Modified: websites-ngen/news/options.ini
===================================================================
--- websites-ngen/news/options.ini	2004-05-30 05:20:57 UTC (rev 6790)
+++ websites-ngen/news/options.ini	2004-05-30 06:37:32 UTC (rev 6791)
@@ -1,30 +1,30 @@
-;[Template]
-
-;; One or more of the following in a space-separated list:
-;;	general
-;;	vorbis
-;;	flac
-;;	theora
-;;	icecast
-
-; required:
-;	Title
-;	Tag Suffix
-;	
-;	
-
-[on2004-04-21at0000]
-Title = Speex 1.1.5 Released
-Tag Suffix = Speex115
-Sections = speex
-Issued = 2004-05-21T04:09:33Z
-; Modified = (optional)
-Summary = The 1.1.x branch of Speex now has a 1.0.x-compatible API and ABI.
-
-[on2004-04-19at0149]
-Title = Vorbis-Tools Released (fake post)
-Tag Suffix = VorbisToolsReleased
+;[Template]
+
+;; One or more of the following in a space-separated list:
+;;	general
+;;	vorbis
+;;	flac
+;;	theora
+;;	icecast
+
+; required:
+;	Title
+;	Tag Suffix
+;	
+;	
+
+[on2004-04-21at0000]
+Title = Speex 1.1.5 Released
+Tag Suffix = Speex115
+Sections = speex
+Issued = 2004-05-21T04:09:33Z
+; Modified = (optional)
+Summary = The 1.1.x branch of Speex now has a 1.0.x-compatible API and ABI.
+
+[on2004-04-19at0149]
+Title = Vorbis-Tools Released (fake post)
+Tag Suffix = VorbisToolsReleased
 Sections = vorbis flac
-Summary = A new version of vorbis-tools was released; oggenc now has a FLAC input.
-
-
+Summary = A new version of vorbis-tools was released; oggenc now has a FLAC input.
+
+

Modified: websites-ngen/style.txt
===================================================================
--- websites-ngen/style.txt	2004-05-30 05:20:57 UTC (rev 6790)
+++ websites-ngen/style.txt	2004-05-30 06:37:32 UTC (rev 6791)
@@ -7,20 +7,22 @@
 
 *	Use four-column tabs for indentation.
 
-*	Keep lines to 100 columns or fewer.
+*	Don’t hard-wrap paragraphs that have no leading whitespace, but for all other things
+	(bulleted and numbered lists) hard-wrap at 100 columns or fewer to keep things nice-looking.
 
 *	Use UTF-8. In particular, use proper apostrophes, quotation marks, (U+2018–U+201E) and
         en and em dashes.
 
-*	Prefer <x y='z'> to <x y="z">. <x y=z> is an absolute no-no.
+*	Prefer <x y='z'> to <x y="z">. Do not use <x y=z>.
 
 *	use camelCase for id and class attribute values.
+	
         Remember that id attributes create things that can be linked to, so avoid trying to break
         them, especially when they’re linked to from other parts of the same page or website.
 
-*	Try to stay as XHTML-compliant as possible; it’s simply good style. This doesn’t mean that
-	you should include a closing slash in your img tags, but it does mean that you should
-	close your p, ul, and li tags.
+*	Explicitly close all opening tags, including those of table, tr, td, dt, and dl. Close them
+	with </table>, &c., not with </>, even though it would be _really_ nice. I may yet move
+	all this stuff to XHTML one day, and I don’t want gratuitous incompatibilities.
 
 *	Use the ===== style of heading for h1 elements; if you use the single # at the beginning of the
         of the document, wrapup and Markdown won’t be able to cope with the UTF-8 BOM that some
@@ -29,13 +31,14 @@
 *	Prefer ## to -------- for second-level headings, unlike in this file and in todo.txt.
 
 *	Directories generally not shown to users should start with a capital letter.
-	Prime examples of this are the */CSS/ directories and /Error/. However, their subdirectories
-	should start with lowercase letters—like /CSS/sidebars/.
+	Prime examples of this are /CSS/, /Error/, and /JS/. However, their subdirectories
+	should start with lowercase letters, like /CSS/sidebars/.
 
 *	Don’t have multiple files or directories that differ only by case; this will cause problems
-	on systems that are case-insensitive.
+	on case-insensitive file systems like NTFS and HFS+.
 
 *	Have two blank lines before headings and one blank line after, as in this file.
+	Except, of course, for the first-level heading at the beginning of the file.
 
 *	Use all-lowercase Markdown URL identifiers. Markdown URL identifiers are compared
         case-insensitively, which means that `[foo][]` and `[Foo][]` resolve to the same identifier
@@ -62,6 +65,7 @@
 ### English-Specific Considerations
 
 *	For em dashes, leave no space between the dash and the words—like this.
+
 *	For the love of all that’s holy, leave no space between a question mark and its
         preceding sentence. Same for exclamation points, periods, commas, and colons.
 

Modified: websites-ngen/xiph.org/contribute/index.markdown
===================================================================
--- websites-ngen/xiph.org/contribute/index.markdown	2004-05-30 05:20:57 UTC (rev 6790)
+++ websites-ngen/xiph.org/contribute/index.markdown	2004-05-30 06:37:32 UTC (rev 6791)
@@ -15,8 +15,7 @@
 
 -->
 
-If you want to help Xiph.Org ensure that the foundations of Internet multimedia remain free,
-there are three main ways to help:
+If you want to help Xiph.Org ensure that the foundations of Internet multimedia remain free, there are three main ways to help:
 
 * Improve our codecs, libraries, or tools.
 * Improve others’ tools and libraries that use our codecs and tools.
@@ -29,13 +28,7 @@
   available to users of the .NET Framework.
 * Help improve our documentation.
 
-However, it’s not enough to have multimedia codecs; their success is dependent on the quality
-and availability of the tools that use them. As such, if you want to help further our mission,
-you may want to consider improving a music or video player rather than working on our libraries
-and tools directly. For example, you may want to work on the UI or plugins of a CD ripper so
-people who want to reencode their music collection in Ogg Vorbis or FLAC can do so with a
-minimum of fuss. If you are writing or improving an application, have a look at [our suggestions
-on how you can improve your application][betterapps].
+However, it’s not enough to have multimedia codecs; their success is dependent on the quality and availability of the tools that use them. As such, if you want to help further our mission, you may want to consider improving a music or video player rather than working on our libraries and tools directly. For example, you may want to work on the UI or plugins of a CD ripper so people who want to reencode their music collection in Ogg Vorbis or FLAC can do so with a minimum of fuss. If you are writing or improving an application, have a look at [our suggestions on how you can improve your application][betterapps].
 
         [betterapps]: ./betterapps/
 
@@ -49,37 +42,36 @@
 
 ##  Help Windows Media Player support more of our formats
 
-Help work on [illiminable’s Ogg DirectShow Filters][illi] so Windows Media Player will be able
-to play Ogg Vorbis, Ogg Speex, Ogg FLAC, and Ogg Theora files.
+Help work on [illiminable’s Ogg DirectShow Filters][illi] so Windows Media Player will be able to play Ogg Vorbis, Ogg Speex, Ogg FLAC, and Ogg Theora files.
 
         [illi]: http://www.illiminable.com/ogg/
 
 
 ## Improve Vorbis, FLAC, and Speex support in iTunes
 
-iTunes is _the_ audio player for OS X; in order to be usable on that platform by novices, we
-need to be at least somewhat usable on that platform.
-Translated: Make sure that people can play Vorbis, FLAC, and Speex on Windows Media player on
-Windows and on iTunes on OS X.
+iTunes is _the_ audio player for OS X; in order to be usable on that platform by novices, we need to be at least somewhat usable on that platform. Translated: Make sure that people can play Vorbis, FLAC, and Speex on Windows Media player on Windows and on iTunes on OS X.
 
 
 ## Implement our codecs in your application
 
-One of the ways you can help us out is to make sure our codecs work on as many players as
-possible—preferably the most common players.
+One of the ways you can help us out is to make sure our codecs work on as many players as possible—preferably the most common players.
 
+
 ## Improve the comment handling in your (or someone else’s) application
 
 A number of music player applications don’t handle all the corner cases that can happen with
 [Vorbis-style comment headers][vcomment]. In particular…
 
 * Does the app ensure that only UTF-8 enters the comment header?
+
 * Does the app allow multiline comment values?
+
 * Does the app handle streams that have more than one comment with the same name?
   
   For example, what would your app do if you had two `%artist%` comments—one set to
   “Duke Ellington” and the other to “Count Basie”? If your app has a way to select tracks by
   artist, would the track show up in both Count Basie’s and Duke Ellington’s lists?
+
 * Concatenate two Ogg-encapsulated audio files together. Does the user lose any functionality
   compared to if they were not concatenated?
 

Modified: websites-ngen/xiph.org/speex/index.markdown
===================================================================
--- websites-ngen/xiph.org/speex/index.markdown	2004-05-30 05:20:57 UTC (rev 6790)
+++ websites-ngen/xiph.org/speex/index.markdown	2004-05-30 06:37:32 UTC (rev 6791)
@@ -1,13 +1,7 @@
 Speex
 =====
 
-Speex is an [Open Source/Free Software][osfs], patent-free audio compression format
-designed for speech. The Speex Project aims to lower the barrier of entry for voice
-applications by providing a free alternative to expensive proprietary speech codecs
-Moreover, Speex is well-adapted to Internet applications and provides useful features that
-are not present in most other codecs.
-Finally, Speex is part of the [<abbr title='GNU’s Not Unix'>GNU</abbr> Project][gnu]
-and is available under the terms of the [BSD license][license].
+Speex is an [Open Source/Free Software][osfs], patent-free audio compression format designed for speech. The Speex Project aims to lower the barrier of entry for voice applications by providing a free alternative to expensive proprietary speech codecs Moreover, Speex is well-adapted to Internet applications and provides useful features that are not present in most other speech codecs.  Finally, Speex is part of the [<abbr title='GNU’s Not Unix'>GNU</abbr> Project][gnu] and is available under the terms of the [BSD license][license].
 
         [osfs]:		./osfs/
         [gnu]:		http://www.gnu.org/
@@ -16,13 +10,12 @@
 
 ## The Technology
 
-Speex is based on <abbr title='Code-Excited Linear Prediction'>CELP</abbr> and is designed
-to compress voice at bitrates between 2 and 44 <abbr title='kilobits per second'>kbps</abbr>.
+Speex is based on <abbr title='Code-Excited Linear Prediction'>CELP</abbr> and is designed to compress voice at bitrates between 2 and 44 <abbr title='kilobits per second'>kbps</abbr>.
 
 Some of Speex’s features include:
 
 *	Narrowband (8 kHz), wideband (16 kHz), and ultra-wideband (32 kHz) compression
-	in the same bitstream
+	with an embedded bitstream
 *	Intensity stereo encoding
 *	Packet loss concealment
 *	Variable bitrate operation (VBR)
@@ -30,16 +23,12 @@
 *	Discontinuous transmission (DTX)
 *	An in-progress fixed-point port
 
-Speex has a number of features that other codecs don’t such as intensity stereo encoding
-and a <abbr title='variable bitrate'>VBR</abbr> mode; see our [comparison page][] for more.
+Speex has a number of features that other codecs don’t such as intensity stereo encoding and a <abbr title='variable bitrate'>VBR</abbr> mode; see our [comparison page][] for more.
 
         [comparison page]: ./compare/
 
 ## Getting Involved
 
-If you want to get involved with Speex, one of the easiest things you can do is use it
-in your application. Speex is well-suited for <abbr title='Voice over IP'>VoIP</abbr>,
-internet audio streaming, voice mail or interview archival, and audio books. For a list
-of applications using Speex, have a look at our [users][] page.
+If you want to get involved with Speex, one of the easiest things you can do is use it in your application. Speex is well-suited for <abbr title='Voice over IP'>VoIP</abbr>, internet audio streaming, voice mail or interview archival, and audio books. For a list of applications using Speex, have a look at our [users][] page.
 
         [users]: ./users/

Modified: websites-ngen/xiph.org/speex/roadmap/index.markdown
===================================================================
--- websites-ngen/xiph.org/speex/roadmap/index.markdown	2004-05-30 05:20:57 UTC (rev 6790)
+++ websites-ngen/xiph.org/speex/roadmap/index.markdown	2004-05-30 06:37:32 UTC (rev 6791)
@@ -1,16 +1,25 @@
 Roadmap
 =======
 
+
 ## What We’re Doing
+
 We’re implementing and debugging new features such as a denoiser, echo canceller, and a
 jitter buffer. In addition, we’re testing out a new
 <acronym title='voice activity detector'>VAD</acronym> and writing a fixed-point version
 of the Speex libraries.
 
+
 ## How You Can Help
+
 Consider…
 
 * writing a plugin for your favorite audio player
+* Doing something that’s on the [to-do list][todo]
 * proposing Speex to a standards organization body looking for a voice compression codec
 * help make Speex an <abbr title="Internet Engineering Task Force">IETF</abbr>-blessed standard
 * helping us finish our fixed-point version of the Speex C library
+* [Donating][] to Xiph.Org
+
+	[todo]:		http://svn.xiph.org/trunk/speex/TODO
+	[donating]:	/donate/

Modified: websites-ngen/xiph.org/vorbis/beforecontent.inherit
===================================================================
--- websites-ngen/xiph.org/vorbis/beforecontent.inherit	2004-05-30 05:20:57 UTC (rev 6790)
+++ websites-ngen/xiph.org/vorbis/beforecontent.inherit	2004-05-30 06:37:32 UTC (rev 6791)
@@ -5,9 +5,6 @@
 ><li><a href='/vorbis/'>Vorbis Home</a></li
 ><li><a href='/vorbis/news/'>News</a></li
 ><li><a href='/vorbis/faq/'>FAQ</a></li
-><li><a href='/vorbis/comments/'>Tagging</a></li
-><li><a href='/vorbis/compare/'>Compare</a></li
-><li><a href='/vorbis/samples/'>Samples</a></li
 ><li><a href='/vorbis/download/'>Download</a></li
 ><li><a href='/vorbis/documentation/'>Documentation</a></li
 ><li><a href='/vorbis/license/'>License</a></li

Modified: websites-ngen/xiph.org/vorbis/index.markdown
===================================================================
--- websites-ngen/xiph.org/vorbis/index.markdown	2004-05-30 05:20:57 UTC (rev 6790)
+++ websites-ngen/xiph.org/vorbis/index.markdown	2004-05-30 06:37:32 UTC (rev 6791)
@@ -1,4 +1,6 @@
-Ogg Vorbis
-==========
+Vorbis
+======
 
-Vorbis rocks.
+Vorbis is a [lossy][], general-purpose audio compression format.
+
+	[lossy]:		/glossary/#lossy "See our glossary entry for “lossy”"

--- >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 'cvs-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.

More information about the commits mailing list