/usr/lib/perl5/Glib/Utils.pod is in libglib-perl 3:1.260-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 | =head1 NAME
Glib::Utils - Miscellaneous utility functions
=cut
=for position SYNOPSIS
=head1 SYNOPSIS
use Glib;
Glib::set_application_name (Glib::get_real_name."'s Cool Program");
print "app name is ".Glib::get_application_name()."\n";
=for position DESCRIPTION
=head1 DESCRIPTION
Here are some useful miscellaneous utilities.
GLib is a portability library, providing portable utility functions for
C programs. As such, most of these functions seem to violate the Glib
binding principle of not duplicating functionality that Perl already
provides, but there's a distinction for each one, i swear. The functions
for dealing with user information are provided on all GLib-supported
platforms, not just where POSIX (which provides similar information) is
available, and even work on platforms where %ENV may not include the
expected information. Also, the "application name" referred to by
(set|get)_application_name is a human readable name, distinct from the
actual program name provided by Perl's own $0.
=cut
=for object Glib::Utils Miscellaneous utility functions
=cut
=head1 METHODS
=head2 string = Glib::get_application_name
Get the human-readable application name set by C<set_application_name>.
Since: glib 2.2
=head2 Glib::set_application_name ($application_name)
=over
=item * $application_name (string)
=back
Set the human-readable application name.
Since: glib 2.2
=head2 string = Glib::get_home_dir
Find the current user's home directory, by system-dependent/appropriate
means.
=head2 list = Glib::get_language_names
Computes a list of applicable locale names, which can be used to e.g. construct
locale-dependent filenames or search paths. The returned list is sorted from
most desirable to least desirable and always contains the default locale "C".
Since: glib 2.6
=head2 string = Glib::get_real_name
Get the current user's real name.
=head2 string = Glib::strerror ($err)
=over
=item * $err (integer)
=back
Return a string describing the given errno value, like "No such file
or directory" for ENOENT. This is translated into the user's
preferred language and is a utf8 wide-char string (unlike a $!
string (L<perlvar>) or POSIX::strerror (L<POSIX>) which are locale
codeset bytes).
=head2 string = Glib::strsignal ($signum)
=over
=item * $signum (integer)
=back
Return a string describing the given signal number, like "Segmentation
violation" for SIGSEGV. This is translated into the user's preferred
language and is a utf8 wide-char string.
=head2 list = Glib::get_system_config_dirs
Returns an ordered list of base directories in which to access system-wide
configuration information.
Since: glib 2.6
=head2 list = Glib::get_system_data_dirs
Returns an ordered list of base directories in which to access system-wide
application data.
Since: glib 2.6
=head2 string = Glib::get_tmp_dir
Get the temp dir as appropriate for the current system. See the GLib docs
for info on how it works.
=head2 string = Glib::get_user_cache_dir
Gets the base directory in which to store non-essential, cached data specific
to particular user.
Since: glib 2.6
=head2 string = Glib::get_user_config_dir
Gets the base directory in which to store user-specific application
configuration information such as user preferences and settings.
Since: glib 2.6
=head2 string = Glib::get_user_data_dir
Get the base directory for application data such as icons that is customized
for a particular user.
Since: glib 2.6
=head2 string = Glib::get_user_name
Get the current user's name by whatever system-dependent means necessary.
=head2 string = Glib::get_user_special_dir ($directory)
=over
=item * $directory (Glib::UserDirectory)
=back
Returns the full path of a special directory using its logical id.
Since: glib 2.14
=cut
=head1 ENUMS AND FLAGS
=head2 enum Glib::UserDirectory
=over
=item * 'desktop' / 'G_USER_DIRECTORY_DESKTOP'
=item * 'documents' / 'G_USER_DIRECTORY_DOCUMENTS'
=item * 'download' / 'G_USER_DIRECTORY_DOWNLOAD'
=item * 'music' / 'G_USER_DIRECTORY_MUSIC'
=item * 'pictures' / 'G_USER_DIRECTORY_PICTURES'
=item * 'public-share' / 'G_USER_DIRECTORY_PUBLIC_SHARE'
=item * 'templates' / 'G_USER_DIRECTORY_TEMPLATES'
=item * 'videos' / 'G_USER_DIRECTORY_VIDEOS'
=back
=cut
=head1 SEE ALSO
L<Glib>
=cut
=head1 COPYRIGHT
Copyright (C) 2003-2011 by the gtk2-perl team.
This software is licensed under the LGPL. See L<Glib> for a full notice.
=cut
|