--- freetable-2.3.orig/Makefile +++ freetable-2.3/Makefile @@ -4,7 +4,7 @@ testsuite/test09.html testsuite/test10.html %.1: %.pod - ln -sf $< freetable.pod && pod2man --center='Freetable' freetable.pod >$@ + ln -sf $< freetable.pod && pod2man --center='Freetable' --utf8 freetable.pod >$@ rm -f freetable.pod all: $(OBJ) --- freetable-2.3.orig/debian/changelog +++ freetable-2.3/debian/changelog @@ -1,42 +1,77 @@ -freetable (2.3) unstable; urgency=low +freetable (2.3-4.1) unstable; urgency=low - * Rewrite of sequencing code -early sequencing algorithm - * Added a test suite - * Added COPYING to source package - * Added TESTS file - list of tests - * Fixed mail addresses in changelog, I hope it won't make too much mess + * Non-maintainer upload. + * Fix "FTBFS with perl 5.18: POD errors": + add =encoding directives to {fr,pl}.pod and convert them to utf8; + call pod2man with --utf8 in Makefile. + (Closes: #723869) - -- Tomasz Wegrzanowski Mon Dec 3 00:20:44 CET 2001 + -- gregor herrmann Wed, 23 Oct 2013 17:34:08 +0200 -freetable (2.1) unstable; urgency=low +freetable (2.3-4) unstable; urgency=low - * Fix cell jumping code + * Remove me from Maintainers. - -- Tomasz Wegrzanowski Fri, 20 Jul 2001 21:44:44 +0200 + -- Luk Claes Wed, 23 Jan 2008 22:56:30 +0000 + +freetable (2.3-3) unstable; urgency=low + + * New maintainers. + * Add debian/compat for debhelper 4. + * Updated debian/copyright. + + -- Luk Claes Sat, 30 Sep 2006 12:21:32 +0200 + +freetable (2.3-2) unstable; urgency=low + + * debian/control: Bump Standards-Version to 3.6.1, no changes needed. + + -- Denis Barbier Tue, 28 Dec 2004 08:38:50 +0100 + +freetable (2.3-1) unstable; urgency=low + + * Tarball contains an ancient fr.pod, which is replaced by a newer one. + * New upstream release (Closes: Bug#123277) + + -- Denis Barbier Mon, 10 Dec 2001 21:20:57 +0100 + +freetable (2.1-1) unstable; urgency=low + + * New upstream release, fix cell jumping code + * Remove add-log-mailing-address to let lintian happy + + -- Denis Barbier Mon, 27 Aug 2001 12:35:41 +0200 + +freetable (2.0-1) unstable; urgency=low + + * New maintainer, with Elie's approval + * New upstream release (Closes: Bug#94104) + + -- Denis Barbier Fri, 20 Jul 2001 22:09:36 +0200 freetable (2.0) unstable; urgency=low * Range or arbitrary Perl code as cell address - -- Tomasz Wegrzanowski Sun, 15 Apr 2001 22:51:21 +0200 + -- Tomasz Wegrzanowski Sun, 15 Apr 2001 22:51:21 +0200 freetable (1.1) unstable; urgency=low * Minor fix for ecmascript in nested tables - -- Tomasz Wegrzanowski Sat, 13 May 2000 11:06:21 +0200 + -- Tomasz Wegrzanowski Sat, 13 May 2000 11:06:21 +0200 freetable (1.0) frozen unstable; urgency=low * Updated French manpage - -- Tomasz Wegrzanowski Sun, 30 Jan 2000 21:57:00 +0100 + -- Tomasz Wegrzanowski Sun, 30 Jan 2000 21:57:00 +0100 freetable (0.11) unstable; urgency=low * New upstream version - -- Tomasz Wegrzanowski Thu, 27 Jan 2000 01:27:00 +0100 + -- Tomasz Wegrzanowski Thu, 27 Jan 2000 01:27:00 +0100 freetable (0.5) unstable; urgency=low @@ -44,11 +79,11 @@ * Solving bug when equal sign appeared immediately after regexp * Correcting Denis' adress - -- Tomasz Wegrzanowski Fri, 31 Dec 1999 11:02:00 +0100 + -- Tomasz Wegrzanowski Fri, 31 Dec 1999 11:02:00 +0100 freetable (0.2) unstable; urgency=low - * Sponsoring package for Tomasz Wegrzanowski + * Sponsoring package for Thoasz Wegrzanowski * Uncommented call to dh_installdocs -- Elie Rosenblum Thu, 9 Dec 1999 16:52:18 -0500 @@ -57,9 +92,5 @@ * Initial Release - -- Tomasz Wegrzanowski Wed, 8 Dec 1999 22:00:00 +0100 + -- Tomasz Wegrzanowski Wed, 8 Dec 1999 22:00:00 +0100 -Local variables: -mode: debian-changelog -add-log-mailing-address: "taw@users.sf.net" -End: --- freetable-2.3.orig/debian/compat +++ freetable-2.3/debian/compat @@ -0,0 +1 @@ +4 --- freetable-2.3.orig/debian/control +++ freetable-2.3/debian/control @@ -1,13 +1,15 @@ Source: freetable Section: web Priority: optional -Maintainer: Elie Rosenblum -Standards-Version: 3.1.0 +Maintainer: Felipe Augusto van de Wiel (faw) +Standards-Version: 3.7.2 +Build-Depends: debhelper (>= 4) +Build-Depends-Indep: perl Package: freetable Architecture: all -Depends: ${perl:Depends} -Description: A Perl script that facilitates the production of HTML tables +Depends: perl +Description: Facilitates production of HTML tables Freetable is a perl script that aims to make the production of HTML tables a little easier. This script works as a filter, reading stdin and writing to stdout. --- freetable-2.3.orig/debian/copyright +++ freetable-2.3/debian/copyright @@ -1,10 +1,27 @@ -Freetable html tables generator -Copyright (c) 1999, 2000, 2001 Tomasz Wegrzanowski +Currently maintained by Luk Claes and + Felipe Augusto van de Wiel -Freetable is free software; you can redistribute it and/or modify -it under the terms of the GNU General Public License as published by -the Free Software Foundation; either version 2 of the License, or -(at your option) any later version. +Authors: + (c) 1999, 2000, 2001 Tomasz Wegrzanowski -On Debian GNU/Linux systems, the complete text of the GNU General -Public License can be found in `/usr/share/common-licenses/GPL'. + Freetable is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + in the file COPYING along with this program; if not, write to + + Free Software Foundation, Inc. + 51 Franklin St, Fifth Floor + Boston, MA 02110-1301, USA + +Thanks to Denis Barbier for contribution + +On Debian GNU/Linux systems, the complete text of the GNU General Public +License may be found in `/usr/share/common-licenses/GPL'. --- freetable-2.3.orig/debian/rules +++ freetable-2.3/debian/rules @@ -33,19 +33,15 @@ dh_testroot dh_clean -k dh_installdirs usr/bin usr/share/man/man1 usr/share/man/fr/man1 usr/share/man/pl/man1 - - cp -av freetable debian/tmp/usr/bin/ - gzip -v debian/tmp/usr/share/man/man1/freetable.1.gz - gzip -v debian/tmp/usr/share/man/fr/man1/freetable.1.gz - gzip -v debian/tmp/usr/share/man/pl/man1/freetable.1.gz - + install -m 755 freetable debian/freetable/usr/bin/ + install -m 644 en.1 debian/freetable/usr/share/man/man1/freetable.1 + install -m 644 fr.1 debian/freetable/usr/share/man/fr/man1/freetable.1 + install -m 644 pl.1 debian/freetable/usr/share/man/pl/man1/freetable.1 dh_installdocs dh_installchangelogs -# dh_compress + dh_compress dh_fixperms - dh_suidregister dh_installdeb - dh_perl dh_gencontrol dh_md5sums dh_builddeb --- freetable-2.3.orig/fr.pod +++ freetable-2.3/fr.pod @@ -1,86 +1,86 @@ -freetable 0.11 -Tomasz Wgrzanowski +=encoding UTF-8 -French Documentation 0.11-1 -Denis Barbier +=head1 NOM -=head1 NAME - -freetable - outil de gnration automatique de tableaux HTML +B - outil de génération automatique de tableaux HTML =head1 VERSION -Cette documentation dcrit l'utilisation de freetable 1.1. +Cette documentation décrit l'utilisation de B version 2.3. -Si vous utilisez une autre version, certaines diffrences peuvent +Si vous utilisez une autre version, certaines différences peuvent apparaitre. =head1 SYNOPSIS B I<[options]> F +ou + +B I<[options]> + Options: -I<-h>, I<--help> Print usage info and exit +I<-h>, I<--help> Affiche cette aide et stoppe -I<-V>, I<--version> Affiche seulement le numro de version - de F +I<-V>, I<--version> Affiche seulement le numéro de version I<-c>, I<--comment> Affiche un commentaire avant chaque cellule pour indiquer son emplacement -I<-b>, I<--no-nbsp> N'ajoute pas C< > dans les cellules +I<-b>, I<--no-nbsp> N'ajoute pas I< > dans les cellules vides pour modifier le rendu 3D I<-w>, I<--warning> Affiche un commentaire avant chaque tableau, indiquant que le tableau est - gnr automatiquement et ne doit pas - tre dit + généré automatiquement et ne doit pas + être édité I<-l>, I<--location> Remplace les indicateurs CrowE> (ligne) - et CcolE> (colonne) l'intrieur des + et CcolE> (colonne) à l'intérieur des tableaux par la position de la cellule courante. -I<-m>, I<--macro> Avec cette option, le contenu des - cellules est pass un pr-processeur, - qui est F par dfaut - -=head1 AVERTISSEMENT SUR LA SECURITE - - N'UTILISEZ PAS DE MACRO PROCESSEUR SUR UN - FICHIER SOURCE DONT VOUS N'ETES PAS SUR. - CELA POURRAIT COMPROMETTRE LA SECURITE DE - VOTRE SYSTEME +I<-m>, I<--macro> I<[program]> + Avec cette option, le contenu des + cellules est passé à un pré-processeur, + qui est B par défaut + +=head1 AVERTISSEMENT SUR LA SÉCURITÉ + + N'UTILISEZ PAS DE MACRO-PROCESSEUR SUR UN + FICHIER SOURCE DONT VOUS N'ÊTES PAS SÛR. + CELA POURRAIT COMPROMETTRE LA SÉCURITÉ DE + VOTRE SYSTÈME - Plus d'informations dans la documentation de F, - en particulier la commande I. +Plus d'informations dans la documentation de B, +en particulier la commande I. =head1 DESCRIPTION -Ce programme est un logiciel libre qui remplace F. +Ce programme est un logiciel libre qui remplace B. -HTML est un langage agrable, mais avec un norme dfaut : les tableaux. -J'ai pass de nombreuses heures lire le code source que j'avais tout -juste crit pour essayer de comprendre quelle cellule dans le code -source correspond ce qui est affich dans le navigateur. +HTML est un langage agréable, mais avec un énorme défaut : les tableaux. +J'ai passé de nombreuses heures à lire le code source que j'avais tout +juste écrit pour essayer de comprendre quelle cellule dans le code +source correspond à ce qui est affiché dans le navigateur. -Si cela vous rappelle une exprience similaire, alors lisez cette +Si cela vous rappelle une expérience similaire, alors lisez cette documentation et votre peine ne sera plus qu'un mauvais souvenir. -Le programme reoit en entre du code HTML provenant soit de l'entre -standard, soit d'un fichier. Il recherche alors les caractres suivants, -qui annoncent l'ouverture d'un tableau: +Le programme reçoit en entrée du code HTML provenant soit de l'entrée +standard (I), soit d'un fichier. Il recherche alors les +caractères suivants, qui annoncent l'ouverture d'un tableau: -Il analyse le contenu jusqu' dtecter la fin du tableau, affiche le +Il analyse le contenu jusqu'à détecter la fin du tableau, affiche le code HTML correspondant puis continue le traitement avec les tableaux suivants. =head1 SYNTAXE -La syntaxe est trs simple: +La syntaxe est très simple: wwwtable: @@ -90,54 +90,55 @@ ... -La chaine optionnelle wwwtable_options est passe telle quelle comme -attribut de la balise CTABLEE>. Le prambule n'est pas trait, -il peux contenir n'importe quel code HTML, il sera insr au dbut du +La chaîne optionnelle wwwtable_options est passée telle quelle comme +attribut de la balise CtableE>. Le préambule n'est pas traité, +il peux contenir n'importe quel code HTML, il sera inséré au début du tableau. -Les cellules sont soit des cellules normales (balise CTDE>), -soit des cellules d'en-tte (balise CTHE>). +Les cellules sont soit des cellules normales (balise CtdE>), +soit des cellules d'en-tête (balise CthE>). +Il en était ainsi jusqu'aux versions 1.x, voyez la prochaine section +pour une autre méthode d'adressage des colonnes. cellule normale: - (ligne,colonne) cellule_options + (ligne,colonne) options_cellule contenu_cellule - cellule en-tte: - ((ligne,colonne)) cellule_options + cellule en-tête: + ((ligne,colonne)) options_cellule contenu_cellule -Le texte contenu dans cellule_options est pass comme attribut -de la balise de la cellule. Les mots-cls C et C -sont interprts pour gnrer des tableaux corrects. +Le texte contenu dans options_cellule est passé comme attribut +de la balise de la cellule. Les mots-clés I et I +sont interprétés pour générer des tableaux corrects. -Le contenu des cellules (contenu_cellule) est quelconque, il peut mme +Le contenu des cellules (contenu_cellule) est quelconque, il peut même contenir d'autres wwwtables ! -Si vous utilisez l'option I<-m>, le contenu des cellules sera pass -comme entre standard de la commande F(1), aprs avoir remplac les -chaines de caractres BrowE> (resp. BcolE>) -par le numro de ligne (resp. colonne) de la cellule. +Si vous utilisez l'option I<-m> (ou son synonyme I<--macro>), le contenu +des cellules sera passé comme entrée standard de la commande B(1), +après avoir remplacé les chaînes de caractères BrowE> (resp. +BcolE>) par le numéro de ligne (resp. colonne) de la cellule. -Les indices de ligne et colonne sont soit des nombres, soit une -expression rgulire qui dsigne un ensemble de cellules. la -diffrence de F, F peut aussi utiliser des -expressions rgulires dans les cellules d'en-tte. Un autre ajout est -la possiblit d'utiliser C<*> la place de C<.*>. +Les indices de ligne et colonne sont soit des nombres, soit un adressage +relatif, soit une expression régulière qui désigne un ensemble de +cellules. À la différence de B, B peut aussi +utiliser des expressions régulières dans les cellules d'en-tête. Un +autre ajout est la possiblité d'utiliser I<*> à la place de I<.*>. -Les expressions rgulires suivantes sont reconnues dans les indices de -lignes et colonnes: +L'adressage relatif est de la forme : -I<=> ou vide : mme indice que la cellule prcdente +I<=> ou vide : même indice que la cellule précédente -I<+> ou I<+X> : incrmente l'indice de I (dfaut: 1) +I<+> ou I<+X> : incrémente l'indice de I (défaut: 1) -I<-> ou I<-X> : dcrmente l'indice de I (dfaut: 1) +I<-> ou I<-X> : décrémente l'indice de I (défaut: 1) -Lorsqu'une cellule est dsigne par plusieurs expressions rgulires, -la fois les options et le contenu de chaque cellule sont ajouts. +Lorsqu'une cellule est désignée par plusieurs expressions, à la fois les +options et le contenu de chaque cellule sont ajoutés. -Si vous n'utilisez que des expressions rgulires, il faut indiquer au -programme la position de la dernire cellule. +Si vous n'utilisez que des expressions régulières, il faut indiquer au +programme la position de la dernière cellule. (*,1) @@ -147,21 +148,91 @@ (4,4) -=head1 INCOMPATIBILITES AVEC WWWTABLE +=head1 AUTRE SYNTAXE D'ADRESSAGE + +Il n'est pas très pratique de spécifier les numéros de cellules avec des +expressions régulières. B 2.0 a introduit deux nouvelles +méthodes d'adressage, qui peuvent être utilisées sur les cellules +normales et les cellules d'en-tête. + +Une compatibilité totale avec les versions antérieures est assurée. +Pour cette raison, il n'était pas question de modifier la syntaxe +actuelle. Malheureusement, vous ne pouvez pas spécifier les lignes en +utilisant une syntaxe d'adressage, et les colonnes avec une autre +syntaxe. Pour remédier à ce problème, les deux méthodes sont très +souples, si bien que vous ne devriez jamais avoir à les mélanger, et +elles vous permettent d'utiliser I<=>, I<+>, I<->, I<+X>, I<-X> et la +chaîne vide de la même façon qu'avec B 1.x. + +De plus, ces nouvelles méthodes déterminent automatiquement la dernière +cellule, contrairement à l'adressage par des expressions régulières. + +=head2 BORNES EXPLICITES + + (bornes_ligne;bornes_colonne) options_cellule + contenu_cellule + +La syntaxe pour I et I est de la forme: +1-2,4-7,9,12. Les doublons sont éliminés. Pour les besoins de +l'adressage relatif, le dernier nombre est utilisée. Ainsi, quand vous +écrivez + + (1-100,32;1) + foo + (+,) + bar -Les utilisateurs de F qui dcident de passer F -devraient lire cette section. La majorit des incompatibilits -proviennent du traitement des expressions rgulires. Il faut aussi -noter que F ne permettait ni le remplacement automatiques des -numros de lignes et de colonnes, ni l'utilisation d'un -pr-processeur. +la cellule (33,1) contiendra « foo bar » et toutes les autres seulement +« foo ». -Les cellules d'en-tte peuvent tre dfinies avec des expressions -rgulires, par exemple +=head2 CODE PERL QUELCONQUE - ((1,*)) align=right + ({code pour les lignes},{code pour les colonnes}) options_cellule + contenu_cellule + +Vous pouvez utiliser n'importe quel code Perl qui tient sur une seule +ligne du moment qu'il est repéré oar notre expression régulière (pas +très futée) et renvoie une liste. Il n'est malheureusement pas possible +de détecter n'importe quel code de Perl grâce à une expression +régulière, mais du moment qu'il ne contient pas les séquences I<},{> et +I<})>, cela devrait marcher. Exemple : + + ({grep {$_%3 == 1} 1..100},{1..2,4}) + foo + + +va créer un tableau de 100 lignes par 4 colonnes avec « foo » dans les +premières, deuxième et quatrième colonnes de chaque ligne dont le numéro +vaut 1 modulo 3. + +Si vous voulez mélanger cet adressage avec le précédent, il suffit de +remplacer I<-> par I<..> dans la définition des bornes, et l'entourer +par des accolades I<{> et I<}>. + +Si vous voulez mélanger cet adressage avec une expression régulière, +vous pouvez remplacer cette dernière par I<{grep {/expression/} min..max}>. +Il est malheureusement obligatoire de spécifier explicitement la +dimension du tableau. + +=head1 INCOMPATIBILITÉS AVEC WWWTABLE + +Les utilisateurs de B qui décident de passer à B +devraient lire cette section. La majorité des incompatibilités +proviennent du traitement des expressions régulières. Il faut aussi +noter que B ne permettait ni le remplacement automatiques des +numéros de lignes et de colonnes, ni l'utilisation d'un +pré-processeur. + +L'option I<-w> a le comportement opposé. Nous n'écrivons aucun +commentaire par défaut, et I<-w> ou I<--warning> est utilisée pour les +ajouter. + +Les cellules d'en-tête peuvent être définies avec des expressions +régulières, par exemple + + ((1,*)) -ce qui tait impossible avec F. +ce qui était impossible avec B. Les indices des axes sont 100% orthogonaux, ce qui signifie qu'avec le code suivant @@ -172,8 +243,8 @@ (=,=) Foo -C va apparaitre en 3e colonne, et si vous vouliez qu'il soit en 1e -position, il faut crire +Foo va apparaitre en 3e colonne, et si vous vouliez qu'il soit en 1e +position, il faut écrire (*,1) width=30 (*,2) width=35 @@ -189,15 +260,24 @@ (=,1) Foo +Avec B 2.0, deux méthodes complètement nouvelles d'adressage +des cellules ont été introduites. Elles sont totalement incompatibles +avec B. + +=head1 BUGS + +L'utilisation de « code Perl quelconque » échouera avec du code +complexe. + =head1 VOIR AUSSI - B +B =head1 AUTEUR Tomasz Wegrzanowski -Traduction franaise de la documentation: -Denis Barbier +Traduction française de la documentation: +Denis Barbier =cut --- freetable-2.3.orig/pl.pod +++ freetable-2.3/pl.pod @@ -1,12 +1,14 @@ +=encoding UTF-8 + =head1 NAME -B - program uatwiajcy tworzenie HTML-owych tabeli +B - program ułatwiający tworzenie HTML-owych tabeli =head1 WERSJA Ten dokument opisuje B w wersji 2.3. -Moe by nie w peni prawidowy jeli uywasz innej wersji. +Może być nie w pełni prawidłowy jeśli używasz innej wersji. =head1 SYNOPSIS @@ -16,207 +18,207 @@ B I<[opcje]> -Dostpne opcje to : +Dostępne opcje to : -I<-h>, I<--help> Program wydrukuje informacj o sposobie uycia i skoczy +I<-h>, I<--help> Program wydrukuje informację o sposobie użycia i skończy -I<-V>, I<--version> Program wydrukuje numer wersji i skoczy +I<-V>, I<--version> Program wydrukuje numer wersji i skończy -I<-c>, I<--comment> Program wstawi przed kad komrk komentarz o jej pozycji +I<-c>, I<--comment> Program wstawi przed każdą komórką komentarz o jej pozycji -I<-b>, I<--no-nbsp> Program nie wstawi I< > do pustych komrek celem -wizualnego ich obnienia na graficznych przegldarkach +I<-b>, I<--no-nbsp> Program nie wstawi I< > do pustych komórek celem +wizualnego ich obniżenia na graficznych przeglądarkach -I<-w>, I<--warning> Program wstawi ostrzeenie e powinna raczej zmienia -rdo ni tabel przed kad tabel, ktr stworzy. +I<-w>, I<--warning> Program wstawi ostrzeżenie że powinnaś raczej zmieniać +źródło niż tabelę przed każdą tabelą, którą stworzy. I<-l>, I<--location> Program zamieni tagi lokacyjne IrowE> i -IcolE> wewntrz tabeli na pozycj komrki, w ktrej wystpi. +IcolE> wewnątrz tabeli na pozycję komórki, w której wystąpią. I<-m>, I<--macro> I<[program]> - Program przepuci tabel przez makroprocesor (domylnie: B) + Program przepuści tabelę przez makroprocesor (domyślnie: B) -=head1 OSTRZEENIE +=head1 OSTRZEŻENIE - NIE UYWAJ MAKROPROCESORA NA NIEPEWNYM RDLE - M4 MOE ZOSTA UYTE DO NARUSZENIA TWEGO BEZPIECZESTWA - WICEJ INFORMACJI ZNAJDZIESZ URUCHAMIAJC : + NIE UŻYWAJ MAKROPROCESORA NA NIEPEWNYM ŹRÓDLE + M4 MOŻE ZOSTAĆ UŻYTE DO NARUSZENIA TWEGO BEZPIECZEŃSTWA + WIĘCEJ INFORMACJI ZNAJDZIESZ URUCHAMIAJĄC : I =head1 DESCRIPTION -Ten program jest wyzwolonym (wolnodostpnym) nastpc B. +Ten program jest wyzwolonym (wolnodostępnym) następcą B. -HTML to wietny jzyk, ale ma straszn niedorb : tabele. -Spdziem wiele czasu wpatrujc si w HTMLowy kod i prbujc zgadn, -ktra komrka kodu odpowiada ktrej w przegldarce. +HTML to świetny język, ale ma straszną niedoróbę : tabele. +Spędziłem wiele czasu wpatrując się w HTMLowy kod i próbując zgadnąć, +która komórka kodu odpowiada której w przeglądarce. -Jeli rwnie miae ten problem, to by moe za chwil zostanie rozwizany. +Jeśli również miałeś ten problem, to być może za chwilę zostanie rozwiązany. -Program czyta z pliku lub ze I. Szuka linii zaczynajcej opis tabeli : +Program czyta z pliku lub ze I. Szuka linii zaczynającej opis tabeli : -Analizuje ten opis, wstawia poprawn HTML-ow tabel i szuka nastpnego opis, a plik -si skoczy. +Analizuje ten opis, wstawia poprawną HTML-ową tabelę i szuka następnego opis, aż plik +się skończy. -=head1 SKADNIA TABELI +=head1 SKŁADNIA TABELI Jest bardzo prosta : wwwtable - [preambua] - [komrka] - [komrka] + [preambuła] + [komórka] + [komórka] ... -opcje bd przekazane do taga ItableE>. -Preambua to dowolny HTML-owy text. Bdzie umieszczony bezporednio przed tabel. +opcje będą przekazane do taga ItableE>. +Preambuła to dowolny HTML-owy text. Będzie umieszczony bezpośrednio przed tabelą. -komrka to albo normalna_komrka (tag ItdE>) albo -nagwkowa_komrka (tag IthE>). -Tak przynajmniej byo w starszych wersjach freetable. -W nastpnej sekcji s opisane nowe metody adresowania komrek. +komórka to albo normalna_komórka (tag ItdE>) albo +nagłówkowa_komórka (tag IthE>). +Tak przynajmniej było w starszych wersjach freetable. +W następnej sekcji są opisane nowe metody adresowania komórek. - normalna_komrka : - (rzd,kolumna) opcje - zawarto + normalna_komórka : + (rząd,kolumna) opcje + zawartość - nagwkowa_komrka : - ((rzd,kolumna)) opcje - zawarto + nagłówkowa_komórka : + ((rząd,kolumna)) opcje + zawartość -opcje bd przekazane do komrkowego taga. Atrybuty I i I -s uwzgldniane podczas tworzenia tabeli. +opcje będą przekazane do komórkowego taga. Atrybuty I i I +są uwzględniane podczas tworzenia tabeli. -zawarto mae zawiera text, tagi a nawet osadzon tabel. +zawartość maże zawierać text, tagi a nawet osadzoną tabelę. -Jeli uywasz opcji I<-m> (lub I<--macro>), zawarto bdzie przerobiona przez m4(1), -z i ustawionymi na adres aktualnej komrki +Jeśli używasz opcji I<-m> (lub I<--macro>), zawartość będzie przerobiona przez m4(1), +z i ustawionymi na adres aktualnej komórki -rzd i kolumna mog by zarwno liczbami, wyraeniami wzgldnymi, albo regex'ami. -W przeciwiestwie do B, z B moesz uywa regex'w rwnie -dla komrek nagwka. -Moesz rwnie uywa I<*>, co znaczy dokadnie tyle co I<.*>. +rząd i kolumna mogą być zarówno liczbami, wyrażeniami względnymi, albo regex'ami. +W przeciwieństwie do B, z B możesz używać regex'ów również +dla komórek nagłówka. +Możesz również używać I<*>, co znaczy dokładnie tyle co I<.*>. -Wyraenia wzgldne to : +Wyrażenia względne to : -I<=> albo pusta znaczy : tyle samo co w poprzedniej komrce +I<=> albo pusta znaczy : tyle samo co w poprzedniej komórce -I<+> albo I<+X> znaczy : o 1 lub X wicej ni w poprzedniej komrce +I<+> albo I<+X> znaczy : o 1 lub X więcej niż w poprzedniej komórce -I<-> albo I<-X> znaczy : o 1 lub X wicej ni w poprzedniej komrce +I<-> albo I<-X> znaczy : o 1 lub X więcej niż w poprzedniej komórce -Jeli wiele definicji adresuje t sam komrk zarwno opcje jak i zawarto s doklejane -w kolejnoci wystpienia. +Jeśli wiele definicji adresuje tą samą komórkę zarówno opcje jak i zawartość są doklejane +w kolejności wystąpienia. -Jeli chcesz uywa tylko regex'w musisz powiedzie programowi o adresie ostatniej komrki : +Jeśli chcesz używać tylko regex'ów musisz powiedzieć programowi o adresie ostatniej komórki : (*,1) - to s piewsze kolumny + to są piewsze kolumny (1,*) - to s piewsze rzdy + to są piewsze rzędy (4,4) -=head1 ALTERNATYWNE ADRESY KOMREK +=head1 ALTERNATYWNE ADRESY KOMÓREK -Adresowanie komrek za pomoc wyrae regularnych jest -bardzo niewygodne. Z tego powodu, w B 2.0 zostay +Adresowanie komórek za pomocą wyrażeń regularnych jest +bardzo niewygodne. Z tego powodu, w B 2.0 zostały wprowadzone dwie nowe metody. -Obie mog by uyte zarwno do komrek normalnych jak i nagwkowych. +Obie mogą być użyte zarówno do komórek normalnych jak i nagłówkowych. -Zachowana jest pena wsteczna kompatybilno. -W tym celu zostaa wprowadzona nowa skadnia. -Niestety, nie moesz adresowa rzdu i kolumny uywajc +Zachowana jest pełna wsteczna kompatybilność. +W tym celu została wprowadzona nowa składnia. +Niestety, nie możesz adresować rzędu i kolumny używając odmiennych metod. -eby obej ten problem, obie nowe metody s bardzo tolerancyjne -i pozwalaj na uycie I<=>, I<+>, I<->, I<+X> I<-X> oraz -pustego acucha z tym samym znaczeniem, jakie maj one +Żeby obejść ten problem, obie nowe metody są bardzo tolerancyjne +i pozwalają na użycie I<=>, I<+>, I<->, I<+X> I<-X> oraz +pustego łańcucha z tym samym znaczeniem, jakie mają one w starej metodzie. -Nowe metody potrafi samodzielnie ustali rozmiar tabeli. +Nowe metody potrafią samodzielnie ustalić rozmiar tabeli. -=head2 ZASIGI +=head2 ZASIĘGI - (zasig rzdw;zasig kolumn) opcje - zawarto + (zasięg rzędów;zasięg kolumn) opcje + zawartość -Skadnia wyglda jak: 1-2,4-7,9,12. -Zduplikowane adresy zostaj wyeliminowane. +Składnia wygląda jak: 1-2,4-7,9,12. +Zduplikowane adresy zostają wyeliminowane. Dla potrzeb adresowania relatywnego, -uyty jest ostatni podany numer. A wic jeli napiszesz +użyty jest ostatni podany numer. A więc jeśli napiszesz (1-100,32;1) foo (+,) bar -Komrka (33,1) bdzie zawiera `foobar' a wszystkie pozostae tylko `foo'. +Komórka (33,1) będzie zawierać `foobar' a wszystkie pozostałe tylko `foo'. =head2 DOWOLNY KOD PERL - ({kod dla rzdw},{kod dla kolumn}) opcje - zawarto + ({kod dla rzędów},{kod dla kolumn}) opcje + zawartość -Moesz uywa dowolnego kodu Perl o ile zmieci si w jednej linijce, -pasuje do naszego wyraenia regularnego i da w wyniku list. -Niestety, nie istnieje wyraenie regularne pasujce do dowolnego -kodu Perl, ale dopki twj kod nie zawiera I<},{> ani I<})>, -powinno dziaa. -Przykad: +Możesz używać dowolnego kodu Perl o ile zmieści się w jednej linijce, +pasuje do naszego wyrażenia regularnego i da w wyniku listę. +Niestety, nie istnieje wyrażenie regularne pasujące do dowolnego +kodu Perl, ale dopóki twój kod nie zawiera I<},{> ani I<})>, +powinno działać. +Przykład: ({grep {$_%3 == 1} 1..100},{1..2,4}) foo -Da tabele 100 rzdw x 4 kolumny z `foo' w kadej -1wszej, 2giej i 4tej kolumnie kadego rzdu o numerze dajcym reszte 1 w +Da tabele 100 rzędów x 4 kolumny z `foo' w każdej +1wszej, 2giej i 4tej kolumnie każdego rzędu o numerze dającym reszte 1 w dzieleniu przez 3. -Jeli chcesz uy "dowolnego kodu" w jednej czsci adresu a zasigu w drugiej -zastp w definicji zasigu I<-> przez I<..> i w zasig midzy I<{> i I<}>. +Jeśli chcesz użyć "dowolnego kodu" w jednej częsci adresu a zasięgu w drugiej +zastąp w definicji zasięgu I<-> przez I<..> i włóż zasięg między I<{> i I<}>. -Jeli chcesz uy "dowolnego kodu" w jednej czsci adresu a wyraenia -regulernego w drugiej, musisz napisa I<{grep {/wyraenie/} od..do}>. -Niestety, w tym wypadku musisz poda rozmiar tablicy. - -=head1 NIEZGODNOCI Z WWWTABLE - -Jeli poprzednio uywae B, a teraz chcesz si przesi, -powiniene przeczyta ten rozdzia. Wikszo jest o regex'ach. -Zauwa rwnie, e B nie mg uywa podstawiania tagw lokacyjnych ani +Jeśli chcesz użyć "dowolnego kodu" w jednej częsci adresu a wyrażenia +regulernego w drugiej, musisz napisać I<{grep {/wyrażenie/} od..do}>. +Niestety, w tym wypadku musisz podać rozmiar tablicy. + +=head1 NIEZGODNOŚCI Z WWWTABLE + +Jeśli poprzednio używałeś B, a teraz chcesz się przesiąść, +powinieneś przeczytać ten rozdział. Większość jest o regex'ach. +Zauważ również, że B nie mógł używać podstawiania tagów lokacyjnych ani makroprocesora. -Opcja I<-w> ma przeciwne znaczenie. Domylnie adne ostrzeenie nie jest drukowane, -a I<-w> albo I<--warning> su wymuszeniu takiego ostrzaenia. +Opcja I<-w> ma przeciwne znaczenie. Domyślnie żadne ostrzeżenie nie jest drukowane, +a I<-w> albo I<--warning> służą wymuszeniu takiego ostrzażenia. -Komrki nagwkowe mog by zdefiniowane za pomoc regex'w : +Komórki nagłówkowe mogą być zdefiniowane za pomocą regex'ów : ((1,*)) -Nie byo to moliwe z B. +Nie było to możliwe z B. -Liczniki pozycji na osiach s 100%-owo niezalene. Wynika z tego e kod : +Liczniki pozycji na osiach są 100%-owo niezależne. Wynika z tego że kod : (*,1) width=30 (*,2) width=35 (*,3) width=40 (=,=) - Co + Cośś -umieci Co w 3ciej kolumnie. Jeli chcesz, by byo w 1wszej, napisz : +umieści Cośś w 3ciej kolumnie. Jeśli chcesz, by było w 1wszej, napisz : (*,1) width=30 (*,2) width=35 (*,3) width=40 (=,1) - Co + Cośś albo @@ -224,16 +226,16 @@ (*,+) width=35 (*,+) width=40 (=,1) - Co + Cośś -W B 2.0 zostay wprowadzone dwie nowe metody adresowania -komrek. S cakowicie niezgodne z B. +W B 2.0 zostały wprowadzone dwie nowe metody adresowania +komórek. Są całkowicie niezgodne z B. =head1 BUGS -Adres typu "Dowolny Kod Perl" moe nie dziaa ze skomplikowanym kodem. +Adres typu "Dowolny Kod Perl" może nie działać ze skomplikowanym kodem. -=head1 ZOBACZ RWNIE +=head1 ZOBACZ RÓWNIEŻ B @@ -241,6 +243,6 @@ Tomasz Wegrzanowski -(zarwno angielska jak i polska wersja) +(zarówno angielska jak i polska wersja) =cut