Author: bnickel
Date: 2008-01-02 21:43:28 -0500 (Wed, 02 Jan 2008)
New Revision: 92148
Added:
trunk/taglib-sharp/docs/Package.en.xml
Removed:
trunk/taglib-sharp/docs/en/
Modified:
trunk/taglib-sharp/ChangeLog
trunk/taglib-sharp/docs/Makefile.am
trunk/taglib-sharp/src/Makefile.am
Log:
2008-01-02 Brian Nickel <[EMAIL PROTECTED]>
* src/Makefile.am: Generate taglib-sharp-docs.xml when building docs.
* docs/en/: Deleted. Will be replaced with autogeneration after this
update.
* docs/Makefile.am: Add docs/Packages.en.xml do DIST_EXTRA
* docs/Package.en.xml: Contains values not in slashdocs.
Modified: trunk/taglib-sharp/ChangeLog
===================================================================
--- trunk/taglib-sharp/ChangeLog 2008-01-03 02:42:19 UTC (rev 92147)
+++ trunk/taglib-sharp/ChangeLog 2008-01-03 02:43:28 UTC (rev 92148)
@@ -1,5 +1,14 @@
2008-01-02 Brian Nickel <[EMAIL PROTECTED]>
+ * src/Makefile.am: Generate taglib-sharp-docs.xml when building docs.
+ * docs/en/: Deleted. Will be replaced with autogeneration after this
+ update.
+
+ * docs/Makefile.am: Add docs/Packages.en.xml do DIST_EXTRA
+ * docs/Package.en.xml: Contains values not in slashdocs.
+
+2008-01-02 Brian Nickel <[EMAIL PROTECTED]>
+
* src/TagLib/CombinedTag.cs:
* src/TagLib/ByteVectorList.cs:
* src/TagLib/Id3v1/Tag.cs:
Modified: trunk/taglib-sharp/docs/Makefile.am
===================================================================
--- trunk/taglib-sharp/docs/Makefile.am 2008-01-03 02:42:19 UTC (rev 92147)
+++ trunk/taglib-sharp/docs/Makefile.am 2008-01-03 02:43:28 UTC (rev 92148)
@@ -28,9 +28,6 @@
mkdir taglib-sharp-web-docs; \
monodocs2html --source en --dest taglib-sharp-web-docs;
-update-slashdoc:
- monodocs2slashdoc en;
-
taglib-sharp-docs.zip taglib-sharp-docs.tree: $(srcdir)/en/*/*.xml
$(srcdir)/en/*.xml
$(DOC_ASSEMBLER) $(srcdir)/en
@@ -45,7 +42,8 @@
$(srcdir)/en/*.xml \
$(srcdir)/en/*/*.xml \
taglib-sharp-docs.source \
- MonodocNodeConfig.cs
+ MonodocNodeConfig.cs \
+ Package.en.xml
DISTCLEANFILES = \
taglib-sharp-docs.zip \
Added: trunk/taglib-sharp/docs/Package.en.xml
===================================================================
--- trunk/taglib-sharp/docs/Package.en.xml 2008-01-03 02:42:19 UTC (rev
92147)
+++ trunk/taglib-sharp/docs/Package.en.xml 2008-01-03 02:43:28 UTC (rev
92148)
@@ -0,0 +1,135 @@
+<Package>
+ <Overview>
+ <Title>TagLib#</Title>
+ <Remarks>This package provides support for reading and writing
+ the tagging information for a large number of tagging formats,
+ as well as reading media properties for many standard audio and
+ video formats.</Remarks>
+ <Copyright>Copyright (C) 2007-2008 Brian Nickel</Copyright>
+ </Overview>
+ <Namespace Name="TagLib">
+ <Docs>
+ <summary>TagLib provides a generic interface for reading
+ media properties and editing tags on different audio and
+ video files.</summary>
+ <remarks>The most straightforward way to read a file is
+ through <see cref="M:TagLib.File.Create(System.String)"
+ />, which does type detection to create the correct <see
+ cref="T:TagLib.File" />.</remarks>
+ </Docs>
+ </Namespace>
+ <Namespace Name="TagLib.Ape">
+ <Docs>
+ <summary><para>The TagLib.Ape namespace contains classes
+ for handling the reading APE tags.</para></summary>
+ <remarks><para>See
+ http://wiki.hydrogenaudio.org/index.php?title=APEv2 for
+ the complete specification.</para></remarks>
+ </Docs>
+ </Namespace>
+ <Namespace Name="TagLib.Asf">
+ <Docs>
+ <summary>The TagLib.Asf namespace contains classes for
+ handling the Microsoft Advanced Systems Format file
+ format.</summary>
+ <remarks>See
+
http://www.microsoft.com/windows/windowsmedia/forpros/format/asfspec.aspx
+ for the complete specification.</remarks>
+ </Docs>
+ </Namespace>
+ <Namespace Name="TagLib.Flac">
+ <Docs>
+ <summary>The TagLib.Flac namespace contains classes for
+ handling the Xiph FLAC file format.</summary>
+ <remarks>See http://flac.sourceforge.net/format.html for
+ the complete specification.</remarks>
+ </Docs>
+ </Namespace>
+ <Namespace Name="TagLib.Id3v1">
+ <Docs>
+ <summary>The TagLib.Id3v1 namespace contains classes for
+ handling the ID3v1.1 tagging format.</summary>
+ <remarks>See http://www.id3.org/ID3v1 for the complete
+ specification.</remarks>
+ </Docs>
+ </Namespace>
+ <Namespace Name="TagLib.Id3v2">
+ <Docs>
+ <summary>The TagLib.Id3v2 namespace contains classes for
+ handling the ID3v2 tagging format.</summary>
+ <remarks>See http://www.id3.org/Developer_Information
+ for the complete specification.</remarks>
+ </Docs>
+ </Namespace>
+ <Namespace Name="TagLib.Mpeg4">
+ <Docs>
+ <summary>The TagLib.Mpeg4 namespace contains classes for
+ handling the MPEG-4 file format.</summary>
+ <remarks>See
+
http://standards.iso.org/ittf/PubliclyAvailableStandards/c041828_ISO_IEC_14496-12_2005(E).zip
+ for the complete specification.</remarks>
+ </Docs>
+ </Namespace>
+ <Namespace Name="TagLib.Mpeg">
+ <Docs>
+ <summary>The TagLib.Mpeg namespace contains classes for handling
+ MPEG-1/2 files and MPEG audio files.</summary>
+ <remarks />
+ </Docs>
+ </Namespace>
+ <Namespace Name="TagLib.MusePack">
+ <Docs>
+ <summary>The TagLib.MusePack namespace contains classes for
+ handling the MusePack file format.</summary>
+ <remarks>See http://www.musepack.net/ for the complete
+ specification.</remarks>
+ </Docs>
+ </Namespace>
+ <Namespace Name="TagLib.NonContainer">
+ <Docs>
+ <summary>The TagLib.NonContainer namespace provides
+ classes for dealing with files that do not have a
+ standardized tagging mechanism and may have any number
+ of tags at their beginning or end.</summary>
+ <remarks>The FLAC file format is included in this
+ because despite having a standard tagging mechanism, ID3
+ and APE tags are not uncommonly attached to the
+ file.</remarks>
+ </Docs>
+ </Namespace>
+ <Namespace Name="TagLib.Ogg.Codecs">
+ <Docs>
+ <summary>The TagLib.Ogg.Codecs namespace contains
+ standard codecs used in Xiph Ogg files.</summary>
+ <remarks />
+ </Docs>
+ </Namespace>
+ <Namespace Name="TagLib.Ogg">
+ <Docs>
+ <summary>The TagLib.Ogg namespace contains classes for
+ handling the Xiph OGG file format.</summary>
+ <remarks>See http://www.xiph.org/ogg/ for the complete
+ specification.</remarks>
+ </Docs>
+ </Namespace>
+ <Namespace Name="TagLib.Riff">
+ <Docs>
+ <summary>The TagLib.Riff namespace contains all classes
+ relevant to the reading of Microsoft RIFF files. These
+ files include namely the WAV and AVI file
+ formats.</summary>
+ <remarks>See
+ http://msdn2.microsoft.com/en-us/library/ms779636.aspx
+ for information on the RIFF AVI format.</remarks>
+ </Docs>
+ </Namespace>
+ <Namespace Name="TagLib.WavPack">
+ <Docs>
+ <summary>The TagLib.WavPack namespace contains all
+ classes relevant to the reading of WavPack
+ files.</summary>
+ <remarks>See http://www.wavpack.com/ for the complete
+ specification.</remarks>
+ </Docs>
+ </Namespace>
+</Package>
Modified: trunk/taglib-sharp/src/Makefile.am
===================================================================
--- trunk/taglib-sharp/src/Makefile.am 2008-01-03 02:42:19 UTC (rev 92147)
+++ trunk/taglib-sharp/src/Makefile.am 2008-01-03 02:43:28 UTC (rev 92148)
@@ -2,6 +2,15 @@
ASSEMBLY = $(ASSEMBLY_NAME).dll
TARGET = $(ASSEMBLY)
+if BUILD_DOCS
+DOCFILE = taglib-sharp-docs.xml
+DOCFLAGS = /doc:$(DOCFILE) /warn:4
+else
+DOCFILE =
+DOCFLAGS =
+endif
+
+
CSC = $(MCS) $(MCS_FLAGS) $(CSFLAGS)
include $(srcdir)/TagLib/TagLib.sources
@@ -16,7 +25,7 @@
taglib_policy_configs_in = $(POLICIES:.dll=.config.in)
$(ASSEMBLY): $(TAGLIB_CSFILES) $(taglib_generated_sources) taglib-sharp.snk
- $(CSC) /target:library $(LIBFLAGS) /define:SIGN /out:$@
$(TAGLIB_CSFILES) $(taglib_generated_sources)
+ $(CSC) /target:library $(LIBFLAGS) $(DOCFLAGS) /define:SIGN /out:$@
$(TAGLIB_CSFILES) $(taglib_generated_sources)
policy.%.$(ASSEMBLY_NAME).dll: policy.%.$(ASSEMBLY_NAME).config
$(AL) al /link:$< /out:$@ /keyfile:taglib-sharp.snk
@@ -25,7 +34,7 @@
EXTRA_DIST = $(TAGLIB_CSFILES) $(taglib_sources_in)
$(taglib_policy_configs_in) taglib-sharp.mdp
DISTCLEANFILES = *.pidb
-CLEANFILES = $(ASSEMBLY) $(ASSEMBLY).mdb $(POLICIES) taglib-sharp.snk
+CLEANFILES = $(ASSEMBLY) $(ASSEMBLY).mdb $(POLICIES) taglib-sharp.snk
$(DOCFILE)
MAINTAINERCLEANFILES = Makefile.in
install-data-local:
_______________________________________________
Mono-patches maillist - [email protected]
http://lists.ximian.com/mailman/listinfo/mono-patches
