projekt kivitendo

Terms of Perl itself

a) the GNU General Public License as published by the Free

   Software Foundation; either version 1, or (at your option) any

   later version, or

b) the "Artistic License"

---------------------------------------------------------------------------

The General Public License (GPL)

Version 2, June 1991

Copyright (C) 1989, 1991 Free Software Foundation, Inc. 675 Mass Ave,

Cambridge, MA 02139, USA. Everyone is permitted to copy and distribute

verbatim copies of this license document, but changing it is not allowed.

Preamble

The licenses for most software are designed to take away your freedom to share

and change it. By contrast, the GNU General Public License is intended to

guarantee your freedom to share and change free software--to make sure the

software is free for all its users. This General Public License applies to most of

the Free Software Foundation's software and to any other program whose

authors commit to using it. (Some other Free Software Foundation software is

covered by the GNU Library General Public License instead.) You can apply it to

your programs, too.

When we speak of free software, we are referring to freedom, not price. Our

General Public Licenses are designed to make sure that you have the freedom

to distribute copies of free software (and charge for this service if you wish), that

you receive source code or can get it if you want it, that you can change the

software or use pieces of it in new free programs; and that you know you can do

these things.

To protect your rights, we need to make restrictions that forbid anyone to deny

you these rights or to ask you to surrender the rights. These restrictions

translate to certain responsibilities for you if you distribute copies of the

software, or if you modify it.

For example, if you distribute copies of such a program, whether gratis or for a

fee, you must give the recipients all the rights that you have. You must make

sure that they, too, receive or can get the source code. And you must show

them these terms so they know their rights.

We protect your rights with two steps: (1) copyright the software, and (2) offer

you this license which gives you legal permission to copy, distribute and/or

modify the software.

Also, for each author's protection and ours, we want to make certain that

everyone understands that there is no warranty for this free software. If the

software is modified by someone else and passed on, we want its recipients to

know that what they have is not the original, so that any problems introduced by

others will not reflect on the original authors' reputations.

Finally, any free program is threatened constantly by software patents. We wish

to avoid the danger that redistributors of a free program will individually obtain

patent licenses, in effect making the program proprietary. To prevent this, we

have made it clear that any patent must be licensed for everyone's free use or

not licensed at all.

The precise terms and conditions for copying, distribution and modification

follow.

GNU GENERAL PUBLIC LICENSE

TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND

MODIFICATION

0. This License applies to any program or other work which contains a notice

placed by the copyright holder saying it may be distributed under the terms of

this General Public License. The "Program", below, refers to any such program

or work, and a "work based on the Program" means either the Program or any

derivative work under copyright law: that is to say, a work containing the

Program or a portion of it, either verbatim or with modifications and/or translated

into another language. (Hereinafter, translation is included without limitation in

the term "modification".) Each licensee is addressed as "you".

Activities other than copying, distribution and modification are not covered by

this License; they are outside its scope. The act of running the Program is not

restricted, and the output from the Program is covered only if its contents

constitute a work based on the Program (independent of having been made by

running the Program). Whether that is true depends on what the Program does.

1. You may copy and distribute verbatim copies of the Program's source code as

you receive it, in any medium, provided that you conspicuously and appropriately

publish on each copy an appropriate copyright notice and disclaimer of warranty;

keep intact all the notices that refer to this License and to the absence of any

warranty; and give any other recipients of the Program a copy of this License

along with the Program.

You may charge a fee for the physical act of transferring a copy, and you may at

your option offer warranty protection in exchange for a fee.

2. You may modify your copy or copies of the Program or any portion of it, thus

forming a work based on the Program, and copy and distribute such

modifications or work under the terms of Section 1 above, provided that you also

meet all of these conditions:

a) You must cause the modified files to carry prominent notices stating that you

changed the files and the date of any change.

b) You must cause any work that you distribute or publish, that in whole or in

part contains or is derived from the Program or any part thereof, to be licensed

as a whole at no charge to all third parties under the terms of this License.

c) If the modified program normally reads commands interactively when run, you

must cause it, when started running for such interactive use in the most ordinary

way, to print or display an announcement including an appropriate copyright

notice and a notice that there is no warranty (or else, saying that you provide a

warranty) and that users may redistribute the program under these conditions,

and telling the user how to view a copy of this License. (Exception: if the

Program itself is interactive but does not normally print such an announcement,

your work based on the Program is not required to print an announcement.)

These requirements apply to the modified work as a whole. If identifiable

sections of that work are not derived from the Program, and can be reasonably

considered independent and separate works in themselves, then this License,

and its terms, do not apply to those sections when you distribute them as

separate works. But when you distribute the same sections as part of a whole

which is a work based on the Program, the distribution of the whole must be on

the terms of this License, whose permissions for other licensees extend to the

entire whole, and thus to each and every part regardless of who wrote it.

Thus, it is not the intent of this section to claim rights or contest your rights to

work written entirely by you; rather, the intent is to exercise the right to control

the distribution of derivative or collective works based on the Program.

In addition, mere aggregation of another work not based on the Program with the

Program (or with a work based on the Program) on a volume of a storage or

distribution medium does not bring the other work under the scope of this

License.

3. You may copy and distribute the Program (or a work based on it, under

Section 2) in object code or executable form under the terms of Sections 1 and 2

