GNOME.org
 

perl-Pango r5 - in trunk: . lib

Author: tsch
Date: Sun Nov 16 19:53:29 2008
New Revision: 5
URL: http://svn.gnome.org/viewvc/perl-Pango?rev=5&view=rev

Log:
* AUTHORS
* lib/Pango.pm: Update list of authors.

* lib/Pango.pm: Add some documentation.

* Makefile.PL: Use META_MERGE instead of EXTRA_META.

* lib/Pango.pm
* Makefile.PL: Remove unused code for handling constants.

* Makefile.PL
* README: Update dependencies.


Modified:
   trunk/AUTHORS
   trunk/Makefile.PL
   trunk/README
   trunk/lib/Pango.pm

Modified: trunk/AUTHORS
==============================================================================
--- trunk/AUTHORS	(original)
+++ trunk/AUTHORS	Sun Nov 16 19:53:29 2008
@@ -1,12 +1,7 @@
 The Gtk2-Perl Team - contact us at gtk-perl-list gnome org
 ==========================================================
 muppet                   scott at asofyet dot org
-Ross McFarland           rwmcfa1 at neces dot com
-Torsten Schoenfeld       kaffeetisch at web dot de
+Torsten Schoenfeld       kaffeetisch at gmx dot de
 Marc Lehmann             pcg at goof dot com
-Goran Thyni              goran at kirra dot net
-Joern Reder              joern at zyn dot de
-Chas Owens               alas at wilma dot widomaker dot com
-Guillaume Cottenceau     gc at mandrakesoft dot com
 
 gtk2-perl is covered by the LGPL -- see the file LICENSE for details.

Modified: trunk/Makefile.PL
==============================================================================
--- trunk/Makefile.PL	(original)
+++ trunk/Makefile.PL	Sun Nov 16 19:53:29 2008
@@ -14,9 +14,6 @@
 # You should have received a copy of the GNU Library General Public License
 # along with this library; if not, write to the Free Software Foundation, Inc.,
 # 59 Temple Place - Suite 330, Boston, MA 02111-1307 USA.
-#
-# $Id$
-#
 
 BEGIN { require 5.008; }
 
@@ -31,7 +28,7 @@
 our %build_reqs = (
 	'perl-ExtUtils-Depends'   => '0.300',
 	'perl-ExtUtils-PkgConfig' => '1.030',
-	'perl-Glib'               => '1.200', # FIXME: 1.22
+	'perl-Glib'               => '1.210', # FIXME: 1.22
 	'perl-Cairo'              => '1.000',
 	'pango'                   => '1.0.0',
 );
@@ -113,24 +110,6 @@
 	$have_cairo = 1;
 }
 
-=for FIXME
-
-#
-# generate the constants wrappers
-#
-my @constants_lists =
-	Glib::MakeHelper->select_files_by_version ('constants', @pango_version);
-my $constants_file = File::Spec->catfile ('build', 'constants.xs');
-Gtk2::CodeGen->generate_constants_wrappers (
-	prefix => 'Pango',
-	lists => \ constants_lists,
-	xs_file => $constants_file,
-	header => 'pango-perl.h',
-        export_tag => 'constants');
-push @xs_files, $constants_file;
-
-=cut
-
 #
 # create version macros
 #
@@ -205,9 +184,6 @@
 # exports list needed for win32, unused on others
 my @exports = Glib::MakeHelper->read_source_list_file ('pango.exports');
 
-my $configure_requires =
-  Glib::MakeHelper->get_configure_requires_yaml(%PREREQ_PM);
-
 WriteMakefile(
     NAME          => 'Pango',
     VERSION_FROM  => 'lib/Pango.pm',
@@ -218,9 +194,10 @@
     FUNCLIST      => \ exports,
     DL_FUNCS      => { Pango => [] },
 
+    META_MERGE    => { configure_requires => \%PREREQ_PM },
+
     $pango->get_makefile_vars,
 
-    EXTRA_META    => $configure_requires,
 );
 
 #

Modified: trunk/README
==============================================================================
--- trunk/README	(original)
+++ trunk/README	Sun Nov 16 19:53:29 2008
@@ -48,8 +48,9 @@
 This module requires these other modules and libraries:
 
   perl >= 5.8.0
-  Glib >= 1.200 (Perl module)
-  pango > 1.x (C library)
+  Glib >= 1.210 (Perl module)
+
+  pango >= 1.x (C library)
 
 If pango is as new or newer as 1.10, the Cairo module is also required:
 

