~ubuntu-branches/ubuntu/jaunty/icecream/jaunty

« back to all changes in this revision

Viewing changes to icecream.8

  • Committer: Bazaar Package Importer
  • Author(s): Cristian Greco
  • Date: 2008-04-29 09:43:16 UTC
  • mfrom: (1.1.2 upstream) (3.1.1 hardy)
  • Revision ID: james.westby@ubuntu.com-20080429094316-srcxihd3j14nb6tr
Tags: 1.3-1
* New Maintainer (Closes: #431684)
* New upstream release (including a patch of mine)
  - Parse .m3u playlists starting with a comment (Closes: #396892)
  - Fix wrong requests to server (Closes: #396893)
  - Support direct stream URLs (Closes: #319342)
  - New features and bugfixes.
  - Fix manpage mistake (now use section 1 instead of 8)
* debian/control:
  - Bump Standards-Version to 3.7.3.
  - Moved the "Homepage:" pseudo-header from the extended description
    to the new field in the source package general paragraph
  - Modified short and extended Description
* debian/copyright:
  - Modified homepage
  - Updated years for the copyright
  - Included GPL headers
  - Included a license statement for Debian packaging
* debian/dirs: deleted 'usr/share/man/man8'
* debian/manpages: list new manpage
* debian/patches:
  - remove 10-manpage-fix.dpatch, fixed upstream
  - add description to 20-makefile-debianlike.dpatch
* debian/rules: binary-arch must exists, even if it is empty (policy 4.9)
* debian/watch: added

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3
2
 
.\"
3
 
.\" Standard preamble:
4
 
.\" ========================================================================
5
 
.de Sh \" Subsection heading
6
 
.br
7
 
.if t .Sp
8
 
.ne 5
9
 
.PP
10
 
\fB\\$1\fR
11
 
.PP
12
 
..
13
 
.de Sp \" Vertical space (when we can't use .PP)
14
 
.if t .sp .5v
15
 
.if n .sp
16
 
..
17
 
.de Vb \" Begin verbatim text
18
 
.ft CW
19
 
.nf
20
 
.ne \\$1
21
 
..
22
 
.de Ve \" End verbatim text
23
 
.ft R
24
 
.fi
25
 
..
26
 
.\" Set up some character translations and predefined strings.  \*(-- will
27
 
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28
 
.\" double quote, and \*(R" will give a right double quote.  | will give a
29
 
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
30
 
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
31
 
.\" expand to `' in nroff, nothing in troff, for use with C<>.
32
 
.tr \(*W-|\(bv\*(Tr
33
 
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
34
 
.ie n \{\
35
 
.    ds -- \(*W-
36
 
.    ds PI pi
37
 
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
38
 
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
39
 
.    ds L" ""
40
 
.    ds R" ""
41
 
.    ds C` ""
42
 
.    ds C' ""
43
 
'br\}
44
 
.el\{\
45
 
.    ds -- \|\(em\|
46
 
.    ds PI \(*p
47
 
.    ds L" ``
48
 
.    ds R" ''
49
 
'br\}
50
 
.\"
51
 
.\" If the F register is turned on, we'll generate index entries on stderr for
52
 
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
53
 
.\" entries marked with X<> in POD.  Of course, you'll have to process the
54
 
.\" output yourself in some meaningful fashion.
55
 
.if \nF \{\
56
 
.    de IX
57
 
.    tm Index:\\$1\t\\n%\t"\\$2"
58
 
..
59
 
.    nr % 0
60
 
.    rr F
61
 
.\}
62
 
.\"
63
 
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
64
 
.\" way too many mistakes in technical documents.
65
 
.hy 0
66
 
.if n .na
67
 
.\"
68
 
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69
 
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
70
 
.    \" fudge factors for nroff and troff
71
 
.if n \{\
72
 
.    ds #H 0
73
 
.    ds #V .8m
74
 
.    ds #F .3m
75
 
.    ds #[ \f1
76
 
.    ds #] \fP
77
 
.\}
78
 
.if t \{\
79
 
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
80
 
.    ds #V .6m
81
 
.    ds #F 0
82
 
.    ds #[ \&
83
 
.    ds #] \&
84
 
.\}
85
 
.    \" simple accents for nroff and troff
86
 
.if n \{\
87
 
.    ds ' \&
88
 
.    ds ` \&
89
 
.    ds ^ \&
90
 
.    ds , \&
91
 
.    ds ~ ~
92
 
.    ds /
93
 
.\}
94
 
.if t \{\
95
 
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
96
 
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
97
 
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
98
 
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
99
 
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
100
 
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
101
 
.\}
102
 
.    \" troff and (daisy-wheel) nroff accents
103
 
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
104
 
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
105
 
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
106
 
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
107
 
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
108
 
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
109
 
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
110
 
.ds ae a\h'-(\w'a'u*4/10)'e
111
 
.ds Ae A\h'-(\w'A'u*4/10)'E
112
 
.    \" corrections for vroff
113
 
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
114
 
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
115
 
.    \" for low resolution devices (crt and lpr)
116
 
.if \n(.H>23 .if \n(.V>19 \
117
 
\{\
118
 
.    ds : e
119
 
.    ds 8 ss
120
 
.    ds o a
121
 
.    ds d- d\h'-1'\(ga
122
 
.    ds D- D\h'-1'\(hy
123
 
.    ds th \o'bp'
124
 
.    ds Th \o'LP'
125
 
.    ds ae ae
126
 
.    ds Ae AE
127
 
.\}
128
 
.rm #[ #] #H #V #F C
129
 
.\" ========================================================================
130
 
.\"
131
 
.IX Title "ICECREAM 1"
132
 
.TH ICECREAM 1 "2006-01-17" "1.2" "User Contributed Perl Documentation"
133
 
.SH "NAME"
134
 
icecream \- listen to, or download icecast streams
135
 
.SH "SYNOPSIS"
136
 
.IX Header "SYNOPSIS"
137
 
icecream [\s-1OPTIONS\s0] \s-1URL\s0 [\s-1URL\s0..]
138
 
.SH "DESCRIPTION"
139
 
.IX Header "DESCRIPTION"
140
 
icecream is a non-interactive stream download utility. It connects
141
 
to icecast and shoutcast servers and redirects all fetched content
142
 
to an stdin-capable player or to media files on your disk. With an
143
 
option turned on, it can save the stream into different files, each
144
 
representing the played track. It is also possible to tee the input
145
 
to both disk and stdout.
146
 
.SH "OPTIONS"
147
 
.IX Header "OPTIONS"
148
 
.IP "\fB\-h\fR, \fB\-\-help\fR" 8
149
 
.IX Item "-h, --help"
150
 
Print a help message describing all options
151
 
.IP "\fB\-q\fR, \fB\-\-quiet\fR" 8
152
 
.IX Item "-q, --quiet"
153
 
Turn off output
154
 
.IP "\fB\-v\fR, \fB\-\-verbose\fR" 8
155
 
.IX Item "-v, --verbose"
156
 
Be verbose
157
 
.IP "\fB\-\-stdout\fR" 8
158
 
.IX Item "--stdout"
159
 
Output stream to stdout (implies \-q)
160
 
.IP "\fB\-t\fR, \fB\-\-tracks\fR" 8
161
 
.IX Item "-t, --tracks"
162
 
Split stream into tracks (if possible)
163
 
.IP "\fB\-\-name=NAME\fR" 8
164
 
.IX Item "--name=NAME"
165
 
Output stream to file specified by \s-1NAME\s0. Format codes starting
166
 
with \*(L"%\*(R" will be replaced. See the date command for valid
167
 
format codes.
168
 
.IP "\fB\-\-stop=N[units]\fR" 8
169
 
.IX Item "--stop=N[units]"
170
 
Stop stream after N minutes, song or \s-1KB/MB\s0 transferred
171
 
.IP "\fB\-\-debug\fR" 8
172
 
.IX Item "--debug"
173
 
Turn on debugging outputs
174
 
.IP "\fB\-\-useragent=AGENT\fR" 8
175
 
.IX Item "--useragent=AGENT"
176
 
Set useragent header to \s-1AGENT\s0
177
 
.IP "\fB\-\-sync\fR" 8
178
 
.IX Item "--sync"
179
 
Turn syncing on, required for some mpeg players that read from stdin
180
 
.SH "EXAMPLES"
181
 
.IX Header "EXAMPLES"
182
 
.IP "Streaming to mpg123" 8
183
 
.IX Item "Streaming to mpg123"
184
 
icecream \-s http://radio.com/playlist.pls | mpg123 \-
185
 
.IP "Split stream into different tracks" 8
186
 
.IX Item "Split stream into different tracks"
187
 
icecream \-t http://metal.org/radio.pls
188
 
.IP "Prepare a 74 minute \s-1CD\s0" 8
189
 
.IX Item "Prepare a 74 minute CD"
190
 
icecream \-t \-\-stop 74min http://trace.net/playlist.m3u 
191
 
.IP "Use a filename with today's date as output" 8
192
 
.IX Item "Use a filename with today's date as output"
193
 
icecream \-q \-\-name 'radio_%Y_%m_%d' \-\-stop 60min
194
 
http://radio.com/playlist.pls
195
 
.SH "BUGS"
196
 
.IX Header "BUGS"
197
 
You are welcome to send bug reports about icecream to our mailing
198
 
list. Feel free to visit http://icecream.sourceforge.net
199
 
.SH "AUTHOR"
200
 
.IX Header "AUTHOR"
201
 
Written by Gil Megidish <gil at megidish.net>