.\" $HeadURL$ $LastChangedRevision$ .\" .TH ALTROD 1 "SPPSYM_RELEASE_DATE_MAN" .ne 5 .SH NAME altrod \- page generator the Alternative Radion On Demand .br .ne 5 .SH SYNOPSIS .B altrod [ .B \-V | .B \-\-version ] [ .B \-v | .B \-\-verbose | .B \-d .I level | .B \-\-debug=\fIlevel ] [ .B \-h | .B \-\-help ] [ .B \-p | .B \-\-list\-paths ] [ .B \-f .I file | .B \-\-file=\fIfile ] [ .B \-F | .B \-\-fragment ] .br .ne 5 .SH DESCRIPTION This manual page documents version SPPSYM_RELEASE_ID of .B altrod\fR. .PP .B Altrod retrieves several web pages from the BBC and extracts URLs for various radio programs listed on their 'Listen Again' pages. With these URLs and a the accompanying programme decription, .B altrod constructs a web page which indexes the programmes on offer. It is intended as a static alternative to the BBC's 'Radio On Demand' service, which does not work well with Linux. .br .ne 5 .SH CONFIGURATION None. .br .ne 5 .SH OPTIONS .TP 25 .B \-d \fIlevel\fR, \fB\-\-debug=\fIlevel\fR Determines how verbose .B altrod will be. The message types displayed for the different values of .I level are as follows: .RS 25 .TP 5 .B 0 internal errors only .TP .B 1 internal errors and normal errors .TP .B 2 internal errors, normal errors and warnings .TP .B 3 internal errors, normal errors, warnings and informational messages .TP .B >3 all the above plus application-specific debug messages. .RE .TP 25 .B \-f \fIfile\fR, \fB\-\-file=\fIfile\fR send the output to .I file instead of stdout. .TP .B \-F\fR, \fB\-\-fragment With this option, .B altrod skips HTML tags down to and including .B \fR, leaving something suitable for importing into another HTML document. .TP .B \-h\fR, \fB\-\-help Displays a brief usage message. .TP .B \-p\fR, \fB\-\-list\-paths List the compiled-in paths of various files and directories that .B altrod uses. .TP .B \-v\fR, \fB\-\-verbose Equivalent to .B \-d 3\fR. .TP .B \-V\fR, \fB\-\-version Print the program's version number and exit. .br .ne 5 .SH EXIT STATUS On success .B altrod returns zero. On failure it returns non-zero and displays a diagnostic message. .br .ne 5 .SH FILES None. .br .ne 5 .SH ENVIRONMENT VARIABLES None. .br .ne 5 .SH EXAMPLES None. .br .ne 5 .SH CAVEATS In order to simulate an HTTP request from the BBC's own Java-based Real Audio player, .B altrod uses www.anonymizer.com's service to strip the referring URL from the request. Unfortunately www.anonymizer.com restrict access to URLs containing certain text patterns. This means that about 2% of the links presented by .B altrod will not be accessible, simply depending on the name of the radio programme. .br .ne 5 .SH SEE ALSO None. .br .ne 5 .SH AUTHOR SPPSYM_AUTHOR_NAME .br .ne 5 .SH COPYRIGHT & DISTRIBUTION POLICY Copyright (C) 2002-SPPSYM_RELEASE_YEAR SPPSYM_AUTHOR_NAME .PP 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. .PP 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. .PP 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., 675 Mass Ave, Cambridge, MA 02139, USA.