From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS22989 209.51.188.0/24 X-Spam-Status: No, score=-3.9 required=3.0 tests=AWL,BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, SPF_HELO_PASS,SPF_PASS,T_SCC_BODY_TEXT_LINE shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dcvr.yhbt.net (Postfix) with ESMTPS id 804FC1F852 for ; Thu, 3 Feb 2022 00:49:31 +0000 (UTC) Received: from localhost ([::1]:42714 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nFQJW-0006fe-O3 for e@80x24.org; Wed, 02 Feb 2022 19:49:30 -0500 Received: from eggs.gnu.org ([209.51.188.92]:36386) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nFQIv-0006bl-LK for dtas-all@nongnu.org; Wed, 02 Feb 2022 19:48:54 -0500 Received: from dcvr.yhbt.net ([64.71.152.64]:45788) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nFQIk-0006EP-Ov for dtas-all@nongnu.org; Wed, 02 Feb 2022 19:48:50 -0500 Received: from localhost (dcvr.yhbt.net [127.0.0.1]) by dcvr.yhbt.net (Postfix) with ESMTP id 340161F9FC for ; Thu, 3 Feb 2022 00:48:22 +0000 (UTC) From: Eric Wong To: dtas-all@nongnu.org Subject: [PATCH 2/2] splitfx: document changes ahead of 0.20.0 release Date: Thu, 3 Feb 2022 00:48:21 +0000 Message-Id: <20220203004821.24947-3-e@80x24.org> In-Reply-To: <20220203004821.24947-1-e@80x24.org> References: <20220203004821.24947-1-e@80x24.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=64.71.152.64; envelope-from=e@80x24.org; helo=dcvr.yhbt.net X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: dtas-all@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: duct tape audio suite List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dtas-all-bounces+e=80x24.org@nongnu.org Sender: "dtas-all" --filter, per-track comments and environments are the subtle but major new features for the next release. --- Documentation/dtas-splitfx.pod | 41 ++++++++++++++++++++++++++++------ 1 file changed, 34 insertions(+), 7 deletions(-) diff --git a/Documentation/dtas-splitfx.pod b/Documentation/dtas-splitfx.pod index 717cfa6..f8de59b 100644 --- a/Documentation/dtas-splitfx.pod +++ b/Documentation/dtas-splitfx.pod @@ -26,7 +26,8 @@ to use L, too. =item -j, --jobs [JOBS] Number of jobs to run in parallel. If no number is specified, all -jobs are run in parallel. +jobs are run in parallel. Default: number of CPUS (dtas 0.20.0+), +previous versions of dtas defaulted to 1. =item -n, --dry-run @@ -76,6 +77,16 @@ outputs the result as a single file with the TRACKNUMBER of "000". For ease-of-typing, commas in this command-line argument are automatically expanded to spaces when passed to sox. +This switch may not be combined with L + +=item -f, --filter [FIELD=]VALUE + +Only process tracks matching a given comment FIELD and VALUE. +If no C<=> is exists, then all comment fields are matched +against the specified VALUE. + +This switch may not be combined with L + =item -p, --sox-pipe Used in place of an output target to specify outputting audio data in @@ -121,7 +132,12 @@ highest-numbered track. Default: true =item targets - hash, see "TARGETS" section -=item command - used only by L +=item command - override the default sox invocation + +This command may be used to specify an alternate command to process each +track. + +Default: sox "$INFILE" $COMMENTS $OUTFMT $OUTDST $TRIMFX $FX $RATEFX $DITHERFX =back @@ -133,11 +149,22 @@ segment. =over -=item t TIME TITLE [fade_in/fade_out=FADE_ARGS] +=item t TIME TITLE [fade_in/fade_out=FADE_ARGS] [.FIELD=VALUE] [env.X=Y] + +The start of a new track at TIME with TITLE. +An optional L and L may be specified for any tracks. +Per-track comments may be specified in the form of C<.FIELD=VALUE>. +Using per-track C<.ARTIST=FOO> allows proper tagging of multi-artist +compilations. -The start of a new track -at TIME with TITLE. An optional fade_in and fade_out may be specified -for the first/last tracks. +Per-track environment variables may be specified in the form +of C where C is the environment variable name and +C is its value. Per-track environment variables do not affect +playback of YAML files via L nor use of the L +command-line option. However, per-track environment variables do affect +any tracks written to the filesystem, including those using the L +switch. These environment variables are intended to affect the specified +L or default L invocation. =item skip TIME - skip a segment starting at TIME @@ -268,7 +295,7 @@ imbalance in a live concert recording from the audience: =head1 COPYRIGHT -Copyright 2013-2020 all contributors L +Copyright all contributors L License: GPL-3.0+ L