GNU/Linux->UNIX
[MyWeb.git] / Web.pm
1 # $Id$
2 # Common functions for HTML/XHTML output generation
3 # Copyright (C) 2003 Jan Kratochvil <project-www.jankratochvil.net@jankratochvil.net>
4
5 # This program is free software; you can redistribute it and/or modify
6 # it under the terms of the GNU General Public License as published by
7 # the Free Software Foundation; exactly version 2 of June 1991 is required
8
9 # This program is distributed in the hope that it will be useful,
10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12 # GNU General Public License for more details.
13
14 # You should have received a copy of the GNU General Public License
15 # along with this program; if not, write to the Free Software
16 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
17
18
19 package My::Web;
20 require 5.6.0;  # at least 'use warnings;' but we need some 5.6.0+ modules anyway
21 our $VERSION=do { my @r=(q$Revision$=~/\d+/g); sprintf "%d.".("%03d"x$#r),@r; };
22 our $CVS_ID=q$Id$;
23 use strict;
24 use warnings;
25
26 use Exporter;
27 sub Wrequire ($);
28 sub Wuse ($@);
29 our $W;
30 our @EXPORT=qw(&Wrequire &Wuse &a_href &a_href_cz &vskip &img &centerimg $W &top_dir &top_dir_disk);
31 our @ISA=qw(Exporter);
32
33 BEGIN
34 {
35         sub Wrequire ($)
36         {
37         my($file)=@_;
38
39 #               print STDERR "Wrequire $file\n";
40                 $file=~s#/#::#g;
41                 $file=~s/[.]pm$//;
42                 my $class=$file;
43                 $file=~s#::#/#g;
44                 $file.=".pm";
45                 my $aref=($W->{"packages_used"}{$Apache::Registry::curstash}||=[]);
46                 push @$aref,$class
47                                 if !{ map(($_=>1),@$aref) }->{$class};  # Prevent duplicated entries.
48                 CORE::require $file;
49                 1;      # Otherwise 'require' would already file above.
50         }
51
52         sub Wuse ($@)
53         {
54         my($file,@list)=@_;
55
56 #               print STDERR "Wuse $file\n";
57                 Wrequire $file;
58                 local $Exporter::ExportLevel=$Exporter::ExportLevel+1;
59                 $file->import(@list);
60                 1;
61         }
62 }
63
64 BEGIN { Wuse 'WebConfig'; }     # for %WebConfig
65 require CGI;    # for &escapeHTML
66 require Image::Size;    # for &imgsize
67 use File::Basename;     # &basename
68 use Carp qw(cluck confess);
69 use URI::Escape;
70 require HTTP::BrowserDetect;
71 require HTTP::Negotiate;
72 require Geo::IP;
73 require CGI;
74
75
76 # Undo 'www/engine/httpd-restart' as it may use obsolete Perl for 'mod_perl'
77 delete $ENV{"PERLLIB"};
78 delete $ENV{"LD_LIBRARY_PATH"};
79
80
81 #our $W;
82                 # $W->{"title"}
83                 # $W->{"head"}
84                 # $W->{"head_css"}
85                 # $W->{"force_charset"}
86                 # %{$W->{"packages_used"}
87                 # $W->{"heading_done"}
88                 # $W->{"footer_passed"}
89                 # %{$W->{"headers"}}
90                 # %{$W->{"headers_lc"}} # maps lc($headers_key)=>$headers_key
91                 # @{$W->{"packages_used"}{$Apache::Registry::curstash}}}
92                 # %{$W->{"args"}}
93
94 sub init ($%)
95 {
96 my($class,%args)=@_;
97
98         my $packages_used_save=$W->{"packages_used"};
99         $W={ %WebConfig,%args };        # override %WebConfig settings
100         $W->{"packages_used"}=$packages_used_save;
101
102         $W->{"__PACKAGE__"}||="Apache::ROOT".$Apache::Registry::curstash;
103
104         $W->{"top_dir"}||=eval '$'.$W->{"__PACKAGE__"}.'::top_dir';
105
106         do { $W->{$_}=0  if !defined $W->{$_}; } for ("detect_ent");
107         do { $W->{$_}=0  if !defined $W->{$_}; } for ("detect_js");
108         do { $W->{$_}=1  if !defined $W->{$_}; } for ("have_css");      # AFAIK it does not hurt anyone.
109         do { $W->{$_}=1  if !defined $W->{$_}; } for ("heading");
110         do { $W->{$_}=1  if !defined $W->{$_}; } for ("footer");
111         do { $W->{$_}=1  if !defined $W->{$_}; } for ("footer_delimit");
112         do { $W->{$_}=1  if !defined $W->{$_}; } for ("footer_mailme");
113         do { $W->{$_}=1  if !defined $W->{$_}; } for ("footer_ids");
114         do { $W->{$_}=1  if !defined $W->{$_}; } for ("indexme");
115         do { $W->{$_}="" if !defined $W->{$_}; } for ("head");
116         do { $W->{$_}="" if !defined $W->{$_}; } for ("head_css");
117
118         my $footer_any=0;
119         for (qw(footer_mailme footer_ids)) {
120                 $W->{$_}=0 if !$W->{"footer"};
121                 $footer_any=1 if $W->{$_};
122                 }
123         $W->{"footer"}=0 if !$footer_any;
124         $W->{"footer_delimit"}=0 if !$W->{"footer"};
125
126         $W->{"r"}=Apache->request();
127
128         $W->{"QUERY_STRING"}=$W->{"r"}->args() || "";
129            if ($W->{"QUERY_STRING"}=~/[&]amp;have_ent/)
130                 { $W->{"have_ent"}=0; }
131         elsif ($W->{"QUERY_STRING"}=~    /[&]have_ent/)
132                 { $W->{"have_ent"}=1; }
133         else
134                 { delete $W->{"have_ent"}; }
135         if ($W->{"detect_ent"} && !defined $W->{"have_ent"} && $W->{"r"}->method() eq "GET") {
136                 $W->{"head"}.='<meta http-equiv="Refresh" content="0; URL='
137                                 .CGI::escapeHTML("http://".$W->{"r"}->hostname()."/".($W->{"r"}->uri()=~m#^/*(.*)$#)[0]
138                                                 ."?".($W->{"QUERY_STRING"} || "detect_ent_glue=1").'&have_ent=detect')
139                                 .'" />'."\n";
140                 }
141         $W->{"QUERY_STRING"}=~s/([&])amp;/$1/g;
142         $W->{"r"}->args($W->{"QUERY_STRING"});
143         $ENV{"QUERY_STRING"}=$W->{"QUERY_STRING"};
144         # Do not: $W->{"r"}->args()
145         # as it  parses only QUERY_STRING (not POST data).
146         $W->{"args"}={ CGI->new()->Vars() };
147
148         do { $W->{$_}=$ENV{"HTTP_ACCEPT"} if !defined $W->{$_}; } for ("accept");
149         do { $W->{$_}=$ENV{"HTTP_USER_AGENT"} if !defined $W->{$_}; } for ("user_agent");
150
151         $W->{"browser"}=HTTP::BrowserDetect->new($W->{"user_agent"});
152
153         if (!defined $W->{"have_style"}) {
154                 $W->{"have_style"}=(!$W->{"browser"}->netscape() || $W->{"browser"}->major>4 ? 1 : 0);
155                 }
156
157         $W->{"have_js"}=($W->{"args"}{"have_js"} ? 1 : 0);
158         if ($W->{"detect_js"} && !$W->{"have_js"}) {
159                 $W->{"head"}.='<script type="text/javascript" src="'.top_dir('/have_js.js.pl').'"></script>'."\n";
160                 }
161
162         do { args_check(%$_) if $_; } for ($W->{"args_check"});
163
164         return $W;
165 }
166
167 sub top_dir_disk ()
168 {
169         do { return $_ if $_; } for ($W->{"top_dir"});
170         return $INC[0]; # fallback
171 }
172
173 sub top_dir (;$)
174 {
175 my($in)=@_;
176
177         if (my $uri=$ENV{"REQUEST_URI"}) {
178                 $uri.="Index" if $uri=~m#/$#;
179                 if (defined $in) {
180                         my($inpath,$inquery)=split /[?]/,$in,2;
181                         $inpath=~tr///cs;
182                         $uri=~tr///cs;
183                         for (;;) {
184                                 my($in1 ,$in2 )=($in =~m#^(/[^/]+)(/.*)$#);
185                                 my($uri1,$uri2)=($uri=~m#^(/[^/]+)(/.*)$#);
186                                 last if !defined $in1 || !defined $uri1 || $in1 ne $uri1;
187                                 $in=$in2;
188                                 $uri=$uri2;
189                                 }
190                         }
191                 $uri=~s#^/*##;
192                 $uri=~s#[^/]+#..#g;
193                 $uri=File::Basename::dirname($uri);
194                 my $r=$uri.(defined $in ? $in : "");
195 #               1 while $r=~s#^[.]/##;
196 #               $r="./$r" if $r=~m#^(?:?.*)$#;  # empty pathname?
197                 return $r;
198                 }
199         return top_dir_disk().$in;
200 }
201
202 sub fatal (;$);
203
204 sub args_check (%)
205 {
206 my(%tmpl)=@_;
207
208         while (my($name,$regex)=each(%tmpl)) {
209                 my $name_html="Parameter <span class=\"quote\">".CGI::escapeHTML($name)."</span>";
210                 $W->{"args"}{$name}="" if !defined $W->{"args"}{$name};
211                 my $val=$W->{"args"}{$name};
212                 $val="" if !defined $val;
213                 fatal "$name_html <span class=\"quote\">".CGI::escapeHTML($val)."</span>"
214                                                 ." does not match required regex <span class=\"quote\">".CGI::escapeHTML($regex)."</span> "
215                                 if $regex ne "" && $val!~/$regex/;
216                 }
217 }
218
219 sub vskip (;$)
220 {
221 my($height)=@_;
222
223         return '<p'.(!defined $height ? "" : ' style="height: '.$height.';"').'>&nbsp;</p>'."\n";
224 }
225
226 sub fatal (;$)
227 {
228 my($msg)=@_;
229
230         $msg="UNKNOWN" if !$msg;
231
232 #       heading(false/*title*/,false/*indexme*/);       # notitle is always safe, don't index the error message
233         print "\n".vskip("3ex")."<hr /><h1 class=\"error\">FATAL ERROR: $msg!</h1>\n"
234                         ."<p>You can report this problem's details to"
235                         ." ".a_href("mailto:".$W->{"admin_mail"},"admin of this website").".</p>\n";
236         footer();
237 }
238
239 sub footer (;$)
240 {
241         exit 1 if $W->{"footer_passed"}++;      # deadlock prevention:
242
243         print vskip if $W->{"footer_delimit"};
244
245         print "<hr />\n" if $W->{"footer"};
246
247         if ($W->{"footer_mailme"}) {
248                 print '<form action="'.top_dir('/SendMsg.pl').'" method="post" onsubmit="'
249                                 ."this.elements['msgscript'].value=this.elements['msghtml'].value;"
250                                 ."this.elements['msghtml'].value='';"
251                                 ."this.submit();"
252                                 .'">'."\n";
253                         print '<p align="right">'."\n";
254                                 print '<input name="msgscript" type="hidden" />'."\n";
255                                 print '<input name="msghtml" type="text" size="32" alt="Message" />'."\n";
256                                 print '<input name="submit" type="submit" value="Quick Note" />'."\n";
257                         print '</p>'."\n";
258                 print '</form>'."\n";
259                 }
260
261         if ($W->{"footer_ids"}) {
262                 print '<p class="cvs-id">';
263                 print join("<br />\n",map({ my $package=$_;
264                         my $cvs_id=(eval('$'.$package."::CVS_ID")
265 #                                       || $package     # debug
266                                         );
267                         if (!$cvs_id) {
268                                 ();
269                                 }
270                         else {
271                                 $cvs_id='$'.$cvs_id.'$';        # Eaten by 'q' operator.
272                                 my @cvs_id_split=split / +/,$cvs_id;
273                                 if (@cvs_id_split==8) {
274                                         my $file=$package;
275                                         $file=~s#::#/#g;
276                                         my $ext;
277                                         for (qw(.html.pl .pl .pm),"") {
278                                                 $ext=$_;
279                                                 last if -r top_dir_disk()."/$file$ext";
280                                                 cluck "Class file $file not found" if !$ext;
281                                                 }
282                                         $file.=$ext;
283                                         $cvs_id_split[2]=""
284                                                         .a_href((map({ my $s=$_; $s=~s#/viewcvs/#$&~checkout~/#; $s; } $W->{"viewcvs"}))[0]."$file?rev=".$cvs_id_split[2],
285                                                                         $cvs_id_split[2]);
286                                         $cvs_id_split[1]=a_href($W->{"viewcvs"}.$file,
287                                                         ($package!~/^Apache::/ ? $package : $cvs_id_split[1]));
288                                         $cvs_id_split[5]=&{$W->{"cvs_id_author"}}($cvs_id_split[5]);
289                                         }
290                                 join " ",@cvs_id_split;
291                                 }
292                         } (
293                                         $W->{"__PACKAGE__"},
294                                         __PACKAGE__,
295                                         @{$W->{"packages_used"}{$Apache::Registry::curstash}},
296                                         )));
297                 print "</p>\n";
298                 }
299
300         for my $package (
301                         $W->{"__PACKAGE__"},
302                         __PACKAGE__,
303                         @{$W->{"packages_used"}{$Apache::Registry::curstash}},
304                         ) {
305                 my $cvs_id=(eval('$'.$package."::CVS_ID")
306 #                               || $package     # debug
307                                 );
308                 print '<!-- '.$package.' - $'.$cvs_id.'$ -->'."\n" if $cvs_id;
309                 }
310
311         if ($W->{"heading"}) {
312                 do { &{$_}() if $_; } for ($W->{"footing"});
313                 }
314
315         print "</body></html>\n";
316         exit(0);
317 }
318
319 sub header (%)
320 {
321 my(%pairs)=@_;
322
323         while (my($key,$val)=each(%pairs)) {
324                 do { cluck "Headers already sent"; next; } if $W->{"heading_done"};
325                 for ($W->{"headers_lc"}{lc $key} || ()) {
326                         delete $W->{"headers"}{$_};
327                         }
328                 $W->{"headers_lc"}{lc $key}=$key;
329                 $W->{"headers"}{$key}=$val;
330                 }
331 }
332
333 sub size_display ($)
334 {
335 my($size)=@_;
336
337            if ($size<4096)
338                 {}
339         elsif ($size<1024*1024)
340                 { $size=sprintf "%.1fK",$size/1024; }
341         else
342                 { $size=sprintf "%.1fM",$size/1024/1024; }
343         $size.="B";
344         return $size;
345 }
346
347 sub url_is_local ($)
348 {
349 my($url)=@_;
350
351         return $url!~m#^[a-z]+://#;
352 }
353
354 sub a_href ($;$%)
355 {
356 my($url,$contents,%args)=@_;
357
358         do { $$_=1 if !defined $$_; } for (\$args{"size"});
359         $contents=CGI::escapeHTML($url) if !defined $contents;
360         $contents=~s#<a\b[^>]*>##gi;
361         $contents=~s#</a>##gi;
362
363         $url=top_dir($url) if url_is_local $url && $url=~m#^/#;
364
365         my $r='<a href="';
366         my $urlent=CGI::escapeHTML($url);
367            if ($url eq $urlent)
368                 { $r.=$url; }
369         elsif (url_is_local $url)
370                 { $r.=$urlent; }
371         elsif (defined $W->{"have_ent"} && !$W->{"have_ent"})   # non-ent client
372                 { $r.=$url; }
373         elsif ($W->{"have_ent"})        # ent client
374                 { $r.=$urlent; }
375         else    # unknown client, &CGI::escapeHTML should not be needed here
376                 { $r.=CGI::escapeHTML(top_dir('/Redirect.pl?location='.uri_escape($url))); }
377         $r.='"';
378         do { $r.=" $_" if $_; } for ($args{"attr"});
379         $r.='>'.$contents.'</a>';
380         if ($args{"size"} && url_is_local($url) && $url=~/[.](?:gz|Z|rpm|zip|deb|lha)/) {       # Downloadable?
381                 $url=top_dir_disk().$url if $url=~m#^/#;
382                 if (!-r $url)
383                         { cluck "File not readable: $url"; }
384                 else {
385                         $r.='&nbsp;('.size_display((stat($url))[7]).')';
386                         }
387                 }
388         return $r;
389 }
390
391 sub remote_ip ()
392 {
393         # Do not: PerlModule                 Apache::ForwardedFor
394         #         PerlPostReadRequestHandler Apache::ForwardedFor
395         # As 'Apache::ForwardedFor' takes the first of $ENV{"HTTP_X_FORWARDED_FOR"}
396         # while the contents is '127.0.0.1, 213.220.195.171' if client has its own proxy.
397         # We must take the last item ourselves.
398         my $r=$ENV{"HTTP_X_FORWARDED_FOR"} || $W->{"r"}->get_remote_host();
399         $r=~s/^.*,\s*//;
400         return $r;
401 }
402
403 sub is_cz ()
404 {
405         return "CZ" eq Geo::IP->new()->country_code_by_addr(remote_ip());
406 }
407
408 sub a_href_cz ($$;%)
409 {
410 my($url,$contents,%args)=@_;
411
412         return a_href $url,$contents,%args if is_cz();
413         return $contents;
414 }
415
416 sub make ($)
417 {
418 my($cmd)=@_;
419
420         system {'flock'} 'flock','-x',top_dir_disk(),$cmd.' >&2';
421 }
422
423 sub img_size ($$)
424 {
425 my($width,$height)=@_;
426
427         return ($W->{"have_style"} ? "style=\"border:0;width:${width}px;height:${height}px\"" : "border=\"0\"")
428                         ." width=\"$width\" height=\"$height\"";
429 }
430
431 sub negotiate_variant (%)
432 {
433 my(%args)=@_;
434
435         my @fields=("id","qs","content-type","encoding","charset","lang","size");
436         return [ map(($args{$_}),@fields) ];
437 }
438
439 my @img_variants=(
440                 { "id"=>"png","qs"=>1.0,"content-type"=>"image/png" },
441                 { "id"=>"gif","qs"=>0.9,"content-type"=>"image/gif" },
442                 );
443 my $img_variants_re='[.](?:'.join('|',"jpeg",map(($_->{"id"}),@img_variants)).')$';
444
445 sub img_src ($)
446 {
447 my($file_base)=@_;
448
449         if (!url_is_local($file_base)) {
450                 return $file_base if !wantarray();
451                 return ($file_base,$file_base);
452                 }
453         # Known image extension?
454         if ($file_base=~m#$img_variants_re#o) {
455                 return $file_base if !wantarray();
456                 return ($file_base,$file_base) if $file_base!~m#^/#;
457                 return (top_dir($file_base),top_dir_disk().$file_base);
458                 }
459
460         my $file_base_disk;
461         my $file_base_uri;
462         if ($file_base!~m#^/#) {
463                 $file_base_disk=$file_base_uri=$file_base;
464                 }
465         else {
466                 $file_base_disk=top_dir_disk().$file_base;
467                 $file_base_uri=top_dir($file_base);
468                 }
469
470         my @nego_variants;
471         for my $var (@img_variants) {
472                 my $file=$file_base_disk.".".$var->{"id"};
473                 # TODO: Somehow quickly check dependencies?
474                 make('make -s --no-print-directory'
475                                                 .' -C '."'".File::Basename::dirname($file)."' '".File::Basename::basename($file)."'")
476                                 if !-f $file;
477                 push @nego_variants,negotiate_variant(
478                                 %$var,
479                                 "size"=>(stat $file)[7],
480                                 );
481                 }
482         # Do not: ,$W->{"r"});
483         # but should we provide somehow either 'HTTP::Headers' or 'HTTP::Request' ?
484         my $ext=HTTP::Negotiate::choose(\@nego_variants);
485         $ext||=$img_variants[0]->{"id"};        # &HTTP::Negotiate::choose failed?
486
487         return $file_base_uri.".".$ext if !wantarray();
488         return ($file_base_uri.".".$ext,$file_base_disk.".".$ext);
489 }
490
491 sub img ($$;%)
492 {
493 my($file_base,$alt,%attr)=@_;
494
495         my($file_uri,$file_disk)=img_src $file_base;
496         my($width,$height)=Image::Size::imgsize($file_disk);
497         $alt=~s/<[^>]*>//g;
498         $alt=CGI::escapeHTML($alt);
499         my $content="<img src=\"$file_uri\" alt=\"$alt\" title=\"$alt\" ".img_size($width,$height)
500                         .(!$attr{"attr"} ? "" : " ".$attr{"attr"})." />";
501         return a_href img_src($attr{"a_href_img"}),$content if $attr{"a_href_img"};
502         return a_href $attr{"a_href"},$content if $attr{"a_href"};
503         return $content;
504 }
505
506 sub centerimg
507 {
508         my $r.="";
509         $r.='<table border="0" width="100%"><tr>'."\n";
510         @_=( [@_] ) if !ref $_[0];
511         for (@_) {
512                 $r.="\t".'<td align="center">'.&{\&img}(@$_).'</td>'."\n";
513                 }
514         $r.='</tr></table>'."\n";
515         return $r;
516 }
517
518 sub readfile ($$)
519 {
520 my($class,$filename)=@_;
521
522         local *F;
523         open F,$filename or die "Cannot open \"$filename\": $!";
524         local $/=undef();
525         my $data=<F>;
526         close F;
527         return $data;
528 }
529
530 sub arr_keys (@)
531 {
532 my(@arr)=@_;
533
534         my @r=();
535         while (@arr) {
536                 push @r,shift @arr;     # key
537                 shift @arr;     # val
538                 }
539         return @r;
540 }
541
542 sub heading ()
543 {
544 my($class)=@_;
545
546         # $ENV{"CLIENT_CHARSET"} ignored (mod_czech support dropped!)
547         my $client_charset=$W->{"force_charset"} || "us-ascii";
548         header("Content-Style-Type"=>"text/css");
549         header("Content-Script-Type"=>"text/javascript");
550
551         while (my($key,$val)=each(%{$W->{"headers"}})) {
552                 $W->{"r"}->header_out($key,$val);
553                 }
554         $W->{"r"}->send_http_header("text/html; charset=$client_charset");      # "Content-type"; do not use header()
555
556         return if $W->{"heading_done"}++;
557         exit if $W->{"r"}->header_only();
558
559         if (1) { # || !$msie_major || $msie_major>=4) # TODO:dyn
560                 print '<?xml version="1.0" encoding="'.$client_charset.'"?>'."\n";
561                 }
562         print '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">'."\n";
563         print '<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-US">'."\n";
564         my $title=$W->{"title_prefix"}.join("",map({ ': '.$_; } ($W->{"title"} || ())));
565         $title=~s#<[^>]*>##g;
566         print "<head>";
567         print "<title>$title</title>\n";
568
569         if ($W->{"have_css"}) {
570                 print <<'HERE';
571 <style type="text/css"><!--
572 .cvs-id   { font-family: monospace; }
573 .error    { color: red;   background-color: transparent; }
574 .quote    { font-family: monospace; }
575 .nowrap   { white-space: nowrap; }
576 .centered { text-align: center; }
577 .tab-bold { font-weight: bold; }
578 .tab-head { font-weight: bold; color: yellow; background-color: transparent; }
579 body {
580                 background-color: black;
581                 color: white;
582                 }
583 :link    { color: aqua;   background-color: transparent; }
584 :visited { color: teal;   background-color: transparent; }
585 h1,h2    { color: yellow; background-color: transparent; }
586 td       { padding: 2px; }
587 caption  { caption-side: bottom; }
588 .footer img { vertical-align: middle; }
589 HERE
590                 print $W->{"head_css"}."\n";
591                 print "--></style>\n";
592                 }
593
594         print '<meta name="robots" content="'.($W->{"indexme"} ? "" : "no" ).'index,follow" />'."\n";
595         print $W->{"head"};
596         for my $type (qw(prev next index contents start up)) {
597                 do { print '<link rel="'.$type.'" href="'.$_.'" />'."\n" if $_; } for ($W->{"rel_$type"});
598                 }
599         print "</head><body";
600         print ' bgcolor="black" text="white" link="aqua" vlink="teal"'
601                         if $W->{"browser"}->netscape() && $W->{"browser"}->major<=4;
602         print ">\n";
603
604         if ($W->{"heading"}) {
605                 do { &{$_}() if $_; } for ($W->{"heading"});
606                 }
607 }
608
609 1;