Merge commit 'upstream/5.2.6+dfsg' into update
[pkg-bacula/bacula.git] / debian / patches / upstream___Add-missing-bwild-bregex-man8-pages.patch
1 Description: Add missing bwild & bregex man8 pages
2 Origin: upstream, commit:3cd099baf538d7773ca95a9ae793c9fed6abcbf7
3 Author: Bruno Friedmann <bruno@ioda-net.ch>
4 Last-Update: 2012-05-31
5
6 ---
7  bacula/manpages/Makefile.in |    2 +-
8  bacula/manpages/bregex.8    |   61 +++++++++++++++++++++++++++++++++++++++
9  bacula/manpages/bwild.8     |   66 +++++++++++++++++++++++++++++++++++++++++++
10  3 files changed, 128 insertions(+), 1 deletion(-)
11  create mode 100644 bacula/manpages/bregex.8
12  create mode 100644 bacula/manpages/bwild.8
13
14 --- a/manpages/Makefile.in
15 +++ b/manpages/Makefile.in
16 @@ -6,7 +6,7 @@
17  
18  MAN8 = bacula.8 bacula-dir.8 bacula-fd.8 bacula-sd.8 \
19         bconsole.8 bcopy.8 bextract.8 bls.8 bscan.8 btape.8 \
20 -       btraceback.8 dbcheck.8
21 +       btraceback.8 dbcheck.8 bwild.8 bregex.8 
22  
23  MAN1 = bacula-tray-monitor.1 bacula-bwxconsole.1 bsmtp.1 bat.1
24        
25 --- /dev/null
26 +++ b/manpages/bregex.8
27 @@ -0,0 +1,61 @@
28 +.\"                                      Hey, EMACS: -*- nroff -*-
29 +.\" First parameter, NAME, should be all caps
30 +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
31 +.\" other parameters are allowed: see man(7), man(1)
32 +.TH BREGEX 8 "30 October 2011" "Kern Sibbald" "Network backup, utilities"
33 +.\" Please adjust this date whenever revising the manpage.
34 +.\"
35 +.\" Some roff macros, for reference:
36 +.\" .nh        disable hyphenation
37 +.\" .hy        enable hyphenation
38 +.\" .ad l      left justify
39 +.\" .ad b      justify to both left and right margins
40 +.\" .nf        disable filling
41 +.\" .fi        enable filling
42 +.\" .br        insert line break
43 +.\" .sp <n>    insert n+1 empty lines
44 +.\" for manpage-specific macros, see man(7)
45 +.SH NAME
46 + bregex \- Bacula's 'regex' engine
47 +.SH SYNOPSIS
48 +.B bregex
49 +.RI [ options ]
50 +.I -f <data\-file>
51 +.br
52 +.SH DESCRIPTION
53 +This manual page documents briefly the
54 +.B bregex
55 +command.
56 +.br
57 +This program can be useful for testing regex expressions to be applied against a list of filenames.
58 +.PP
59 +.\" TeX users may be more comfortable with the \fB<whatever>\fP and
60 +.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
61 +.\" respectively.
62 +.SH OPTIONS
63 +A summary of options is included below.
64 +.TP
65 +.B \-?
66 +Show version and usage of program.
67 +.TP
68 +.BI \-d\  nn
69 +Set debug level to \fInn\fP.
70 +.TP
71 +.BI \-dt
72 +Print timestamp in debug output
73 +.TP
74 +.BI \-f\ <data\-file>
75 +The data-file is a filename that contains lines of data to be matched (or not) against one or more patterns. When the program is run, it will prompt you for a regular expression pattern, then apply it one line at a time against the data in the file. Each line that matches will be printed preceded by its line number. You will then be prompted again for another pattern. 
76 +.TP
77 +.BI \-n 
78 +Print lines that do not match
79 +.TP
80 +.BI \-l
81 +Suppress lines numbers.
82 +.SH SEE ALSO
83 +.BR regex(7)
84 +.br
85 +.SH AUTHOR
86 +This manual page was written by Bruno Friedmann
87 +.nh 
88 +<bruno@ioda\-net.ch>.
89 --- /dev/null
90 +++ b/manpages/bwild.8
91 @@ -0,0 +1,66 @@
92 +.\"                                      Hey, EMACS: -*- nroff -*-
93 +.\" First parameter, NAME, should be all caps
94 +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
95 +.\" other parameters are allowed: see man(7), man(1)
96 +.TH BWILD 8 "30 October 2011" "Kern Sibbald" "Network backup, utilities"
97 +.\" Please adjust this date whenever revising the manpage.
98 +.\"
99 +.\" Some roff macros, for reference:
100 +.\" .nh        disable hyphenation
101 +.\" .hy        enable hyphenation
102 +.\" .ad l      left justify
103 +.\" .ad b      justify to both left and right margins
104 +.\" .nf        disable filling
105 +.\" .fi        enable filling
106 +.\" .br        insert line break
107 +.\" .sp <n>    insert n+1 empty lines
108 +.\" for manpage-specific macros, see man(7)
109 +.SH NAME
110 + bwild \- Bacula's 'wildcard' engine
111 +.SH SYNOPSIS
112 +.B bwild
113 +.RI [ options ]
114 +.I -f <data\-file>
115 +.br
116 +.SH DESCRIPTION
117 +This manual page documents briefly the
118 +.B bwild
119 +command.
120 +.br
121 +This is a simple program that will allow you to test wild-card expressions against a file of data.
122 +.PP
123 +.\" TeX users may be more comfortable with the \fB<whatever>\fP and
124 +.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
125 +.\" respectively.
126 +.SH OPTIONS
127 +A summary of options is included below.
128 +.TP
129 +.B \-?
130 +Show version and usage of program.
131 +.TP
132 +.BI \-d\  nn
133 +Set debug level to \fInn\fP.
134 +.TP
135 +.BI \-dt
136 +Print timestamp in debug output
137 +.TP
138 +.BI \-f\ <data\-file>
139 +The data-file is a filename that contains lines of data to be matched (or not) against one or more patterns. When the program is run, it will prompt you for a wild-card pattern, then apply it one line at a time against the data in the file. Each line that matches will be printed preceded by its line number. You will then be prompted again for another pattern.
140 +.br
141 +Enter an empty line for a pattern to terminate the program. You can print only lines that do not match by using the -n option, and you can suppress printing of line numbers with the -l option. 
142 +.TP
143 +.BI \-n 
144 +Print lines that do not match
145 +.TP
146 +.BI \-l
147 +Suppress lines numbers.
148 +.TP
149 +.BI \-i
150 +use case insensitive match.
151 +.SH SEE ALSO
152 +.BR fnmatch(3)
153 +.br
154 +.SH AUTHOR
155 +This manual page was written by Bruno Friedmann
156 +.nh 
157 +<bruno@ioda\-net.ch>.