Copyright (C) 1999, 2000 The SourceForge Crew
Copyright (C) 2000-2006 Mathieu Roy
Copyright (C) 2014, 2016, 2017 Assaf Gordon
Copyright (C) 2001-2011, 2013, 2017 Sylvain Beucler
Copyright (C) 2013, 2014, 2017-2025 Ineiev

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.  This file is offered as-is,
without any warranty.

This file is part of Savane.

Copyright notices of Savane may use year ranges ("2002-2006") instead
of listing individual years ("2002, 2003, 2004, 2005, 2006").

Introduction
============

Savane is a free software hosting system.  As of 2023, it powers
Puszcza and GNU Savannah: each site runs its own version of Savane;
this tarball distributes the version of GNU Savannah.  For the exact
release number, see the NEWS file.

Licensing
=========

The original package was distributed under GPLv2 "or later."
On 2008-03-30, the option to re-license under a later version
was used.  In other words, the old code is distributed under the GPLv3
"or later" (commit 8b757b2565ff).  Then, section 13 of GPLv3
and section 13 of AGPLv3 allowed combining code released under these
licenses, so all further contributions come under the AGPL.
The combination is effectively under the AGPLv3 "or later," but
the precise conditions are explained in the licenses.

The license notices for the AGPL and the GPL follow.

Savane is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

Savane 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 Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

Savane 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 3 of the
License, or (at your option) any later version.

Savane 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, see <https://www.gnu.org/licenses/>.

Getting Savane
==============

The code of Savane is maintaned in the Savane Git repository of
the "administration" group of GNU Savannah,

https://savannah.nongnu.org/git/?group=administration

Generally, Savane instances are updated at each host of GNU Savannah when needed
to a recent commit from that repository, typically the head of either the i18n
or the frontend branch; master is a fast-forward-only branch that follows
the development; for more info, see
https://savannah.nongnu.org/maintenance/SavaneReleases/.

Tarballs of Savane are released periodically, mainly for the reference
of the Translation Project, in the download area of Savannah
administration:

https://savannah.nongnu.org/files/?group=administration

Contacting developers
=====================

See https://savannah.gnu.org/contact.php

Dependencies
============

Getting a release
-----------------

* A web browser or any program that can download files using HTTP, FTP,
  or RSYNC protocol
* GnuPG - checking the integrity

Bootstrapping from Git checkout
-------------------------------

* GNU Autotools and their dependencies
* Git - generating ChangeLog

Build Time
----------

* GNU Bash - assumed in Makefiles
* GNU Coreutils
* GNU Gettext 0.16.1 or later
* GNU Make
* Grep
* Sed
* Find
* ImageMagic - resizing images for icons

Run Time
--------

* GNU Coreutils
* Curl (Savannah-specific: triggering web page updates on changes in CVS)
* Grep
* GnuPG
* PHP 5.{4,5,6}, 7.{0,1,2,3,4}, 8.{0,1,2,3,4} - frontend
** Text_CAPTCHA (php-text-captcha, php-image-text in Trisquel)
** mysqli extension (php-mysqli in Trisquel)
** mailparse extension (php-mailparse in Trisquel) - comments on trackers
     via email
** imap extension (php-imap in Trisquel) - signed email notifications
* Perl >= 5.6
** DBI (libdbi-perl in Trisquel)
** DBD::mysql (libdbd-mysql-perl, depends on libdbi-perl in Trisquel)
** Mail::Send (libmailtools-perl in Trisquel)
** Geo::IP (libgeo-ip-perl, geoip-database in Trisquel) - mirror-redirect
** Locale::Codes (liblocale-codes-perl in Trisquel) - sv_gnu-mirmon
** WWW::Mechanize (libwww-mechanize-perl in Trisquel) - regression tests
** LWP::Simple (libwww-perl in Trisquel) - sv_gnu-mirmon
* MariaDB (MySQL may also work)
* Apache (apache2, libapache2-mod-php, apache2-utils in Trisquel) - frontend
* Pwqcheck (passwdqc in Trisquel) - handling new passwords in frontend
* Graphviz (graphviz in Trisquel) - frontend, optionally displaying inter-item
    dependency graphs.

Documentation
=============

For more info, see Savannah wiki,
https://savannah.gnu.org/maintenance/back-page/
