From 5a0dbfc1cfddd2028ced800fc1f65e1c443126ab Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Mon, 19 Jan 2015 23:36:49 +0000 Subject: update copyright years and links to mailing list archives The documentation part is managed by the new Documentation/update-copyright script. For the future, the rest may be managed by the update-copyright tool in gnulib --- Documentation/.gitignore | 2 +- Documentation/GNUmakefile | 2 +- Documentation/dtas-console.txt | 7 ++-- Documentation/dtas-ctl.txt | 7 ++-- Documentation/dtas-cueedit.txt | 7 ++-- Documentation/dtas-enq.txt | 7 ++-- Documentation/dtas-env.txt | 8 ++--- Documentation/dtas-msinkctl.txt | 7 ++-- Documentation/dtas-player.txt | 9 +++-- Documentation/dtas-player_effects.txt | 7 ++-- Documentation/dtas-player_protocol.txt | 7 ++-- Documentation/dtas-player_sink_examples.txt | 10 ++++-- Documentation/dtas-sinkedit.txt | 7 ++-- Documentation/dtas-sourceedit.txt | 8 +++-- Documentation/dtas-splitfx.txt | 3 +- Documentation/dtas-tl.txt | 7 ++-- Documentation/dtas-xdelay.txt | 7 ++-- Documentation/update-footer.rb | 52 +++++++++++++++++++++++++++++ 18 files changed, 118 insertions(+), 46 deletions(-) create mode 100755 Documentation/update-footer.rb (limited to 'Documentation') diff --git a/Documentation/.gitignore b/Documentation/.gitignore index cdff475..c011221 100644 --- a/Documentation/.gitignore +++ b/Documentation/.gitignore @@ -1,4 +1,4 @@ -# Copyright (C) 2013-2014, Eric Wong and all contributors +# Copyright (C) 2013-2015 all contributors # License: GPLv3 or later (https://www.gnu.org/licenses/gpl-3.0.txt) *.1 *.5 diff --git a/Documentation/GNUmakefile b/Documentation/GNUmakefile index ac7df77..4f44cdc 100644 --- a/Documentation/GNUmakefile +++ b/Documentation/GNUmakefile @@ -1,4 +1,4 @@ -# Copyright (C) 2013-2014, Eric Wong and all contributors +# Copyright (C) 2013-2015 all contributors # License: GPLv3 or later (https://www.gnu.org/licenses/gpl-3.0.txt) all:: diff --git a/Documentation/dtas-console.txt b/Documentation/dtas-console.txt index 520769e..55b0bde 100644 --- a/Documentation/dtas-console.txt +++ b/Documentation/dtas-console.txt @@ -53,13 +53,14 @@ a problem. # CONTACT -All feedback welcome via plain-text mail to \ -Mailing list archives available at \ +All feedback welcome via plain-text mail to: \ +Mailing list archives available at and +\ No subscription is necessary to post to the mailing list. # COPYRIGHT -Copyright 2013-2014, Eric Wong and all contributors.\ +Copyright 2013-2015 all contributors .\ License: GPLv3 or later # SEE ALSO diff --git a/Documentation/dtas-ctl.txt b/Documentation/dtas-ctl.txt index 97d27f5..7e6d589 100644 --- a/Documentation/dtas-ctl.txt +++ b/Documentation/dtas-ctl.txt @@ -60,13 +60,14 @@ This defaults to ~/.dtas/player.sock # CONTACT -All feedback welcome via plain-text mail to \ -Mailing list archives available at \ +All feedback welcome via plain-text mail to: \ +Mailing list archives available at and +\ No subscription is necessary to post to the mailing list. # COPYRIGHT -Copyright 2013-2014, Eric Wong and all contributors.\ +Copyright 2013-2015 all contributors .\ License: GPLv3 or later # SEE ALSO diff --git a/Documentation/dtas-cueedit.txt b/Documentation/dtas-cueedit.txt index 65e1458..3ce47a4 100644 --- a/Documentation/dtas-cueedit.txt +++ b/Documentation/dtas-cueedit.txt @@ -21,13 +21,14 @@ VISUAL / EDITOR - your favorite *nix text editor, defaults to 'vi' if unset. # CONTACT -All feedback welcome via plain-text mail to \ -Mailing list archives available at \ +All feedback welcome via plain-text mail to: \ +Mailing list archives available at and +\ No subscription is necessary to post to the mailing list. # COPYRIGHT -Copyright 2013-2014, Eric Wong and all contributors.\ +Copyright 2013-2015 all contributors .\ License: GPLv3 or later # SEE ALSO diff --git a/Documentation/dtas-enq.txt b/Documentation/dtas-enq.txt index ca9e9e2..a15d87e 100644 --- a/Documentation/dtas-enq.txt +++ b/Documentation/dtas-enq.txt @@ -26,13 +26,14 @@ This defaults to ~/.dtas/player.sock # CONTACT -All feedback welcome via plain-text mail to \ -Mailing list archives available at \ +All feedback welcome via plain-text mail to: \ +Mailing list archives available at and +\ No subscription is necessary to post to the mailing list. # COPYRIGHT -Copyright 2013-2014, Eric Wong and all contributors.\ +Copyright 2013-2015 all contributors .\ License: GPLv3 or later # SEE ALSO diff --git a/Documentation/dtas-env.txt b/Documentation/dtas-env.txt index e081b7a..374f626 100644 --- a/Documentation/dtas-env.txt +++ b/Documentation/dtas-env.txt @@ -49,12 +49,12 @@ temporary files are placed for most programs. # CONTACT -All feedback welcome via plain-text mail to \ -Mailing list archives available at -and \ +All feedback welcome via plain-text mail to: \ +Mailing list archives available at and +\ No subscription is necessary to post to the mailing list. # COPYRIGHT -Copyright 2015, all contributors .\ +Copyright 2015 all contributors .\ License: GPLv3 or later diff --git a/Documentation/dtas-msinkctl.txt b/Documentation/dtas-msinkctl.txt index c7f58d3..5f0ee5b 100644 --- a/Documentation/dtas-msinkctl.txt +++ b/Documentation/dtas-msinkctl.txt @@ -42,13 +42,14 @@ This defaults to ~/.dtas/player.sock # CONTACT -All feedback welcome via plain-text mail to \ -Mailing list archives available at \ +All feedback welcome via plain-text mail to: \ +Mailing list archives available at and +\ No subscription is necessary to post to the mailing list. # COPYRIGHT -Copyright 2013-2014, Eric Wong and all contributors.\ +Copyright 2013-2015 all contributors .\ License: GPLv3 or later # SEE ALSO diff --git a/Documentation/dtas-player.txt b/Documentation/dtas-player.txt index d0211e6..20f2705 100644 --- a/Documentation/dtas-player.txt +++ b/Documentation/dtas-player.txt @@ -53,6 +53,8 @@ created and playing the audio. # TROUBLESHOOTING + + ## Audio playback does not start The most common problem with dtas-player is the play(1) command @@ -107,13 +109,14 @@ state across restarts of dtas-player. # CONTACT -All feedback welcome via plain-text mail to \ -Mailing list archives available at \ +All feedback welcome via plain-text mail to: \ +Mailing list archives available at and +\ No subscription is necessary to post to the mailing list. # COPYRIGHT -Copyright 2013-2014, Eric Wong and all contributors.\ +Copyright 2013-2015 all contributors .\ License: GPLv3 or later # SEE ALSO diff --git a/Documentation/dtas-player_effects.txt b/Documentation/dtas-player_effects.txt index 6efa193..9bfc525 100644 --- a/Documentation/dtas-player_effects.txt +++ b/Documentation/dtas-player_effects.txt @@ -46,11 +46,12 @@ They are applied in the order described. # CONTACT -All feedback welcome via plain-text mail to \ -Mailing list archives available at \ +All feedback welcome via plain-text mail to: \ +Mailing list archives available at and +\ No subscription is necessary to post to the mailing list. # COPYRIGHT -Copyright 2013-2014, Eric Wong and all contributors.\ +Copyright 2013-2015 all contributors .\ License: GPLv3 or later diff --git a/Documentation/dtas-player_protocol.txt b/Documentation/dtas-player_protocol.txt index ff8f7ae..82986cf 100644 --- a/Documentation/dtas-player_protocol.txt +++ b/Documentation/dtas-player_protocol.txt @@ -289,11 +289,12 @@ Commands here should be alphabetized according to `LC_ALL=C sort' # CONTACT -All feedback welcome via plain-text mail to \ -Mailing list archives available at \ +All feedback welcome via plain-text mail to: \ +Mailing list archives available at and +\ No subscription is necessary to post to the mailing list. # COPYRIGHT -Copyright 2013-2014, Eric Wong and all contributors.\ +Copyright 2013-2015 all contributors .\ License: GPLv3 or later diff --git a/Documentation/dtas-player_sink_examples.txt b/Documentation/dtas-player_sink_examples.txt index 1b17ae5..b696e02 100644 --- a/Documentation/dtas-player_sink_examples.txt +++ b/Documentation/dtas-player_sink_examples.txt @@ -11,6 +11,8 @@ dtas-sinkedit SINKNAME # EXAMPLES + + ## Streaming Ogg-Vorbis to Icecast To use oggfwd(1) and Icecast, the following sink works. @@ -67,15 +69,17 @@ See dtas-xdelay(1). # CONTACT -All feedback welcome via plain-text mail to \ -Mailing list archives available at \ +All feedback welcome via plain-text mail to: \ +Mailing list archives available at and +\ No subscription is necessary to post to the mailing list. # COPYRIGHT -Copyright 2013-2014, Eric Wong and all contributors.\ +Copyright 2013-2015 all contributors .\ License: GPLv3 or later # SEE ALSO + dtas-ctl(1), dtas-sinkedit(1), dtas-xdelay(1), sox(1), play(1), oggfwd(1), ssh(1), ssh_config(5), env(1) diff --git a/Documentation/dtas-sinkedit.txt b/Documentation/dtas-sinkedit.txt index 012a058..d6653fb 100644 --- a/Documentation/dtas-sinkedit.txt +++ b/Documentation/dtas-sinkedit.txt @@ -38,13 +38,14 @@ This defaults to ~/.dtas/player.sock # CONTACT -All feedback welcome via plain-text mail to \ -Mailing list archives available at \ +All feedback welcome via plain-text mail to: \ +Mailing list archives available at and +\ No subscription is necessary to post to the mailing list. # COPYRIGHT -Copyright 2013-2014, Eric Wong and all contributors.\ +Copyright 2013-2015 all contributors .\ License: GPLv3 or later # SEE ALSO diff --git a/Documentation/dtas-sourceedit.txt b/Documentation/dtas-sourceedit.txt index cff3bbc..049ba57 100644 --- a/Documentation/dtas-sourceedit.txt +++ b/Documentation/dtas-sourceedit.txt @@ -24,6 +24,7 @@ This behavior may be disabled by using the -N or --no-watch command-line switch. # OPTIONS + -N, \--no-watch : Disable inotify(7) support on Linux systems @@ -61,13 +62,14 @@ This defaults to ~/.dtas/player.sock # CONTACT -All feedback welcome via plain-text mail to \ -Mailing list archives available at \ +All feedback welcome via plain-text mail to: \ +Mailing list archives available at and +\ No subscription is necessary to post to the mailing list. # COPYRIGHT -Copyright 2013-2014, Eric Wong and all contributors.\ +Copyright 2013-2015 all contributors .\ License: GPLv3 or later # SEE ALSO diff --git a/Documentation/dtas-splitfx.txt b/Documentation/dtas-splitfx.txt index 91894d1..3c421a4 100644 --- a/Documentation/dtas-splitfx.txt +++ b/Documentation/dtas-splitfx.txt @@ -113,6 +113,7 @@ use in targets: * DITHERFX - dither effect and arguments for sox(1) dithering * FX - any user-specified sox effects which encompases the entire file. (e.g. "highpass 35 vol +3dB stats") + # TARGETS The default targets will split audio and avoid applying any effects. @@ -171,7 +172,7 @@ For reference, the "opusenc" default target is implemented as follows: # COPYRIGHT -Copyright 2013-2014, Eric Wong and all contributors.\ +Copyright 2013-2015 all contributors .\ License: GPLv3 or later # SEE ALSO diff --git a/Documentation/dtas-tl.txt b/Documentation/dtas-tl.txt index 5bb5349..41d039e 100644 --- a/Documentation/dtas-tl.txt +++ b/Documentation/dtas-tl.txt @@ -64,13 +64,14 @@ This defaults to ~/.dtas/player.sock # CONTACT -All feedback welcome via plain-text mail to \ -Mailing list archives available at \ +All feedback welcome via plain-text mail to: \ +Mailing list archives available at and +\ No subscription is necessary to post to the mailing list. # COPYRIGHT -Copyright 2013-2014, Eric Wong and all contributors.\ +Copyright 2013-2015 all contributors .\ License: GPLv3 or later # SEE ALSO diff --git a/Documentation/dtas-xdelay.txt b/Documentation/dtas-xdelay.txt index 7813e71..0e52549 100644 --- a/Documentation/dtas-xdelay.txt +++ b/Documentation/dtas-xdelay.txt @@ -61,13 +61,14 @@ greatly appreciated. # CONTACT -All feedback welcome via plain-text mail to \ -Mailing list archives available at \ +All feedback welcome via plain-text mail to: \ +Mailing list archives available at and +\ No subscription is necessary to post to the mailing list. # COPYRIGHT -Copyright 2013-2014, Eric Wong and all contributors.\ +Copyright 2013-2015 all contributors .\ License: GPLv3 or later # SEE ALSO diff --git a/Documentation/update-footer.rb b/Documentation/update-footer.rb new file mode 100755 index 0000000..30316ac --- /dev/null +++ b/Documentation/update-footer.rb @@ -0,0 +1,52 @@ +#!/usr/bin/env ruby +# Copyright 2015 all contributors +# License: GPLv3 or later +contact = %q{ +All feedback welcome via plain-text mail to: \ +Mailing list archives available at and +\ +No subscription is necessary to post to the mailing list. +} + +copyright = %q{ +Copyright %s all contributors .\ +License: GPLv3 or later +} + +ENV['TZ'] = 'UTC' +now_year = Time.now.strftime("%Y") +ARGV.each do |file| + cmd = %W(git log --reverse --pretty=format:%ad --date=short -- #{file}) + beg_year = IO.popen(cmd, &:gets).split('-')[0] + years = beg_year == now_year ? beg_year : "#{beg_year}-#{now_year}" + + File.open(file, "r+") do |fp| + state = :top + sections = [ state ] + sec = { state => "" } + fp.each_line do |l| + case l + when /^(#.+)$/ + state = $1.freeze + sections << state + sec[state] = "" + else + sec[state] << l + end + end + + fp.truncate(0) + fp.rewind + sec["# CONTACT"] = contact + sec["# COPYRIGHT"] = sprintf(copyright, years) + while section = sections.shift + fp.puts(section) if String === section + blob = sec[section].sub(/\A\n+/, '').sub(/\n+\z/, '') + fp.puts("\n") if String === section + fp.write(blob) + fp.puts("\n") + fp.puts("\n") if sections[0] + end + fp.rewind + end +end -- cgit v1.2.3-24-ge0c7