above provided that you also do one of the following:

a) Accompany it with the complete corresponding machine-readable source

code, which must be distributed under the terms of Sections 1 and 2 above on a

medium customarily used for software interchange; or,

b) Accompany it with a written offer, valid for at least three years, to give any

third party, for a charge no more than your cost of physically performing source

distribution, a complete machine-readable copy of the corresponding source

code, to be distributed under the terms of Sections 1 and 2 above on a medium

customarily used for software interchange; or,

c) Accompany it with the information you received as to the offer to distribute

corresponding source code. (This alternative is allowed only for noncommercial

distribution and only if you received the program in object code or executable

form with such an offer, in accord with Subsection b above.)

The source code for a work means the preferred form of the work for making

modifications to it. For an executable work, complete source code means all the

source code for all modules it contains, plus any associated interface definition

files, plus the scripts used to control compilation and installation of the

executable. However, as a special exception, the source code distributed need

not include anything that is normally distributed (in either source or binary form)

with the major components (compiler, kernel, and so on) of the operating system

on which the executable runs, unless that component itself accompanies the

executable.

If distribution of executable or object code is made by offering access to copy

from a designated place, then offering equivalent access to copy the source

code from the same place counts as distribution of the source code, even though

third parties are not compelled to copy the source along with the object code.

4. You may not copy, modify, sublicense, or distribute the Program except as

expressly provided under this License. Any attempt otherwise to copy, modify,

sublicense or distribute the Program is void, and will automatically terminate

your rights under this License. However, parties who have received copies, or

rights, from you under this License will not have their licenses terminated so long

as such parties remain in full compliance.

5. You are not required to accept this License, since you have not signed it.

However, nothing else grants you permission to modify or distribute the Program

or its derivative works. These actions are prohibited by law if you do not accept

this License. Therefore, by modifying or distributing the Program (or any work

based on the Program), you indicate your acceptance of this License to do so,

and all its terms and conditions for copying, distributing or modifying the

Program or works based on it.

6. Each time you redistribute the Program (or any work based on the Program),

the recipient automatically receives a license from the original licensor to copy,

distribute or modify the Program subject to these terms and conditions. You

may not impose any further restrictions on the recipients' exercise of the rights

granted herein. You are not responsible for enforcing compliance by third parties

to this License.

7. If, as a consequence of a court judgment or allegation of patent infringement

or for any other reason (not limited to patent issues), conditions are imposed on

you (whether by court order, agreement or otherwise) that contradict the

conditions of this License, they do not excuse you from the conditions of this

License. If you cannot distribute so as to satisfy simultaneously your obligations

under this License and any other pertinent obligations, then as a consequence

you may not distribute the Program at all. For example, if a patent license would

not permit royalty-free redistribution of the Program by all those who receive

copies directly or indirectly through you, then the only way you could satisfy

both it and this License would be to refrain entirely from distribution of the

Program.

If any portion of this section is held invalid or unenforceable under any particular

circumstance, the balance of the section is intended to apply and the section as

a whole is intended to apply in other circumstances.

It is not the purpose of this section to induce you to infringe any patents or other

property right claims or to contest validity of any such claims; this section has

the sole purpose of protecting the integrity of the free software distribution

system, which is implemented by public license practices. Many people have

made generous contributions to the wide range of software distributed through

that system in reliance on consistent application of that system; it is up to the

author/donor to decide if he or she is willing to distribute software through any

other system and a licensee cannot impose that choice.

This section is intended to make thoroughly clear what is believed to be a

consequence of the rest of this License.

8. If the distribution and/or use of the Program is restricted in certain countries

either by patents or by copyrighted interfaces, the original copyright holder who

places the Program under this License may add an explicit geographical

distribution limitation excluding those countries, so that distribution is permitted

only in or among countries not thus excluded. In such case, this License

incorporates the limitation as if written in the body of this License.

9. The Free Software Foundation may publish revised and/or new versions of the

General Public License from time to time. Such new versions will be similar in

spirit to the present version, but may differ in detail to address new problems or

concerns.

Each version is given a distinguishing version number. If the Program specifies a

version number of this License which applies to it and "any later version", you

have the option of following the terms and conditions either of that version or of

any later version published by the Free Software Foundation. If the Program does

not specify a version number of this License, you may choose any version ever

published by the Free Software Foundation.

10. If you wish to incorporate parts of the Program into other free programs

whose distribution conditions are different, write to the author to ask for

permission. For software which is copyrighted by the Free Software Foundation,

write to the Free Software Foundation; we sometimes make exceptions for this.

Our decision will be guided by the two goals of preserving the free status of all

derivatives of our free software and of promoting the sharing and reuse of

software generally.

NO WARRANTY

11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS

NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY

APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE

COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM

"AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR

IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF

MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE

ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE

PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE,

YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR

CORRECTION.

12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED

TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY

WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS

PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY

GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES

ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM

(INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING

RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD

PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY

OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS

BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

END OF TERMS AND CONDITIONS

---------------------------------------------------------------------------

The Artistic License

Preamble

The intent of this document is to state the conditions under which a Package

may be copied, such that the Copyright Holder maintains some semblance of

artistic control over the development of the package, while giving the users of the

package the right to use and distribute the Package in a more-or-less customary

fashion, plus the right to make reasonable modifications.

Definitions:

-    "Package" refers to the collection of files distributed by the Copyright

     Holder, and derivatives of that collection of files created through textual

     modification. 

-    "Standard Version" refers to such a Package if it has not been modified,

     or has been modified in accordance with the wishes of the Copyright

     Holder. 

-    "Copyright Holder" is whoever is named in the copyright or copyrights for

     the package. 

-    "You" is you, if you're thinking about copying or distributing this Package.

-    "Reasonable copying fee" is whatever you can justify on the basis of

     media cost, duplication charges, time of people involved, and so on. (You

     will not be required to justify it to the Copyright Holder, but only to the

     computing community at large as a market that must bear the fee.) 

-    "Freely Available" means that no fee is charged for the item itself, though

     there may be fees involved in handling the item. It also means that

     recipients of the item may redistribute it under the same conditions they

     received it. 

1. You may make and give away verbatim copies of the source form of the

Standard Version of this Package without restriction, provided that you duplicate

all of the original copyright notices and associated disclaimers.

2. You may apply bug fixes, portability fixes and other modifications derived from

the Public Domain or from the Copyright Holder. A Package modified in such a

way shall still be considered the Standard Version.

3. You may otherwise modify your copy of this Package in any way, provided

that you insert a prominent notice in each changed file stating how and when

you changed that file, and provided that you do at least ONE of the following:

     a) place your modifications in the Public Domain or otherwise

     make them Freely Available, such as by posting said modifications

     to Usenet or an equivalent medium, or placing the modifications on

     a major archive site such as ftp.uu.net, or by allowing the

     Copyright Holder to include your modifications in the Standard

     Version of the Package.

     b) use the modified Package only within your corporation or

     organization.

     c) rename any non-standard executables so the names do not

     conflict with standard executables, which must also be provided,

     and provide a separate manual page for each non-standard

     executable that clearly documents how it differs from the Standard

     Version.

     d) make other distribution arrangements with the Copyright Holder.

4. You may distribute the programs of this Package in object code or executable

form, provided that you do at least ONE of the following:

     a) distribute a Standard Version of the executables and library

     files, together with instructions (in the manual page or equivalent)

     on where to get the Standard Version.

     b) accompany the distribution with the machine-readable source of

     the Package with your modifications.

     c) accompany any non-standard executables with their

     corresponding Standard Version executables, giving the

     non-standard executables non-standard names, and clearly

     documenting the differences in manual pages (or equivalent),

     together with instructions on where to get the Standard Version.

     d) make other distribution arrangements with the Copyright Holder.

5. You may charge a reasonable copying fee for any distribution of this Package.

You may charge any fee you choose for support of this Package. You may not

charge a fee for this Package itself. However, you may distribute this Package in

aggregate with other (possibly commercial) programs as part of a larger

(possibly commercial) software distribution provided that you do not advertise

this Package as a product of your own.

6. The scripts and library files supplied as input to or produced as output from

the programs of this Package do not automatically fall under the copyright of this

Package, but belong to whomever generated them, and may be sold

commercially, and may be aggregated with this Package.

7. C or perl subroutines supplied by you and linked into this Package shall not

be considered part of this Package.

8. Aggregation of this Package with a commercial distribution is always permitted

provided that the use of this Package is embedded; that is, when no overt attempt

is made to make this Package's interfaces visible to the end user of the

commercial distribution. Such use shall not be construed as a distribution of

this Package.

9. The name of the Copyright Holder may not be used to endorse or promote

products derived from this software without specific prior written permission.

10. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR

IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED

WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR

PURPOSE.

The End

Copyright (c) 2004 Casey West.  All rights reserved.

This module is free software; you can redistribute it and/or modify it

under the same terms as Perl itself.

Perl is distributed under your choice of the GNU General Public License or

the Artistic License.

The complete text of the GNU General Public License can be found in

/usr/share/common-licenses/GPL and the Artistic Licence can be found

in /usr/share/common-licenses/Artistic.

COPYRIGHT AND LICENSE

Copyright (C) 2004-2006 by Tassilo von Parseval

This library is free software; you can redistribute it and/or modify

it under the same terms as Perl itself, either Perl version 5.8.4 or,

at your option, any later version of Perl 5 you may have available.

This software is copyright (c) 2012 by Paul Evans <leonerd@leonerd.org.uk>.

This is free software; you can redistribute it and/or modify it under

the same terms as the Perl 5 programming language system itself.

Terms of the Perl programming language system itself

a) the GNU General Public License as published by the Free

   Software Foundation; either version 1, or (at your option) any

   later version, or

b) the "Artistic License"

--- The GNU General Public License, Version 1, February 1989 ---

This software is Copyright (c) 2012 by Paul Evans <leonerd@leonerd.org.uk>.

This is free software, licensed under:

  The GNU General Public License, Version 1, February 1989

                    GNU GENERAL PUBLIC LICENSE

                     Version 1, February 1989

 Copyright (C) 1989 Free Software Foundation, Inc.

 51 Franklin St, Suite 500, Boston, MA  02110-1335  USA

 Everyone is permitted to copy and distribute verbatim copies

 of this license document, but changing it is not allowed.

                            Preamble

  The license agreements of most software companies try to keep users

