Refactoring: Verwendung von POSIX::strftime anstelle von localtime() + sprintf
[kivitendo-erp.git] / SL / Common.pm
1 #====================================================================
2 # LX-Office ERP
3 # Copyright (C) 2004
4 # Based on SQL-Ledger Version 2.1.9
5 # Web http://www.lx-office.org
6 #
7 #====================================================================
8
9 package Common;
10
11 use utf8;
12 use strict;
13
14 use Carp;
15 use English qw(-no_match_vars);
16 use Time::HiRes qw(gettimeofday);
17 use Data::Dumper;
18 use File::Copy;
19 use File::stat;
20 use File::Slurp;
21 use POSIX ();
22
23 use SL::DBUtils;
24
25 sub unique_id {
26   my ($a, $b) = gettimeofday();
27   return "${a}-${b}-${$}";
28 }
29
30 sub tmpname {
31   return "/tmp/kivitendo-tmp-" . unique_id();
32 }
33
34 sub truncate {
35   my ($text, %params) = @_;
36
37   $params{at}       //= 50;
38   $params{at}         =  3 if 3 > $params{at};
39
40   $params{strip}    //= '';
41
42   $text =~ s/[\r\n]+$//g if $params{strip} =~ m/^(?: 1 | newlines? | full )$/x;
43   $text =~ s/[\r\n]+/ /g if $params{strip} =~ m/^(?:     newlines? | full )$/x;
44
45   return $text if length($text) <= $params{at};
46   return substr($text, 0, $params{at} - 3) . '...';
47 }
48
49 sub retrieve_parts {
50   $main::lxdebug->enter_sub();
51
52   my ($self, $myconfig, $form, $order_by, $order_dir) = @_;
53
54   my $dbh = $form->dbconnect($myconfig);
55
56   my (@filter_values, $filter);
57
58   foreach (qw(partnumber description ean)) {
59     next unless $form->{$_};
60
61     $filter .= qq| AND ($_ ILIKE ?)|;
62     push @filter_values, '%' . $form->{$_} . '%';
63   }
64
65   if ($form->{no_assemblies}) {
66     $filter .= qq| AND (NOT COALESCE(assembly, FALSE))|;
67   }
68   if ($form->{assemblies}) {
69     $filter .= qq| AND assembly=TRUE|;
70   }
71
72   if ($form->{no_services}) {
73     $filter .= qq| AND (inventory_accno_id is not NULL or assembly=TRUE)|;
74   }
75
76   substr($filter, 1, 3) = "WHERE" if ($filter);
77
78   $order_by =~ s/[^a-zA-Z_]//g;
79   $order_dir = $order_dir ? "ASC" : "DESC";
80
81   my $query =
82     qq|SELECT id, partnumber, description, ean, | .
83     qq|       warehouse_id, bin_id | .
84     qq|FROM parts $filter | .
85     qq|ORDER BY $order_by $order_dir|;
86   my $sth = $dbh->prepare($query);
87   $sth->execute(@filter_values) || $form->dberror($query . " (" . join(", ", @filter_values) . ")");
88   my $parts = [];
89   while (my $ref = $sth->fetchrow_hashref()) {
90     push(@{$parts}, $ref);
91   }
92   $sth->finish();
93   $dbh->disconnect();
94
95   $main::lxdebug->leave_sub();
96
97   return $parts;
98 }
99
100 sub retrieve_projects {
101   $main::lxdebug->enter_sub();
102
103   my ($self, $myconfig, $form, $order_by, $order_dir) = @_;
104
105   my $dbh = $form->dbconnect($myconfig);
106
107   my (@filter_values, $filter);
108   if ($form->{"projectnumber"}) {
109     $filter .= qq| AND (projectnumber ILIKE ?)|;
110     push(@filter_values, '%' . $form->{"projectnumber"} . '%');
111   }
112   if ($form->{"description"}) {
113     $filter .= qq| AND (description ILIKE ?)|;
114     push(@filter_values, '%' . $form->{"description"} . '%');
115   }
116   substr($filter, 1, 3) = "WHERE" if ($filter);
117
118   $order_by =~ s/[^a-zA-Z_]//g;
119   $order_dir = $order_dir ? "ASC" : "DESC";
120
121   my $query =
122     qq|SELECT id, projectnumber, description | .
123     qq|FROM project $filter | .
124     qq|ORDER BY $order_by $order_dir|;
125   my $sth = $dbh->prepare($query);
126   $sth->execute(@filter_values) || $form->dberror($query . " (" . join(", ", @filter_values) . ")");
127   my $projects = [];
128   while (my $ref = $sth->fetchrow_hashref()) {
129     push(@{$projects}, $ref);
130   }
131   $sth->finish();
132   $dbh->disconnect();
133
134   $main::lxdebug->leave_sub();
135
136   return $projects;
137 }
138
139 sub retrieve_employees {
140   $main::lxdebug->enter_sub();
141
142   my ($self, $myconfig, $form, $order_by, $order_dir) = @_;
143
144   my $dbh = $form->dbconnect($myconfig);
145
146   my (@filter_values, $filter);
147   if ($form->{"name"}) {
148     $filter .= qq| AND (name ILIKE ?)|;
149     push(@filter_values, '%' . $form->{"name"} . '%');
150   }
151   substr($filter, 1, 3) = "WHERE" if ($filter);
152
153   $order_by =~ s/[^a-zA-Z_]//g;
154   $order_dir = $order_dir ? "ASC" : "DESC";
155
156   my $query =
157     qq|SELECT id, name | .
158     qq|FROM employee $filter | .
159     qq|ORDER BY $order_by $order_dir|;
160   my $sth = $dbh->prepare($query);
161   $sth->execute(@filter_values) || $form->dberror($query . " (" . join(", ", @filter_values) . ")");
162   my $employees = [];
163   while (my $ref = $sth->fetchrow_hashref()) {
164     push(@{$employees}, $ref);
165   }
166   $sth->finish();
167   $dbh->disconnect();
168
169   $main::lxdebug->leave_sub();
170
171   return $employees;
172 }
173
174 sub retrieve_customers_or_vendors {
175   $main::lxdebug->enter_sub();
176
177   my ($self, $myconfig, $form, $order_by, $order_dir, $is_vendor, $allow_both) = @_;
178
179   my $dbh = $form->dbconnect($myconfig);
180
181   my (@filter_values, $filter);
182   if ($form->{"name"}) {
183     $filter .= " AND (TABLE.name ILIKE ?)";
184     push(@filter_values, '%' . $form->{"name"} . '%');
185   }
186   if (!$form->{"obsolete"}) {
187     $filter .= " AND NOT TABLE.obsolete";
188   }
189   substr($filter, 1, 3) = "WHERE" if ($filter);
190
191   $order_by =~ s/[^a-zA-Z_]//g;
192   $order_dir = $order_dir ? "ASC" : "DESC";
193
194   my (@queries, @query_parameters);
195
196   if ($allow_both || !$is_vendor) {
197     my $c_filter = $filter;
198     $c_filter =~ s/TABLE/c/g;
199     push(@queries, qq|SELECT
200                         c.id, c.name, 0 AS customer_is_vendor,
201                         c.street, c.zipcode, c.city,
202                         ct.cp_gender, ct.cp_title, ct.cp_givenname, ct.cp_name
203                       FROM customer c
204                       LEFT JOIN contacts ct ON (c.id = ct.cp_cv_id)
205                       $c_filter|);
206     push(@query_parameters, @filter_values);
207   }
208
209   if ($allow_both || $is_vendor) {
210     my $v_filter = $filter;
211     $v_filter =~ s/TABLE/v/g;
212     push(@queries, qq|SELECT
213                         v.id, v.name, 1 AS customer_is_vendor,
214                         v.street, v.zipcode, v.city,
215                         ct.cp_gender, ct.cp_title, ct.cp_givenname, ct.cp_name
216                       FROM vendor v
217                       LEFT JOIN contacts ct ON (v.id = ct.cp_cv_id)
218                       $v_filter|);
219     push(@query_parameters, @filter_values);
220   }
221
222   my $query = join(" UNION ", @queries) . " ORDER BY $order_by $order_dir";
223   my $sth = $dbh->prepare($query);
224   $sth->execute(@query_parameters) || $form->dberror($query . " (" . join(", ", @query_parameters) . ")");
225   my $customers = [];
226   while (my $ref = $sth->fetchrow_hashref()) {
227     push(@{$customers}, $ref);
228   }
229   $sth->finish();
230   $dbh->disconnect();
231
232   $main::lxdebug->leave_sub();
233
234   return $customers;
235 }
236
237 sub retrieve_delivery_customer {
238   $main::lxdebug->enter_sub();
239
240   my ($self, $myconfig, $form, $order_by, $order_dir) = @_;
241
242   my $dbh = $form->dbconnect($myconfig);
243
244   my (@filter_values, $filter);
245   if ($form->{"name"}) {
246     $filter .= qq| (name ILIKE ?) AND|;
247     push(@filter_values, '%' . $form->{"name"} . '%');
248   }
249
250   $order_by =~ s/[^a-zA-Z_]//g;
251   $order_dir = $order_dir ? "ASC" : "DESC";
252
253   my $query =
254     qq!SELECT id, name, customernumber, (street || ', ' || zipcode || city) AS address ! .
255     qq!FROM customer ! .
256     qq!WHERE $filter business_id = (SELECT id FROM business WHERE description = 'Endkunde') ! .
257     qq!ORDER BY $order_by $order_dir!;
258   my $sth = $dbh->prepare($query);
259   $sth->execute(@filter_values) ||
260     $form->dberror($query . " (" . join(", ", @filter_values) . ")");
261   my $delivery_customers = [];
262   while (my $ref = $sth->fetchrow_hashref()) {
263     push(@{$delivery_customers}, $ref);
264   }
265   $sth->finish();
266   $dbh->disconnect();
267
268   $main::lxdebug->leave_sub();
269
270   return $delivery_customers;
271 }
272
273 sub retrieve_vendor {
274   $main::lxdebug->enter_sub();
275
276   my ($self, $myconfig, $form, $order_by, $order_dir) = @_;
277
278   my $dbh = $form->dbconnect($myconfig);
279
280   my (@filter_values, $filter);
281   if ($form->{"name"}) {
282     $filter .= qq| (name ILIKE ?) AND|;
283     push(@filter_values, '%' . $form->{"name"} . '%');
284   }
285
286   $order_by =~ s/[^a-zA-Z_]//g;
287   $order_dir = $order_dir ? "ASC" : "DESC";
288
289   my $query =
290     qq!SELECT id, name, customernumber, (street || ', ' || zipcode || city) AS address FROM customer ! .
291     qq!WHERE $filter business_id = (SELECT id FROM business WHERE description = ?') ! .
292     qq!ORDER BY $order_by $order_dir!;
293   push @filter_values, $::locale->{iconv_utf8}->convert('Händler');
294   my $sth = $dbh->prepare($query);
295   $sth->execute(@filter_values) ||
296     $form->dberror($query . " (" . join(", ", @filter_values) . ")");
297   my $vendors = [];
298   while (my $ref = $sth->fetchrow_hashref()) {
299     push(@{$vendors}, $ref);
300   }
301   $sth->finish();
302   $dbh->disconnect();
303
304   $main::lxdebug->leave_sub();
305
306   return $vendors;
307 }
308
309 sub mkdir_with_parents {
310   $main::lxdebug->enter_sub();
311
312   my ($full_path) = @_;
313
314   my $path = "";
315
316   $full_path =~ s|/+|/|;
317
318   foreach my $part (split(m|/|, $full_path)) {
319     $path .= "/" if ($path);
320     $path .= $part;
321
322     die("Could not create directory '$path' because a file exists with " .
323         "the same name.\n") if (-f $path);
324
325     if (! -d $path) {
326       mkdir($path, 0770) || die("Could not create the directory '$path'. " .
327                                 "OS error: $!\n");
328     }
329   }
330
331   $main::lxdebug->leave_sub();
332 }
333
334 sub webdav_folder {
335   $main::lxdebug->enter_sub();
336
337   my ($form) = @_;
338
339   return $main::lxdebug->leave_sub()
340     unless ($::instance_conf->get_webdav && $form->{id});
341
342
343
344   $form->{WEBDAV} = [];
345
346   my ($path, $number) = get_webdav_folder($form);
347   return $main::lxdebug->leave_sub() unless ($path && $number);
348
349   if (!-d $path) {
350     mkdir_with_parents($path);
351
352   } else {
353     my $base_path = $ENV{'SCRIPT_NAME'};
354     $base_path =~ s|[^/]+$||;
355     if (opendir my $dir, $path) {
356       foreach my $file (sort { lc $a cmp lc $b } readdir $dir) {
357         next if (($file eq '.') || ($file eq '..'));
358
359         my $fname = $file;
360         $fname  =~ s|.*/||;
361
362         my $is_directory = -d "$path/$file";
363
364         $file  = join('/', map { $form->escape($_) } grep { $_ } split m|/+|, "$path/$file");
365         $file .=  '/' if ($is_directory);
366
367         push @{ $form->{WEBDAV} }, {
368           'name' => $fname,
369           'link' => $base_path . $file,
370           'type' => $is_directory ? $main::locale->text('Directory') : $main::locale->text('File'),
371         };
372       }
373
374       closedir $dir;
375     }
376   }
377
378   $main::lxdebug->leave_sub();
379 }
380
381 sub get_vc_details {
382   $main::lxdebug->enter_sub();
383
384   my ($self, $myconfig, $form, $vc, $vc_id) = @_;
385
386   $vc = $vc eq "customer" ? "customer" : "vendor";
387
388   my $dbh = $form->dbconnect($myconfig);
389
390   my $query;
391
392   $query =
393     qq|SELECT
394          vc.*,
395          pt.description AS payment_terms,
396          b.description AS business,
397          l.description AS language
398        FROM ${vc} vc
399        LEFT JOIN payment_terms pt ON (vc.payment_id = pt.id)
400        LEFT JOIN business b ON (vc.business_id = b.id)
401        LEFT JOIN language l ON (vc.language_id = l.id)
402        WHERE vc.id = ?|;
403   my $ref = selectfirst_hashref_query($form, $dbh, $query, $vc_id);
404
405   if (!$ref) {
406     $dbh->disconnect();
407     $main::lxdebug->leave_sub();
408     return 0;
409   }
410
411   map { $form->{$_} = $ref->{$_} } keys %{ $ref };
412
413   map { $form->{$_} = $form->format_amount($myconfig, $form->{$_} * 1) } qw(discount creditlimit);
414
415   $query = qq|SELECT * FROM shipto WHERE (trans_id = ?)|;
416   $form->{SHIPTO} = selectall_hashref_query($form, $dbh, $query, $vc_id);
417
418   $query = qq|SELECT * FROM contacts WHERE (cp_cv_id = ?)|;
419   $form->{CONTACTS} = selectall_hashref_query($form, $dbh, $query, $vc_id);
420
421   # Only show default pricegroup for customer, not vendor, which is why this is outside the main query
422   ($form->{pricegroup}) = selectrow_query($form, $dbh, qq|SELECT pricegroup FROM pricegroup WHERE id = ?|, $form->{klass});
423
424   $dbh->disconnect();
425
426   $main::lxdebug->leave_sub();
427
428   return 1;
429 }
430
431 sub get_shipto_by_id {
432   $main::lxdebug->enter_sub();
433
434   my ($self, $myconfig, $form, $shipto_id, $prefix) = @_;
435
436   $prefix ||= "";
437
438   my $dbh = $form->dbconnect($myconfig);
439
440   my $query = qq|SELECT * FROM shipto WHERE shipto_id = ?|;
441   my $ref   = selectfirst_hashref_query($form, $dbh, $query, $shipto_id);
442
443   map { $form->{"${prefix}${_}"} = $ref->{$_} } keys %{ $ref } if $ref;
444
445   $dbh->disconnect();
446
447   $main::lxdebug->leave_sub();
448 }
449
450 sub save_email_status {
451   $main::lxdebug->enter_sub();
452
453   my ($self, $myconfig, $form) = @_;
454
455   my ($table, $query, $dbh);
456
457   if ($form->{script} eq 'oe.pl') {
458     $table = 'oe';
459
460   } elsif ($form->{script} eq 'is.pl') {
461     $table = 'ar';
462
463   } elsif ($form->{script} eq 'ir.pl') {
464     $table = 'ap';
465
466   } elsif ($form->{script} eq 'do.pl') {
467     $table = 'delivery_orders';
468   }
469
470   return $main::lxdebug->leave_sub() if (!$form->{id} || !$table || !$form->{formname});
471
472   $dbh = $form->get_standard_dbh($myconfig);
473
474   my ($intnotes) = selectrow_query($form, $dbh, qq|SELECT intnotes FROM $table WHERE id = ?|, $form->{id});
475
476   $intnotes =~ s|\r||g;
477   $intnotes =~ s|\n$||;
478
479   $intnotes .= "\n\n" if ($intnotes);
480
481   my $cc  = $form->{cc}  ? $main::locale->text('Cc') . ": $form->{cc}\n"   : '';
482   my $bcc = $form->{bcc} ? $main::locale->text('Bcc') . ": $form->{bcc}\n" : '';
483   my $now = scalar localtime;
484
485   $intnotes .= $main::locale->text('[email]') . "\n"
486     . $main::locale->text('Date') . ": $now\n"
487     . $main::locale->text('To (email)') . ": $form->{email}\n"
488     . "${cc}${bcc}"
489     . $main::locale->text('Subject') . ": $form->{subject}\n\n"
490     . $main::locale->text('Message') . ": $form->{message}";
491
492   $intnotes =~ s|\r||g;
493
494   do_query($form, $dbh, qq|UPDATE $table SET intnotes = ? WHERE id = ?|, $intnotes, $form->{id});
495
496   $form->save_status($dbh);
497
498   $dbh->commit();
499
500   $main::lxdebug->leave_sub();
501 }
502
503 sub check_params {
504   my $params = shift;
505
506   foreach my $key (@_) {
507     if ((ref $key eq '') && !defined $params->{$key}) {
508       my $subroutine = (caller(1))[3];
509       $main::lxdebug->message(LXDebug->BACKTRACE_ON_ERROR, "[Common::check_params] failed, params object dumped below");
510       $main::lxdebug->message(LXDebug->BACKTRACE_ON_ERROR, Dumper($params));
511       $main::form->error($main::locale->text("Missing parameter #1 in call to sub #2.", $key, $subroutine));
512
513     } elsif (ref $key eq 'ARRAY') {
514       my $found = 0;
515       foreach my $subkey (@{ $key }) {
516         if (defined $params->{$subkey}) {
517           $found = 1;
518           last;
519         }
520       }
521
522       if (!$found) {
523         my $subroutine = (caller(1))[3];
524         $main::lxdebug->message(LXDebug->BACKTRACE_ON_ERROR, "[Common::check_params] failed, params object dumped below");
525         $main::lxdebug->message(LXDebug->BACKTRACE_ON_ERROR, Dumper($params));
526         $main::form->error($main::locale->text("Missing parameter (at least one of #1) in call to sub #2.", join(', ', @{ $key }), $subroutine));
527       }
528     }
529   }
530 }
531
532 sub check_params_x {
533   my $params = shift;
534
535   foreach my $key (@_) {
536     if ((ref $key eq '') && !exists $params->{$key}) {
537       my $subroutine = (caller(1))[3];
538       $main::form->error($main::locale->text("Missing parameter #1 in call to sub #2.", $key, $subroutine));
539
540     } elsif (ref $key eq 'ARRAY') {
541       my $found = 0;
542       foreach my $subkey (@{ $key }) {
543         if (exists $params->{$subkey}) {
544           $found = 1;
545           last;
546         }
547       }
548
549       if (!$found) {
550         my $subroutine = (caller(1))[3];
551         $main::form->error($main::locale->text("Missing parameter (at least one of #1) in call to sub #2.", join(', ', @{ $key }), $subroutine));
552       }
553     }
554   }
555 }
556
557 sub get_webdav_folder {
558   $main::lxdebug->enter_sub();
559
560   my ($form) = @_;
561
562   croak "No client set in \$::auth" unless $::auth->client;
563
564   my ($path, $number);
565
566   # dispatch table
567   if ($form->{type} eq "sales_quotation") {
568     ($path, $number) = ("angebote", $form->{quonumber});
569   } elsif ($form->{type} eq "sales_order") {
570     ($path, $number) = ("bestellungen", $form->{ordnumber});
571   } elsif ($form->{type} eq "request_quotation") {
572     ($path, $number) = ("anfragen", $form->{quonumber});
573   } elsif ($form->{type} eq "purchase_order") {
574     ($path, $number) = ("lieferantenbestellungen", $form->{ordnumber});
575   } elsif ($form->{type} eq "sales_delivery_order") {
576     ($path, $number) = ("verkaufslieferscheine", $form->{donumber});
577   } elsif ($form->{type} eq "purchase_delivery_order") {
578     ($path, $number) = ("einkaufslieferscheine", $form->{donumber});
579   } elsif ($form->{type} eq "credit_note") {
580     ($path, $number) = ("gutschriften", $form->{invnumber});
581   } elsif ($form->{vc} eq "customer") {
582     ($path, $number) = ("rechnungen", $form->{invnumber});
583   } elsif ($form->{vc} eq "vendor") {
584     ($path, $number) = ("einkaufsrechnungen", $form->{invnumber});
585   } else {
586     $main::lxdebug->leave_sub();
587     return undef;
588   }
589
590   $number =~ s|[/\\]|_|g;
591
592   $path = "webdav/" . $::auth->client->{id} . "/${path}/${number}";
593
594   $main::lxdebug->leave_sub();
595
596   return ($path, $number);
597 }
598
599 sub copy_file_to_webdav_folder {
600   $::lxdebug->enter_sub();
601
602   my ($form) = @_;
603   my ($last_mod_time, $latest_file_name, $complete_path);
604
605   # checks
606   foreach my $item (qw(tmpdir tmpfile type)){
607     next if $form->{$item};
608     $::lxdebug->message(LXDebug::WARN(), 'Missing parameter');
609     $::form->error($::locale->text("Missing parameter for webdav file copy"));
610   }
611
612   my ($webdav_folder, $document_name) =  get_webdav_folder($form);
613
614   if (! $webdav_folder){
615     $::lxdebug->leave_sub();
616     $::form->error($::locale->text("Cannot check correct webdav folder"));
617     return undef;
618   }
619
620   $complete_path =  join('/', $form->{cwd},  $webdav_folder);
621   opendir my $dh, $complete_path or die "Could not open $complete_path: $!";
622
623   my ($newest_name, $newest_time);
624   while ( defined( my $file = readdir( $dh ) ) ) {
625     my $path = File::Spec->catfile( $complete_path, $file );
626     next if -d $path; # skip directories, or anything else you like
627     ( $newest_name, $newest_time ) = ( $file, -M _ ) if( ! defined $newest_time or -M $path < $newest_time );
628   }
629
630   closedir $dh;
631
632   $latest_file_name    = $complete_path .'/' . $newest_name;
633   my $filesize         = stat($latest_file_name)->size;
634
635   my ($ext)            = $form->{tmpfile} =~ /(\.[^.]+)$/;
636   my $current_file     = join('/', $form->{tmpdir}, $form->{tmpfile});
637   my $current_filesize = -f $current_file ? stat($current_file)->size : 0;
638
639   if ($current_filesize == $filesize) {
640     $::lxdebug->leave_sub();
641     return;
642   }
643
644   my $timestamp  =  get_current_formatted_time();
645   my $myfilename =  $form->generate_attachment_filename();
646   $myfilename    =~ s/\./$timestamp\./;
647
648   if (!copy(join('/', $form->{tmpdir}, $form->{tmpfile}), join('/', $form->{cwd}, $webdav_folder, $myfilename))) {
649     my $from = join('/', $form->{tmpdir}, $form->{tmpfile});
650     my $to   = join('/', $form->{cwd},    $webdav_folder);
651     $::lxdebug->message(LXDebug::WARN(), "Copy file from $from to $to failed");
652     $::form->error($::locale->text("Copy file from #1 to #2 failed", $from, $to));
653   }
654
655   $::lxdebug->leave_sub();
656 }
657
658 sub get_current_formatted_time {
659   return POSIX::strftime('_%Y%m%d_%H%M%S', localtime());
660 }
661
662 1;
663 __END__
664
665 =pod
666
667 =encoding utf8
668
669 =head1 NAME
670
671 Common - Common routines used in a lot of places.
672
673 =head1 SYNOPSIS
674
675   my $short_text = Common::truncate($long_text, at => 10);
676
677 =head1 FUNCTIONS
678
679 =over 4
680
681 =item C<truncate $text, %params>
682
683 Truncates C<$text> at a position and insert an ellipsis if the text is
684 longer. The maximum number of characters to return is given with the
685 paramter C<at> which defaults to 50.
686
687 The optional parameter C<strip> can be used to remove unwanted line
688 feed/carriage return characters from the text before truncation. It
689 can be set to C<1> (only strip those at the end of C<$text>) or
690 C<full> (replace consecutive line feed/carriage return characters in
691 the middle by a single space and remove tailing line feed/carriage
692 return characters).
693
694 =back
695
696 =head1 BUGS
697
698 Nothing here yet.
699
700 =head1 AUTHOR
701
702 Moritz Bunkus E<lt>m.bunkus@linet-services.deE<gt>,
703 Sven Schöling E<lt>s.schoeling@linet-services.deE<gt>
704
705 =cut