moved from Mate-Extra

author: Stefano Karapetsas <[email protected]> 2011-12-11 13:11:15 +0100
committer: Stefano Karapetsas <[email protected]> 2011-12-11 13:11:15 +0100
commit: 4ee2559eaaf2a94ac26c265517e9604a72729360 (patch)
tree: f24e3e3294c2b75819755289e592bf2e28e668c4 /profiles/help/C
download: mate-media-4ee2559eaaf2a94ac26c265517e9604a72729360.tar.bz2
mate-media-4ee2559eaaf2a94ac26c265517e9604a72729360.tar.xz
4 files changed, 335 insertions, 0 deletions
diff --git a/profiles/help/C/figures/mate-audio-profiles-profile-window.png b/profiles/help/C/figures/mate-audio-profiles-profile-window.png
new file mode 100644
index 0000000..20a0243
--- /dev/null
+++ b/profiles/help/C/figures/mate-audio-profiles-profile-window.png
diff --git a/profiles/help/C/figures/mate-audio-profiles-profiles-window.png b/profiles/help/C/figures/mate-audio-profiles-profiles-window.png
new file mode 100644
index 0000000..8a12356
--- /dev/null
+++ b/profiles/help/C/figures/mate-audio-profiles-profiles-window.png
diff --git a/profiles/help/C/legal.xml b/profiles/help/C/legal.xml
new file mode 100644
index 0000000..331b1d4
--- /dev/null
+++ b/profiles/help/C/legal.xml
@@ -0,0 +1,73 @@
+ <legalnotice id="legalnotice">
+ <para>
+ Permission is granted to copy, distribute and/or modify this
+ document under the terms of the GNU Free Documentation
+ License (GFDL), Version 1.1 or any later version published
+ by the Free Software Foundation with no Invariant Sections,
+ no Front-Cover Texts, and no Back-Cover Texts. You can find
+ a copy of the GFDL at this <ulink type="help"
+ url="ghelp:fdl">link</ulink> or in the file COPYING-DOCS
+ distributed with this manual.
+ </para>
+ <para> This manual is part of a collection of MATE manuals
+ distributed under the GFDL. If you want to distribute this
+ manual separately from the collection, you can do so by
+ adding a copy of the license to the manual, as described in
+ section 6 of the license.
+ </para>
+
+ <para>
+ Many of the names used by companies to distinguish their
+ products and services are claimed as trademarks. Where those
+ names appear in any MATE documentation, and the members of
+ the MATE Documentation Project are made aware of those
+ trademarks, then the names are in capital letters or initial
+ capital letters.
+ </para>
+
+ <para>
+ DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
+ UNDER THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
+ WITH THE FURTHER UNDERSTANDING THAT:
+
+ <orderedlist>
+ <listitem>
+ <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
+ WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
+ IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
+ THAT THE DOCUMENT OR MODIFIED VERSION OF THE
+ DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
+ A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
+ RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
+ OF THE DOCUMENT OR MODIFIED VERSION OF THE
+ DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
+ MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
+ YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
+ CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
+ SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
+ OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
+ LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
+ VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
+ EXCEPT UNDER THIS DISCLAIMER; AND
+ UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
+ THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
+ CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
+ INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
+ DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
+ OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
+ PARTIES, BE LIABLE TO ANY PERSON FOR ANY
+ DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
+ CONSEQUENTIAL DAMAGES OF ANY CHARACTER
+ INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
+ OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
+ MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
+ LOSSES ARISING OUT OF OR RELATING TO USE OF THE
+ DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
+ EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
+ THE POSSIBILITY OF SUCH DAMAGES.
+ </para>
+ </listitem>
+ </orderedlist>
+ </para>
+ </legalnotice>
+
diff --git a/profiles/help/C/mate-audio-profiles.xml b/profiles/help/C/mate-audio-profiles.xml
new file mode 100644
index 0000000..929554d
--- /dev/null
+++ b/profiles/help/C/mate-audio-profiles.xml
@@ -0,0 +1,262 @@
+<?xml version="1.0"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+ "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+ <!ENTITY appname "mate-audio-profiles">
+ <!ENTITY app "<application>MATE Audio Profiles</application>">
+ <!ENTITY appversion "2.27.3">
+ <!ENTITY manrevision "2.27.0">
+ <!-- Information about the entities
+ Use the app and appname entities to specify the name of the application.
+ Use the appversion entity to specify the version of the application.
+ Use the manrevision entity to specify the revision number of this manual.
+ Use the date entity to specify the release date of this manual.
+ -->
+ ]>
+<!--
+ (Do not remove this comment block.)
+ Maintained by the MATE Documentation Project
+ http://live.mate.org/DocumentationProject
+ Template version: 3.0 beta
+ Template last modified 2006-11-21
+
+ -->
+<!-- =============Document Header ============================= -->
+<article id="index" lang="en">
+ <articleinfo>
+ <title>&app; Manual</title>
+ <abstract role="description">
+ <para>&app; is a set of audio encoding configurations for
+ GStreamer based applications.</para>
+ </abstract>
+
+ <copyright>
+ <year>2008-2009</year>
+ <holder>MATE Documentation Project</holder>
+ </copyright>
+
+ <!-- An address can be added to the publisher information. -->
+ <publisher role="maintainer">
+ <publishername>MATE Documentation Project</publishername>
+ </publisher>
+
+ <xi:include href="legal.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+ <!-- The file legal.xml contains link to license for the documentation,
+ and other legal stuff such as "NO WARRANTY" statement.
+ Please do not change any of this. -->
+
+ <authorgroup>
+ <author>
+ <firstname>Marc-Andre</firstname>
+ <surname>Lureau</surname>
+ <affiliation>
+ <orgname>MATE Project</orgname>
+ <address> <email>[email protected]</email> </address>
+ </affiliation>
+ </author>
+ </authorgroup>
+
+
+ <!-- According to GNU FDL, revision history is mandatory if you are -->
+ <!-- modifying/reusing someone else's document. If not, you can omit it. -->
+ <!-- Remember to remove the &manrevision; entity from the revision entries other
+ -->
+ <!-- than the current revision. -->
+ <!-- The revision numbering system for MATE manuals is as follows: -->
+ <!-- * the revision number consists of two components -->
+ <!-- * the first component of the revision number reflects the release version of the MATE desktop. -->
+ <!-- * the second component of the revision number is a decimal unit that is incremented with each revision of the manual. -->
+ <!-- For example, if the MATE desktop release is V2.x, the first version of the manual that -->
+ <!-- is written in that desktop timeframe is V2.0, the second version of the manual is V2.1, etc. -->
+ <!-- When the desktop release version changes to V3.x, the revision number of the manual changes -->
+ <!-- to V3.0, and so on. -->
+ <revhistory>
+ <revision>
+ <revnumber>Audio Profiles Manual V&manrevision;</revnumber>
+ <date>June 2009</date>
+ <revdescription>
+ <para>Fill some blanks, add screenshots.</para>
+ <para>Release with MATE Media 2.27.3</para>
+ <para role="author">Marc-Andre Lureau</para>
+ <para role="publisher">MATE Documentation Project</para>
+ </revdescription>
+ </revision>
+ <revision>
+ <revnumber>Audio Profiles Manual V0.1</revnumber>
+ <date>December 2008</date>
+ <revdescription>
+ <para role="author">Marc-Andre Lureau</para>
+ <para role="publisher">MATE Documentation Project</para>
+ </revdescription>
+ </revision>
+ </revhistory>
+
+ <releaseinfo>This manual describes version &appversion; of MATE Audio Profiles.
+ </releaseinfo>
+ <legalnotice>
+ <title>Feedback</title>
+ <para>To report a bug or make a suggestion regarding the &app; application or
+ this manual, follow the directions in the
+ <ulink url="ghelp:user-guide?feedback-bugs" type="help">Feedback section of the MATE User Guide</ulink>.
+ </para>
+ <!-- Translators may also add here feedback address for translations -->
+ </legalnotice>
+ </articleinfo>
+
+ <indexterm zone="index">
+ <primary>MATE Audio Profiles</primary>
+ </indexterm>
+
+ <!-- ============= Document Body ============================= -->
+ <!-- ============= Introduction ============================== -->
+
+ <sect1 id="mate-audio-profiles-introduction">
+ <title>Introduction</title>
+ <para>&app; let you select and modify a list of pre-defined encoding formats.
+ By default, &app; provides the following audio format:</para>
+ <itemizedlist>
+ <listitem>
+ <para>AAC-MP4 - The new standard of lossy compression.</para>
+ </listitem>
+ <listitem>
+ <para>Ogg Vorbis - Xiph.Org lossy compression.</para>
+ </listitem>
+ <listitem>
+ <para>Speex - Xiph.Org lossy compression optimized for voice.</para>
+ </listitem>
+ <listitem>
+ <para>FLAC - Xiph.Org lossless audio compression.</para>
+ </listitem>
+ <listitem>
+ <para>MP3 - The popular lossy compression format.</para>
+ </listitem>
+ <listitem>
+ <para>MP2 - MPEG-1 Audio Layer II, largely supported.</para>
+ </listitem>
+ <listitem>
+ <para>WAV - Lossless.</para>
+ </listitem>
+ </itemizedlist>
+
+ <note>
+ <para>Some format may be illegal in your jurisdiction.</para>
+ </note>
+ </sect1>
+
+ <sect1 id="mate-audio-profiles-usage">
+ <title>Usage</title>
+ <para>Use &app; to modify a list of pre-defined encoding formats.</para>
+
+ <sect2 id="mate-audio-profiles-profiles-edit">
+ <title>Profile selection dialog</title>
+
+ <para>The following window is displayed to modify, add or remove
+ the pre-defined formats.</para>
+
+ <!-- ==== Figure ==== -->
+ <figure id="mate-audio-profiles-profiles-window">
+ <title>&app; Window</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/mate-audio-profiles-profiles-window.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Shows &app; main window. Contains list of
+ profiles and modification options.</phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ <!-- ==== End of Figure ==== -->
+
+ <para>Select one of the profiles and click "Edit" to modify
+ it. The "Profile modification window" will be displayed.</para>
+
+ <para>"Delete" will remove the currently selected profile from the
+ list of profiles.</para>
+
+ <para>To create a new profile, click "New". The "Profile
+5~ modification window" will be displayed.</para>
+
+ </sect2>
+
+ <sect2 id="mate-audio-profiles-profile-edit">
+ <title>Profile editing</title>
+
+ <para>&app; let you modify the parameters of an audio profile.</para>
+
+ <!-- ==== Figure ==== -->
+ <figure id="mate-audio-profiles-profile-window">
+ <title>Profile modification window</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/mate-audio-profiles-profile-window.png" format="PNG"/>
+ </imageobject>
+ <textobject>
+ <phrase>Shows &app; profile window. </phrase>
+ </textobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ <!-- ==== End of Figure ==== -->
+
+ <itemizedlist>
+ <listitem>
+ <para>Profile name - user friendly name of the profile.</para>
+ </listitem>
+ <listitem>
+ <para>Profile description - long description of this profile.</para>
+ </listitem>
+ <listitem>
+ <para>GStreamer pipeline - the GStreamer encoding pipeline.</para>
+ </listitem>
+ <listitem>
+ <para>File extension - the filename extension associated to
+ this profile.</para>
+ </listitem>
+ <listitem>
+ <para>Active - whether this profile is listed in client
+ application.</para>
+ </listitem>
+ </itemizedlist>
+
+ </sect2>
+
+ </sect1>
+
+ <!-- ============= Bugs ================================== -->
+ <!-- This section is optional and is commented out by default.
+ You can use it to describe known bugs and limitations of the
+ program if there are any - please be frank and list all
+ problems you know of.
+
+ <sect1 id="mayapp-bugs">
+ <title>Known Bugs and Limitations</title>
+ <para> </para>
+ </sect1>
+ -->
+ <!-- ============= About ================================== -->
+ <!-- This section contains info about the program (not docs), such as
+ author's name(s), web page, license, feedback address. This
+ section is optional: primary place for this info is "About.." box of
+ the program. However, if you do wish to include this info in the
+ manual, this is the place to put it. Alternatively, you can put this information in the title page.-->
+ <sect1 id="mate-audio-profiles-about">
+ <title>About &app;</title>
+ <para>
+ To report a bug or make a suggestion regarding this application or
+ this manual, follow the directions in the
+ <ulink url="ghelp:user-guide?feedback-bugs" type="help">Feedback section of the MATE User Guide</ulink>.
+ </para>
+
+ <para> This program is distributed under the terms of the GNU
+ Library General Public license as published by the Free Software
+ Foundation; either version 2 of the License, or (at your option)
+ any later version. A
+ <ulink url="ghelp:lgpl" type="help">copy of this license</ulink>
+ is included with this documentation; another can be found in the file
+ COPYING included with the source code of this program. </para>
+
+ </sect1>
+</article>
author	Stefano Karapetsas <[email protected]>	2011-12-11 13:11:15 +0100
committer	Stefano Karapetsas <[email protected]>	2011-12-11 13:11:15 +0100
commit	4ee2559eaaf2a94ac26c265517e9604a72729360 (patch)
tree	f24e3e3294c2b75819755289e592bf2e28e668c4 /profiles/help/C
download	mate-media-4ee2559eaaf2a94ac26c265517e9604a72729360.tar.bz2 mate-media-4ee2559eaaf2a94ac26c265517e9604a72729360.tar.xz