[SCM] gsequencer/master: undelete doc directory

jkraehemann-guest at users.alioth.debian.org jkraehemann-guest at users.alioth.debian.org
Fri Jun 19 16:24:40 UTC 2015


The following commit has been merged in the master branch:
commit 3c65396d4ab1796a2a22061de51771e2c52363b7
Author: Joël Krähemann <jkraehemann at gmail.com>
Date:   Fri Jun 19 17:58:16 2015 +0200

    undelete doc directory

diff --git a/doc/appa.xml b/doc/appa.xml
new file mode 100644
index 0000000..a3a3a34
--- /dev/null
+++ b/doc/appa.xml
@@ -0,0 +1,560 @@
+<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<appendix id="fdl">
+  <title>GNU Free Documentation License</title>
+  <simpara>Version 1.3, 3 November 2008</simpara>
+  <simpara>
+    Copyright © 2000, 2001, 2002, 2007, 2008
+    <ulink url="http://www.fsf.org/">Free Software Foundation, Inc.</ulink>
+  </simpara>
+  <simpara>
+    Everyone is permitted to copy and distribute verbatim copies of this
+    license document, but changing it is not allowed.
+  </simpara>
+  <bridgehead id="section0" renderas="sect2">
+    0. PREAMBLE
+  </bridgehead>
+  <simpara>
+    The purpose of this License is to make a manual, textbook, or other
+    functional and useful document “free” in the sense of freedom:
+    to assure everyone the effective freedom to copy and redistribute it, with
+    or without modifying it, either commercially or
+    noncommercially. Secondarily, this License preserves for the author and
+    publisher a way to get credit for their work, while not being considered
+    responsible for modifications made by others.
+  </simpara>
+  <simpara>
+    This License is a kind of “copyleft”, which means that
+    derivative works of the document must themselves be free in the same
+    sense. It complements the GNU General Public License, which is a copyleft
+    license designed for free software.
+  </simpara>
+  <simpara>
+    We have designed this License in order to use it for manuals for free
+    software, because free software needs free documentation: a free program
+    should come with manuals providing the same freedoms that the software
+    does. But this License is not limited to software manuals; it can be used
+    for any textual work, regardless of subject matter or whether it is
+    published as a printed book. We recommend this License principally for
+    works whose purpose is instruction or reference.
+  </simpara>
+  <bridgehead id="section1" renderas="sect2">
+    1. APPLICABILITY AND DEFINITIONS
+  </bridgehead>
+  <simpara>
+    This License applies to any manual or other work, in any medium, that
+    contains a notice placed by the copyright holder saying it can be
+    distributed under the terms of this License. Such a notice grants a
+    world-wide, royalty-free license, unlimited in duration, to use that work
+    under the conditions stated herein. The “Document”, below,
+    refers to any such manual or work. Any member of the public is a licensee,
+    and is addressed as “you”. You accept the license if you copy,
+    modify or distribute the work in a way requiring permission under
+    copyright law.
+  </simpara>
+  <simpara>
+    A “Modified Version” of the Document means any work containing
+    the Document or a portion of it, either copied verbatim, or with
+    modifications and/or translated into another language.
+  </simpara>
+  <simpara>
+    A “Secondary Section” is a named appendix or a front-matter
+    section of the Document that deals exclusively with the relationship of
+    the publishers or authors of the Document to the Document&#x2019;s overall
+    subject (or to related matters) and contains nothing that could fall
+    directly within that overall subject. (Thus, if the Document is in part a
+    textbook of mathematics, a Secondary Section may not explain any
+    mathematics.) The relationship could be a matter of historical connection
+    with the subject or with related matters, or of legal, commercial,
+    philosophical, ethical or political position regarding them.
+  </simpara>
+  <simpara>
+    The “Invariant Sections” are certain Secondary Sections whose
+    titles are designated, as being those of Invariant Sections, in the notice
+    that says that the Document is released under this License. If a section
+    does not fit the above definition of Secondary then it is not allowed to
+    be designated as Invariant. The Document may contain zero Invariant
+    Sections. If the Document does not identify any Invariant Sections then
+    there are none.
+  </simpara>
+  <simpara>
+    The “Cover Texts” are certain short passages of text that are
+    listed, as Front-Cover Texts or Back-Cover Texts, in the notice that says
+    that the Document is released under this License. A Front-Cover Text may
+    be at most 5 words, and a Back-Cover Text may be at most 25 words.
+  </simpara>
+  <simpara>
+    A “Transparent” copy of the Document means a machine-readable
+    copy, represented in a format whose specification is available to the
+    general public, that is suitable for revising the document
+    straightforwardly with generic text editors or (for images composed of
+    pixels) generic paint programs or (for drawings) some widely available
+    drawing editor, and that is suitable for input to text formatters or for
+    automatic translation to a variety of formats suitable for input to text
+    formatters. A copy made in an otherwise Transparent file format whose
+    markup, or absence of markup, has been arranged to thwart or discourage
+    subsequent modification by readers is not Transparent. An image format is
+    not Transparent if used for any substantial amount of text. A copy that is
+    not “Transparent” is called “Opaque”.
+  </simpara>
+  <simpara>
+    Examples of suitable formats for Transparent copies include plain ASCII
+    without markup, Texinfo input format, LaTeX input format, SGML or XML
+    using a publicly available DTD, and standard-conforming simple HTML,
+    PostScript or PDF designed for human modification. Examples of transparent
+    image formats include PNG, XCF and JPG. Opaque formats include proprietary
+    formats that can be read and edited only by proprietary word processors,
+    SGML or XML for which the DTD and/or processing tools are not generally
+    available, and the machine-generated HTML, PostScript or PDF produced by
+    some word processors for output purposes only.
+  </simpara>
+  <simpara>
+    The “Title Page” means, for a printed book, the title page
+    itself, plus such following pages as are needed to hold, legibly, the
+    material this License requires to appear in the title page. For works in
+    formats which do not have any title page as such, “Title Page”
+    means the text near the most prominent appearance of the work&#x2019;s
+    title, preceding the beginning of the body of the text.
+  </simpara>
+  <simpara>
+    The “publisher” means any person or entity that distributes
+    copies of the Document to the public.
+  </simpara>
+  <simpara>
+    A section “Entitled XYZ” means a named subunit of the Document
+    whose title either is precisely XYZ or contains XYZ in parentheses
+    following text that translates XYZ in another language. (Here XYZ stands
+    for a specific section name mentioned below, such as
+    “Acknowledgements”, “Dedications”,
+    “Endorsements”, or “History”.) To “Preserve
+    the Title” of such a section when you modify the Document means that
+    it remains a section “Entitled XYZ” according to this
+    definition.
+  </simpara>
+  <simpara>
+    The Document may include Warranty Disclaimers next to the notice which
+    states that this License applies to the Document. These Warranty
+    Disclaimers are considered to be included by reference in this License,
+    but only as regards disclaiming warranties: any other implication that
+    these Warranty Disclaimers may have is void and has no effect on the
+    meaning of this License.
+  </simpara>
+  <bridgehead id="section2" renderas="sect2">
+    2. VERBATIM COPYING
+  </bridgehead>
+  <simpara>
+    You may copy and distribute the Document in any medium, either
+    commercially or noncommercially, provided that this License, the copyright
+    notices, and the license notice saying this License applies to the
+    Document are reproduced in all copies, and that you add no other
+    conditions whatsoever to those of this License. You may not use technical
+    measures to obstruct or control the reading or further copying of the
+    copies you make or distribute. However, you may accept compensation in
+    exchange for copies. If you distribute a large enough number of copies you
+    must also follow the conditions in section 3.
+  </simpara>
+  <simpara>
+    You may also lend copies, under the same conditions stated above, and you
+    may publicly display copies.
+  </simpara>
+  <bridgehead id="section3" renderas="sect2">
+    3. COPYING IN QUANTITY
+  </bridgehead>
+  <simpara>
+    If you publish printed copies (or copies in media that commonly have
+    printed covers) of the Document, numbering more than 100, and the
+    Document&#x2019;s license notice requires Cover Texts, you must enclose
+    the copies in covers that carry, clearly and legibly, all these Cover
+    Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on the
+    back cover. Both covers must also clearly and legibly identify you as the
+    publisher of these copies. The front cover must present the full title
+    with all words of the title equally prominent and visible. You may add
+    other material on the covers in addition. Copying with changes limited to
+    the covers, as long as they preserve the title of the Document and satisfy
+    these conditions, can be treated as verbatim copying in other respects.
+  </simpara>
+  <simpara>
+    If the required texts for either cover are too voluminous to fit legibly,
+    you should put the first ones listed (as many as fit reasonably) on the
+    actual cover, and continue the rest onto adjacent pages.
+  </simpara>
+  <simpara>
+    If you publish or distribute Opaque copies of the Document numbering more
+    than 100, you must either include a machine-readable Transparent copy
+    along with each Opaque copy, or state in or with each Opaque copy a
+    computer-network location from which the general network-using public has
+    access to download using public-standard network protocols a complete
+    Transparent copy of the Document, free of added material. If you use the
+    latter option, you must take reasonably prudent steps, when you begin
+    distribution of Opaque copies in quantity, to ensure that this Transparent
+    copy will remain thus accessible at the stated location until at least one
+    year after the last time you distribute an Opaque copy (directly or
+    through your agents or retailers) of that edition to the public.
+  </simpara>
+  <simpara>
+    It is requested, but not required, that you contact the authors of the
+    Document well before redistributing any large number of copies, to give
+    them a chance to provide you with an updated version of the Document.
+  </simpara>
+  <bridgehead id="section4" renderas="sect2">
+    4. MODIFICATIONS
+  </bridgehead>
+  <simpara>
+    You may copy and distribute a Modified Version of the Document under the
+    conditions of sections 2 and 3 above, provided that you release the
+    Modified Version under precisely this License, with the Modified Version
+    filling the role of the Document, thus licensing distribution and
+    modification of the Modified Version to whoever possesses a copy of it. In
+    addition, you must do these things in the Modified Version:
+  </simpara>
+  <orderedlist numeration="upperalpha">
+    <listitem>
+      <simpara>
+        Use in the Title Page (and on the covers, if any) a title distinct
+        from that of the Document, and from those of previous versions (which
+        should, if there were any, be listed in the History section of the
+        Document). You may use the same title as a previous version if the
+        original publisher of that version gives permission.
+      </simpara>
+    </listitem>
+    <listitem>
+      <simpara>
+        List on the Title Page, as authors, one or more persons or entities
+        responsible for authorship of the modifications in the Modified
+        Version, together with at least five of the principal authors of the
+        Document (all of its principal authors, if it has fewer than five),
+        unless they release you from this requirement.
+      </simpara>
+    </listitem>
+    <listitem>
+      <simpara>
+        State on the Title page the name of the publisher of the Modified
+        Version, as the publisher.
+      </simpara>
+    </listitem>
+    <listitem>
+      <simpara>
+        Preserve all the copyright notices of the Document.
+      </simpara>
+    </listitem>
+    <listitem>
+      <simpara>
+        Add an appropriate copyright notice for your modifications adjacent to
+        the other copyright notices.
+      </simpara>
+    </listitem>
+    <listitem>
+      <simpara>
+        Include, immediately after the copyright notices, a license notice
+        giving the public permission to use the Modified Version under the
+        terms of this License, in the form shown in the Addendum below.
+      </simpara>
+    </listitem>
+    <listitem>
+      <simpara>
+        Preserve in that license notice the full lists of Invariant Sections
+        and required Cover Texts given in the Document&#x2019;s license
+        notice.
+      </simpara>
+    </listitem>
+    <listitem>
+      <simpara>
+        Include an unaltered copy of this License.
+      </simpara>
+    </listitem>
+    <listitem>
+      <simpara>
+        Preserve the section Entitled “History”, Preserve its
+        Title, and add to it an item stating at least the title, year, new
+        authors, and publisher of the Modified Version as given on the Title
+        Page. If there is no section Entitled “History” in the
+        Document, create one stating the title, year, authors, and publisher
+        of the Document as given on its Title Page, then add an item
+        describing the Modified Version as stated in the previous sentence.
+      </simpara>
+    </listitem>
+    <listitem>
+      <simpara>
+        Preserve the network location, if any, given in the Document for
+        public access to a Transparent copy of the Document, and likewise the
+        network locations given in the Document for previous versions it was
+        based on.  These may be placed in the “History”
+        section. You may omit a network location for a work that was published
+        at least four years before the Document itself, or if the original
+        publisher of the version it refers to gives permission.
+      </simpara>
+    </listitem>
+    <listitem>
+      <simpara>
+        For any section Entitled “Acknowledgements” or
+        “Dedications”, Preserve the Title of the section, and
+        preserve in the section all the substance and tone of each of the
+        contributor acknowledgements and/or dedications given therein.
+      </simpara>
+    </listitem>
+    <listitem>
+      <simpara>
+        Preserve all the Invariant Sections of the Document, unaltered in
+        their text and in their titles. Section numbers or the equivalent are
+        not considered part of the section titles.
+      </simpara>
+    </listitem>
+    <listitem>
+      <simpara>
+        Delete any section Entitled “Endorsements”. Such a section
+        may not be included in the Modified Version.
+      </simpara>
+    </listitem>
+    <listitem>
+      <simpara>
+        Do not retitle any existing section to be Entitled
+        “Endorsements” or to conflict in title with any Invariant
+        Section.
+      </simpara>
+    </listitem>
+    <listitem>
+      <simpara>
+        Preserve any Warranty Disclaimers.
+      </simpara>
+    </listitem>
+  </orderedlist>
+  <simpara>
+    If the Modified Version includes new front-matter sections or appendices
+    that qualify as Secondary Sections and contain no material copied from the
+    Document, you may at your option designate some or all of these sections
+    as invariant. To do this, add their titles to the list of Invariant
+    Sections in the Modified Version&#x2019;s license notice. These titles
+    must be distinct from any other section titles.
+  </simpara>
+  <simpara>
+    You may add a section Entitled “Endorsements”, provided it
+    contains nothing but endorsements of your Modified Version by various
+    parties — for example, statements of peer review or that the text
+    has been approved by an organization as the authoritative definition of a
+    standard.
+  </simpara>
+  <simpara>
+    You may add a passage of up to five words as a Front-Cover Text, and a
+    passage of up to 25 words as a Back-Cover Text, to the end of the list of
+    Cover Texts in the Modified Version. Only one passage of Front-Cover Text
+    and one of Back-Cover Text may be added by (or through arrangements made
+    by) any one entity. If the Document already includes a cover text for the
+    same cover, previously added by you or by arrangement made by the same
+    entity you are acting on behalf of, you may not add another; but you may
+    replace the old one, on explicit permission from the previous publisher
+    that added the old one.
+  </simpara>
+  <simpara>
+    The author(s) and publisher(s) of the Document do not by this License give
+    permission to use their names for publicity for or to assert or imply
+    endorsement of any Modified Version.
+  </simpara>
+  <bridgehead id="section5" renderas="sect2">
+    5. COMBINING DOCUMENTS
+  </bridgehead>
+  <simpara>
+    You may combine the Document with other documents released under this
+    License, under the terms defined in section 4 above for modified versions,
+    provided that you include in the combination all of the Invariant Sections
+    of all of the original documents, unmodified, and list them all as
+    Invariant Sections of your combined work in its license notice, and that
+    you preserve all their Warranty Disclaimers.
+  </simpara>
+  <simpara>
+    The combined work need only contain one copy of this License, and multiple
+    identical Invariant Sections may be replaced with a single copy. If there
+    are multiple Invariant Sections with the same name but different contents,
+    make the title of each such section unique by adding at the end of it, in
+    parentheses, the name of the original author or publisher of that section
+    if known, or else a unique number. Make the same adjustment to the section
+    titles in the list of Invariant Sections in the license notice of the
+    combined work.
+  </simpara>
+  <simpara>
+    In the combination, you must combine any sections Entitled
+    “History” in the various original documents, forming one
+    section Entitled “History”; likewise combine any sections
+    Entitled “Acknowledgements”, and any sections Entitled
+    “Dedications”. You must delete all sections Entitled
+    “Endorsements”.
+  </simpara>
+  <bridgehead id="section6" renderas="sect2">
+    6. COLLECTIONS OF DOCUMENTS
+  </bridgehead>
+  <simpara>
+    You may make a collection consisting of the Document and other documents
+    released under this License, and replace the individual copies of this
+    License in the various documents with a single copy that is included in
+    the collection, provided that you follow the rules of this License for
+    verbatim copying of each of the documents in all other respects.
+  </simpara>
+  <simpara>
+    You may extract a single document from such a collection, and distribute
+    it individually under this License, provided you insert a copy of this
+    License into the extracted document, and follow this License in all other
+    respects regarding verbatim copying of that document.
+  </simpara>
+  <bridgehead id="section7" renderas="sect2">
+    7. AGGREGATION WITH INDEPENDENT WORKS
+  </bridgehead>
+  <simpara>
+    A compilation of the Document or its derivatives with other separate and
+    independent documents or works, in or on a volume of a storage or
+    distribution medium, is called an “aggregate” if the copyright
+    resulting from the compilation is not used to limit the legal rights of
+    the compilation&#x2019;s users beyond what the individual works
+    permit. When the Document is included in an aggregate, this License does
+    not apply to the other works in the aggregate which are not themselves
+    derivative works of the Document.
+  </simpara>
+  <simpara>
+    If the Cover Text requirement of section 3 is applicable to these copies
+    of the Document, then if the Document is less than one half of the entire
+    aggregate, the Document&#x2019;s Cover Texts may be placed on covers that
+    bracket the Document within the aggregate, or the electronic equivalent of
+    covers if the Document is in electronic form. Otherwise they must appear
+    on printed covers that bracket the whole aggregate.
+  </simpara>
+  <bridgehead id="section8" renderas="sect2">
+    8. TRANSLATION
+  </bridgehead>
+  <simpara>
+    Translation is considered a kind of modification, so you may distribute
+    translations of the Document under the terms of section 4. Replacing
+    Invariant Sections with translations requires special permission from
+    their copyright holders, but you may include translations of some or all
+    Invariant Sections in addition to the original versions of these Invariant
+    Sections. You may include a translation of this License, and all the
+    license notices in the Document, and any Warranty Disclaimers, provided
+    that you also include the original English version of this License and the
+    original versions of those notices and disclaimers. In case of a
+    disagreement between the translation and the original version of this
+    License or a notice or disclaimer, the original version will prevail.
+  </simpara>
+  <simpara>
+    If a section in the Document is Entitled “Acknowledgements”,
+    “Dedications”, or “History”, the requirement
+    (section 4) to Preserve its Title (section 1) will typically require
+    changing the actual title.
+  </simpara>
+  <bridgehead id="section9" renderas="sect2">
+    9. TERMINATION
+  </bridgehead>
+  <simpara>
+    You may not copy, modify, sublicense, or distribute the Document except as
+    expressly provided under this License. Any attempt otherwise to copy,
+    modify, sublicense, or distribute it is void, and will automatically
+    terminate your rights under this License.
+  </simpara>
+  <simpara>
+    However, if you cease all violation of this License, then your license
+    from a particular copyright holder is reinstated (a) provisionally, unless
+    and until the copyright holder explicitly and finally terminates your
+    license, and (b) permanently, if the copyright holder fails to notify you
+    of the violation by some reasonable means prior to 60 days after the
+    cessation.
+  </simpara>
+  <simpara>
+    Moreover, your license from a particular copyright holder is reinstated
+    permanently if the copyright holder notifies you of the violation by some
+    reasonable means, this is the first time you have received notice of
+    violation of this License (for any work) from that copyright holder, and
+    you cure the violation prior to 30 days after your receipt of the notice.
+  </simpara>
+  <simpara>
+    Termination of your rights under this section does not terminate the
+    licenses of parties who have received copies or rights from you under this
+    License. If your rights have been terminated and not permanently
+    reinstated, receipt of a copy of some or all of the same material does not
+    give you any rights to use it.
+  </simpara>
+  <bridgehead id="section10" renderas="sect2">
+    10. FUTURE REVISIONS OF THIS LICENSE
+  </bridgehead>
+  <simpara>
+    The Free Software Foundation may publish new, revised versions of the GNU
+    Free Documentation License from time to time. Such new versions will be
+    similar in spirit to the present version, but may differ in detail to
+    address new problems or concerns. See
+    <ulink url="http://www.gnu.org/copyleft/">Copyleft</ulink>.
+  </simpara>
+  <simpara>
+    Each version of the License is given a distinguishing version number. If
+    the Document specifies that a particular numbered version of this License
+    “or any later version” applies to it, you have the option of
+    following the terms and conditions either of that specified version or of
+    any later version that has been published (not as a draft) by the Free
+    Software Foundation. If the Document does not specify a version number of
+    this License, you may choose any version ever published (not as a draft)
+    by the Free Software Foundation. If the Document specifies that a proxy
+    can decide which future versions of this License can be used, that
+    proxy&#x2019;s public statement of acceptance of a version permanently
+    authorizes you to choose that version for the Document.
+  </simpara>
+  <bridgehead id="section11" renderas="sect2">
+    11. RELICENSING
+  </bridgehead>
+  <simpara>
+    “Massive Multiauthor Collaboration Site” (or “MMC
+    Site”) means any World Wide Web server that publishes copyrightable
+    works and also provides prominent facilities for anybody to edit those
+    works. A public wiki that anybody can edit is an example of such a
+    server. A “Massive Multiauthor Collaboration” (or
+    “MMC”) contained in the site means any set of copyrightable
+    works thus published on the MMC site.
+  </simpara>
+  <simpara>
+    “CC-BY-SA” means the Creative Commons Attribution-Share Alike
+    3.0 license published by Creative Commons Corporation, a not-for-profit
+    corporation with a principal place of business in San Francisco,
+    California, as well as future copyleft versions of that license published
+    by that same organization.
+  </simpara>
+  <simpara>
+    “Incorporate” means to publish or republish a Document, in
+    whole or in part, as part of another Document.
+  </simpara>
+  <simpara>
+    An MMC is “eligible for relicensing” if it is licensed under
+    this License, and if all works that were first published under this
+    License somewhere other than this MMC, and subsequently incorporated in
+    whole or in part into the MMC, (1) had no cover texts or invariant
+    sections, and (2) were thus incorporated prior to November 1, 2008.
+  </simpara>
+  <simpara>
+    The operator of an MMC Site may republish an MMC contained in the site
+    under CC-BY-SA on the same site at any time before August 1, 2009,
+    provided the MMC is eligible for relicensing.
+  </simpara>
+  <bridgehead id="addendum" renderas="sect2">
+    ADDENDUM: How to use this License for your documents
+  </bridgehead>
+  <simpara>
+    To use this License in a document you have written, include a copy of the
+    License in the document and put the following copyright and license
+    notices just after the title page:
+  </simpara>
+  <screen>Copyright © 2013 Joël Krähemann
+
+Permission is granted to copy, distribute and/or modify this document under the
+terms of the GNU Free Documentation License, Version 1.3 or any later version
+published by the Free Software Foundation; with no Invariant Sections, no
+Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in
+the section entitled “GNU Free Documentation License”.</screen>
+  <simpara>
+    If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
+    replace the “with… Texts.” line with this:
+  </simpara>
+  <screen>with the Invariant Sections being LIST THEIR TITLES, with the Front-Cover Texts
+being LIST, and with the Back-Cover Texts being LIST.</screen>
+  <simpara>
+    If you have Invariant Sections without Cover Texts, or some other
+    combination of the three, merge those two alternatives to suit the
+    situation.
+  </simpara>
+  <simpara>
+    If your document contains nontrivial examples of program code, we
+    recommend releasing these examples in parallel under your choice of free
+    software license, such as the GNU General Public License, to permit their
+    use in free software.
+  </simpara>
+</appendix>
diff --git a/doc/images/ags-toolbar.png b/doc/images/ags-toolbar.png
new file mode 100644
index 0000000..5b922b2
Binary files /dev/null and b/doc/images/ags-toolbar.png differ
diff --git a/doc/images/ags_audio_preferences.png b/doc/images/ags_audio_preferences.png
new file mode 100644
index 0000000..138f0c0
Binary files /dev/null and b/doc/images/ags_audio_preferences.png differ
diff --git a/doc/images/ags_drum.png b/doc/images/ags_drum.png
new file mode 100644
index 0000000..a08a1c0
Binary files /dev/null and b/doc/images/ags_drum.png differ
diff --git a/doc/images/ags_export_window.png b/doc/images/ags_export_window.png
new file mode 100644
index 0000000..182792e
Binary files /dev/null and b/doc/images/ags_export_window.png differ
diff --git a/doc/images/ags_ffplayer.png b/doc/images/ags_ffplayer.png
new file mode 100644
index 0000000..bcb7bf3
Binary files /dev/null and b/doc/images/ags_ffplayer.png differ
diff --git a/doc/images/ags_generic_preferences.png b/doc/images/ags_generic_preferences.png
new file mode 100644
index 0000000..c513d1c
Binary files /dev/null and b/doc/images/ags_generic_preferences.png differ
diff --git a/doc/images/ags_ladspa_browser.png b/doc/images/ags_ladspa_browser.png
new file mode 100644
index 0000000..e8c9784
Binary files /dev/null and b/doc/images/ags_ladspa_browser.png differ
diff --git a/doc/images/ags_machine_properties-input.png b/doc/images/ags_machine_properties-input.png
new file mode 100644
index 0000000..e301172
Binary files /dev/null and b/doc/images/ags_machine_properties-input.png differ
diff --git a/doc/images/ags_machine_properties-link_input.png b/doc/images/ags_machine_properties-link_input.png
new file mode 100644
index 0000000..b4e31af
Binary files /dev/null and b/doc/images/ags_machine_properties-link_input.png differ
diff --git a/doc/images/ags_machine_properties-output.png b/doc/images/ags_machine_properties-output.png
new file mode 100644
index 0000000..6b57eb7
Binary files /dev/null and b/doc/images/ags_machine_properties-output.png differ
diff --git a/doc/images/ags_machine_properties-resize_channels.png b/doc/images/ags_machine_properties-resize_channels.png
new file mode 100644
index 0000000..851c48b
Binary files /dev/null and b/doc/images/ags_machine_properties-resize_channels.png differ
diff --git a/doc/images/ags_matrix.png b/doc/images/ags_matrix.png
new file mode 100644
index 0000000..436cce1
Binary files /dev/null and b/doc/images/ags_matrix.png differ
diff --git a/doc/images/ags_mixer.png b/doc/images/ags_mixer.png
new file mode 100644
index 0000000..187185d
Binary files /dev/null and b/doc/images/ags_mixer.png differ
diff --git a/doc/images/ags_navigation.png b/doc/images/ags_navigation.png
new file mode 100644
index 0000000..65ea10c
Binary files /dev/null and b/doc/images/ags_navigation.png differ
diff --git a/doc/images/ags_panel.png b/doc/images/ags_panel.png
new file mode 100644
index 0000000..a2b0830
Binary files /dev/null and b/doc/images/ags_panel.png differ
diff --git a/doc/images/ags_performance_preferences.png b/doc/images/ags_performance_preferences.png
new file mode 100644
index 0000000..15ef9ea
Binary files /dev/null and b/doc/images/ags_performance_preferences.png differ
diff --git a/doc/images/ags_server_preferences.png b/doc/images/ags_server_preferences.png
new file mode 100644
index 0000000..cd64304
Binary files /dev/null and b/doc/images/ags_server_preferences.png differ
diff --git a/doc/images/ags_synth.png b/doc/images/ags_synth.png
new file mode 100644
index 0000000..752fc16
Binary files /dev/null and b/doc/images/ags_synth.png differ
diff --git a/doc/usersBook.xml b/doc/usersBook.xml
new file mode 100644
index 0000000..231587e
--- /dev/null
+++ b/doc/usersBook.xml
@@ -0,0 +1,43 @@
+<?xml version='1.0' encoding="utf-8"?>
+<!DOCTYPE book [
+<!ENTITY jkraehemann "Joël Krähemann">
+<!ENTITY bookpath ".">
+]>
+<book xmlns="http://docbook.org/ns/docbook"
+      xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0">
+  <title>Advanced Gtk+ Sequencer</title>
+  <subtitle>User's Handbook</subtitle>
+
+  <info>
+      <legalnotice>
+	<para>
+	  Copyright (C)  &jkraehemann;.
+	  Permission is granted to copy, distribute and/or modify this document
+	  under the terms of the GNU Free Documentation License, Version 1.3
+	  or any later version published by the Free Software Foundation;
+	  with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+	  A copy of the license is included in the section entitled "GNU
+	  Free Documentation License".
+	</para>
+      </legalnotice>
+      <author>
+	<personname>
+	  <firstname>Joël</firstname>
+	  <surname>Krähemann</surname>
+	</personname>
+      </author>
+  </info>
+
+  <dedication>
+    <para>This book is dedicated to my father †Hans-Jörg Krähemann.</para>
+  </dedication>
+
+  <xi:include href="&bookpath;/usersBook/preface.xml"/>
+  <xi:include href="&bookpath;/usersBook/chap1.xml"/> <!--menubar -->
+  <xi:include href="&bookpath;/usersBook/chap2.xml"/> <!-- machines/engines -->
+  <xi:include href="&bookpath;/usersBook/chap3.xml"/> <!-- editor -->
+  <xi:include href="&bookpath;/usersBook/chap4.xml"/> <!--navigation -->
+  <xi:include href="&bookpath;/appa.xml"/>
+  <xi:include href="&bookpath;/usersBook/appb.xml"/>
+
+</book>
diff --git a/doc/usersBook/appb.xml b/doc/usersBook/appb.xml
new file mode 100644
index 0000000..d6bdac7
--- /dev/null
+++ b/doc/usersBook/appb.xml
@@ -0,0 +1,7 @@
+<?xml version='1.0' encoding="utf-8"?>
+<appendix>
+  <title>Resources</title>
+  <para>
+    <!-- TODO:JK: write some content -->
+  </para>
+</appendix>
diff --git a/doc/usersBook/chap1.xml b/doc/usersBook/chap1.xml
new file mode 100644
index 0000000..580dd14
--- /dev/null
+++ b/doc/usersBook/chap1.xml
@@ -0,0 +1,168 @@
+<?xml version='1.0' encoding="utf-8"?>
+<!DOCTYPE book [
+<!ENTITY ags "Advanced Gtk+ Sequencer">
+]>
+<chapter xmlns="http://docbook.org/ns/docbook" version="5.0">
+  <title>The menubar</title>
+  <para>
+    Within the mainbar you may do basic tasks like open/close files or show this help. In this section we cover
+    briefly the the different entries.
+  </para>
+
+  <sect1>
+    <title>File</title>
+    <para>
+      The file menu lets you do maintenance related to files or quit application.
+    </para>
+
+    <itemizedlist mark="bullet">
+      <listitem>
+	<para>
+	  Open - open an &ags; XML file.
+	</para>
+      </listitem>
+      <listitem>
+	<para>
+	  Save - save your current work.
+	</para>
+      </listitem>
+      <listitem>
+	<para>
+	  Save as - save your current work as a different filename.
+	</para>
+      </listitem>
+      <listitem>
+	<para>
+	  Export - export to PCM audio file.
+	</para>
+      </listitem>
+      <listitem>
+	<para>
+	  Quit - leave &ags;.
+	</para>
+      </listitem>
+    </itemizedlist>
+
+    <sect2>
+      <title>Export to PCM audio file</title>
+      <imagedata fileref="../images/ags_export_window.png" />
+      <para>
+	This shows you the export dialog. You may select filename to export to and duration of the exported track. BPM adjustment
+	is take from the navigation. Basically &ags; exports what you hear of the speakers.
+      </para>
+      <para>
+	With the export toggle button you can start exporting to PCM audio file or stop it at an arbitrary time.
+      </para>
+    </sect2>
+  </sect1>
+
+  <sect1>
+    <title>Edit</title>
+    <para>
+      The edit menu lets you add/remove audio machines or open preferences dialog.
+    </para>
+
+    <itemizedlist mark="bullet">
+      <listitem>
+	<para>
+	  Add - select of different machines
+	</para>
+
+	<itemizedlist mark="bullet">
+	  <listitem>
+	    <para>
+	      Panel - acts as your default sink.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Mixer - enables you to bundle your different output engines.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Drum - is used to do pattern editing using PCM audio files. 
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Matrix - is used to pattern editing, intended to be linked against Synth.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      Synth - is a software synthesizer.
+	    </para>
+	  </listitem>
+	  <listitem>
+	    <para>
+	      FFPlayer - may be used to open Soundfont2 audio file container format.
+	    </para>
+	  </listitem>
+	</itemizedlist>
+	
+      </listitem>
+      <listitem>
+	<para>
+	  Remove - the focused machine.
+	</para>
+      </listitem>
+      <listitem>
+	<para>
+	  Preferences - open preferences dialog.
+	</para>
+      </listitem>
+    </itemizedlist>
+
+    <sect2>
+      <title>Preferences dialog</title>
+      <para>
+	Within preferences dialog you may choose between different topics. For each one one tab.
+      </para>
+
+      <sect3>
+	<title>Generic</title>
+	<imagedata fileref="../images/ags_generic_preferences.png" />
+	<para>
+	  The autosave thread option enables auto-saving to $HOME/.gsequencer directory.
+	</para>
+      </sect3>
+
+      <sect3>
+	<title>Audio</title>
+	<imagedata fileref="../images/ags_audio_preferences.png" />
+	<para>
+	  Sound card is your physical devices to do playback.
+	</para>
+	<para>
+	  Audio channels specifies the audio channels to allocate for output device.
+	</para>
+	<para>
+	  Samplerate affects the entire project. Your audio files have to be at very same rate further
+	  your device has to support the given rate.
+	</para>
+	<para>
+	  Buffer size is used for all audio buffers. Your soundcard has to support the passed buffer size.
+	</para>
+      </sect3>
+
+      <sect3>
+	<title>Performance</title>
+	<imagedata fileref="../images/ags_performance_preferences.png" />
+	<para>
+	  Auto-sense on stream is required for certain LADSPA plugins but may cause additional performance losses.
+	</para>
+      </sect3>
+
+      <sect3>
+	<title>Server</title>
+	<imagedata fileref="../images/ags_server_preferences.png" />
+	<para>
+	  Ignored for now.
+	</para>
+      </sect3>
+
+    </sect2>
+  </sect1>
+
+</chapter>
diff --git a/doc/usersBook/chap2.xml b/doc/usersBook/chap2.xml
new file mode 100644
index 0000000..2ec0df5
--- /dev/null
+++ b/doc/usersBook/chap2.xml
@@ -0,0 +1,138 @@
+<?xml version='1.0' encoding="utf-8"?>
+<chapter xmlns="http://docbook.org/ns/docbook" version="5.0">
+  <title>Engines</title>
+  <para>
+    You can add engines by activating the appropriate menu item within
+    the "add" submenu of the "edit" menu item. You may change the properties
+    of an engine by opening the properties dialog from the context menu.
+    From the context menu you may perform some other tasks, too.
+  </para>
+  <itemizedlist mark="bullet">
+    <listitem>
+      <para>
+	To move up or down an engine open context menu and activate "up"
+	respectively "down" entry.
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+	To show or hide an engine open context menu and activate "show"
+	respectively "hide" entry. Note the engines won't be hidden entirely
+	they are just collapsed.
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+	To rename an engine open context menu and activate "rename" entry.
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+	To remove an engine open context menu and activate "destroy" entry.
+      </para>
+    </listitem>
+    <listitem>
+      <para>
+	To open properties dialog open context menu and activate "properties"
+	entry.
+      </para>
+    </listitem>
+  </itemizedlist>
+
+  <sect1>
+    <title>Machine Properties</title>
+    <para>
+      Within properties dialog you can link lines or add effects and adjust audio-channels/pads.
+    </para>
+    
+    <sect2>
+      <imagedata fileref="../images/ags_machine_properties-output.png" />
+      <para>
+	The output tab lets you mainly perform linking and adding effects.
+      </para>
+    </sect2>
+
+    <sect2>
+      <imagedata fileref="../images/ags_machine_properties-input.png" />
+      <para>
+	The input tab does the same as output tab in view of input lines.
+      </para>
+    </sect2>
+
+    <sect2>
+      <imagedata fileref="../images/ags_machine_properties-link_input.png" />
+      <para>
+	Do linking in batch mode.
+      </para>
+    </sect2>
+
+    <sect2>
+      <imagedata fileref="../images/ags_machine_properties-resize_channels.png" />
+      <para>
+	Adjust audio channels or input/output pads.
+      </para>
+    </sect2>
+
+    <sect2>
+      <imagedata fileref="../images/ags_ladspa_browser.png" />
+      <para>
+	The LADSPA browser gives you choice of available LADSPA plugin. It lets you modify
+	the controls to be used.
+      </para>
+    </sect2>
+    
+  </sect1>
+
+  <sect1>
+    <title>Panel</title>
+    <imagedata fileref="../images/ags_panel.png" />
+    <para>
+      The panel is used to output to your soundcard.
+    </para>
+  </sect1>
+
+  <sect1>
+    <title>Mixer</title>
+    <imagedata fileref="../images/ags_mixer.png" />
+    <para>
+      Bundle audio lines with the mixer and perform toplevel stream manipulation.
+    </para>
+  </sect1>
+
+  <sect1>
+    <title>Drum</title>
+    <imagedata fileref="../images/ags_drum.png" />
+    <para>
+      Produce an audio stream by defining a pattern. The drum supports opening
+      audio files and associate to its input.
+    </para>
+  </sect1>
+
+  <sect1>
+    <title>Matrix</title>
+    <imagedata fileref="../images/ags_matrix.png" />
+    <para>
+      Produce an audio stream by defining a pattern. The matrix itselves doesn't
+      have any audio signals on its own input you may rather link it to a synth
+      engine.
+    </para>
+  </sect1>
+
+  <sect1>
+    <title>Synth</title>
+    <imagedata fileref="../images/ags_synth.png" />
+    <para>
+      Produce audio data using its oscillators. The count of oscillators depends on number of
+      input lines.
+    </para>
+  </sect1>
+
+  <sect1>
+    <title>FFPlayer</title>
+    <imagedata fileref="../images/ags_ffplayer.png" />
+    <para>
+      Produce audio data by opening Soundfont2 audio file container format.
+    </para>
+  </sect1>
+
+</chapter>
diff --git a/doc/usersBook/chap3.xml b/doc/usersBook/chap3.xml
new file mode 100644
index 0000000..9a6c2ac
--- /dev/null
+++ b/doc/usersBook/chap3.xml
@@ -0,0 +1,104 @@
+<?xml version='1.0' encoding="utf-8"?>
+<!DOCTYPE book [
+<!ENTITY indexMenuIcon "/usr/share/icons/Adwaita/32x32/actions/system-run.png">
+<!ENTITY cursorIcon "/usr/share/icons/Adwaita/32x32/actions/go-jump.png">
+<!ENTITY notesIcon "/usr/share/icons/Adwaita/32x32/mimetypes/audio-x-generic.png">
+<!ENTITY deleteIcon "/usr/share/icons/Adwaita/32x32/actions/edit-clear-all.png">
+<!ENTITY selectIcon "/usr/share/icons/Adwaita/32x32/actions/edit-select-all.png">
+<!ENTITY copyIcon "/usr/share/icons/Adwaita/32x32/actions/edit-copy.png">
+<!ENTITY cutIcon "/usr/share/icons/Adwaita/32x32/actions/edit-cut.png">
+<!ENTITY pasteIcon "/usr/share/icons/Adwaita/32x32/actions/edit-paste.png">
+]>
+<chapter xmlns="http://docbook.org/ns/docbook" version="5.0">
+  <title>Editor</title>
+  <para>
+    The editor features a piano roll. After linking an editor index with an enginge
+    You may perform tasks like adding notes or copy, cut and paste them. You may
+    change view segmentation, too.
+  </para>
+
+  <sect1>
+    <title>Linking</title>
+    <para>
+      Before you might perform any task with the editor you have to link engines
+      by adding an index. Then you should link it with an engine. That can all be
+      done by using the menu button <imagedata fileref="&indexMenuIcon;" /> of the
+      index list.
+    </para>
+  </sect1>
+
+  <sect1>
+    <title>Toolbar</title>
+    <imagedata fileref="../images/ags-toolbar.png" />
+    <para>
+      In the table below are the various buttons explained you may use for editing.
+    </para>
+    <table>
+      <title>AGS editor toolbar controls table.</title>
+      <tgroup cols="3" align="left" colsep='1' rowsep='1'>
+	<thead>
+	  <row>
+	    <entry>icon</entry>
+	    <entry>action</entry>
+	    <entry>description</entry>
+	  </row>
+	</thead>
+	<tbody>
+	  <row>
+	    <entry><imagedata fileref="&cursorIcon;" /></entry>
+	    <entry>cursor</entry>
+	    <entry>
+	      You may want to set the cursor to paste notes at the position where it
+	      is located.
+	    </entry>
+	  </row>
+	  <row>
+	    <entry><imagedata fileref="¬esIcon;" /></entry>
+	    <entry>notes</entry>
+	    <entry>
+	      Add notes by clicking within the piano roll and move to till them having
+	      the wished duration.
+	    </entry>
+	  </row>
+	  <row>
+	    <entry><imagedata fileref="&deleteIcon;" /></entry>
+	    <entry>delete</entry>
+	    <entry>
+	      Delete notes by clicking on the note you don't want anymore.
+	    </entry>
+	  </row>
+	  <row>
+	    <entry><imagedata fileref="&selectIcon;" /></entry>
+	    <entry>select</entry>
+	    <entry>
+	      Select notes to copy or cut them.
+	    </entry>
+	  </row>
+	  <row>
+	    <entry><imagedata fileref="©Icon;" /></entry>
+	    <entry>copy</entry>
+	    <entry>
+	      Copy notes to the clipboard.
+	    </entry>
+	  </row>
+	  <row>
+	    <entry><imagedata fileref="&cutIcon;" /></entry>
+	    <entry>cut</entry>
+	    <entry>
+	      Cut notes to the clipboard.
+	    </entry>
+	  </row>
+	  <row>
+	    <entry><imagedata fileref="&pasteIcon;" /></entry>
+	    <entry>paste</entry>
+	    <entry>
+	      Paste the previously copied or cutted notes at the cursor position or
+	      just insert them where they are/were located. 
+	    </entry>
+	  </row>
+	</tbody>
+      </tgroup>
+    </table>
+  </sect1>
+
+</chapter>
diff --git a/doc/usersBook/chap4.xml b/doc/usersBook/chap4.xml
new file mode 100644
index 0000000..34dc5b4
--- /dev/null
+++ b/doc/usersBook/chap4.xml
@@ -0,0 +1,86 @@
+<?xml version='1.0' encoding="utf-8"?>
+<!DOCTYPE book [
+<!ENTITY backwardIcon "/usr/share/icons/Adwaita/32x32/actions/media-skip-backward.png">
+<!ENTITY previousIcon "/usr/share/icons/Adwaita/32x32/actions/media-seek-backward.png">
+<!ENTITY playIcon "/usr/share/icons/Adwaita/32x32/actions/media-playback-start.png">
+<!ENTITY stopIcon "/usr/share/icons/Adwaita/32x32/actions/media-playback-stop.png">
+<!ENTITY nextIcon "/usr/share/icons/Adwaita/32x32/actions/media-seek-forward.png">
+<!ENTITY forwardIcon "/usr/share/icons/Adwaita/32x32/actions/media-skip-forward.png">
+]>
+<chapter xmlns="http://docbook.org/ns/docbook" version="5.0">
+  <title>The navigation</title>
+  <imagedata fileref="../images/ags_navigation.png" />
+  <para>
+    With the navigation you have overall control of your song. Settings you perform
+    here may influence the behaviour of AGS.
+  </para>
+
+  <sect1>
+    <title>BPM</title>
+    <para>
+      The beats per minute (BPM for short) indicates the velocity of a song being
+      played. To adjust the BPM of the project in-/decrement the spinner labeled
+      with bpm. To edit patterns or notes at a more granular rate select the wished
+      tact within the appropriate engine or editor.
+    </para>
+    <para>
+      To calculate timings you divide 1 minute with the entered BPM and divide it
+      with basic. For example you have a BPM rate of 120 and a 4/4 tact you would
+      calculate the timing as follow:
+    </para>
+    <equation>
+      <mathphrase>t = 1 / 120 * (1 / 4)</mathphrase>
+    </equation>
+  </sect1>
+
+  <sect1>
+    <title>Playback controls</title>
+    <para>
+      With these controls you can play/stop a song or seek to the wished position.
+    </para>
+    <table>
+      <title>AGS playback controls table</title>
+      <tgroup cols="3" align="left" colsep='1' rowsep='1'>
+	<thead>
+	  <row>
+	    <entry>icon</entry>
+	    <entry>action</entry>
+	    <entry>description</entry>
+	  </row>
+	</thead>
+	<tbody>
+	  <row>
+	    <entry><imagedata fileref="&backwardIcon;" /></entry>
+	    <entry>backward</entry>
+	    <entry>Seeking back until it's pressed again.</entry>
+	  </row>
+	  <row>
+	    <entry><imagedata fileref="&previousIcon;" /></entry>
+	    <entry>previous</entry>
+	    <entry>Seeking back until it's not pressed anymore.</entry>
+	  </row>
+	  <row>
+	    <entry><imagedata fileref="&playIcon;" /></entry>
+	    <entry>play</entry>
+	    <entry>Starts the engines and the piano roll.</entry>
+	  </row>
+	  <row>
+	    <entry><imagedata fileref="&stopIcon;" /></entry>
+	    <entry>stop</entry>
+	    <entry>Stops the engines and the piano roll.</entry>
+	  </row>
+	  <row>
+	    <entry><imagedata fileref="&nextIcon;" /></entry>
+	    <entry>next</entry>
+	    <entry>Seeking forward until it's not pressed anymore.</entry>
+	  </row>
+	  <row>
+	    <entry><imagedata fileref="&forwardIcon;" /></entry>
+	    <entry>forward</entry>
+	    <entry>Seeking forward until it's pressed again.</entry>
+	  </row>
+	</tbody>
+      </tgroup>
+    </table>
+  </sect1>
+</chapter>
diff --git a/doc/usersBook/preface.xml b/doc/usersBook/preface.xml
new file mode 100644
index 0000000..1fa6716
--- /dev/null
+++ b/doc/usersBook/preface.xml
@@ -0,0 +1,34 @@
+<?xml version='1.0' encoding="utf-8"?>
+<!DOCTYPE book [
+<!ENTITY win98 "Microsoft Windows 98">
+<!ENTITY java2 "Sun Microsystem's Java 1.2">
+<!ENTITY n160 "Compaq Evo n160">
+<!ENTITY stallman "Richard Stallman">
+<!ENTITY ags "Advanced Gtk+ Sequencer">
+]>
+<preface>
+  <title>Foreword</title>
+  <para>
+    When I started to use GNU/Linux in 2001 I missed only one thing. A sequencer with a
+    nice GUI. There was already rosegarden available. But who didn't get stuck of midi
+    setup, yet? The time before I was using free software and became an affiliate to its
+    community I was using &win98; on my father's desktop computer and did my first steps
+    in &java2;.
+  </para>
+  <para>
+    My very first own Notebook was a &n160; and it's preinstalled &win98; had to vanish
+    because I became a fellow of &stallman;. Soon, I begun to code and older I became my
+    demands to ags increased. I developed the concept of the underlying audio library
+    myself as not graduated college student.
+  </para>
+  <para>
+    October 2005, I decided to reimplement &ags; from scratch in order to get rid of
+    inherited burden. And it was one big development process until I was almost satisfied
+    with it's design. There was a time in 2007 where I even wanted to replace GObject and
+    Gtk+ dependencies with my own libraries I begun to develop. I'm glad of didn't doing
+    so.
+  </para>
+  <para>
+    Thank you!
+  </para>
+</preface>
diff --git a/ags.1 b/midi2xml.1
similarity index 63%
copy from ags.1
copy to midi2xml.1
index e69afbb..69da606 100644
--- a/ags.1
+++ b/midi2xml.1
@@ -1,15 +1,15 @@
 '\" t
 .\"     Title: 
