File: lltag_formats.5

package info (click to toggle)
lltag 0.14.6-1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 476 kB
  • ctags: 253
  • sloc: perl: 2,833; makefile: 120; sh: 17
file content (112 lines) | stat: -rw-r--r-- 1,858 bytes parent folder | download | duplicates (7)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH lltag_formats 5 "NOVEMBER 2006"



.SH NAME
formats \- Internal formats database file for lltag




.SH DESCRIPTION
The internal format database is usually stored in
.IR /etc/lltag/formats .
The user may override this file by defining a
.IR $HOME/.lltag/formats .
If this file exists, the system-wide one is ignored.



These files contain entries starting with a line such as:

.I [%n - %a - %t]
.RS
A title between bracket that will be displayed at runtime.
.RE



Then, the following 3 lines must be given to explain how the format
is actually used to parse filenames:

.I type = basename
.RS
The type is either
.I basename
(to parse the last part of the path to a file)
or
.I path
(to parse the directory part of the path to a file).
When actually parsing the path to target files,
.I basename
and
.I path
parsers will be assembled.
All possible combination will be tried.
.RE



.I regexp = %L%N%S-%S%A%S-%S%A%L
.RS
A string composed of any characters, with the following special fields:

.I %L
for delimiter (empty by default, multiple spaces if
.I --spaces
was given)

.I %S
for a space (or multiple spaces if
.I --spaces
was given)

.I %N
for numbers

.I %A
for an alphanumeric string without /

.I %P
for any path (alphanumeric string with /)

.I %%
for %
.RE



.I indices = NUMBER,ARTIST,TITLE
.RS
A list of fields to match (either given by their full name or associated letter)
corresponding to each %N or %A field in the previous format.
It may be
.BR AUTHOR " (or " a "), "
.BR ALBUM " (" A "), "
.BR GENRE " (" g "), "
.BR NUMBER " (" n "), "
.BR TITLE " (" t "), "
.BR DATE " (" d "), "
.BR COMMENT " (" c ") or "
.BR IGNORE " (" i ")."
See also
.B FORMAT
in the manpage of
.I lltag
for details about these fields.




.SH SEE ALSO
.PP
.BR lltag (1)




.SH AUTHOR
Brice Goglin