aboutsummaryrefslogtreecommitdiff
path: root/NEWS
diff options
context:
space:
mode:
authorSergey Poznyakoff <gray@gnu.org.ua>2011-08-01 11:07:53 +0300
committerSergey Poznyakoff <gray@gnu.org.ua>2011-08-01 11:25:42 +0300
commit5e02198e9c27e09c9fe8bbf9d9cc8fe93dfc3cb5 (patch)
treeec872dafd2b6d3242785c3995fce08b7f101c255 /NEWS
parent284a1ac48b35ef107979978fd443fbde6a6b4b12 (diff)
downloadidest-5e02198e9c27e09c9fe8bbf9d9cc8fe93dfc3cb5.tar.gz
idest-5e02198e9c27e09c9fe8bbf9d9cc8fe93dfc3cb5.tar.bz2
Final cleanup. Version 2.0.
Diffstat (limited to 'NEWS')
-rw-r--r--NEWS49
1 files changed, 25 insertions, 24 deletions
diff --git a/NEWS b/NEWS
index a5b4d89..df81d33 100644
--- a/NEWS
+++ b/NEWS
@@ -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.

Return to:

Send suggestions and report system problems to the System administrator.