README (English)

Path: /dolibarr/build/README

##################################################
Building packages
##################################################

All sub-directories of "build" directory contains files (setup or binary tools) required to build automatically Dolibarr packages.
The build directory and all its contents is absolutely not required to make Dolibarr working. 
It is here only to build Dolibarr packages, and those generated packages will not contains this "build" directory.


There are several tools:


- To build full Dolibarr packages, launch the script
> Launch command perl makepack-dolibarr.pl

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


Prerequisites to build tgz, debian and rpm packages:
> apt-get install tar dpkg dpatch p7zip-full rpm zip


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

Prerequisites to build autoexe DoliWamp package:
> apt-get install wine q4wine
> Launch "wine cmd" to check a drive Z: pointing to / exists.
> Install InnoSetup
   For example by running isetup-5.5.8.exe (https://www.jrsoftware.org)  https://files.jrsoftware.org/is/5/
> Install WampServer into "C:\wamp64" to have Apache, PHP and MariaDB
   For example by running wampserver3.2.0_x64.exe (https://www.wampserver.com). 
   See file build/exe/doliwamp.iss to know the doliwamp version currently setup.
> Add path to ISCC into PATH windows var:
  Launch wine cmd, then regedit and add entry int HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Session Manager\Environment\PATH
> To build manually the .exe from Windows (running from makepack-dolibarr.pl script is however recommanded), 
  open file build/exe/doliwamp.iss and click on button "Compile".
  The .exe file will be build into directory build.

--------------------------------------------------------------------------------------------------
  
- To build a theme package, launch the script
> perl makepack-dolibarrtheme.pl


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

- To build a package for a module, launch the script
> perl makepack-dolibarrmodule.pl


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

- To build developper documentation, launch the script
> perl dolibarr-doxygen-build.pl


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


You can find in "build", following sub-directories:

* composer
To test an upgrade of a lib.

* debian
To build Debian package.

* dmg:
To build Mac OS package (not ready yet).

* doap:
To build Doap descriptor to promote/describe Dolibarr releases.

* docker:
To deploy Dolibarr with docker.

* doxygen:
Dir with config file to build doxygen documentation.

* exe:
To build exe package for Windows that distribute Dolibarr sources or
to build the complete DoliWamp package.

* gource:
To build the video of history of git changes.

* launchpad:
Doc file to explain how to use launchpad.

* obs:
Doc file to explain how to push release onto OBS.

* pad:
To build a PAD file descriptor to promote/describe Dolibarr releases.

* patch:
Script file to generate a patch file to distribute a Dolibarr mod.

* perl:
Tool to install dolibarr when using virtualmin pro

* rpm:
To build Redhat, Opensuse or Mandriva package.

* tgz:
To build a tgz package.

* travis-ci:
Used by travis to make CI.

* zip:
To build a zip package.