-      ags
+      midi2xml
     
 .\"    Author: [see the "AUTHOR" section]
 .\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
 .\"      Date: 2015-06-15
-.\"    Manual: ags v0.4.2
-.\"    Source: ags v0.4.2
+.\"    Manual: midi2xml v0.4.2
+.\"    Source: midi2xml v0.4.2
 .\"  Language: English
 .\"
-.TH "AGS" "1" "2015\-06\-15" "ags v0.4.2" "ags v0.4.2"
+.TH "MIDI2XML" "1" "2015\-06\-15" "midi2xml v0.4.2" "midi2xml v0.4.2"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -30,33 +30,24 @@
 .\" * MAIN CONTENT STARTS HERE *
 .\" -----------------------------------------------------------------
 .SH "NAME"
-ags \- Advanced Gtk+ Sequencer is an audio sequencer and composition editor
+midi2xml \- midi2xml converts your MIDI files to XML format
 .SH "SYNOPSIS"
-.HP \w'\fB/usr/bin/ags\fR\ 'u
-\fB/usr/bin/ags\fR [\-\-help] [\-\-version] [\-\-single\-thread] [\-\-filename\ \fIfile\fR...]
+.HP \w'\fB/usr/bin/midi2xml\fR\ 'u
+\fB/usr/bin/midi2xml\fR [\-\-help] [\-\-version] [file]
 .SH "DESCRIPTION"
 .PP
-Advanced GTK+ Sequencer is intended to use for music composition\&. It features a piano roll, as well a synth, matrix editor, drum machine, soundfont2 player, mixer and an output panel\&. It\(cqs designed to be highly configurable\&. You may add effects to its effect chain; and add or remove audio channels/pads\&. You may set up a fully functional network of engines, thus there is a link editor for linking audio lines\&.
-.PP
-LADSPA support has been added to version 0\&.4\&.2 as well export to WAV audio file\&.
-.PP
-\&...
+midi2xml takes your MIDI file from command line and outputs the resulting XML to stdout\&.
 .SH "OPTIONS"
 .PP
 The program follows the usual GNU command line syntax, with long options starting with two dashes (`\-\*(Aq)\&. A summary of options is included below\&. For a complete description, see the
 \fBinfo\fR(1)
 files\&.
 .PP
-\fB\-\-filename file\fR
+\fBfile\fR
 .RS 4
 Open file from command line\&.
 .RE
 .PP
-\fB\-\-single\-thread\fR
-.RS 4
-Run in single thread mode\&.
-.RE
-.PP
 \fB\-\-help\fR
 .RS 4
 Show summary of options\&.

-- 
gsequencer packaging



More information about the pkg-multimedia-commits mailing list