at the mercy of those companies.  By contrast, our General Public

License is intended to guarantee your freedom to share and change free

software--to make sure the software is free for all its users.  The

General Public License applies to the Free Software Foundation's

software and to any other program whose authors commit to using it.

You can use it for your programs, too.

  When we speak of free software, we are referring to freedom, not

price.  Specifically, the General Public License is designed to make

sure that you have the freedom to give away or sell copies of free

software, that you receive source code or can get it if you want it,

that you can change the software or use pieces of it in new free

programs; and that you know you can do these things.

  To protect your rights, we need to make restrictions that forbid

anyone to deny you these rights or to ask you to surrender the rights.

These restrictions translate to certain responsibilities for you if you

distribute copies of the software, or if you modify it.

  For example, if you distribute copies of a such a program, whether

gratis or for a fee, you must give the recipients all the rights that

you have.  You must make sure that they, too, receive or can get the

source code.  And you must tell them their rights.

  We protect your rights with two steps: (1) copyright the software, and

(2) offer you this license which gives you legal permission to copy,

distribute and/or modify the software.

  Also, for each author's protection and ours, we want to make certain

that everyone understands that there is no warranty for this free

software.  If the software is modified by someone else and passed on, we

want its recipients to know that what they have is not the original, so

that any problems introduced by others will not reflect on the original

authors' reputations.

  The precise terms and conditions for copying, distribution and

modification follow.

                    GNU GENERAL PUBLIC LICENSE

   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

  0. This License Agreement applies to any program or other work which

contains a notice placed by the copyright holder saying it may be

distributed under the terms of this General Public License.  The

"Program", below, refers to any such program or work, and a "work based

on the Program" means either the Program or any work containing the

Program or a portion of it, either verbatim or with modifications.  Each

licensee is addressed as "you".

  1. You may copy and distribute verbatim copies of the Program's source

code as you receive it, in any medium, provided that you conspicuously and

appropriately publish on each copy an appropriate copyright notice and

disclaimer of warranty; keep intact all the notices that refer to this

General Public License and to the absence of any warranty; and give any

other recipients of the Program a copy of this General Public License

along with the Program.  You may charge a fee for the physical act of

transferring a copy.

  2. You may modify your copy or copies of the Program or any portion of

it, and copy and distribute such modifications under the terms of Paragraph

1 above, provided that you also do the following:

    a) cause the modified files to carry prominent notices stating that

    you changed the files and the date of any change; and

    b) cause the whole of any work that you distribute or publish, that

    in whole or in part contains the Program or any part thereof, either

    with or without modifications, to be licensed at no charge to all

    third parties under the terms of this General Public License (except

    that you may choose to grant warranty protection to some or all

    third parties, at your option).

    c) If the modified program normally reads commands interactively when

    run, you must cause it, when started running for such interactive use

    in the simplest and most usual way, to print or display an

    announcement including an appropriate copyright notice and a notice

    that there is no warranty (or else, saying that you provide a

    warranty) and that users may redistribute the program under these

    conditions, and telling the user how to view a copy of this General

    Public License.

    d) You may charge a fee for the physical act of transferring a

    copy, and you may at your option offer warranty protection in

    exchange for a fee.

Mere aggregation of another independent work with the Program (or its

derivative) on a volume of a storage or distribution medium does not bring

the other work under the scope of these terms.

  3. You may copy and distribute the Program (or a portion or derivative of

it, under Paragraph 2) in object code or executable form under the terms of

Paragraphs 1 and 2 above provided that you also do one of the following:

    a) accompany it with the complete corresponding machine-readable

    source code, which must be distributed under the terms of

    Paragraphs 1 and 2 above; or,

    b) accompany it with a written offer, valid for at least three

    years, to give any third party free (except for a nominal charge

    for the cost of distribution) a complete machine-readable copy of the

    corresponding source code, to be distributed under the terms of

    Paragraphs 1 and 2 above; or,

    c) accompany it with the information you received as to where the

    corresponding source code may be obtained.  (This alternative is

    allowed only for noncommercial distribution and only if you

    received the program in object code or executable form alone.)

Source code for a work means the preferred form of the work for making

modifications to it.  For an executable file, complete source code means

all the source code for all modules it contains; but, as a special

exception, it need not include source code for modules which are standard

libraries that accompany the operating system on which the executable

file runs, or for standard header files or definitions files that

accompany that operating system.

  4. You may not copy, modify, sublicense, distribute or transfer the

Program except as expressly provided under this General Public License.

Any attempt otherwise to copy, modify, sublicense, distribute or transfer

the Program is void, and will automatically terminate your rights to use

the Program under this License.  However, parties who have received

copies, or rights to use copies, from you under this General Public

License will not have their licenses terminated so long as such parties

remain in full compliance.

  5. By copying, distributing or modifying the Program (or any work based

on the Program) you indicate your acceptance of this license to do so,

and all its terms and conditions.

  6. Each time you redistribute the Program (or any work based on the

Program), the recipient automatically receives a license from the original

licensor to copy, distribute or modify the Program subject to these

terms and conditions.  You may not impose any further restrictions on the

recipients' exercise of the rights granted herein.

  7. The Free Software Foundation may publish revised and/or new versions

of the General Public License from time to time.  Such new versions will