Modified: trunk/lib/Pango.pm
==============================================================================
--- trunk/lib/Pango.pm	(original)
+++ trunk/lib/Pango.pm	Sun Nov 16 19:53:29 2008
@@ -16,8 +16,6 @@
 # along with this library; if not, write to the Free Software Foundation, Inc.,
 # 59 Temple Place - Suite 330, Boston, MA  02111-1307  USA.
 #
-# $Id$
-#
 
 package Pango;
 
@@ -43,62 +41,70 @@
 # now load the XS code.
 Pango->bootstrap ($VERSION);
 
-# %Pango::EXPORT_TAGS is filled from the constants-x.y files by the generated XS
-# code in build/constants.xs
-our @EXPORT_OK = map { @$_ } values %Pango::EXPORT_TAGS;
-$Pango::EXPORT_TAGS{all} = \ EXPORT_OK;
-
 1;
 __END__
 # documentation is a good thing.
 
 =head1 NAME
 
-Pango - FIXME
+Pango - Layout and render international text
 
 =head1 SYNOPSIS
 
-  FIXME
-
-=head1 ABSTRACT
-
-FIXME
+  my $surface = Cairo::ImageSurface->create ('argb32', 200, 100);
+  my $cr = Cairo::Context->create ($surface);
 
-=head1 DESCRIPTION
+  my $layout = Pango::Cairo::create_layout ($cr);
+  $layout->set_text ("\x{03A0}\x{03B1}\x{03BD}\x{8A9E}");
 
-FIXME
+  my $font = Pango::FontDescription->from_string ('Serif Bold 27');
+  $layout->set_font_description ($font);
 
-=head1 EXPORTS
+  Pango::Cairo::show_layout($cr, $layout);
 
-Pango exports nothing by default, but some constants are available upon request.
+  $surface->write_to_png ('pango.png');
 
-=over
-
-=item Tag: constants
-
-  FIXME
+=head1 ABSTRACT
 
-=back
+Pango is a library for laying out and rendering text, with an emphasis on
+internationalization. Pango can be used anywhere that text layout is needed,
+but using Pango in conjunction with L<Cairo> and/or L<Gtk2> provides a complete
+solution with high quality text handling and graphics rendering.
+
+Dynamically loaded modules handle text layout for particular combinations of
+script and font backend. Pango provides a wide selection of modules, including
+modules for Hebrew, Arabic, Hangul, Thai, and a number of Indic
+scripts. Virtually all of the world's major scripts are supported.
+
+In addition to the low level layout rendering routines, Pango includes
+L<Pango::Layout>, a high level driver for laying out entire blocks of text, and
+routines to assist in editing internationalized text.
+
+[Adapted from L<http://www.pango.org/>.]
+
+=head1 DOCUMENTATION
+
+L<Pango> tries to stick very close in spirit to the C API of the underlying
+pango library.  Thus, the manual available at
+L<http://library.gnome.org/devel/pango/stable/> also applies to this module.
+Additionally, API listings in POD form are generated during compilation for
+each of the sub-modules.  An index of those POD pages is available at
+L<Pango::index>.
 
 =head1 SEE ALSO
 
-L<perl>(1), L<Glib>(3pm), L<Gtk2>(3pm).
+L<perl>, L<Glib>, L<Cairo>, L<Gtk2>.
 
-L<Pango::index>(3pm) lists the autogenerated api documentation pod files for
-Pango.1
+L<Pango::index> lists the autogenerated API documentation pod files for Pango.
 
-=head1 AUTHORS
+L<http://www.pango.org/> is the homepage of the pango C library.  Its API
+documentation is available at L<http://library.gnome.org/devel/pango/stable/>.
 
-The gtk2-perl team:
+=head1 AUTHORS
 
  muppet <scott at asofyet dot org>
- Ross McFarland <rwmcfa1 at neces dot com>
- Torsten Schoenfeld <kaffeetisch at web dot de>
+ Torsten Schoenfeld <kaffeetisch at gmx dot de>
  Marc Lehmann <pcg at goof dot com>
- GÃran Thyni <gthyni at kirra dot net>
- JÃrn Reder <joern at zyn dot de>
- Chas Owens <alas at wilma dot widomaker dot com>
- Guillaume Cottenceau <gc at mandrakesoft dot com>
 
 =head1 COPYRIGHT AND LICENSE
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]