Windows CE

开发平台：
C/C++

usage.c：源码内容
							/* metaflac - Command-line FLAC metadata editor
 * Copyright (C) 2001,2002,2003,2004,2005  Josh Coalson
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 */
#include "usage.h"
#include "FLAC/format.h"
#include <stdarg.h>
#include <stdio.h>
static void usage_header(FILE *out)
{
	fprintf(out, "==============================================================================n");
	fprintf(out, "metaflac - Command-line FLAC metadata editor version %sn", FLAC__VERSION_STRING);
	fprintf(out, "Copyright (C) 2001,2002,2003,2004,2005  Josh Coalsonn");
	fprintf(out, "n");
	fprintf(out, "This program is free software; you can redistribute it and/orn");
	fprintf(out, "modify it under the terms of the GNU General Public Licensen");
	fprintf(out, "as published by the Free Software Foundation; either version 2n");
	fprintf(out, "of the License, or (at your option) any later version.n");
	fprintf(out, "n");
	fprintf(out, "This program is distributed in the hope that it will be useful,n");
	fprintf(out, "but WITHOUT ANY WARRANTY; without even the implied warranty ofn");
	fprintf(out, "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See then");
	fprintf(out, "GNU General Public License for more details.n");
	fprintf(out, "n");
	fprintf(out, "You should have received a copy of the GNU General Public Licensen");
	fprintf(out, "along with this program; if not, write to the Free Softwaren");
	fprintf(out, "Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.n");
	fprintf(out, "==============================================================================n");
}
static void usage_summary(FILE *out)
{
	fprintf(out, "Usage:n");
	fprintf(out, "  metaflac [options] [operations] FLACfile [FLACfile ...]n");
	fprintf(out, "n");
	fprintf(out, "Use metaflac to list, add, remove, or edit metadata in one or more FLAC files.n");
	fprintf(out, "You may perform one major operation, or many shorthand operations at a time.n");
	fprintf(out, "n");
	fprintf(out, "Options:n");
	fprintf(out, "--preserve-modtime    Preserve the original modification time in spite of editsn");
	fprintf(out, "--with-filename       Prefix each output line with the FLAC file namen");
	fprintf(out, "                      (the default if more than one FLAC file is specified)n");
	fprintf(out, "--no-filename         Do not prefix each output line with the FLAC file namen");
	fprintf(out, "                      (the default if only one FLAC file is specified)n");
	fprintf(out, "--no-utf8-convert     Do not convert tags from UTF-8 to local charset,n");
	fprintf(out, "                      or vice versa.  This is useful for scripts.n");
	fprintf(out, "--dont-use-padding    By default metaflac tries to use padding where possiblen");
	fprintf(out, "                      to avoid rewriting the entire file if the metadata sizen");
	fprintf(out, "                      changes.  Use this option to tell metaflac to not taken");
	fprintf(out, "                      advantage of padding this way.n");
}
int short_usage(const char *message, ...)
{
	va_list args;
	if(message) {
		va_start(args, message);
		(void) vfprintf(stderr, message, args);
		va_end(args);
	}
	usage_header(stderr);
	fprintf(stderr, "n");
	fprintf(stderr, "This is the short help; for full help use 'metaflac --help'n");
	fprintf(stderr, "n");
	usage_summary(stderr);
	return message? 1 : 0;
}
int long_usage(const char *message, ...)
{
	FILE *out = (message? stderr : stdout);
	va_list args;
	if(message) {
		va_start(args, message);
		(void) vfprintf(stderr, message, args);
		va_end(args);
	}
	usage_header(out);
	fprintf(out, "n");
	usage_summary(out);
	fprintf(out, "n");
	fprintf(out, "Shorthand operations:n");
	fprintf(out, "--show-md5sum         Show the MD5 signature from the STREAMINFO block.n");
	fprintf(out, "--show-min-blocksize  Show the minimum block size from the STREAMINFO block.n");
	fprintf(out, "--show-max-blocksize  Show the maximum block size from the STREAMINFO block.n");
	fprintf(out, "--show-min-framesize  Show the minimum frame size from the STREAMINFO block.n");
	fprintf(out, "--show-max-framesize  Show the maximum frame size from the STREAMINFO block.n");
	fprintf(out, "--show-sample-rate    Show the sample rate from the STREAMINFO block.n");
	fprintf(out, "--show-channels       Show the number of channels from the STREAMINFO block.n");
	fprintf(out, "--show-bps            Show the # of bits per sample from the STREAMINFO block.n");
	fprintf(out, "--show-total-samples  Show the total # of samples from the STREAMINFO block.n");
	fprintf(out, "n");
	fprintf(out, "--show-vendor-tag     Show the vendor string from the VORBIS_COMMENT block.n");
	fprintf(out, "--show-tag=NAME       Show all tags where the the field name matches 'NAME'.n");
	fprintf(out, "--remove-tag=NAME     Remove all tags whose field name is 'NAME'.n");
	fprintf(out, "--remove-first-tag=NAME  Remove first tag whose field name is 'NAME'.n");
	fprintf(out, "--remove-all-tags     Remove all tags, leaving only the vendor string.n");
	fprintf(out, "--set-tag=FIELD       Add a tag.  The FIELD must comply with the Vorbis commentn");
	fprintf(out, "                      spec, of the form "NAME=VALUE".  If there is currentlyn");
	fprintf(out, "                      no tag block, one will be created.n");
	fprintf(out, "--import-tags-from=FILE Import tags from a file.  Use '-' for stdin.  Each linen");
	fprintf(out, "                      should be of the form NAME=VALUE.  Multi-line commentsn");
	fprintf(out, "                      are currently not supported.  Specify --remove-all-tagsn");
	fprintf(out, "                      and/or --no-utf8-convert before --import-tags-from ifn");
	fprintf(out, "                      necessary.n");
	fprintf(out, "--export-tags-to=FILE Export tags to a file.  Use '-' for stdin.  Each linen");
	fprintf(out, "                      will be of the form NAME=VALUE.  Specifyn");
	fprintf(out, "                      --no-utf8-convert if necessary.n");
	fprintf(out, "--import-cuesheet-from=FILE  Import a cuesheet from a file.  Use '-' for stdin.n");
	fprintf(out, "                      Only one FLAC file may be specified.  A seekpoint will ben");
	fprintf(out, "                      added for each index point in the cuesheet to the SEEKTABLEn");
	fprintf(out, "                      unless --no-cued-seekpoints is specified.n");
	fprintf(out, "--export-cuesheet-to=FILE  Export CUESHEET block to a cuesheet file, suitablen");
	fprintf(out, "                      for use by CD authoring software.  Use '-' for stdout.n");
	fprintf(out, "                      Only one FLAC file may be specified on the command line.n");
	fprintf(out, "--add-replay-gain     Calculates the title and album gains/peaks of the givenn");
	fprintf(out, "                      FLAC files as if all the files were part of one album,n");
	fprintf(out, "                      then stores them in the VORBIS_COMMENT block.  The tagsn");
	fprintf(out, "                      are the same as those used by vorbisgain.  Existingn");
	fprintf(out, "                      ReplayGain tags will be replaced.  If only one FLAC filen");
	fprintf(out, "                      is given, the album and title gains will be the same.n");
	fprintf(out, "                      Since this operation requires two passes, it is alwaysn");
	fprintf(out, "                      executed last, after all other operations have beenn");
	fprintf(out, "                      completed and written to disk.  All FLAC files specifiedn");
	fprintf(out, "                      must have the same resolution, sample rate, and numbern");
	fprintf(out, "                      of channels.  The sample rate must be one of 8, 11.025,n");
	fprintf(out, "                      12, 16, 22.05, 24, 32, 44.1, or 48 kHz.n");
	fprintf(out, "--add-seekpoint={#|X|#x|#s}  Add seek points to a SEEKTABLE blockn");
	fprintf(out, "       #  : a specific sample number for a seek pointn");
	fprintf(out, "       X  : a placeholder point (always goes at the end of the SEEKTABLE)n");
	fprintf(out, "       #x : # evenly spaced seekpoints, the first being at sample 0n");
	fprintf(out, "       #s : a seekpoint every # seconds; # does not have to be a whole numbern");
	fprintf(out, "                      If no SEEKTABLE block exists, one will be created.  Ifn");
	fprintf(out, "                      one already exists, points will be added to the existingn");
	fprintf(out, "                      table, and any duplicates will be turned into placeholdern");
	fprintf(out, "                      points.  You may use many --add-seekpoint options; then");
	fprintf(out, "                      resulting SEEKTABLE will be the unique-ified union ofn");
	fprintf(out, "                      all such values.  Example: --add-seekpoint=100xn");
	fprintf(out, "                      --add-seekpoint=3.5s will add 100 evenly spacedn");
	fprintf(out, "                      seekpoints and a seekpoint every 3.5 seconds.n");
	fprintf(out, "--add-padding=length  Add a padding block of the given length (in bytes).n");
	fprintf(out, "                      The overall length of the new block will be 4 + length;n");
	fprintf(out, "                      the extra 4 bytes is for the metadata block header.n");
	fprintf(out, "n");
	fprintf(out, "Major operations:n");
	fprintf(out, "--versionn");
	fprintf(out, "    Show the metaflac version number.n");
	fprintf(out, "--listn");
	fprintf(out, "    List the contents of one or more metadata blocks to stdout.  By default,n");
	fprintf(out, "    all metadata blocks are listed in text format.  Use the following optionsn");
	fprintf(out, "    to change this behavior:n");
	fprintf(out, "n");
	fprintf(out, "    --block-number=#[,#[...]]n");
	fprintf(out, "    An optional comma-separated list of block numbers to display.  The firstn");
	fprintf(out, "    block, the STREAMINFO block, is block 0.n");
	fprintf(out, "n");
	fprintf(out, "    --block-type=type[,type[...]]n");
	fprintf(out, "    --except-block-type=type[,type[...]]n");
	fprintf(out, "    An optional comma-separated list of block types to be included or ignoredn");
	fprintf(out, "    with this option.  Use only one of --block-type or --except-block-type.n");
	fprintf(out, "    The valid block types are: STREAMINFO, PADDING, APPLICATION, SEEKTABLE,n");
	fprintf(out, "    VORBIS_COMMENT.  You may narrow down the types of APPLICATION blocksn");
	fprintf(out, "    displayed as follows:n");
	fprintf(out, "        APPLICATION:abcd        The APPLICATION block(s) whose textual repre-n");
	fprintf(out, "                                sentation of the 4-byte ID is "abcd"n");
	fprintf(out, "        APPLICATION:0xXXXXXXXX  The APPLICATION block(s) whose hexadecimal big-n");
	fprintf(out, "                                endian representation of the 4-byte ID isn");
	fprintf(out, "                                "0xXXXXXXXX".  For the example "abcd" above then");
	fprintf(out, "                                hexadecimal equivalalent is 0x61626364n");
	fprintf(out, "n");
	fprintf(out, "    NOTE: if both --block-number and --[except-]block-type are specified,n");
	fprintf(out, "          the result is the logical AND of both arguments.n");
	fprintf(out, "n");
#if 0
	/*@@@ not implemented yet */
	fprintf(out, "    --data-format=binary|textn");
	fprintf(out, "    By default a human-readable text representation of the data is displayed.n");
	fprintf(out, "    You may specify --data-format=binary to dump the raw binary form of eachn");
	fprintf(out, "    metadata block.  The output can be read in using a subsequent call ton");
	fprintf(out, "    "metaflac --append --from-file=..."n");
	fprintf(out, "n");
#endif
	fprintf(out, "    --application-data-format=hexdump|textn");
	fprintf(out, "    If the application block you are displaying contains binary data but yourn");
	fprintf(out, "    --data-format=text, you can display a hex dump of the application datan");
	fprintf(out, "    contents instead using --application-data-format=hexdumpn");
	fprintf(out, "n");
#if 0
	/*@@@ not implemented yet */
	fprintf(out, "--appendn");
	fprintf(out, "    Insert a metadata block from a file.  The input file must be in the samen");
	fprintf(out, "    format as generated with --list.n");
	fprintf(out, "n");
	fprintf(out, "    --block-number=#n");
	fprintf(out, "    Specify the insertion point (defaults to last block).  The new block willn");
	fprintf(out, "    be added after the given block number.  This prevents the illegal insertionn");
	fprintf(out, "    of a block before the first STREAMINFO block.  You may not --append anothern");
	fprintf(out, "    STREAMINFO block.n");
	fprintf(out, "n");
	fprintf(out, "    --from-file=filenamen");
	fprintf(out, "    Mandatory 'option' to specify the input file containing the block contents.n");
	fprintf(out, "n");
	fprintf(out, "    --data-format=binary|textn");
	fprintf(out, "    By default the block contents are assumed to be in binary format.  You cann");
	fprintf(out, "    override this by specifying --data-format=textn");
	fprintf(out, "n");
#endif
	fprintf(out, "--removen");
	fprintf(out, "    Remove one or more metadata blocks from the metadata.  Unlessn");
	fprintf(out, "    --dont-use-padding is specified, the blocks will be replaced with padding.n");
	fprintf(out, "    You may not remove the STREAMINFO block.n");
	fprintf(out, "n");
	fprintf(out, "    --block-number=#[,#[...]]n");
	fprintf(out, "    --block-type=type[,type[...]]n");
	fprintf(out, "    --except-block-type=type[,type[...]]n");
	fprintf(out, "    See --list above for usage.n");
	fprintf(out, "n");
	fprintf(out, "    NOTE: if both --block-number and --[except-]block-type are specified,n");
	fprintf(out, "          the result is the logical AND of both arguments.n");
	fprintf(out, "n");
	fprintf(out, "--remove-alln");
	fprintf(out, "    Remove all metadata blocks (except the STREAMINFO block) from then");
	fprintf(out, "    metadata.  Unless --dont-use-padding is specified, the blocks will ben");
	fprintf(out, "    replaced with padding.n");
	fprintf(out, "n");
	fprintf(out, "--merge-paddingn");
	fprintf(out, "    Merge adjacent PADDING blocks into single blocks.n");
	fprintf(out, "n");
	fprintf(out, "--sort-paddingn");
	fprintf(out, "    Move all PADDING blocks to the end of the metadata and merge them into an");
	fprintf(out, "    single block.n");
	return message? 1 : 0;
}

						