summaryrefslogtreecommitdiff
path: root/pages
diff options
context:
space:
mode:
authorAndrew Williams <andy@andywilliams.me>2018-01-05 07:51:26 -0800
committerapache <apache@e5-web1.enlightenment.org>2018-01-05 07:51:26 -0800
commit06686d0aa7a5e31310098c4b16f6d374cca04779 (patch)
treec3eaad6b8752a47a091288893e22536ddad94eaf /pages
parent98fa7aaaee5fb0775693c9251db3ebde133bc3cb (diff)
Wiki page freebsd-start.md changed with summary [created] by Andrew Williams
Diffstat (limited to 'pages')
-rw-r--r--pages/develop/setup/c/fedora.md.txt192
-rw-r--r--pages/docs/distros/freebsd-start.md.txt174
-rw-r--r--pages/docs/distros/freebsd-start.txt77
3 files changed, 174 insertions, 269 deletions
diff --git a/pages/develop/setup/c/fedora.md.txt b/pages/develop/setup/c/fedora.md.txt
deleted file mode 100644
index a909f2a16..000000000
--- a/pages/develop/setup/c/fedora.md.txt
+++ /dev/null
@@ -1,192 +0,0 @@
1---
2~~Title: Installing EFL on Fedora~~
3~~NOCACHE~~
4---
5
6# Installing EFL on Fedora #
7[The *Enlightenment Foundation Libraries (EFL)*](about-efl.md) power millions of systems from mobile phones to set-top boxes, desktops, laptops, game systems and more. You'll need EFL if you want to develop apps for Enlightenment and for any of the devices that use Enlightenment for its visual interface.
8
9This tutorial describes several ways to install EFL on your system. You will only need to use one of these. Select your chosen method using the index on the right.
10
11Many distributions offer EFL as an installable package from their default repositories. In this case you only need to use your distribution's software management system to install. However most versions of EFL in default repositories are out of date and will not compile more recent Enlightenment applications. If this is not an issue for you, read through the ["From Distribution Repositories"](#From_Distribution_Repositories) section below.
12
13Distributions often provide a special repository maintained by users or a method of integrating a bleeding edge version of EFL with your software management system. This means that once installed you can keep EFL current just by running system updates. If your distribution offers this, take a look at the section ["Installing from a Special Repository"](#Installing_from_a_Special_Repository).
14
15The Enlightenment developers provide a pre-packaged source of EFL. Although not bleeding edge it is up to date and considered stable for production environments. You can download, compile and install it yourself by following the instructions in ["Installing from Packaged Source"](#Installing_from_Packaged_Source).
16
17You can also download the source code for the most recent version from the EFL git repositories. This will provide you with the latest code, which is updated on a nightly basis. To get started, read the section ["Installing from Git"](#Installing_from_Git).
18
19Whichever installation method you use, visit ["Compiling EFL Applications"](#Compiling_EFL_Applications) to discover how to compile your Enlightenment applications.
20
21## From Distribution Repositories ##
22
23Fedora includes an *efl* packge in its default repositories. This makes installing EFL a simple task:
24
25```bash
26sudo dnf install efl
27```
28
29Fedora does not come with *gcc* or *cpp* preinstalled. You'll need to install these to compile EFL-based applications:
30
31```bash
32sudo dnf install gcc cpp
33```
34
35Note that the version of EFL in Fedoras's official repositories may not be the most recent release. This can cause problems when trying to compile examples from tutorials in this documentation. If this is the case, install a more recent version of EFL using one of the following methods:
36
37## Installing from a Special Repository ##
38
39Fedora does not maintain a repository with a nightly, up to date, version of EFL. There is a [user-maintained repository containing a nightly version of Enlightenment](http://download.opensuse.org/repositories/X11:/Enlightenment:/Nightly/Fedora_Rawhide/). Unfortunately installing packages with duplicate names from user-maintained repository is very complex. It's much easier to install and maintain EFL installing it from Enlightenments official packages and git repository, so this should be your first resort.
40
41## Installing from Packaged Source ##
42
43There are two versions of EFL available from the Enlightenment website. One is the nightly bleeding edge version which you can [download using git](#Installing_from_Git). The other is packaged and available from the [EFL's download site](https://download.enlightenment.org/rel/libs/efl/) which is the focus of this section.
44
45### Step 1: Downloading Stable Version ###
46
47[Download the latest version of EFL](https://download.enlightenment.org/rel/libs/efl/) and check it against its SHA256 hash:
48
49```bash
50wget https://download.enlightenment.org/rel/libs/efl/efl-X.XX.X.tar.xz
51wget https://download.enlightenment.org/rel/libs/efl/efl-X.XX.X.tar.xz.sha256
52cat efl-X.XX.X.tar.xz.sha256; sha256sum efl-X.XX.X.tar.xz
53```
54
55Note that you will have to change ``X.XX.X`` to the current version of EFL.
56
57### Step 2: Unpacking ###
58
59Once you have downloaded the archive file containing EFL unpack it with:
60
61```bash
62tar xvf efl-X.XX.X.tar.xz
63```
64
65This will create a folder named *efl-X.XX.X*.
66
67### Step 3: Installing Dependencies ###
68
69Before you can compile and install EFL, you will have to install some software packages EFL requires:
70
71```bash
72sudo dnf install gcc gcc-c++ doxygen openssl-devel systemd-devel libjpeg-turbo-devel glib2-devel gstreamer1-devel luajit-devel freetype-devel fontconfig-devel fribidi-devel xorg-x11-server-devel libXrender-devel giflib-devel libtiff-devel poppler-devel poppler-cpp-devel libspectre-devel LibRaw-devel librsvg2-devel libmount-devel dbus-devel pulseaudio-libs-devel libsndfile-devel libXcursor-devel libXcomposite-devel libXinerama-devel libXrandr-devel libXtst-devel libXScrnSaver-devel bullet-devel gstreamer1-plugins-base-devel
73
74```
75
76### Step 4: Building and Installing ###
77
78Once you have installed all dependencies ``cd`` into the *efl-X.XX.X* folder and run:
79
80```bash
81./configure
82make
83sudo make install
84```
85
86This will configure the files needed for compiling and installation.
87
88### Step 5: Carrying out Post Installation Tasks ###
89
90As you are not installing to */usr* but to */usr/local*, you will have to ensure that some files are visible to *dbus*:
91
92```bash
93sudo ln -s /usr/local/share/dbus-1/services/org.enlightenment.Ethumb.service /usr/share/dbus-1/services/org.enlightenment.Ethumb.service
94```
95
96You also have to make some files visible to *pkgconfig*. To do this open */etc/profile* in a text editor as root (using ``sudo vi /etc/profile`` for instance) and add the following line to the end:
97
98```bash
99export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig
100```
101
102You may also need to refresh your library path to make sure your apps can find the EFL libraries:
103
104```bash
105sudo ldconfig
106```
107
108## Installing from Git ##
109
110Download the bleeding edge version of EFL by cloning it from the git repository.
111
112### Step 1: Installing git and Cloning ###
113
114By default, *git* is installed in Fedora, so the first step is to clone EFL's source code:
115
116```bash
117git clone https://git.enlightenment.org/core/efl.git
118```
119
120This will create a a directory named *efl/*.
121
122### Step 2: Installing Dependencies ###
123
124You now need to install some tools to build the configuration file:
125
126```bash
127sudo dnf install autoconf libtool gettext-devel
128```
129
130Install the dependencies specific for EFL too:
131
132```bash
133sudo dnf install gcc gcc-c++ doxygen openssl-devel systemd-devel libjpeg-turbo-devel glib2-devel gstreamer1-devel luajit-devel freetype-devel fontconfig-devel fribidi-devel xorg-x11-server-devel libXrender-devel giflib-devel libtiff-devel poppler-devel poppler-cpp-devel libspectre-devel LibRaw-devel librsvg2-devel libmount-devel dbus-devel pulseaudio-libs-devel libsndfile-devel libXcursor-devel libXcomposite-devel libXinerama-devel libXrandr-devel libXtst-devel libXScrnSaver-devel bullet-devel gstreamer1-plugins-base-devel
134```
135
136### Step 3: Configuring the Software ###
137
138Now you can ``cd`` into the *efl\* directory and run the *autoreconf* script to create and configure the software ready for compilation:
139
140```bash
141./autogen.sh
142```
143
144Once configured, you can compile the software with:
145
146```bash
147make
148sudo make install
149```
150
151### Step 4: Carrying out Post Installation Tasks ###
152
153As you are not installing to */usr* but to */usr/local*, you will have to ensure that some files are visible to *dbus*:
154
155```bash
156sudo ln -s /usr/local/share/dbus-1/services/org.enlightenment.Ethumb.service /usr/share/dbus-1/services/org.enlightenment.Ethumb.service
157
158```
159
160You also have to make some files visible to *pkgconfig*. To do this, open */etc/profile* in a text editor as root (using for example ``sudo vi /etc/profile``) and add the following line to the end:
161
162```bash
163export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig
164```
165
166You may also need to refresh your library path to make sure your apps can find the EFL libraries:
167
168```bash
169sudo ldconfig
170```
171
172## Compiling EFL Applications ###
173
174With EFL installed you can start compiling the applications you've written using Enlightenment technologies:
175
176```bash
177gcc -o your_app your_app.c `pkg-config --cflags --libs eina efl elementary`
178```
179
180Change ``your_app`` to the name of the app you want to build and ``your_app.c`` to the source code file for your application.
181
182If the compilation is successful, this will create an executable application called *your_app* in the directory. You can run this app like any other program.
183
184## Troubleshooting ##
185
186If you get errors when you compile the examples in this guide you may be using an out of date version of EFL. Update your libraries by installing from [EFL's git repository](#Installing_from_Git).
187
188If you are having problems compiling and installing EFL, you can come and seek advice on any of [our IRC channels](https://www.enlightenment.org/contact) or [post a ticket to our Phabricator](https://phab.enlightenment.org).
189
190## Installing on Other Operating Systems ##
191
192If you would like to install EFL on a different operating system visit the [Setting up a C Development Environment page](start.md). \ No newline at end of file
diff --git a/pages/docs/distros/freebsd-start.md.txt b/pages/docs/distros/freebsd-start.md.txt
new file mode 100644
index 000000000..616d78ff3
--- /dev/null
+++ b/pages/docs/distros/freebsd-start.md.txt
@@ -0,0 +1,174 @@
1---
2~~Title: Installing EFL on FreeBSD~~
3~~NOCACHE~~
4---
5
6# Installing EFL on FreeBSD #
7
8[The *Enlightenment Foundation Libraries (EFL)*](/about-efl.md) power millions of systems from mobile phones to set-top boxes, desktops, laptops, game systems and more. You'll need EFL if you want to develop apps for Enlightenment and for any of the devices that use Enlightenment for its visual interface.
9
10This tutorial describes several ways to install EFL on your system. You will only need to use one of these. Select your chosen method using the index on the right.
11
12Many distributions offer EFL as an installable package from their default repositories. In this case you only need to use your distribution's software management system to install. However most versions of EFL in default repositories are out of date and will not compile more recent Enlightenment applications. If this is not an issue for you read through the ["From Distribution Repositories"](#From_Distribution_Repositories) section below.
13
14The Enlightenment developers provide a pre-packaged source of EFL. Although not bleeding edge it is up to date and considered stable for production environments. You can download, compile and install it yourself by following the instructions in ["Installing from Packaged Source"](#Installing_from_Packaged_Source).
15
16You can also download the source code for the most recent version from the EFL git repositories. This will provide you with the latest code, which is updated on a nightly basis. To get started, read the section ["Installing from Git"](#Installing_from_Git).
17
18Whichever installation method you use, visit ["Compiling EFL Applications"](#Compiling_EFL_Applications) to discover how to compile your Enlightenment applications.
19
20## From Distribution Repositories ##
21
22FreeBSD contains an instance of the EFL package in its official repositories. To install it run the following command as root:
23
24```bash
25pkg install efl
26```
27
28This will give you a working EFL installation.
29
30The version in FreeBSD's official repositories may lag behind the latest version of EFL and give you problems when trying to compile examples from tutorials in this documentation. If this is the case, install a more recent version of EFL using one of the methods below.
31
32## Installing from Packaged Source ##
33
34There are two versions of EFL available from the Enlightenment website. One is the nightly bleeding edge version which you can [download using git](#Installing_from_Git). The other is packaged and available from the [EFL download page](https://download.enlightenment.org/rel/libs/efl/), which is the focus of this section.
35
36### Step 1: Downloading Stable Version ###
37
38[Download the latest version of EFL](https://download.enlightenment.org/rel/libs/efl/) and check it against its SHA256 hash:
39
40```bash
41wget --no-check-certificate https://download.enlightenment.org/rel/libs/efl/efl-X.XX.X.tar.xz
42wget --no-check-certificate https://download.enlightenment.org/rel/libs/efl/efl-X.XX.X.tar.xz.sha256
43cat efl-X.XX.X.tar.xz.sha256; sha256sum efl-X.XX.X.tar.xz
44```
45
46Note that you'll need to change ``X.XX.X`` to the actual version of EFL e.g. efl-1.20.6.tar.xz
47
48### Step 2: Unpacking ###
49
50Once you've downloaded the archive file containing EFL to your hard drive unpack it with:
51
52```bash
53tar xvf efl-X.XX.X.tar.xz
54```
55
56This will produce a folder named *efl-X.XX.X*.
57
58### Step 3: Installing Dependencies ###
59
60To compile from source you'll need *gcc* and few more GNU tools:
61
62```bash
63su
64pkg install gcc automake gmake pkgconf
65```
66
67Next install the software packages required by EFL:
68
69```bash
70su
71pkg install check pkgconfig doxygen openssl jpeg gstreamer1 luajit fribidi tiff poppler libspectre libraw librsvg2 pulseaudio libXcursor libXcomposite libXinerama libXrandr libXScrnSaver bullet gstreamer1-plugins
72```
73
74### Step 4: Building and Installing ###
75
76Once you have installed all the required packages ``cd`` into the *efl-X.XX.X* folder and run
77
78```bash
79./configure
80gmake
81su
82gmake install
83```
84
85This will configure the files needed for compiling, compile the software itself and then install it.
86
87### Step 5: Carrying out Post Installation Tasks ###
88
89As you are not installing to */usr* but to */usr/local* you need to ensure that some files are visible to *dbus*:
90
91```bash
92su
93ln -s /usr/local/share/dbus-1/services/org.enlightenment.Ethumb.service /usr/share/dbus-1/services/org.enlightenment.Ethumb.service
94```
95
96You may also need to refresh your library path to make sure your apps can find the EFL libraries:
97
98```bash
99ldconfig
100```
101
102## Installing from Git ##
103
104You can also install the bleeding edge version of EFL by cloning it from the git repository.
105
106### Step 1: Installing git and Cloning ###
107
108By default, *git* is not installed in FreeBSD, so the first step is to install it:
109
110```bash
111pkg install git
112```
113
114Next clone EFL's source code:
115
116```bash
117git clone https://git.enlightenment.org/core/efl.git
118```
119
120This will create a a directory named *efl/*.
121
122### Step 2: Installing Dependencies ###
123
124You now need to install some tools to build the configuration file:
125
126```bash
127pkg install gcc automake gmake pkgconf
128```
129
130Make sure to install the dependencies specific to EFL also:
131
132```bash
133pkg install check doxygen openssl jpeg gstreamer1 luajit fribidi tiff poppler libspectre libraw librsvg2 pulseaudio libXcursor libXcomposite libXinerama libXrandr libXScrnSaver bullet gstreamer1-plugins
134```
135
136### Step 3: Configuring the Software ###
137
138You can now ``cd`` into the *efl\* directory and run the *autoreconf* script to create and configure the software ready for compilation:
139
140```bash
141./autogen.sh
142```
143
144Once configured, compile the software with:
145
146```bash
147gmake
148su
149gmake install
150```
151
152### Step 4: Carrying out Post Installation Tasks ###
153
154As you are not installing to */usr* but to */usr/local*, you need to ensure that some files are visible to *dbus*:
155
156```bash
157su
158ln -s /usr/local/share/dbus-1/services/org.enlightenment.Ethumb.service /usr/share/dbus-1/services/org.enlightenment.Ethumb.service
159```
160
161You may also need to refresh your library path to make sure your apps can find the EFL libraries:
162
163```bash
164su
165ldconfig
166```
167
168## Troubleshooting ##
169
170If you are having problems compiling and installing EFL you can find help on any of [our IRC channels](https://www.enlightenment.org/contact) or [post a ticket to our Phabricator](https://phab.enlightenment.org).
171
172## Installing on Other Operating Systems ##
173
174If you would like to install EFL on a different operating system visit the [Setting up a C Development Environment page](start.md). \ No newline at end of file
diff --git a/pages/docs/distros/freebsd-start.txt b/pages/docs/distros/freebsd-start.txt
deleted file mode 100644
index efc99d078..000000000
--- a/pages/docs/distros/freebsd-start.txt
+++ /dev/null
@@ -1,77 +0,0 @@
1 ~~Title: EFL on FreeBSD~~
2==== FreeBSD and E/EFL ====
3
4Enlightenment and EFL are available for multiple versions of FreeBSD:
5
6 * FreeBSD 8 - NOW EOL
7 * FreeBSD 9
8 * FreeBSD 10
9 * CURRENT
10
11<note tip>
12Enlightenment on FreeBSD only has the latest release version currently this is:
13</note>
14^ Name ^ Version ^ Submited Update ^
15| Enlightenment | 0.19.13 | Latest |
16| EFL | 1.16.0 | Latest |
17| Elementary | 1.16.0 | Latest |
18| Terminology | 0.9.1 | Latest |
19
20==== Installation ====
21The way to install Enlightenment is the same between those distributions,
22here is an example:
23Option: 1
24<code bash>
25# pkg install enlightenment
26</code>
27
28Install Enlightenment and Terminology:
29<code bash>
30# pkg install enlightenment
31# pkg install terminology
32</code>
33
34Install EFL only:
35
36<code bash>
37# pkg install efl
38</code>
39
40Option: 2
41
42You may also compile E/EFL from source using the ports system.
43<code bash>
44# svn co http://svn.freebsd.org/ports/head /usr/ports
45</code>
46or
47<code bash>
48# portsnap fetch extract
49</code>
50
51Installing E on FreeBSD using the ports system.
52<code bash>
53# cd /usr/ports/x11-wm/enlightenment && make install clean
54</code>
55or
56<code bash>
57# make -C /usr/ports/x11-wm/enlightenment install clean
58</code>
59
60==== TODO ====
61
62Enlightenment on FreeBSD is always looking at ways to improve, mainly to allow users to have both the latest version along with the latest git sources. We plan on having both a normal release as well as a -devel port for both EFL and Enlightenment.
63
64==== Helping ====
65If you would like to help out, please register the Enlightenment mailing list
66[[https://lists.freebsd.org/mailman/listinfo/freebsd-enlightenment|Enlightenment Mailing List]]
67
68Or you mail email me personally
69[[chris@bsdjunk.com|Email Me]]
70
71==== Support ====
72We also have an IRC channel on Efnet and FreeNode
73=== FreeNode ===
74#freebsd-enlightenment
75
76=== EFnet ===
77#freebsd-enlightenment \ No newline at end of file