diff options
author | Sergey Poznyakoff <gray@gnu.org.ua> | 2011-08-01 11:07:53 +0300 |
---|---|---|
committer | Sergey Poznyakoff <gray@gnu.org.ua> | 2011-08-01 11:25:42 +0300 |
commit | 5e02198e9c27e09c9fe8bbf9d9cc8fe93dfc3cb5 (patch) | |
tree | ec872dafd2b6d3242785c3995fce08b7f101c255 /NEWS | |
parent | 284a1ac48b35ef107979978fd443fbde6a6b4b12 (diff) | |
download | idest-5e02198e9c27e09c9fe8bbf9d9cc8fe93dfc3cb5.tar.gz idest-5e02198e9c27e09c9fe8bbf9d9cc8fe93dfc3cb5.tar.bz2 |
Final cleanup. Version 2.0.
Diffstat (limited to 'NEWS')
-rw-r--r-- | NEWS | 49 |
1 files changed, 25 insertions, 24 deletions
@@ -1,11 +1,11 @@ -IdEst -- history of user-visible changes. 2011-07-25 +IdEst -- history of user-visible changes. 2011-08-01 Copyright (C) 2009-2011 Sergey Poznyakoff See the end of file for copying conditions. -Please send bug reports to <gray+idest@gnu.org.ua> +Please send bug reports to <bug-idest@gnu.org.ua> -Version 1.99.90, Git +Version 2.0, 2011-08-01 * New option --info (-i) @@ -13,51 +13,52 @@ idest --info shows information about input file structure. * Set mode shortcut. -When setting frames, you can omit the --set option from all +When setting frames, you can omit the `--set' option from all assignments, except the first one, e.g.: idest --set track=1 year=1985 album=Maremar track01.mp3 * New option --copy (-c) -The --copy=FILE option copies frames from FILE to each file from -the file list. All frames are copied, unless the --filter option +The `--copy=FILE' option copies frames from FILE to each file from +the file list. All frames are copied, unless the `--filter' option is specified (see below), in which case only the listed frames are copied. -The --copy option can be used together with --set and --script. +The `--copy' option can be used together with `--set', `--script' and +`--batch' options. * New option --filter (-F) -The --filter=FRAME-LIST option can be used in conjunction with ---query, --copy and --delete. It abridges the scope of operation -to fields from FRAME-LIST. The `--delete --filter=FRAME-LIST' +The `--filter=FRAME-LIST' option can be used in conjunction with +`--query', `--copy' and `--delete'. It abridges the scope of operation +to the fields from FRAME-LIST. The `--delete --filter=FRAME-LIST' is equivalent to `--delete=FRAME-LIST'. * New option --list-frames (-L) -Lists the supported frames IDs, along with their qualifiers and +Lists the supported frame IDs, along with their qualifiers and descriptions. * The --convert option -The argument to --convert option is either a single major version +The argument to `--convert' option is either a single major version number or a comma-separated list of version numbers. * The --id-version option -The semantics of the --id-version option has changed. Now it +The semantics of the `--id-version' option has changed. Now it instructs the program to write new and changed tags in the specified -ID3 format. In the contrast to the `--convert' option, this option -does not affect files which underwent no changes. +major ID3 format (1 or 2). In the contrast to the `--convert' option, +this option does not affect files which underwent no changes. -The argument to --id-version option is either a single major version +The argument to `--id-version' option is either a single major version number or a comma-separated list of version numbers. * New option --default-id-version (-U) -The --default-id-version option sets the default ID3 version to use. -It differs from --id-version (-V) in that the default version is used +The `--default-id-version' option sets the default ID3 version to use. +It differs from `--id-version' (`-V') in that the default version is used only if the input file originally had no ID3 tags. * New option --describe (-D) @@ -67,7 +68,7 @@ Prints verbose frame descriptions instead of their short names. * The `--script' option. The `--script' (`-S') option stops further argument processing and -passes the rest of command line as argument to the script. The script +passes the rest of command line as arguments to the script. The script can modify the arguments (e.g. by removing its command-line options). The modified arguments are then returned to idest and processed as a list of input file names. @@ -157,9 +158,9 @@ The full syntax is: * Changes in Scheme representation of frame lists. -Each frame in the list is represented by a cons. Car of this +Each frame in the list is represented by a cons. The car of this cons is the frame name (a string). Its cdr is an association list -keeping this frame properties. Keys in this list are property +of the frame properties. The keys in this list are property IDs (Scheme symbols). The following properties are defined for all frames: @@ -177,9 +178,9 @@ Unsupported or partially-supported frames contain a single property: rawdata. The value of this property is a list of frame fields. Each field is represented by a triplet (ORD TYPE VALUE), where ORD is the ordinal number of that field in frame, TYPE is its type (integer) and -VALUE is its value. If TYPE is one of numeric types, VALUE is the -numeric value converted to string (string->number will bring it back -to number). If TYPE is a string type, VALUE contains the string in +VALUE is its value (string). If TYPE is one of numeric types, VALUE +is the numeric value converted to string (string->number will bring it +back to number). If TYPE is a string type, VALUE contains the string in the appropriate encoding. Otherwise, VALUE holds the field value as a binary string. Each byte in such a string is represented by two hexagesimal digits. For example, "AB\n" is represented as 41420A. |