Skip to content

Commit

Permalink
2007-05-22 Brian Nickel <brian.nickel@gmail.com>
Browse files Browse the repository at this point in the history 
	* src/TagLib/Tag.cs: Make abstract.
	* src/TagLib/Mpc/File.cs: Make namespace "MusePack".
	* src/TagLib/Mpc/StreamHeader.cs: Convert to struct.
	* src/TagLib/File.cs: Store TagTypes as uint. Remove unused read styles.
	Add File.TagTypes and File.TagTypesOnDisk. Add CloseStream to 
	IFileAbstraction for SilverLight support.
	* src/TagLib/Riff/File.cs: Add TagTypes.
	* src/TagLib/ByteVectorList.cs: Remove ToByteVector()
	* src/TagLib/Id3v2/Tag.cs:
	* src/TagLib/Id3v2/Footer.cs:
	* src/TagLib/Id3v2/SynchData.cs:
	* src/TagLib/Id3v2/FrameFactory.cs:
	* src/TagLib/Id3v2/FrameHeader.cs:
	* src/TagLib/Id3v2/Header.cs:
	* src/TagLib/Id3v2/Frames/PlayCountFrame.cs:
	* src/TagLib/Id3v2/Frames/UnsynchronisedLyricsFrame.cs:
	* src/TagLib/Id3v2/Frames/RelativeVolumeFrame.cs:
	* src/TagLib/Id3v2/Frames/CommentsFrame.cs:
	* src/TagLib/Id3v2/Frames/SynchronizedLyricsFrame.cs:
	* src/TagLib/Id3v2/Frames/AttachedPictureFrame.cs:
	* src/TagLib/Id3v2/Frames/UniqueFileIdentifierFrame.cs:
	* src/TagLib/Id3v2/Frames/PrivateFrame.cs:
	* src/TagLib/Id3v2/Frames/GeneralEncapsulatedObjectFrame.cs:
	* src/TagLib/Id3v2/Frames/TextIdentificationFrame.cs:
	* src/TagLib/Id3v2/Frames/UnknownFrame.cs:
	* src/TagLib/Id3v2/Frame.cs: Significant refactoring. Use byte for 
	version. Use enums for header and frame flags. Use string for language.
	Unsupported frames and frame properties throw NotImplementedException.
	Added PlayCountFrame.
	* src/TagLib/Mpeg/XingHeader.cs: Make struct.
	* src/TagLib/Mpeg/File.cs:
	* src/TagLib/Mpeg/VideoHeader.cs: Make struct.
	* src/TagLib/Mpeg/AudioFile.cs:
	* src/TagLib/Mpeg/AudioHeader.cs: Make struct.
	* src/TagLib/Debugger.cs: Make internal.
	* src/TagLib/ByteVector.cs: Clean up constructors.
	* src/TagLib/IntList.cs: Clean up constructors.
	* src/TagLib/WavPack/StreamHeader.cs: Convert to struct.
	* src/TagLib/NonContainer/Tag.cs: Add TagTypes.
	* src/TagLib/NonContainer/File.cs: Add TagTypes.
	* src/TagLib/NonContainer/EndTag.cs: Add TagTypes.
	* src/TagLib/NonContainer/StartTag.cs: Add TagTypes.
	* src/TagLib/Ape/Tag.cs: 
	* src/TagLib/Ape/Footer.cs: Make struct. Use enum for flags.
	* src/TagLib/Flac/File.cs:
	* src/TagLib/Flac/BlockHeader.cs: Make struct.
	* src/TagLib/Flac/StreamHeader.cs: Make struct.
	* src/TagLib/StringList.cs: Clean up constructors.
	* src/TagLib/FileTypes.cs: Add support for registering types.
	* src/TagLib/Asf/File.cs: Add TagTypes.
	* src/TagLib/Asf/HeaderObject.cs:
	* src/TagLib/Asf/StreamPropertiesObject.cs:
	* src/TagLib/Asf/FilePropertiesObject.cs:
	* src/TagLib/Asf/ContentDescriptionObject.cs:
	* src/TagLib/Asf/Object.cs:
	* src/TagLib/Asf/Guid.cs: Use System.Guid.
	* src/TagLib/Asf/ContentDescriptor.cs: Use unsigned types.
	* src/TagLib/ListBase.cs: Clean up constructors.
	* src/TagLib/Mpeg4/File.cs: Add TagTypes.
	* src/TagLib/Ogg/GroupedComment.cs: Add IsEmpty.
	* src/TagLib/Ogg/File.cs: Add TagTypes.
	* src/TagLib/Ogg/Page.cs:
	* src/TagLib/Ogg/Paginator.cs:
	* src/TagLib/Ogg/Bitstream.cs:
	* src/TagLib/Ogg/PageHeader.cs: Make PageHeader a struct and add 
	PageFlags.
	* docs/en/*: Thousands more docs filled out.

svn path=/trunk/taglib-sharp/; revision=77818
  • Loading branch information
@bnickel
bnickel committed May 22, 2007
1 parent ca311e4 commit ac6636a
Show file tree
Hide file tree
Showing 153 changed files with 4,420 additions and 4,732 deletions.
70 changes: 70 additions & 0 deletions ChangeLog
View file
@@ -1,3 +1,73 @@
2007-05-22 Brian Nickel <brian.nickel@gmail.com>

* src/TagLib/Tag.cs: Make abstract.
* src/TagLib/Mpc/File.cs: Make namespace "MusePack".
* src/TagLib/Mpc/StreamHeader.cs: Convert to struct.
* src/TagLib/File.cs: Store TagTypes as uint. Remove unused read styles.
Add File.TagTypes and File.TagTypesOnDisk. Add CloseStream to
IFileAbstraction for SilverLight support.
* src/TagLib/Riff/File.cs: Add TagTypes.
* src/TagLib/ByteVectorList.cs: Remove ToByteVector()
* src/TagLib/Id3v2/Tag.cs:
* src/TagLib/Id3v2/Footer.cs:
* src/TagLib/Id3v2/SynchData.cs:
* src/TagLib/Id3v2/FrameFactory.cs:
* src/TagLib/Id3v2/FrameHeader.cs:
* src/TagLib/Id3v2/Header.cs:
* src/TagLib/Id3v2/Frames/PlayCountFrame.cs:
* src/TagLib/Id3v2/Frames/UnsynchronisedLyricsFrame.cs:
* src/TagLib/Id3v2/Frames/RelativeVolumeFrame.cs:
* src/TagLib/Id3v2/Frames/CommentsFrame.cs:
* src/TagLib/Id3v2/Frames/SynchronizedLyricsFrame.cs:
* src/TagLib/Id3v2/Frames/AttachedPictureFrame.cs:
* src/TagLib/Id3v2/Frames/UniqueFileIdentifierFrame.cs:
* src/TagLib/Id3v2/Frames/PrivateFrame.cs:
* src/TagLib/Id3v2/Frames/GeneralEncapsulatedObjectFrame.cs:
* src/TagLib/Id3v2/Frames/TextIdentificationFrame.cs:
* src/TagLib/Id3v2/Frames/UnknownFrame.cs:
* src/TagLib/Id3v2/Frame.cs: Significant refactoring. Use byte for
version. Use enums for header and frame flags. Use string for language.
Unsupported frames and frame properties throw NotImplementedException.
Added PlayCountFrame.
* src/TagLib/Mpeg/XingHeader.cs: Make struct.
* src/TagLib/Mpeg/File.cs:
* src/TagLib/Mpeg/VideoHeader.cs: Make struct.
* src/TagLib/Mpeg/AudioFile.cs:
* src/TagLib/Mpeg/AudioHeader.cs: Make struct.
* src/TagLib/Debugger.cs: Make internal.
* src/TagLib/ByteVector.cs: Clean up constructors.
* src/TagLib/IntList.cs: Clean up constructors.
* src/TagLib/WavPack/StreamHeader.cs: Convert to struct.
* src/TagLib/NonContainer/Tag.cs: Add TagTypes.
* src/TagLib/NonContainer/File.cs: Add TagTypes.
* src/TagLib/NonContainer/EndTag.cs: Add TagTypes.
* src/TagLib/NonContainer/StartTag.cs: Add TagTypes.
* src/TagLib/Ape/Tag.cs:
* src/TagLib/Ape/Footer.cs: Make struct. Use enum for flags.
* src/TagLib/Flac/File.cs:
* src/TagLib/Flac/BlockHeader.cs: Make struct.
* src/TagLib/Flac/StreamHeader.cs: Make struct.
* src/TagLib/StringList.cs: Clean up constructors.
* src/TagLib/FileTypes.cs: Add support for registering types.
* src/TagLib/Asf/File.cs: Add TagTypes.
* src/TagLib/Asf/HeaderObject.cs:
* src/TagLib/Asf/StreamPropertiesObject.cs:
* src/TagLib/Asf/FilePropertiesObject.cs:
* src/TagLib/Asf/ContentDescriptionObject.cs:
* src/TagLib/Asf/Object.cs:
* src/TagLib/Asf/Guid.cs: Use System.Guid.
* src/TagLib/Asf/ContentDescriptor.cs: Use unsigned types.
* src/TagLib/ListBase.cs: Clean up constructors.
* src/TagLib/Mpeg4/File.cs: Add TagTypes.
* src/TagLib/Ogg/GroupedComment.cs: Add IsEmpty.
* src/TagLib/Ogg/File.cs: Add TagTypes.
* src/TagLib/Ogg/Page.cs:
* src/TagLib/Ogg/Paginator.cs:
* src/TagLib/Ogg/Bitstream.cs:
* src/TagLib/Ogg/PageHeader.cs: Make PageHeader a struct and add
PageFlags.
* docs/en/*: Thousands more docs filled out.

2007-05-20 Brian Nickel <brian.nickel@gmail.com>

* src/TagLib/ByteVector.cs:
Expand Down
106 changes: 14 additions & 92 deletions docs/en/TagLib.Ape/Footer.xml
View file
@@ -1,23 +1,14 @@
<Type Name="Footer" FullName="TagLib.Ape.Footer">
<TypeSignature Language="C#" Value="public class Footer" />
<TypeSignature Language="C#" Value="public struct Footer" />
<AssemblyInfo>
<AssemblyName>taglib-sharp</AssemblyName>
<AssemblyVersion>1.9.0.0</AssemblyVersion>
</AssemblyInfo>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
<BaseTypeName>System.ValueType</BaseTypeName>
</Base>
<Interfaces />
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public Footer ();" />
<MemberType>Constructor</MemberType>
<Parameters />
<Docs>
<summary>Constructs and initializes a new instance of <see cref="T:TagLib.Ape.Footer" /> with the default values.</summary>
<remarks>This is used when creating an empty tag.</remarks>
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public Footer (TagLib.ByteVector data);" />
<MemberType>Constructor</MemberType>
Expand All @@ -30,20 +21,6 @@
<remarks />
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public Footer (TagLib.File file, long offset);" />
<MemberType>Constructor</MemberType>
<Parameters>
<Parameter Name="file" Type="TagLib.File" />
<Parameter Name="offset" Type="System.Int64" />
</Parameters>
<Docs>
<param name="file">A <see cref="T:TagLib.File" /> containing a header or footer to read.</param>
<param name="offset">A <see cref="T:System.Int64" /> specifying where to read from the file. It must be the position of either an APE header or footer.</param>
<summary>Constructs and initializes a new instance of <see cref="T:TagLib.Ape.Footer" /> by reading one from given position in a <see cref="T:TagLib.File" />.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName="FileIdentifier">
<MemberSignature Language="C#" Value="public static readonly TagLib.ByteVector FileIdentifier;" />
<MemberType>Field</MemberType>
Expand Down Expand Up @@ -81,37 +58,6 @@
<remarks />
</Docs>
</Member>
<Member MemberName="Parse">
<MemberSignature Language="C#" Value="protected void Parse (TagLib.ByteVector data);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="data" Type="TagLib.ByteVector" />
</Parameters>
<Docs>
<param name="data">A <see cref="T:TagLib.ByteVector" /> containing an APE header or footer.</param>
<summary>Sets values in the current instance by reading a header or footer block from a <see cref="T:TagLib.ByteVector" />.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName="Render">
<MemberSignature Language="C#" Value="protected TagLib.ByteVector Render (bool is_header);" />
<MemberType>Method</MemberType>
<ReturnValue>
<ReturnType>TagLib.ByteVector</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="is_header" Type="System.Boolean" />
</Parameters>
<Docs>
<param name="is_header">A <see cref="T:System.Boolean" /> specifying whether to render a header or a footer.</param>
<summary>Renders the current instance to a new <see cref="T:TagLib.ByteVector" />, either as a header or a footer, as specified.</summary>
<returns>A <see cref="T:TagLib.ByteVector" /> containing an APE Version 2 header or footer.</returns>
<remarks />
</Docs>
</Member>
<Member MemberName="Version">
<MemberSignature Language="C#" Value="public uint Version { get; };" />
<MemberType>Property</MemberType>
Expand All @@ -124,42 +70,6 @@
<remarks>The version will always be 2 for newly created tags and the all tags will be rendered in that format.</remarks>
</Docs>
</Member>
<Member MemberName="FooterPresent">
<MemberSignature Language="C#" Value="public bool FooterPresent { get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<summary>Gets whether or not a footer is present in the tag.</summary>
<value>A <see cref="T:System.Boolean" /> representing whether or not a footer is present in the tag. This should always be true.</value>
<remarks />
</Docs>
</Member>
<Member MemberName="IsHeader">
<MemberSignature Language="C#" Value="public bool IsHeader { get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<summary>Gets whether or not the current instance is actually a header.</summary>
<value>A <see cref="T:System.Boolean" /> representing whether or not a the current instance is a header.</value>
<remarks>The <see cref="T:TagLib.Ape.Footer" /> class is used for representing both headers and footers, which differ only in one bit.</remarks>
</Docs>
</Member>
<Member MemberName="HeaderPresent">
<MemberSignature Language="C#" Value="public bool HeaderPresent { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<summary>Gets and sets whether or not a footer is present in the tag.</summary>
<value>A <see cref="T:System.Boolean" /> representing whether or not a header is present in the tag.</value>
<remarks>Headers are mandatory for APE tags stored at the beginning of a file.</remarks>
</Docs>
</Member>
<Member MemberName="ItemCount">
<MemberSignature Language="C#" Value="public uint ItemCount { set; get; };" />
<MemberType>Property</MemberType>
Expand Down Expand Up @@ -208,6 +118,18 @@
<remarks />
</Docs>
</Member>
<Member MemberName="Flags">
<MemberSignature Language="C#" Value="public TagLib.Ape.FooterFlags Flags { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>TagLib.Ape.FooterFlags</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
</Docs>
</Member>
</Members>
<Docs>
<summary>This class is used to access and manipulate header and footer blocks used in the APE tagging format.</summary>
Expand Down
24 changes: 12 additions & 12 deletions docs/en/TagLib.Ape/Tag.xml
View file
Expand Up @@ -166,18 +166,6 @@ Otherwise, the values will be stored as "<paramref name="number" />/<paramref na
<remarks />
</Docs>
</Member>
<Member MemberName="Footer">
<MemberSignature Language="C#" Value="public TagLib.Ape.Footer Footer { get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>TagLib.Ape.Footer</ReturnType>
</ReturnValue>
<Docs>
<summary>Get the APE footer for the current instance.</summary>
<value>A <see cref="T:TagLib.Ape.Footer" /> containing information for the current instance.</value>
<remarks />
</Docs>
</Member>
<Member MemberName="AddValue">
<MemberSignature Language="C#" Value="public void AddValue (string key, string[] value);" />
<MemberType>Method</MemberType>
Expand Down Expand Up @@ -265,6 +253,18 @@ Otherwise, the values will be added as "<paramref name="number" />/<paramref nam
<remarks />
</Docs>
</Member>
<Member MemberName="HeaderPresent">
<MemberSignature Language="C#" Value="public bool HeaderPresent { set; get; };" />
<MemberType>Property</MemberType>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
</Docs>
</Member>
</Members>
<Docs>
<summary>This class is used to access and manipulate tags stored in the APE tagging format.</summary>
Expand Down
46 changes: 23 additions & 23 deletions docs/en/TagLib.Asf/ContentDescriptionObject.xml
View file
Expand Up @@ -17,19 +17,19 @@
<Parameter Name="position" Type="System.Int64" />
</Parameters>
<Docs>
<param name="file">To be added.</param>
<param name="position">To be added.</param>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<param name="file">A <see cref="T:TagLib.Asf.File" /> to read the object data from.</param>
<param name="position">A <see cref="T:System.Int64" /> specifying where in the file the object begins.</param>
<summary>Constructs and initialized a new instance of <see cref="T:TagLib.Asf.ContentDescriptionObject" /> by reading the contents from a file.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public ContentDescriptionObject ();" />
<MemberType>Constructor</MemberType>
<Parameters />
<Docs>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<summary>Constructs and initialized a new instance of <see cref="T:TagLib.Asf.ContentDescriptionObject" /> with no values.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName="Title">
Expand All @@ -39,9 +39,9 @@
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>Gets and sets the title of the current instance.</summary>
<value>A <see cref="T:System.String" /> containing the title of the current instance.</value>
<remarks />
</Docs>
</Member>
<Member MemberName="Author">
Expand All @@ -51,9 +51,9 @@
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>Gets and sets the author of the current instance.</summary>
<value>A <see cref="T:System.String" /> containing the author of the current instance.</value>
<remarks />
</Docs>
</Member>
<Member MemberName="Copyright">
Expand All @@ -63,9 +63,9 @@
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>Gets and sets the copyright of the current instance.</summary>
<value>A <see cref="T:System.String" /> containing the copyright of the current instance.</value>
<remarks />
</Docs>
</Member>
<Member MemberName="Description">
Expand All @@ -75,9 +75,9 @@
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>Gets and sets the description of the current instance.</summary>
<value>A <see cref="T:System.String" /> containing the description of the current instance.</value>
<remarks />
</Docs>
</Member>
<Member MemberName="Rating">
Expand All @@ -87,14 +87,14 @@
<ReturnType>System.String</ReturnType>
</ReturnValue>
<Docs>
<summary>To be added.</summary>
<value>To be added.</value>
<remarks>To be added.</remarks>
<summary>Gets and sets the rating of the current instance.</summary>
<value>A <see cref="T:System.String" /> containing the rating of the current instance.</value>
<remarks />
</Docs>
</Member>
</Members>
<Docs>
<summary>To be added.</summary>
<remarks>To be added.</remarks>
<summary>This class is for reading, writing, and manipulating ASF content description objects.</summary>
<remarks />
</Docs>
</Type>

0 comments on commit ac6636a

Please sign in to comment.