be similar in spirit to the present version, but may differ in detail to

address new problems or concerns.

Each version is given a distinguishing version number.  If the Program

specifies a version number of the license which applies to it and "any

later version", you have the option of following the terms and conditions

either of that version or of any later version published by the Free

Software Foundation.  If the Program does not specify a version number of

the license, you may choose any version ever published by the Free Software

Foundation.

  8. If you wish to incorporate parts of the Program into other free

programs whose distribution conditions are different, write to the author

to ask for permission.  For software which is copyrighted by the Free

Software Foundation, write to the Free Software Foundation; we sometimes

make exceptions for this.  Our decision will be guided by the two goals

of preserving the free status of all derivatives of our free software and

of promoting the sharing and reuse of software generally.

                            NO WARRANTY

  9. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY

FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN

OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES

PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED

OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF

MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS

TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE

PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,

REPAIR OR CORRECTION.

  10. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING

WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR

REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,

INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING

OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED

TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY

YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER

PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE

POSSIBILITY OF SUCH DAMAGES.

                     END OF TERMS AND CONDITIONS

        Appendix: How to Apply These Terms to Your New Programs

  If you develop a new program, and you want it to be of the greatest

possible use to humanity, the best way to achieve this is to make it

free software which everyone can redistribute and change under these

terms.

  To do so, attach the following notices to the program.  It is safest to

attach them to the start of each source file to most effectively convey

the exclusion of warranty; and each file should have at least the

"copyright" line and a pointer to where the full notice is found.

    <one line to give the program's name and a brief idea of what it does.>

    Copyright (C) 19yy  <name of author>

    This program 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 1, 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

    along with this program; if not, write to the Free Software

    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA  02110-1301 USA

Also add information on how to contact you by electronic and paper mail.

If the program is interactive, make it output a short notice like this

when it starts in an interactive mode:

    Gnomovision version 69, Copyright (C) 19xx name of author

    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.

    This is free software, and you are welcome to redistribute it

    under certain conditions; type `show c' for details.

The hypothetical commands `show w' and `show c' should show the

appropriate parts of the General Public License.  Of course, the

commands you use may be called something other than `show w' and `show

c'; they could even be mouse-clicks or menu items--whatever suits your

program.

You should also get your employer (if you work as a programmer) or your

school, if any, to sign a "copyright disclaimer" for the program, if

