bump version
[fdkaac.git] / README
diff --git a/README b/README
index 70a2301a215e2c61a310128915c25d88793f12f0..007af3adfbfd2ee88a10618e3576bc073f86ffd8 100644 (file)
--- a/README
+++ b/README
@@ -4,11 +4,49 @@ fdkaac - command line frontend encoder for libfdk-aac
 
 Prerequisites
 -------------
-You need libfdk-aac, GNU autoconf and automake, and C compiler.
-On Posix environment, you will also need GNU gettext (for iconv.m4).
+You need libfdk-aac.
+On Posix environment, you will also need GNU gettext (for iconv.m4) and
+GNU autoconf/automake.
+
+How to build on Posix environment
+---------------------------------
+First, you need to build libfdk-aac and install on your system.
+Once you have done it, the following will do the task.
+(MinGW build can be done the same way, and doesn't require gettext/iconv)
 
-How to build
-------------
 $ autoreconf -i
-$ ./configure
-$ make
+$ ./configure && make && make install
+
+How to build on MSVC
+--------------------
+First you have to extract libfdk-aac source here, so that directory tree will
+look like the following:
++- fdk-aac ---+-documentation
+|             +-libAACdec
+|             +-libAACenc
+|             :
++- m4
++- missings
++- MSVC
++- src
+
+MSVC solution for Visual Studio 2010 is under MSVC directory.
+
+Tagging Options
+---------------
+Generic tagging options like --tag, --tag-from-file, --long-tag allows you
+to set arbitrary tags.
+Available tags and their fcc (four char code) for --tag and --tag-from-file
+can be found at http://code.google.com/p/mp4v2/wiki/iTunesMetadata
+
+For tags such as Artist where first char of fcc is copyright sign,
+you can skip first char and just say like --tag="ART:Foo Bar" or
+--tag-from-file=lyr:/path/to/your/lyrics.txt
+
+Currently, --tag-from-file just stores file contents into m4a without any
+character encoding / line terminater conversion.
+Therefore, only use UTF-8 (without BOM) when setting text tags by this option.
+
+On the other hand, --tag / --long-tag (and other command line arguments) are
+converted from locale character encoding to UTF-8 on Posix environment.
+On Windows, command line arguments are always treated as Unicode.
This page took 0.009852 seconds and 4 git commands to generate.