=encoding utf8

=for syntax specification:
https://perldoc.perl.org/perlpod

=head1 NAME

F<epgsearchdirs.conf> – recording directories

=head1 DESCRIPTION

In EPGSearch, you often have to enter entire directory paths,
for example, when editing search timers. Since this is rather
tedious, frequently used paths can be specified in this file,
which can then be easily selected from the menu.

This file is one of the sources for the C<Select directory> menu.
The items displayed are collected from the following sources:

=over 2

=item * current recording directories

=item * current timer directories

=item * directories used in search timers

=item * directories specified in this file

=item * entries in the VDR file F<folders.conf>

=back

The menu consolidates the found directories and displays only distinct
ones. The key C<yellow> allows changing the level of the directories
shown. Items containing EPG category variables, like C<%Genre%>,
always appear before other directories. They also do not depend on
the level and are shown with their full directory path.

If this menu is called from the timer-edit menu and the selected item
already contains the variables C<%Title%> or C<%Subtitle>, the timer's
C<File> entry gets cleared, since title or subtitle already included
in the C<Directory> item.

=head1 SYNTAX

Each line contains the pathname of a directory that can include
variables, if necessary.
You can use internal variables, those of EPG categories configured
in F<epgsearchcats.conf>, and variables defined in F<epgsearchuservars.conf>.

The following internal variables are available:

=over 4

=item B<%Time%>

An event's start time in 'HH:MM' format.

=item B<%Time_D%>

An event's start date in 'DD' format.

=item B<%Time_W%>

Name of the weekday on which an event starts.

=item B<%Time_Lng%>

An event's start date and time in I<Epoch> encoding
(i.e., seconds since 1970-01-01 00:00 UTC).

=item B<%Date%>

An event's start date in 'DD.MM.YY' format.

=item B<%DateSh%>

An event's start date in 'DD.MM' format.

=item B<%Title%>

An event's title.

=item B<%Subtitle%>

An event's subtitle.

=back

Also see B<epgsearchcats.conf>(5) and B<epgsearchuservars.conf>(5)
for further variables.

=head1 EXAMPLE

=over 4

   %Category%~%Genre%
   %Category%~%Genre%~%Title%~%Episode%: %Subtitle%
   %Series%
   Information~Nature~%Title%~%Episode%: %Subtitle%
   Movies~Action
   Movies~Documentary
   Movies~Drama
   Movies~Horror
   Music
   Sports

=back

=head1 AUTHOR (man pages)

Mike Constabel <epgsearch (at) constabel (dot) net>

=head1 REPORT BUGS

Bug reports (german):

L<http://projects.vdr-developer.org/projects/plg-epgsearch>

Mailing list:

L<http://www.vdr-developer.org/mailman/listinfo/epgsearch>

=head1 COPYRIGHT and LICENSE

Copyright (C) 2004-2010 Christian Wieninger

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.

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.

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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
Or, point your browser to http://www.gnu.org/licenses/old-licenses/gpl-2.0.html

The author can be reached at cwieninger@gmx.de

The project's page is at http://winni.vdr-developer.org/epgsearch

The MD5 code has been derived from the MD5 Message-Digest Algorithm of RSA Data Security, Inc.

=head1 SEE ALSO

B<epgsearch>(1), B<epgsearchcats.conf>(5), B<epgsearchuservars.conf>(5)
