]> git.vpit.fr Git - perl/modules/Linux-SysInfo.git/commitdiff
POD formatting cleanup
authorVincent Pit <vince@profvince.com>
Tue, 10 Mar 2009 15:57:30 +0000 (16:57 +0100)
committerVincent Pit <vince@profvince.com>
Tue, 10 Mar 2009 15:57:30 +0000 (16:57 +0100)
lib/Linux/SysInfo.pm

index 3b2e9d3f072919ec42fefc75c0427714420689ca..f8351a09677ba9fa141a1c9cd36cf765829ccb82 100644 (file)
@@ -27,13 +27,15 @@ BEGIN {
 
 =head1 DESCRIPTION
 
-This module is a wrapper around the sysinfo(2) Linux system call. It gives information about the current uptime, load average, memory usage and processes running. Other systems have also this system call (e.g. Solaris), but in most cases the returned information is different.
+This module is a wrapper around the C<sysinfo(2)> Linux system call.
+It gives information about the current uptime, load average, memory usage and processes running.
+Other systems have also this system call (e.g. Solaris), but in most cases the returned information is different.
 
 =head1 CONSTANTS
 
 =head2 C<LS_HAS_EXTENDED>
 
-This constant is set to 1 if your kernel supports the three extended fields C<totalhigh>, C<freehigh> and C<mem_unit> ; and to 0 otherwise.
+This constant is set to C<1> if your kernel supports the three extended fields C<totalhigh>, C<freehigh> and C<mem_unit> ; and to C<0> otherwise.
 
 =head1 FUNCTIONS
 
@@ -46,61 +48,87 @@ BEGIN {
 
 =head2 C<sysinfo>
 
-This function takes no argument. It returns undef on failure or a hash reference whose keys are the members name of the struct sysinfo on success :
+This function takes no argument.
+It returns C<undef> on failure or a hash reference whose keys are the members name of the C<struct sysinfo> on success :
 
 =over 4
 
-=item C<uptime>
+=item *
+
+C<uptime>
 
 Seconds elapsed since the system booted.
 
-=item C<load1>, C<load5>, C<load15>
+=item *
+
+C<load1>, C<load5>, C<load15>
 
 1, 5 and 15 minutes load average.
 
-=item C<totalram>
+=item *
+
+C<totalram>
 
 Total usable main memory size.
 
-=item C<freeram>
+=item *
+
+C<freeram>
 
 Available memory size.
 
-=item C<sharedram>
+=item *
+
+C<sharedram>
 
 Amount of shared memory.
 
-=item C<bufferram>
+=item *
+
+C<bufferram>
 
 Memory used by buffers.
 
-=item C<totalswap>
+=item *
+
+C<totalswap>
 
 Total swap space size.
 
-=item C<freeswap>
+=item *
+
+C<freeswap>
 
 Swap space still available.
 
-=item C<procs>
+=item *
+
+C<procs>
 
 Number of current processes.
 
 =back
 
-Prior to Linux 2.3.23 on i386 and 2.3.48 on all other architectures, the memory sizes were given in bytes. Since then, the following members are also available and all the memory sizes are given as multiples of mem_unit bytes :
+Prior to Linux 2.3.23 on i386 and 2.3.48 on all other architectures, the memory sizes were given in bytes.
+Since then, the following members are also available and all the memory sizes are given as multiples of C<mem_unit> bytes :
 
 =over 4
 
-=item C<totalhigh>
+=item *
+
+C<totalhigh>
 
 Total high memory size.
 
-=item C<freehigh>
+=item *
+
+C<freehigh>
 
 Available high memory size.
 
-=item C<mem_unit>
+=item *
+
+C<mem_unit>
 
 Memory unit size in bytes.
 
@@ -108,7 +136,8 @@ Memory unit size in bytes.
 
 =head1 EXPORT
 
-The only function of this module, C<sysinfo>, and the constant C<LS_HAS_EXTENDED> are only exported on request. Functions are also exported by the C<:funcs> tag, and constants by C<:consts>.
+The only function of this module, C<sysinfo>, and the constant C<LS_HAS_EXTENDED> are only exported on request.
+Functions are also exported by the C<:funcs> tag, and constants by C<:consts>.
 
 =cut
 
@@ -146,11 +175,8 @@ You can contact me by mail or on C<irc.perl.org> (vincent).
 
 =head1 BUGS
 
-Please report any bugs or feature requests to
-C<bug-linux-sysinfo at rt.cpan.org>, or through the web interface at
-L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Linux-SysInfo>.
-I will be notified, and then you'll automatically be notified of progress on
-your bug as I make changes.
+Please report any bugs or feature requests to C<bug-linux-sysinfo at rt.cpan.org>, or through the web interface at L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Linux-SysInfo>.
+I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
 
 =head1 SUPPORT