mirrors
/
flac
mirror of https://github.com/xiph/flac
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Add help and man text for --append

This commit is contained in:
Martijn van Beurden 2023-04-11 10:44:36 +02:00 committed by GitHub
parent 4b2c33ebf2
commit f7bd64bc70
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 29 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
man/metaflac.md
View File

@ -261,12 +261,25 @@ modification time is set to the current time):
application data contents instead using
\--application-data-format=hexdump.
**\--data-format=binary\|binary-headerless\|text**
: By default a human-readable text representation of the data is
displayed. You may specify --data-format=binary to dump the raw
binary form of each metadata block. Specify
--data-format=binary-headerless to omit output of metadata block
headers, including the id of APPLICATION metadata blocks.
**\--data-format=binary\|binary-headerless\|text**
: For use with --list. By default a human-readable text
representation of the data is isplayed. You may specify
--data-format=binary to dump the raw binary form of each metadata
block. Specify --data-format=binary-headerless to omit output of
metadata block headers, including the id of APPLICATION metadata
blocks.
**\--append**
: Insert a metadata block from a file. This must be a binary block as
exported with --list --data-format=binary. The insertion point is
defined with --block-number=#. The new block will be added after the
given block number. This prevents the illegal insertion of a block
before the first STREAMINFO block. You may not --append another
STREAMINFO block. It is possible to copy a metadata block from one
file to another with this option. For example use
`metaflac --list --data-format=binary --block-number=6 file.flac > block`
to export the block, and then import it with
`metaflac --append anotherfile.flac < block`
**\--remove-all**
: Remove all metadata blocks (except the STREAMINFO block) from the

10
src/metaflac/usage.c
View File

@ -289,6 +289,16 @@ int long_usage(const char *message, ...)
fprintf(out, " contents instead using --application-data-format=hexdump\n");
fprintf(out, "\n");
fprintf(out, "--append\n");
fprintf(out, " Insert a metadata block from a file. This must be a binary block as\n");
fprintf(out, " exported with --list --data-format=binary. The insertion point is\n");
fprintf(out, " defined with --block-number=#. The new block will be added after the\n");
fprintf(out, " given block number. This prevents the illegal insertion of a block\n");
fprintf(out, " before the first STREAMINFO block. You may not --append another\n");
fprintf(out, " STREAMINFO block. It is possible to copy a metadata block from one\n");
fprintf(out, " file to another with this option. For example use\n");
fprintf(out, " metaflac --list --data-format=binary --block-number=6 file.flac > block\n");
fprintf(out, " to export the block, and then import it with\n");
fprintf(out, " metaflac --append anotherfile.flac < block\n");
fprintf(out, " Insert a metadata block from a file. The input file must be in the same\n");
fprintf(out, " format as generated with --list.\n");
fprintf(out, "\n");