summaryrefslogtreecommitdiff
path: root/pages
diff options
context:
space:
mode:
authorAndrew Williams <andy@andywilliams.me>2018-01-05 07:42:24 -0800
committerapache <apache@e5-web1.enlightenment.org>2018-01-05 07:42:24 -0800
commita168929f6df6cddd2c971434b7e6ae727903f992 (patch)
tree082caeba2d6c2bde69a2aaf117cabb755bad8b3b /pages
parent744855112c9303f557b8ed93d464d8358b1e04de (diff)
Wiki page archlinux-start.md changed with summary [created] by Andrew Williams
Diffstat (limited to 'pages')
-rw-r--r--pages/develop/setup/c/ubuntu.md.txt194
-rw-r--r--pages/docs/distros/archlinux-start.md.txt221
-rw-r--r--pages/docs/distros/archlinux-start.txt84
3 files changed, 221 insertions, 278 deletions
diff --git a/pages/develop/setup/c/ubuntu.md.txt b/pages/develop/setup/c/ubuntu.md.txt
deleted file mode 100644
index e69ad28af..000000000
--- a/pages/develop/setup/c/ubuntu.md.txt
+++ /dev/null
@@ -1,194 +0,0 @@
1---
2~~Title: Installing EFL on Ubuntu ~~
3---
4
5# Installing EFL on Ubuntu #
6[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.
7
8This 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.
9
10Many 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.
11
12Distributions 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).
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 repos ##
21
22EFL is not available in Ubuntu's official repositories, but you can install all the items you need from a special PPA repository. [See below for instructions on how to do that](#Installing_from_a_Special_Repository).
23
24## Installing from a Special Repository ##
25
26To install the latest EFL available from a special Ubuntu PPA repository, add the new repository with:
27
28```bash
29sudo add-apt-repository ppa:niko2040/e19
30```
31Refresh your repositories:
32
33```bash
34sudo apt-get update
35```
36
37And then install EFL and its development libraries:
38
39```bash
40sudo apt-get install libefl-dev
41```
42
43Ubuntu does not install by default the *gcc* compiler, so, before you can [compile any apps](#Compiling_EFL_Applications), you will need to install that too:
44
45```bash
46sudo apt-get install gcc
47```
48
49Also note that, due to EFL's fast development rate, it is unlikely the PPA will provide by default the latest version of EFL. This means that many of the examples in this documentation will probably need tweaking to work. If you would like to install an up to date version of EFL, see the [Installing from Source](#Installing_from_Source) section below or the instructions for [Installing from Git](#Installing_from_Git), also available below.
50
51## Installing from Packaged Source ##
52
53There are two versions available form the Enlightenment website. One is a packaged and available from the [EFL's download site](https://download.enlightenment.org/rel/libs/efl/). The other is the nightly bleeding edge version which you can [download using git](#Installing_from_Git). This section deals with installing with the packaged version available from the [EFL's download site](https://download.enlightenment.org/rel/libs/efl/).
54
55### Step 1: Downloading Stable Version ###
56
57[Download the latest version of EFL](https://download.enlightenment.org/rel/libs/efl/) and check it against its SHA256 hash:
58
59```bash
60wget https://download.enlightenment.org/rel/libs/efl/efl-X.XX.X.tar.xz
61wget https://download.enlightenment.org/rel/libs/efl/efl-X.XX.X.tar.xz.sha256
62cat efl-X.XX.X.tar.xz.sha256; sha256sum efl-X.XX.X.tar.xz
63```
64
65Note that you will have to change ``X.XX.X`` for the actual version of EFL.
66
67### Step 2: Unpacking ###
68
69Once you have the archive file containing EFL in your hard disk, unpack it with:
70
71```bash
72tar xvf efl-X.XX.X.tar.xz
73```
74
75This will produce a folder called *efl-X.XX.X*.
76
77### Step 3: Installing Dependencies ###
78
79Before you can compile and install EFL, you will have to install some software packages EFL needs:
80
81```bash
82sudo apt install check libssl-dev libsystemd-dev libjpeg-dev libglib2.0-dev libgstreamer1.0-dev libluajit-5.1-dev libfreetype6-dev libfontconfig1-dev libfribidi-dev libx11-dev libxext-dev libxrender-dev libgl1-mesa-dev libgif-dev libtiff5-dev libpoppler-dev libpoppler-cpp-dev libspectre-dev libraw-dev librsvg2-dev libudev-dev libmount-dev libdbus-1-dev libpulse-dev libsndfile1-dev libxcursor-dev libxcomposite-dev libxinerama-dev libxrandr-dev libxtst-dev libxss-dev libbullet-dev libgstreamer-plugins-base1.0-dev doxygen
83```
84
85### Step 4: Building and Installing ###
86
87Once you have installed all the packages EFL needs, ``cd`` into the *efl-X.XX.X* folder and run
88
89```bash
90./configure
91make
92sudo make install
93```
94
95This will configure the files needed for compiling, actually compile the software, and then install it.
96
97### Step 5: Carrying out Post Installation Tasks ###
98
99As you are not installing to */usr* but to */usr/local*, you will have to ensure that some files are visible to *dbus*:
100
101```bash
102sudo ln -s /usr/local/share/dbus-1/services/org.enlightenment.Ethumb.service /usr/share/dbus-1/services/org.enlightenment.Ethumb.service
103```
104
105You may also need to refresh your library path to make sure your apps can find the EFL libraries:
106
107```bash
108sudo ldconfig
109```
110
111## Installing from Git ##
112
113You can also get the bleeding edge version of EFL by cloning it from the git repository.
114
115### Step 1: Installing git and Cloning ###
116
117By default, *git* is not installed in Ubuntu, so the first step is to install it:
118
119```bash
120sudo apt install git
121```
122
123Next clone EFL's source code:
124
125```bash
126git clone https://git.enlightenment.org/core/efl.git
127```
128
129This will create a a directory called *efl/*.
130
131### Step 2: Installing Dependencies ###
132
133You will need to install some tools to build the configuration file:
134
135```bash
136sudo apt install autoconf autopoint libtool
137```
138
139As well as the dependencies specific for EFL:
140
141```bash
142sudo apt install check libssl-dev libsystemd-dev libjpeg-dev libglib2.0-dev libgstreamer1.0-dev libluajit-5.1-dev libfreetype6-dev libfontconfig1-dev libfribidi-dev libx11-dev libxext-dev libxrender-dev libgl1-mesa-dev libgif-dev libtiff5-dev libpoppler-dev libpoppler-cpp-dev libspectre-dev libraw-dev librsvg2-dev libudev-dev libmount-dev libdbus-1-dev libpulse-dev libsndfile1-dev libxcursor-dev libxcomposite-dev libxinerama-dev libxrandr-dev libxtst-dev libxss-dev libbullet-dev libgstreamer-plugins-base1.0-dev doxygen
143```
144
145### Step 3: Configuring the Software ###
146
147Now you can ``cd`` into the *efl\* directory and run the *autoreconf* script to create and configure the software ready for compilation:
148
149```bash
150./autogen.sh
151```
152
153Once configured, you can compile the software with:
154
155```bash
156make
157sudo make install
158```
159
160### Step 4: Carrying out Post Installation Tasks ###
161
162As you are not installing to */usr* but to */usr/local*, you will have to ensure that some files are visible to *dbus*:
163
164```bash
165sudo ln -s /usr/local/share/dbus-1/services/org.enlightenment.Ethumb.service /usr/share/dbus-1/services/org.enlightenment.Ethumb.service
166```
167
168You may also need to refresh your library path to make sure your apps can find the EFL libraries:
169
170```bash
171sudo ldconfig
172```
173
174## Compiling EFL Applications ###
175
176With EFL installed, you can start compiling the applications you write using Enlightenment technologies:
177
178```bash
179gcc -o your_app your_app.c `pkg-config --cflags --libs eina efl elementary`
180```
181
182Where ``your_app`` is the name of the app you want to build and ``your_app.c`` contains the source code of your application.
183
184If 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.
185
186## Troubleshooting ##
187
188If 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 installing from [EFL's git repository](#Installing_from_Git).
189
190If you are having problems compiling and installing EFL, you can come and seek advice on the [any of our IRC channels](https://www.enlightenment.org/contact) or [post a ticket to our Phabricator](https://phab.enlightenment.org).
191
192## Installing on Other Operating Systems ##
193
194If 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/archlinux-start.md.txt b/pages/docs/distros/archlinux-start.md.txt
new file mode 100644
index 000000000..1d16edae3
--- /dev/null
+++ b/pages/docs/distros/archlinux-start.md.txt
@@ -0,0 +1,221 @@
1---
2~~Title: Installing EFL on Arch~~
3~~NOCACHE~~
4---
5
6# Installing EFL on Arch #
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 support more recent Enlightenment applications. If this is not an issue for you, read through the ["From Distribution Repositories"](#From_Distribution_Repositories) section below.
13
14Distributions 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).
15
16The 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).
17
18You 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 usually of stable quality. To get started, read the section ["Installing from Git"](#Installing_from_Git).
19
20Whichever installation method you use, visit ["Compiling EFL Applications"](#Compiling_EFL_Applications) to discover how to compile your Enlightenment applications.
21
22## From Distribution Repositories ##
23
24Arch contains an instance of the EFL package in its official repositories. To install, run the following command as root:
25
26```bash
27pacman -S efl
28```
29
30This will give you a working EFL installation.
31
32The version in Arch's official repositories may lag behind the latest version of EFL. This may cause problems when trying to compile examples from tutorials in this guide. If this happens, install a more recent version of EFL using one of the methods listed below.
33
34## Installing from a Special Repository ##
35
36You can use Arch's package management system to install an up-to-date version of EFL from the *Arch User Repository (AUR)* named *elf-git*. Using the *elf-git* AUR is relatively simple and makes your EFL package easey to maintain using Arch's package management system, *pacman*.
37
38### Step 1: Download Meta Package ###
39
40Download the files containing the required meta-information to install EFL from the AUR:
41
42```bash
43wget https://aur.archlinux.org/cgit/aur.git/snapshot/efl-git.tar.gz
44```
45
46### Step 2: Install Build Tools and Dependencies ###
47
48In order to build EFL from source, you'll need some tools:
49
50```bash
51pacman -S gcc fakeroot binutils autoconf automake pkg-config make
52```
53
54The *makepkg* script in the following step will handle most dependencies however you need to install *wayland-protocols* manually too:
55
56```bash
57pacman -S wayland-protocols
58```
59
60### Step 3: Make Package ###
61
62Unpack the file you downloaded in Step 1 with ``tar xvf efl-git.tar.gz``. Next, ``cd`` into the new *efl-git/* directory and build the package with:
63
64```bash
65makepkg -s
66```
67
68This process will download EFL from the Enlightenment git repositories, run the configuration and download and install the remaining dependencies. It will also compile and install the software (locally) then build a viable and installable package for your system. None of these steps need to be run as root.
69
70### Step 4: Install the package ###
71
72When *makepkg* is finished you'll find a file in your directory with a name like *efl-git-X.XX.XX.XXXXX.XXXXXXXXX-X-x86-64.pkg.tar.xz*. This is the actual package you can install. Switch to root and run:
73
74```bash
75pacman -U efl-git-X.XX.XX.XXXXX.XXXXXXXXX-X-x86-64.pkg.tar.xz
76```
77
78*pacman* will now install EFL for you.
79
80## Installing from Packaged Source ##
81
82There are two versions 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 site](https://download.enlightenment.org/rel/libs/efl/), which is the focus of this section.
83
84### Step 1: Downloading Stable Version ###
85
86[Download the latest version of EFL](https://download.enlightenment.org/rel/libs/efl/) and check it against its SHA256 hash:
87
88```bash
89wget https://download.enlightenment.org/rel/libs/efl/efl-X.XX.X.tar.xz
90wget https://download.enlightenment.org/rel/libs/efl/efl-X.XX.X.tar.xz.sha256
91cat efl-X.XX.X.tar.xz.sha256; sha256sum efl-X.XX.X.tar.xz
92```
93
94Note that you will have to change ``X.XX.X`` to the actual version of EFL.
95
96### Step 2: Unpacking ###
97
98Once you have the archive file containing EFL on your hard disk unpack it with:
99
100```bash
101tar xvf efl-X.XX.X.tar.xz
102```
103
104This will produce a folder named *efl-X.XX.X*.
105
106### Step 3: Installing Dependencies ###
107
108Before you can compile and install EFL you need to install the required software packages and tools:
109
110```bash
111pacman -S gcc make pkg-config luajit libjpeg gstreamer freetype2 fontconfig fribidi libx11 xorg-server-devel libxrender giflib libtiff poppler libspectre libraw librsvg libpulse libxcursor libxcomposite libxinerama libxrandr libxss bullet gst-plugins-base-libs
112```
113
114### Step 4: Building and Installing ###
115
116Once you have installed all the required packages, ``cd`` into the *efl-X.XX.X* folder and run
117
118```bash
119./configure
120make
121su -c "make install"
122```
123
124This will configure the files needed for compiling, compile the software, then install it.
125
126### Step 5: Carrying out Post Installation Tasks ###
127
128As you are not installing to */usr* but to */usr/local* you'll have to ensure that some files are visible to *dbus*:
129
130```bash
131sudo ln -s /usr/local/share/dbus-1/services/org.enlightenment.Ethumb.service /usr/share/dbus-1/services/org.enlightenment.Ethumb.service
132```
133
134You 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 nano /etc/profile``) and add the following line to the end:
135
136```bash
137export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig
138```
139
140You may also need to refresh your library path to make sure your apps can find the EFL libraries:
141
142```bash
143sudo ldconfig
144```
145
146## Installing from Git ##
147
148You can also download the bleeding edge version of EFL by cloning it from the git repository.
149
150### Step 1: Installing git and Cloning ###
151
152By default, *git* is not installed in Arch, so first install it:
153
154```bash
155pacman -S git
156```
157
158Next clone EFL's source code:
159
160```bash
161git clone https://git.enlightenment.org/core/efl.git
162```
163
164This will create a a directory named *efl/*.
165
166### Step 2: Installing Dependencies ###
167
168You'll need to install some tools to build the configuration file:
169
170```bash
171pacman -S gcc binutils autoconf automake pkg-config make
172```
173
174You also must install the dependencies specific to EFL:
175
176```bash
177pacman -S luajit libjpeg gstreamer freetype2 fontconfig fribidi libx11 xorg-server-devel libxrender giflib libtiff poppler libspectre libraw librsvg libpulse libxcursor libxcomposite libxinerama libxrandr libxss bullet gst-plugins-base-libs doxygen check
178```
179
180### Step 3: Configuring the Software ###
181
182You can now ``cd`` into the *efl\* directory and run the *autoreconf* script to create and configure the software, ready for compilation:
183
184```bash
185./autogen.sh
186```
187
188Once configured, compile the software with:
189
190```bash
191make
192su -c "make install"
193```
194
195### Step 4: Carrying out Post Installation Tasks ###
196
197As you are not installing to */usr* but to */usr/local* you'll have to ensure that some files are visible to *dbus*:
198
199```bash
200sudo ln -s /usr/local/share/dbus-1/services/org.enlightenment.Ethumb.service /usr/share/dbus-1/services/org.enlightenment.Ethumb.service
201```
202
203You 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 nano /etc/profile``) and add the following line to the end:
204
205```bash
206export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:/usr/local/lib/pkgconfig
207```
208
209You may also need to refresh your library path to make sure your apps can find the EFL libraries:
210
211```bash
212sudo ldconfig
213```
214
215## Troubleshooting ##
216
217If you are having problems compiling and installing EFL you can find help on [our IRC channels](https://www.enlightenment.org/contact) or [post a ticket to our Phabricator](https://phab.enlightenment.org).
218
219## Installing on Other Operating Systems ##
220
221If 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/archlinux-start.txt b/pages/docs/distros/archlinux-start.txt
deleted file mode 100644
index 823b61eb1..000000000
--- a/pages/docs/distros/archlinux-start.txt
+++ /dev/null
@@ -1,84 +0,0 @@
1~~Title: EFL on Arch Linux~~
2==== Arch ====
3
4The way to install Enlightenment on Arch Linux is quite easy, use the official repo:
5
6<code bash>
7pacman -S enlightenment
8pacman -S terminology # optional terminal
9</code>
10
11Install and enable offical Enlightenment login manager - Entrance
12
13<code bash>
14yaourt entrance-git
15systemctl enable entrance.service
16</code>
17
18Many apps or efl tools are available in AUR packages, for example with [[https://wiki.archlinux.org/index.php/Yaourt|Yaourt]]:
19
20<code bash>
21yaourt -S clouseau-git
22</code>
23
24If you only want Elementary with EFL:
25
26<code bash>
27pacman -S elementary
28</code>
29
30If you want to install Enlightenment and/or EFL from source, the easiest way is to first install the arch packages to have them pull in dependencies, then remove them:
31
32<code bash>
33pacman -S elementary
34pacman -R efl
35</code>
36
37Then go to [[/docs/distros/|install]] tutorial, to install Enlightenment and/or EFL from source.
38
39==== Programs ====
40
41If you want to install Enlightenment base programs:
42
43<code bash>
44pacman -S rage #Video Player
45yaourt ecrire-git #Text Editor
46yaourt enjoy-git #Music Player
47yaourt ephoto-git #Photo Viewer
48
49#Games
50yaourt efbb-git #Escape from Booty Bay (like Angry Birds)
51yaourt elemines-git #Elemines minesweeper style game
52
53</code>
54
55To install all without games:
56<code bash>
57pacman -S rage && yaourt ecrire-git && yaourt enjoy-git && yaourt ephoto-git
58</code>
59
60To install all with games:
61<code bash>
62pacman -S rage && yaourt ecrire-git && yaourt enjoy-git && yaourt ephoto-git && yaourt efbb && yaourt elemines-git
63</code>
64
65==== Enlightenment with Wayland ====
66
67<note important>Note: Highly Experimental !</note>
68
69Install Wayland and Enlightenment with Wayland support
70<code bash>
71pacman -S wayland
72yaourt enlightenment-wayland-git
73</code>
74
75
76After install that package, reboot system.
77Login to a TTY and type
78<code bash>
79enlightenment_start_wayland
80</code>
81(The best run without a graphical login manager.)
82
83
84Full documentation community Archlinux available at [[https://wiki.archlinux.org/index.php/Enlightenment]]