]> git.deb.at Git - deb/packages.git/blob - lib/Packages/HTML.pm
Sort packages listed by pkg_list
[deb/packages.git] / lib / Packages / HTML.pm
1 package Packages::HTML;
2
3 use strict;
4 use warnings;
5
6 use Exporter;
7 use URI::Escape;
8 use HTML::Entities;
9 use Locale::gettext;
10
11 use Packages::CGI ();
12 use Packages::Search qw( read_entry_simple );
13 use Packages::Config qw( :all );
14
15 #use Packages::Util;
16 use Packages::I18N::Locale;
17 use Packages::I18N::Languages;
18 use Packages::I18N::LanguageNames;
19 #use Generated::Strings qw( gettext dgettext );
20
21 our @ISA = qw( Exporter );
22 our @EXPORT = qw( header title trailer file_changed time_stamp
23                   read_md5_hash write_md5_hash simple_menu
24                   ds_begin ds_item ds_end title marker pdesc
25                   pdeplegend pkg_list pmoreinfo print_deps print_src_deps );
26
27 our $CHANGELOG_URL = '/changelogs';
28
29 sub img {
30     my ( $root, $url, $src, $alt, %attr ) = @_; 
31     my @attr;
32
33     foreach my $a ( keys %attr ) {
34         push @attr, "$a=\"$attr{$a}\"";
35     }
36
37     return "<a href=\"$root$url\"><img src=\"$root$src\" alt=\"$alt\" @attr></a>";
38 }
39
40 sub simple_menu {
41     my $str = "";
42     foreach my $entry (@_) {
43         $str .= "[&nbsp;$entry->[0] <a title=\"$entry->[1]\" href=\"$entry->[2]\">$entry->[3]</a>&nbsp;]\n";
44     }
45     return $str;
46 }
47
48 sub title {
49     return "<h1>$_[0]</h1>\n";
50 }
51
52 sub marker {
53     return "[<strong class=\"pmarker\">$_[0]</strong>]";
54 }
55
56 sub pdesc {
57     my ( $short_desc, $long_desc ) = @_;
58     my $str = "";
59
60     $str .= "<div id=\"pdesc\">\n";
61     $str .= "<h2>$short_desc</h2>\n";
62
63     $str .= "<p>$long_desc\n";
64     $str .= "</div> <!-- end pdesc -->\n";
65
66     return $str;
67 }
68
69 sub pdeplegend {
70     my $str = "<table id=\"pdeplegend\" summary=\"legend\"><tr>\n";
71
72     foreach my $entry (@_) {
73         $str .= "<td><img src=\"$ROOT/Pics/$entry->[0].gif\" alt=\"[$entry->[0]]\" width=\"16\" height=\"16\">= $entry->[1]</td>";
74     }
75
76     $str .= "\n</tr></table>\n";
77     return $str;
78 }
79
80 sub pkg_list {
81     my ( $packages, $opts, $pkgs, $lang ) = @_;
82     my $suite = $opts->{suite}[0];
83
84     my $str = "";
85     foreach my $p ( sort @$pkgs ) {
86
87         # we don't deal with virtual packages here because for the
88         # current uses of this function this isn't needed
89         my $short_desc = (read_entry_simple( $packages, $p, $opts->{h_archives}, $suite))->[-1];
90
91         if ( $short_desc ) {
92             $str .= "<dt><a href=\"$ROOT/$suite/$p\">$p</a></dt>\n".
93                     "\t<dd>$short_desc</dd>\n";
94         } else {
95             $str .= "<dt>$p</dt>\n\t<dd>"._g("Not available")."</dd>\n";
96         }
97     }
98     if ($str) {
99         $str = "<dl>$str</dl>\n";
100     }
101
102     return $str;
103 }
104
105 sub pmoreinfo {
106     my %info = @_;
107     
108     my $name = $info{name} or return;
109     my $env = $info{env} or return;
110     my $opts = $info{opts} or return;
111     my $page = $info{data} or return;
112     my $is_source = $info{is_source};
113     my $suite = $opts->{suite}[0];
114
115     my $str = "<div id=\"pmoreinfo\">";
116     $str .= sprintf( "<h2>"._g( "More Information on %s" )."</h2>",
117                      $name );
118     
119     if ($info{bugreports}) {
120         my $bug_url = $is_source ? $SRC_BUG_URL : $BUG_URL; 
121         $str .= "<p>\n".sprintf( _g( "Check for <a href=\"%s\">Bug Reports</a> about %s." )."<br>\n",
122                          $bug_url.$name, $name );
123     }
124         
125     my $source = $page->get_src( 'package' );
126     my $source_version = $page->get_src( 'version' );
127     my $src_dir = $page->get_src('directory');
128     if ($info{sourcedownload}) {
129         my $files = $page->get_src( 'files' );
130         my $path = (@{$opts->{archive}} >1) ?
131             $suite :
132             "$suite/$opts->{archive}[0]";
133         $str .= _g( "Source Package:" );
134         $str .= " <a href=\"$ROOT/$path/source/$source\">$source</a>, ".
135             _g( "Download" ).":\n";
136
137         unless (defined($files) and @$files) {
138             $str .= _g( "Not found" );
139         } else {
140             foreach( @$files ) {
141                 my ($src_file_md5, $src_file_size, $src_file_name) = split /\s/o, $_;
142                 for ("$suite/".$page->get_newest('archive')) {
143                     /security/o && do {
144                         $str .= "<a href=\"$env->{security}/$src_dir/$src_file_name\">["; last };
145                     /volatile/o && do {
146                         $str .= "<a href=\"$env->{volatile}/$src_dir/$src_file_name\">["; last };
147                     /backports/o && do {
148                         $str .= "<a href=\"$env->{backports}/$src_dir/$src_file_name\">["; last };
149                     /non-us/io && do {
150                         $str .= "<a href=\"$env->{'non-US'}/$src_dir/$src_file_name\">["; last };
151                     $str .= "<a href=\"$env->{us}/$src_dir/$src_file_name\">[";
152                 }
153                 if ($src_file_name =~ /dsc$/) {
154                     $str .= "dsc";
155                 } else {
156                     $str .= $src_file_name;
157                 }
158                 $str .= "]</a>\n";
159             }
160         }
161 #           $package_page .= sprintf( _g( " (These sources are for version %s)\n" ), $src_version )
162 #               if ($src_version ne $version) && !$src_version_given_in_control;
163     }
164
165     if ($info{changesandcopy}) {
166         if ( $src_dir ) {
167             (my $src_basename = $source_version) =~ s,^\d+:,,; # strip epoche
168             $src_basename = "${source}_$src_basename";
169             $src_dir =~ s,pool/updates,pool,o;
170             $src_dir =~ s,pool/non-US,pool,o;
171             $str .= "<br>".sprintf( _g( 'View the <a href="%s">Debian changelog</a>' ),
172                                     "$CHANGELOG_URL/$src_dir/$src_basename/changelog" )."<br>\n";
173             my $copyright_url = "$CHANGELOG_URL/$src_dir/$src_basename/";
174             $copyright_url .= ( $is_source ? 'copyright' : "$name.copyright" );
175
176             $str .= sprintf( _g( 'View the <a href="%s">copyright file</a>' ),
177                              $copyright_url )."</p>";
178         }
179    }
180
181     if ($info{maintainers}) {
182         my $uploaders = $page->get_src( 'uploaders' );
183         if ($uploaders && @$uploaders) {
184             foreach (@$uploaders) {
185                 $_->[0] = encode_entities( $_->[0], '&<>' );
186             }
187             my ($maint_name, $maint_mail) = @{shift @$uploaders}; 
188             unless (@$uploaders) {
189                 $str .= "<p>\n".sprintf( _g( "%s is responsible for this Debian package." ).
190                                          "\n",
191                                          "<a href=\"mailto:$maint_mail\">$maint_name</a>" 
192                                          );
193             } else {
194                 my $up_str = "<a href=\"mailto:$maint_mail\">$maint_name</a>";
195                 my @uploaders_str;
196                 foreach (@$uploaders) {
197                     push @uploaders_str, "<a href=\"mailto:$_->[1]\">$_->[0]</a>";
198                 }
199                 my $last_up = pop @uploaders_str;
200                 $up_str .= ", ".join ", ", @uploaders_str if @uploaders_str;
201                 $up_str .= sprintf( _g( " and %s are responsible for this Debian package." ), $last_up );
202                 $str .= "<p>\n$up_str ";
203             }
204         }
205
206         $str .= sprintf( _g( "See the <a href=\"%s\">developer information for %s</a>." )."</p>", $QA_URL.$source, $name ) if $source;
207     }
208
209     if ($info{search}) {
210         my $encodedname = uri_escape( $name );
211         my $search_url = $is_source ? "$ROOT/source" : $ROOT;
212         $str .= "<p>".sprintf( _g( "Search for <a href=\"%s\">other versions of %s</a>" ),
213             "$search_url/$encodedname", $name )."</p>\n";
214     }
215
216     $str .= "</div> <!-- end pmoreinfo -->\n";
217     return $str;
218 }
219
220 sub dep_item {
221     my ( $link, $name, $info, $desc ) = @_;
222     my $post_link = '';
223     if ($link) {
224         $link = "<a href=\"$link\">";
225         $post_link = '</a>';
226     } else {
227         $link = '';
228     }
229     if ($info) {
230         $info = " $info";
231     } else {
232         $info = '';
233     }
234     if ($desc) {
235         $desc = "</dt><dd>$desc</dd>";
236     } else {
237         $desc = '</dt>';
238     }
239
240     return "$link$name$post_link$info$desc";
241 } # end dep_item
242
243 sub provides_string {
244     my ($path, $entry,$also) = @_;
245     my @provided_by = split /\s/, $entry;
246     my $short_desc = $also ? _g("also a virtual package provided by ")
247         : _g("virtual package provided by ");
248     if (@provided_by < 10) {
249         $short_desc .= join( ', ',map { "<a href=\"$path/$_\">$_</a>" } @provided_by);
250     } else {
251         $short_desc .= sprintf( _g("%s packages"), scalar(@provided_by));
252     }
253     return $short_desc;
254 }
255
256 sub print_deps {
257     my ( $packages, $opts, $pkg, $relations, $type) = @_;
258     my %dep_type = ('depends' => 'dep', 'recommends' => 'rec', 
259                     'suggests' => 'sug', 'build-depends' => 'adep',
260                     'build-depends-indep' => 'idep' );
261     my $res = "<ul class=\"ul$dep_type{$type}\">\n";
262     my $first = 1;
263     my $suite = $opts->{suite}[0];
264
265 #    use Data::Dumper;
266 #    debug( "print_deps called:\n".Dumper( $pkg, $relations, \$type ), 3 ) if DEBUG;
267
268     foreach my $rel (@$relations) {
269         my $is_old_pkgs = $rel->[0];
270         my @res_pkgs = ();
271
272         if ($is_old_pkgs)  {
273             $res .= "<dt>";
274         } else {
275             if ($first) {
276                 $res .= "<li>";
277                 $first = 0;
278             } else {
279                 $res .= "</dl></li>\n<li>";
280             }
281             $res .= "<dl><dt><img class=\"hidecss\" src=\"$ROOT/Pics/$dep_type{$type}.gif\" alt=\"[$dep_type{$type}]\"> ";
282         }
283
284         foreach my $rel_alt ( @$rel ) {
285             next unless ref($rel_alt);
286             my ( $p_name, $pkg_version, $arch_neg,
287                  $arch_str, $subsection, $available ) = @$rel_alt;
288
289             if ($arch_str ||= '') {
290                 if ($arch_neg) {
291                     $arch_str = " ["._g("not")." $arch_str]";
292                 } else {
293                     $arch_str = " [$arch_str]";
294                 }
295             }
296             $pkg_version = "($pkg_version)" if $pkg_version ||= '';
297             
298             my @results;
299             my %entries;
300             my $entry = $entries{$p_name} ||
301                 read_entry_simple( $packages, $p_name, $opts->{h_archives}, $suite);
302             my $short_desc = $entry->[-1];
303             my $arch = $entry->[3];
304             my $archive = $entry->[1];
305             my $path = $entry->[2];
306             if ( $short_desc ) {
307                 if ( $is_old_pkgs ) {
308                     push @res_pkgs, dep_item( "$ROOT/$path/$p_name",
309                                               $p_name, "$pkg_version$arch_str" );
310                 } elsif (defined $entry->[1]) {
311                     $entries{$p_name} ||= $entry;
312                     $short_desc = encode_entities( $short_desc, "<>&\"" );
313                     $short_desc .= "<br>".provides_string( "$ROOT/$path",
314                                                            $entry->[0],
315                                                            1 )
316                         if defined $entry->[0];
317                     push @res_pkgs, dep_item( "$ROOT/$path/$p_name",
318                                               $p_name, "$pkg_version$arch_str", $short_desc );
319                 } elsif (defined $entry->[0]) {
320                     $short_desc = provides_string( "$ROOT/$path",
321                                                    $entry->[0] );
322                     push @res_pkgs, dep_item( "$ROOT/$path/$p_name",
323                                               $p_name, "$pkg_version$arch_str", $short_desc );
324                 }
325             } elsif ( $is_old_pkgs ) {
326                 push @res_pkgs, dep_item( undef, $p_name, "$pkg_version$arch_str" );
327             } else {
328                 my $short_desc = _g( "Package not available" );
329                 push @res_pkgs, dep_item( undef, $p_name, "$pkg_version$arch_str", $short_desc );
330             }
331             
332         }
333         
334         $res .= "\n".join( "<dt>"._g( "or" )." ", @res_pkgs )."\n";
335     }
336     if (@$relations) {
337         $res .= "</dl></li>\n";
338         $res .= "</ul>\n";
339     } else {
340         $res = "";
341     }
342     return $res;
343 } # end print_deps
344
345 my $ds_begin = '<dl>';
346 my $ds_item_desc  = '<dt>';
347 my $ds_item = ':</dt><dd>';
348 my $ds_item_end = '</dd>';
349 my $ds_end = '</dl>';
350 #           my $ds_begin = '<table><tbody>';
351 #           my $ds_item_desc  = '<tr><td>';
352 #           my $ds_item = '</td><td>';
353 #           my $ds_item_end = '</td></tr>';
354 #           my $ds_end = '</tbody></table>';
355
356 sub ds_begin {
357     return $ds_begin;
358 }
359 sub ds_item {
360     return "$ds_item_desc$_[0]$ds_item$_[1]$ds_item_end\n";
361 }
362 sub ds_end {
363     return $ds_end;
364 }
365
366 sub header {
367     my (%params) = @_;
368
369     my $DESC_LINE;
370     if (defined $params{desc}) {
371         $DESC_LINE = "<meta name=\"Description\" content=\"$params{desc}\">";
372     }
373     else {
374         $DESC_LINE = '';
375     }
376
377     my $title_keywords = $params{title_keywords} || $params{title} || '';
378     my $title_tag = $params{title_tag} || $params{title} || '';
379     my $title_in_header = $params{page_title} || $params{title} || '';
380     my $page_title = $params{page_title} || $params{title} || '';
381     my $meta = $params{meta} || '';
382
383     my $search_in_header = '';
384     $params{print_search_field} ||= "";
385     if ($params{print_search_field} eq 'packages') {
386         my %values = %{$params{search_field_values}};
387         my %checked_searchon = ( names => "",
388                                  all => "",
389                                  sourcenames => "",
390                                  contents => "");
391         $checked_searchon{$values{searchon}} = "checked=\"checked\"";
392         $checked_searchon{names} = "checked=\"checked\""
393                 if $values{searchon} eq 'default';
394         $search_in_header = <<MENU;
395 <form method="GET" action="$SEARCH_URL">
396 <div id="hpacketsearch">
397 <input type="text" size="30" name="keywords" value="" id="kw">
398 <input type="submit" value="%s">
399 <span style="font-size: 60%%"><a href="$SEARCH_PAGE#search_packages">%s</a></span>
400 <br>
401 <div style="font-size: 80%%">%s
402 <input type="radio" name="searchon" value="names" id="onlynames" $checked_searchon{names}>
403 <label for="onlynames">%s</label>&nbsp;&nbsp;
404 <input type="radio" name="searchon" value="all" id="descs" $checked_searchon{all}>
405 <label for="descs">%s</label>
406 <br>
407 <input type="radio" name="searchon" value="sourcenames" id="src" $checked_searchon{sourcenames}>
408 <label for="src">%s</label>
409 <input type="radio" name="searchon" value="contents" id="conts" $checked_searchon{contents}>
410 <label for="conts">%s</label>
411 </div>
412 </div> <!-- end hpacketsearch -->
413 </form>
414 MENU
415 ;
416         $search_in_header = sprintf( $search_in_header,
417                                      _g( 'Search' ),
418                                      _g( 'Full options' ),
419                                      _g( 'Search on:'),
420                                      _g( 'Package Names' ),
421                                      _g( 'Descriptions' ),
422                                      _g( 'Source package names' ),
423                                      _g( 'Package contents' ));
424 #     } elsif ($params{print_search_field} eq 'contents') {
425 #       my %values = %{$params{search_field_values}};
426 #       my %checked_searchmode = ( searchfiles => "",
427 #                                  searchfilesanddirs => "",
428 #                                  searchword => "",
429 #                                  filelist => "", );
430 #       $checked_searchmode{$values{searchmode}} = "checked=\"checked\"";
431 #       $search_in_header = <<MENU;
432 # <form method="GET" action="$CONTENTS_SEARCH_CGI">
433 # <div id="hpacketsearch">
434 # <input type="hidden" name="debug" value="$values{debug}" />
435 # <input type="hidden" name="version" value="$values{version}" />
436 # <input type="hidden" name="arch" value="$values{arch}" />
437 # <input type="hidden" name="case" value="$values{case}" />
438 # <input type="text" size="30" name="word" id="keyword" value="$values{keyword}">&nbsp;
439 # <input type="submit" value="Search">
440 # <span style="font-size: 60%"><a href="$SEARCH_PAGE#search_contents">Full options</a></span>
441 # <br>
442 # <div style="font-size: 80%">Display:
443 # <input type=radio name="searchmode" value="searchfiles" id="searchfiles" $checked_searchmode{searchfiles}>
444 # <label for="searchfiles">files</label>
445 # <input type=radio name="searchmode" value="searchfilesanddirs" id="searchfilesanddirs" $checked_searchmode{searchfilesanddirs}>
446 # <label for="searchfilesanddirs">files &amp; directories</label>
447 # <br>
448 # <input type=radio name="searchmode" value="searchword" id="searchword" $checked_searchmode{searchword}>
449 # <label for="searchword">subword matching</label>
450 # <input type=radio name="searchmode" value="filelist" id="filelist" $checked_searchmode{filelist}>
451 # <label for="filelist">content list</label>
452 # </div>
453 # </div> <!-- end hpacketsearch -->
454 # </form>
455 # MENU
456 # ;
457     }
458
459     my $keywords = $params{keywords} || '';
460     my $KEYWORDS_LINE = "<meta name=\"Keywords\" content=\"debian, $keywords $title_keywords\">";
461     
462     my $LANG = $params{lang};
463     my $charset = get_charset($LANG);
464     my $txt = <<HEAD;
465 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
466 <html lang="$LANG">
467 <head>
468 <title>Debian -- $title_tag</title>
469 <link rev="made" href="mailto:$WEBMASTER_MAIL">
470 <meta http-equiv="Content-Type" content="text/html; charset=$charset">
471 <meta name="Author" content="Debian Webmaster, $WEBMASTER_MAIL">
472 $KEYWORDS_LINE
473 $DESC_LINE
474 $meta
475 <link href="$ROOT/debian.css" rel="stylesheet" type="text/css" media="all">
476 <link href="$ROOT/packages.css" rel="stylesheet" type="text/css" media="all">
477 </head>
478 <body>
479 <div id="header">
480    <div id="upperheader">
481    <div id="logo">
482   <a href="$HOME/"><img src="$HOME/logos/openlogo-nd-50.png" alt="" /></a>
483 HEAD
484 ;
485
486     $txt .= img( "$HOME/", "", "Pics/debian.png", _g( "Debian Project" ),
487                  width => 179, height => 61 );
488     $txt .= <<HEADEND;
489
490 </div> <!-- end logo -->
491 HEADEND
492 ;
493
494     $txt .= <<NAVBEGIN;
495 $search_in_header
496 </div> <!-- end upperheader -->
497
498 NAVBEGIN
499 ;
500     $txt .= "<p class=\"hidecss\"><a href=\"\#inner\">" . _g("Skip Site Navigation")."</a></p>\n";
501     $txt .= "<div id=\"navbar\">\n<ul>".
502         "<li><a href=\"$HOME/intro/about\">"._g( "About&nbsp;Debian" )."</a></li>\n".
503         "<li><a href=\"$HOME/News/\">"._g( "News" )."</a></li>\n".
504         "<li><a href=\"$HOME/distrib/\">"._g( "Getting&nbsp;Debian" )."</a></li>\n".
505         "<li><a href=\"$HOME/support\">"._g( "Support" )."</a></li>\n".
506         "<li><a href=\"$HOME/devel/\">"._g( "Development" )."</a></li>\n".
507         "<li><a href=\"$HOME/sitemap\">"._g( "Site map" )."</a></li>\n".
508         "<li><a href=\"http://search.debian.org/\">"._g( "Search" )."</a></li>\n";
509     $txt .= "</ul>\n";
510     $txt .= <<ENDNAV;
511 </div> <!-- end navbar -->
512 </div> <!-- end header -->
513 ENDNAV
514 ;
515     $txt .= <<BEGINCONTENT;
516 <div id="outer">
517 <div id="inner">
518
519 BEGINCONTENT
520 ;
521     if ($params{print_title}) {
522         $txt .= "<h1>$page_title</h1>\n";
523     }
524
525     return $txt;
526 }
527
528 sub trailer {
529     my ($ROOT, $NAME, $LANG, @USED_LANGS) = @_;
530     my $txt = "</div> <!-- end inner -->\n<div id=\"footer\">\n";
531     my $langs = languages( $NAME, $LANG, @USED_LANGS );
532     my $bl_class = $langs ? ' class="bordertop"' : "";
533     $txt .=
534         $langs.
535         "\n<hr class=\"hidecss\">\n" .
536         "<p$bl_class>".
537         sprintf( _g( "Back to: <a href=\"%s/\">Debian Project homepage</a> || <a href=\"%s/\">Packages search page</a>" ), $HOME, $ROOT ).
538         "</p>\n<hr class=\"hidecss\">\n".
539         "<div id=\"fineprint\" class=\"bordertop\"><p>".
540         sprintf( _g( "To report a problem with the web site, e-mail <a href=\"mailto:%s\">%s</a>. For other contact information, see the Debian <a href=\"%s/contact\">contact page</a>." ), $CONTACT_MAIL, $CONTACT_MAIL, $HOME).
541         "</p>\n".
542         "<p>". _g( "Last Modified: " ). "LAST_MODIFIED_DATE".
543         "<br>\n".
544         sprintf( _g( "Copyright &copy; 1997-2005 <a href=\"http://www.spi-inc.org\">SPI</a>; See <a href=\"%s/license\">license terms</a>." ), "$HOME/" )."<br>\n".
545         _g( "Debian is a registered trademark of Software in the Public Interest, Inc." ).
546         "</div> <!-- end fineprint -->\n".
547         "</div> <!-- end footer -->\n".
548         "</div> <!-- end outer -->\n".
549         "</body>\n</html>\n";
550
551     return $txt;
552 }
553
554 sub languages {
555     my ( $name, $lang, @used_langs ) = @_;
556     
557     my $str = "";
558     
559     if (@used_langs) {
560         $str .= "<hr class=\"hidecss\">\n";
561         $str .= "<!--UdmComment-->\n<p>\n";
562         $str .= _g( "This page is also available in the following languages:\n" );
563         $str .= "</p><p class=\"navpara\">\n";
564         
565         my @printed_langs = ();
566         foreach (@used_langs) {
567             next if $_ eq $lang; # Never print the current language
568             unless (get_selfname($_)) { warn "missing language $_"; next } #DEBUG
569             push @printed_langs, $_;
570         }
571         return "" unless scalar @printed_langs;
572         # Sort on uppercase to work with languages which use lowercase initial
573         # letters.
574         foreach my $cur_lang (sort langcmp @printed_langs) {
575             my $tooltip = dgettext( "langs", get_language_name($cur_lang) );
576             $str .= "<a href=\"$name.$cur_lang.html\" title=\"$tooltip\" hreflang=\"$cur_lang\" lang=\"$cur_lang\" rel=\"alternate\">".get_selfname($cur_lang);
577             $str .= " (".get_transliteration($cur_lang).")" if defined get_transliteration($cur_lang);
578             $str .= "</a>\n";
579         }
580         $str .= "\n</p><p>\n";
581         $str .= sprintf( _g( "How to set <a href=\"%s\">the default document language</a>" ), $CN_HELP_URL )."</p>";
582         $str .= "\n<!--/UdmComment-->\n";
583     }
584     
585     return $str;
586 }
587
588 1;