necessary.  Here a sample; alter the names:

  Yoyodyne, Inc., hereby disclaims all copyright interest in the

  program `Gnomovision' (a program to direct compilers to make passes

  at assemblers) written by James Hacker.

  <signature of Ty Coon>, 1 April 1989

  Ty Coon, President of Vice

That's all there is to it!

--- The Artistic License 1.0 ---

This software is Copyright (c) 2012 by Paul Evans <leonerd@leonerd.org.uk>.

This is free software, licensed under:

  The Artistic License 1.0

The Artistic License

Preamble

The intent of this document is to state the conditions under which a Package

may be copied, such that the Copyright Holder maintains some semblance of

artistic control over the development of the package, while giving the users of

the package the right to use and distribute the Package in a more-or-less

customary fashion, plus the right to make reasonable modifications.

Definitions:

  - "Package" refers to the collection of files distributed by the Copyright

    Holder, and derivatives of that collection of files created through

    textual modification.

  - "Standard Version" refers to such a Package if it has not been modified,

    or has been modified in accordance with the wishes of the Copyright

    Holder.

  - "Copyright Holder" is whoever is named in the copyright or copyrights for

    the package.

  - "You" is you, if you're thinking about copying or distributing this Package.

  - "Reasonable copying fee" is whatever you can justify on the basis of media

    cost, duplication charges, time of people involved, and so on. (You will

    not be required to justify it to the Copyright Holder, but only to the

    computing community at large as a market that must bear the fee.)

  - "Freely Available" means that no fee is charged for the item itself, though

    there may be fees involved in handling the item. It also means that

    recipients of the item may redistribute it under the same conditions they

    received it.

1. You may make and give away verbatim copies of the source form of the

Standard Version of this Package without restriction, provided that you

duplicate all of the original copyright notices and associated disclaimers.

2. You may apply bug fixes, portability fixes and other modifications derived

from the Public Domain or from the Copyright Holder. A Package modified in such

a way shall still be considered the Standard Version.

3. You may otherwise modify your copy of this Package in any way, provided that

you insert a prominent notice in each changed file stating how and when you

changed that file, and provided that you do at least ONE of the following:

  a) place your modifications in the Public Domain or otherwise make them

     Freely Available, such as by posting said modifications to Usenet or an

     equivalent medium, or placing the modifications on a major archive site

     such as ftp.uu.net, or by allowing the Copyright Holder to include your

     modifications in the Standard Version of the Package.

  b) use the modified Package only within your corporation or organization.

  c) rename any non-standard executables so the names do not conflict with

     standard executables, which must also be provided, and provide a separate

     manual page for each non-standard executable that clearly documents how it

     differs from the Standard Version.

  d) make other distribution arrangements with the Copyright Holder.

4. You may distribute the programs of this Package in object code or executable

form, provided that you do at least ONE of the following:

  a) distribute a Standard Version of the executables and library files,

     together with instructions (in the manual page or equivalent) on where to

     get the Standard Version.

  b) accompany the distribution with the machine-readable source of the Package

     with your modifications.

  c) accompany any non-standard executables with their corresponding Standard

     Version executables, giving the non-standard executables non-standard

     names, and clearly documenting the differences in manual pages (or

     equivalent), together with instructions on where to get the Standard

     Version.

  d) make other distribution arrangements with the Copyright Holder.

5. You may charge a reasonable copying fee for any distribution of this

Package.  You may charge any fee you choose for support of this Package. You

may not charge a fee for this Package itself. However, you may distribute this

Package in aggregate with other (possibly commercial) programs as part of a

larger (possibly commercial) software distribution provided that you do not

advertise this Package as a product of your own.

6. The scripts and library files supplied as input to or produced as output

from the programs of this Package do not automatically fall under the copyright

of this Package, but belong to whomever generated them, and may be sold

commercially, and may be aggregated with this Package.

7. C or perl subroutines supplied by you and linked into this Package shall not

be considered part of this Package.

8. The name of the Copyright Holder may not be used to endorse or promote

products derived from this software without specific prior written permission.

9. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED

WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF

MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

The End

pod2text CGI::Perljax.pm > README

CGI::Perljax

Perljax - a perl-specific system for writing AJAX- or

DHTML-based web applications.

Perljax provides a unique mechanism for using perl code

asynchronously from javascript using AJAX to access user-written

perl functions/methods. Perljax unburdens the user from having to

write any javascript, except for having to associate an exported

method with a document-defined event (such as onClick, onKeyUp,

etc). Only in the more advanced implementations of a exported perl

method would a user need to write custom javascript. Perljax supports

methods that return single results, or multiple results to the web

page. No other projects that we know of are like Perljax for the

following reasons: 1. Perljax is targeted specifically for perl

development. 2. Perljax shields the user from having to write any

javascript at all (unless they want to).  3. The URL for the HTTP GET

request is automatically generated based on HTML layout and events,

and the page is then dynamically updated.  4. Perljax is not part

of a Content Management System, or some other larger project.

INSTALL

perl Makefile.PL

make

make test

make install

*If you are on a windows box you should use 'nmake' rather than 'make'.

Installation will place Perljax into the system perl @INC path, but it

is important that you make sure mod_perl uses this path (which is

mod_perl's default behavior, and also assuming you use mod_perl, and

not just run perl as a CGI).

Example scripts are provided in the source script directory, and can

also be seen on the project's website, http://www.perljax.us.

File::Slurp.pm version 0.04

===========================

This module provides subroutines to read or write entire files with a

simple call.  It also has a subroutine for reading the list of filenames

in a directory.

In the extras/ directory you can read an article (slurp_article.pod)

about file slurping and also run a benchmark (slurp_bench.pl) that

compares many ways of slurping/spewing files.

This module was first written and owned by David Muir Sharnoff (MUIR on

CPAN).  I checked out his module and decided to write a new version

which would be faster, and with many more features.  To that end, David

graciously transfered the namespace to me.

Since then, I discovered and fixed a bug in the original module's test

script (which had only 7 tests), which is included now as t/original.t.

This module now has 164 tests in 7 test scripts, and passes on Windows,

Linux, Solaris and Mac OS X.

There have been some comments about the somewhat unusual version number.

The problem was that David used a future date (2004.0904) in his version

number, and the only way I could get CPAN to index my new module was to

make it have a version number higher than the old one, so I chose the

9999 prefix and appended the real revision number to it.

INSTALLATION

To install this module type the following:

   perl Makefile.PL

   make

   make test

   make install

COPYRIGHT AND LICENCE

Copyright (C) 2003 Uri Guttman <uri@stemsystems.com>

Licensed the same as Perl.

NAME

    `List::UtilsBy' - higher-order list utility functions

SYNOPSIS

     use List::UtilsBy qw( nsort_by min_by );

     use File::stat qw( stat );

     my @files_by_age = nsort_by { stat($_)->mtime } @files;

     my $shortest_name = min_by { length } @names;

