Fixed POD syntax.

This commit is contained in:
JT Smith 2002-12-16 01:13:06 +00:00
parent 4481cbec49
commit 3e89b31e13
28 changed files with 2003 additions and 1657 deletions

View file

@ -23,7 +23,7 @@ use WebGUI::Utility;
=head1 NAME
Package WebGUI::URL
Package WebGUI::URL
=head1 SYNOPSIS
@ -38,14 +38,11 @@ use WebGUI::Utility;
=head1 DESCRIPTION
This package provides URL writing functionality. It is important that
all WebGUI URLs be written using these methods so that they can contain
any extra information that WebGUI needs to add to the URLs in order
to function properly.
This package provides URL writing functionality. It is important that all WebGUI URLs be written using these methods so that they can contain any extra information that WebGUI needs to add to the URLs in order to function properly.
=head1 METHODS
These subroutines are available from this package:
These subroutines are available from this package:
=cut
@ -55,18 +52,22 @@ use WebGUI::Utility;
=head2 append ( url, pairs )
Returns a URL after adding some information to the end of it.
Returns a URL after adding some information to the end of it.
=over
=item url
The URL to append information to.
The URL to append information to.
=item pairs
Name value pairs to add to the URL in the form of:
Name value pairs to add to the URL in the form of:
name1=value1&name2=value2&name3=value3
=back
=cut
sub append {
@ -84,13 +85,17 @@ sub append {
=head2 escape ( string )
Encodes a string to make it safe to pass in a URL.
Encodes a string to make it safe to pass in a URL.
NOTE: See WebGUI::URL::unescape()
NOTE: See WebGUI::URL::unescape()
=over
=item string
The string to escape.
The string to escape.
=back
=cut
@ -103,18 +108,22 @@ sub escape {
=head2 gateway ( pageURL [ , pairs ] )
Generate a URL based on WebGUI's gateway script.
Generate a URL based on WebGUI's gateway script.
=over
=item pageURL
The urlized title of a page that you wish to create a URL for.
The urlized title of a page that you wish to create a URL for.
=item pairs
Name value pairs to add to the URL in the form of:
Name value pairs to add to the URL in the form of:
name1=value1&name2=value2&name3=value3
=back
=cut
sub gateway {
@ -133,12 +142,15 @@ sub gateway {
=head2 makeCompliant ( string )
Returns a string that has made into a WebGUI compliant URL.
Returns a string that has made into a WebGUI compliant URL.
=over
=item string
The string to make compliant. This is usually a page title or a
filename.
The string to make compliant. This is usually a page title or a filename.
=back
=cut
@ -158,14 +170,18 @@ sub makeCompliant {
=head2 page ( [ pairs ] )
Returns the URL of the current page.
Returns the URL of the current page.
=over
=item pairs
Name value pairs to add to the URL in the form of:
Name value pairs to add to the URL in the form of:
name1=value1&name2=value2&name3=value3
=back
=cut
sub page {
@ -184,13 +200,17 @@ sub page {
=head2 unescape
Decodes a string that was URL encoded.
Decodes a string that was URL encoded.
NOTE: See WebGUI::URL::escape()
NOTE: See WebGUI::URL::escape()
=over
=item string
The string to unescape.
The string to unescape.
=back
=cut
@ -202,13 +222,16 @@ sub unescape {
=head2 urlize ( string )
Same as makeCompliant except that it also lower-cases the string.
This is mainly meant for WebGUI page URLs.
Same as makeCompliant except that it also lower-cases the string. This is mainly meant for WebGUI page URLs.
=over
=item string
The string to urlize.
=back
=cut
sub urlize {