DESCRIPTION

    This module provides a number of list utility functions, all of which

    take an initial code block to control their behaviour. They are

    variations on similar core perl or `List::Util' functions of similar

    names, but which use the block to control their behaviour. For example,

    the core Perl function `sort' takes a list of values and returns them,

    sorted into order by their string value. The `sort_by' function sorts

    them according to the string value returned by the extra function, when

    given each value.

     my @names_sorted = sort @names;

     my @people_sorted = sort_by { $_->name } @people;

FUNCTIONS

  @vals = sort_by { KEYFUNC } @vals

    Returns the list of values sorted according to the string values

    returned by the `KEYFUNC' block or function. A typical use of this may

    be to sort objects according to the string value of some accessor, such

    as

     sort_by { $_->name } @people

    The key function is called in scalar context, being passed each value in

    turn as both `$_' and the only argument in the parameters, `@_'. The

    values are then sorted according to string comparisons on the values

    returned.

    This is equivalent to

     sort { $a->name cmp $b->name } @people

    except that it guarantees the `name' accessor will be executed only once

    per value.

    One interesting use-case is to sort strings which may have numbers

    embedded in them "naturally", rather than lexically.

     sort_by { s/(\d+)/sprintf "%09d", $1/eg; $_ } @strings

    This sorts strings by generating sort keys which zero-pad the embedded

    numbers to some level (9 digits in this case), helping to ensure the

    lexical sort puts them in the correct order.

  @vals = nsort_by { KEYFUNC } @vals

    Similar to `sort_by' but compares its key values numerically.

  @vals = rev_sort_by { KEYFUNC } @vals

  @vals = rev_nsort_by { KEYFUNC } @vals

    Similar to `sort_by' and `nsort_by' but returns the list in the reverse

    order. Equivalent to

     @vals = reverse sort_by { KEYFUNC } @vals

    except that these functions are slightly more efficient because they

    avoid the final `reverse' operation.

  $optimal = max_by { KEYFUNC } @vals

  @optimal = max_by { KEYFUNC } @vals

    Returns the (first) value from `@vals' that gives the numerically

    largest result from the key function.

     my $tallest = max_by { $_->height } @people

     use File::stat qw( stat );

     my $newest = max_by { stat($_)->mtime } @files;

    In scalar context, the first maximal value is returned. In list context,

    a list of all the maximal values is returned. This may be used to obtain

    positions other than the first, if order is significant.

    If called on an empty list, an empty list is returned.

    For symmetry with the `nsort_by' function, this is also provided under

    the name `nmax_by' since it behaves numerically.

  $optimal = min_by { KEYFUNC } @vals

  @optimal = min_by { KEYFUNC } @vals

    Similar to `max_by' but returns values which give the numerically

    smallest result from the key function. Also provided as `nmin_by'

  @vals = uniq_by { KEYFUNC } @vals

    Returns a list of the subset of values for which the key function block

    returns unique values. The first value yielding a particular key is

    chosen, subsequent values are rejected.

     my @some_fruit = uniq_by { $_->colour } @fruit;

    To select instead the last value per key, reverse the input list. If the

    order of the results is significant, don't forget to reverse the result

    as well:

     my @some_fruit = reverse uniq_by { $_->colour } reverse @fruit;

  %parts = partition_by { KEYFUNC } @vals

    Returns a key/value list of ARRAY refs containing all the original

    values distributed according to the result of the key function block.

    Each value will be an ARRAY ref containing all the values which returned

    the string from the key function, in their original order.

     my %balls_by_colour = partition_by { $_->colour } @balls;

    Because the values returned by the key function are used as hash keys,

    they ought to either be strings, or at least well-behaved as strings

    (such as numbers, or object references which overload stringification in

    a suitable manner).

  %counts = count_by { KEYFUNC } @vals

    Returns a key/value list of integers, giving the number of times the key

    function block returned the key, for each value in the list.

     my %count_of_balls = count_by { $_->colour } @balls;

    Because the values returned by the key function are used as hash keys,

    they ought to either be strings, or at least well-behaved as strings

    (such as numbers, or object references which overload stringification in

    a suitable manner).

  @vals = zip_by { ITEMFUNC } \@arr0, \@arr1, \@arr2,...

    Returns a list of each of the values returned by the function block,

    when invoked with values from across each each of the given ARRAY

    references. Each value in the returned list will be the result of the

    function having been invoked with arguments at that position, from

    across each of the arrays given.

     my @transposition = zip_by { [ @_ ] } @matrix;

     my @names = zip_by { "$_[1], $_[0]" } \@firstnames, \@surnames;

     print zip_by { "$_[0] => $_[1]\n" } [ keys %hash ], [ values %hash ];

    If some of the arrays are shorter than others, the function will behave

    as if they had `undef' in the trailing positions. The following two

    lines are equivalent:

     zip_by { f(@_) } [ 1, 2, 3 ], [ "a", "b" ]

     f( 1, "a" ), f( 2, "b" ), f( 3, undef )

    The item function is called by `map', so if it returns a list, the

    entire list is included in the result. This can be useful for example,

    for generating a hash from two separate lists of keys and values

     my %nums = zip_by { @_ } [qw( one two three )], [ 1, 2, 3 ];

     # %nums = ( one => 1, two => 2, three => 3 )

    (A function having this behaviour is sometimes called `zipWith', e.g. in

    Haskell, but that name would not fit the naming scheme used by this

    module).

  $arr0, $arr1, $arr2, ... = unzip_by { ITEMFUNC } @vals

    Returns a list of ARRAY references containing the values returned by the

    function block, when invoked for each of the values given in the input

    list. Each of the returned ARRAY references will contain the values

    returned at that corresponding position by the function block. That is,

    the first returned ARRAY reference will contain all the values returned

    in the first position by the function block, the second will contain all

    the values from the second position, and so on.

     my ( $firstnames, $lastnames ) = unzip_by { m/^(.*?) (.*)$/ } @names;

    If the function returns lists of differing lengths, the result will be

    padded with `undef' in the missing elements.

    This function is an inverse of `zip_by', if given a corresponding

    inverse function.

  @vals = extract_by { SELECTFUNC } @arr

    Removes elements from the referenced array on which the selection

    function returns true, and returns a list containing those elements.

    This function is similar to `grep', except that it modifies the

    referenced array to remove the selected values from it, leaving only the

    unselected ones.

     my @red_balls = extract_by { $_->color eq "red" } @balls;

     # Now there are no red balls in the @balls array

    This function modifies a real array, unlike most of the other functions

    in this module. Because of this, it requires a real array, not just a

    list.

    This function is implemented by invoking `splice()' on the array, not by

    constructing a new list and assigning it. One result of this is that

    weak references will not be disturbed.

     extract_by { !defined $_ } @refs;

    will leave weak references weakened in the `@refs' array, whereas

     @refs = grep { defined $_ } @refs;

    will strengthen them all again.

  @vals = weighted_shuffle_by { WEIGHTFUNC } @vals

    Returns the list of values shuffled into a random order. The

    randomisation is not uniform, but weighted by the value returned by the

    `WEIGHTFUNC'. The probabilty of each item being returned first will be

    distributed with the distribution of the weights, and so on recursively

    for the remaining items.

  @vals = bundle_by { BLOCKFUNC } $number, @vals

    Similar to a regular `map' functional, returns a list of the values

    returned by `BLOCKFUNC'. Values from the input list are given to the

    block function in bundles of `$number'.

    If given a list of values whose length does not evenly divide by

    `$number', the final call will be passed fewer elements than the others.

TODO

    * XS implementations

        These functions are currently all written in pure perl. Some at

        least, may benefit from having XS implementations to speed up their

        logic.

    * Merge into List::Util or List::MoreUtils

        This module shouldn't really exist. The functions should instead be

        part of one of the existing modules that already contain many list

        utility functions. Having Yet Another List Utilty Module just

        worsens the problem.

        I have attempted to contact the authors of both of the above

        modules, to no avail; therefore I decided it best to write and

        release this code here anyway so that it is at least on CPAN. Once

        there, we can then see how best to merge it into an existing module.

AUTHOR

    Paul Evans <leonerd@leonerd.org.uk>

README for Sort::Naturally

                                        Time-stamp: "2001-05-25 21:17:33 MDT"

			    Sort::Naturally

[extracted from the Pod...]

NAME

     Sort::Naturally -- sort lexically, but sort numeral parts

     numerically

SYNOPSIS

       @them = nsort(qw(

        foo12a foo12z foo13a foo 14 9x foo12 fooa foolio Foolio Foo12a

       ));

       print join(' ', @them), "\n";

     Prints:

       9x 14 foo fooa foolio Foolio foo12 foo12a Foo12a foo12z foo13a

     (Or "foo12a" + "Foo12a" and "foolio" + "Foolio" and might be

     switched, depending on your locale.)

DESCRIPTION

     This module exports two functions, nsort and ncmp; they are

     used in implementing my idea of a "natural sorting"

     algorithm.  Under natural sorting, numeric substrings are

     compared numerically, and other word-characters are compared

     lexically.

     This is the way I define natural sorting:

     o    Non-numeric word-character substrings are sorted

          lexically, case-insensitively: "Foo" comes between

          "fish" and "fowl".

     o    Numeric substrings are sorted numerically:  "100" comes

          after "20", not before.

     o    \W substrings (neither words-characters nor digits) are

          ignored.

     o    Our use of \w, \d, \D, and \W is locale-sensitive:

          Sort::Naturally uses a use locale statement.

     o    When comparing two strings, where a numeric substring

          in one place is not up against a numeric substring in

          another, the non-numeric always comes first.  This is

          fudged by reading pretending that the lack of a number

          substring has the value -1, like so:

            foo       =>  "foo",  -1

            foobar    =>  "foo",  -1,  "bar"

            foo13     =>  "foo",  13,

            foo13xyz  =>  "foo",  13,  "xyz"

          That's so that "foo" will come before "foo13", which

          will come before "foobar".

     o    The start of a string is exceptional: leading non-\W

          (non-word, non-digit) components are are ignored, and

          numbers come before letters.

     o    I define "numeric substring" just as sequences matching

          m/\d+/ -- scientific notation, commas, decimals, etc.,

          are not seen.  If your data has thousands separators in

          numbers ("20,000 Leagues Under The Sea" or "20.000

          lieues sous les mers"), consider stripping them before

          feeding them to nsort or ncmp.

[end Pod extract]

INSTALLATION

You install Sort::Naturally, as you would install any perl module

library, by running these commands:

   perl Makefile.PL

   make

   make test

   make install

If you want to install a private copy of Sort::Naturally in your home

directory, then you should try to produce the initial Makefile with

something like this command:

  perl Makefile.PL LIB=~/perl

See perldoc perlmodinstall for more information on installing modules.

DOCUMENTATION

POD-format documentation is included in Naturally.pm.  POD is readable

with the 'perldoc' utility.  See ChangeLog for recent changes.

SUPPORT

Questions, bug reports, useful code bits, and suggestions for

Sort::Naturally should just be sent to me at sburke@cpan.org

AVAILABILITY

The latest version of Sort::Naturally is available from the

Comprehensive Perl Archive Network (CPAN).  Visit

<http://www.perl.com/CPAN/> to find a CPAN site near you.

COPYRIGHT

Copyright 2001, Sean M. Burke <sburke@cpan.org>, all rights

reserved.

The programs and documentation in this dist are distributed in

the hope that they will be useful, but without any warranty; without

even the implied warranty of merchantability or fitness for a

particular purpose.

This library is free software; you can redistribute it and/or modify

it under the same terms as Perl itself.