summaryrefslogtreecommitdiff
path: root/pages
diff options
context:
space:
mode:
authorAndrew Williams <andy@andywilliams.me>2018-01-05 07:54:38 -0800
committerapache <apache@e5-web1.enlightenment.org>2018-01-05 07:54:38 -0800
commit1875029eb0a9502329245d8bba03355a8046e083 (patch)
tree8e94ac7948a3edd3b3d341690cc9809c67e66666 /pages
parente82262fccf801561b0c2b30d2abd867d825d3596 (diff)
Wiki page opensuse-start.md changed with summary [created] by Andrew Williams
Diffstat (limited to 'pages')
-rw-r--r--pages/develop/setup/c/freebsd.md.txt188
-rw-r--r--pages/docs/distros/opensuse-start.md.txt182
-rw-r--r--pages/docs/distros/opensuse-start.txt41
3 files changed, 182 insertions, 229 deletions
diff --git a/pages/develop/setup/c/freebsd.md.txt b/pages/develop/setup/c/freebsd.md.txt
deleted file mode 100644
index d6de63a88..000000000
--- a/pages/develop/setup/c/freebsd.md.txt
+++ /dev/null
@@ -1,188 +0,0 @@
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## Compiling EFL Applications ###
169
170With EFL installed, you can start compiling the applications you write using Enlightenment technologies:
171
172```bash
173gcc -o your_app your_app.c `pkg-config --cflags --libs eina efl elementary`
174```
175
176Change ``your_app`` to the name of the app you want to build and ``your_app.c`` to the file containing the source code for your application.
177
178If the compilation is successful this will create an executable application named *your_app* in the directory. You can run this app in the same way as any other program.
179
180## Troubleshooting ##
181
182If 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).
183
184If 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).
185
186## Installing on Other Operating Systems ##
187
188If 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/opensuse-start.md.txt b/pages/docs/distros/opensuse-start.md.txt
new file mode 100644
index 000000000..2c0815192
--- /dev/null
+++ b/pages/docs/distros/opensuse-start.md.txt
@@ -0,0 +1,182 @@
1---
2~~Title: Installing EFL on openSUSE ~~
3---
4
5# Installing EFL on openSUSE #
6
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
23openSUSE happens to have quite a good support for EFL and you can install all the items you need from openSUSE's official repository:
24
25```bash
26sudo zypper efl
27```
28
29This will give you a working EFL installation.
30
31However, the version in openSUSE'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, it is advised you install a more recent version of EFL following one of the methods below.
32
33## Installing from a Special Repository ##
34
35You can also install the latest EFL using a special repository. Add it to your regular repositories with:
36
37```bash
38sudo zypper ar https://download.opensuse.org/repositories/X11:/Enlightenment:/Nightly/openSUSE_Tumbleweed/x86_64/ Enlightenment_Nightly
39```
40Refresh your repositories:
41
42```bash
43sudo zypper ref
44```
45
46And then install EFL and its development libraries:
47
48```bash
49sudo zypper in efl efl-devel
50```
51Note that the version in the Nightly repositories may lag behind the official Nightly by about 24 hours. This shouldn't be a big deal in most circumstances.
52
53## Installing from Packaged Source ##
54
55There 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/).
56
57### Step 1: Downloading Stable Version ###
58
59[Download the latest version of EFL](https://download.enlightenment.org/rel/libs/efl/) and check it against its SHA256 hash:
60
61```bash
62wget https://download.enlightenment.org/rel/libs/efl/efl-X.XX.X.tar.xz
63wget https://download.enlightenment.org/rel/libs/efl/efl-X.XX.X.tar.xz.sha256
64cat efl-X.XX.X.tar.xz.sha256; sha256sum efl-X.XX.X.tar.xz
65```
66
67Note that you will have to change ``X.XX.X`` for the actual version of EFL.
68
69### Step 2: Unpacking ###
70
71Once you have the archive file containing EFL in your hard disk, unpack it with:
72
73```bash
74tar xvf efl-X.XX.X.tar.xz
75```
76
77This will produce a folder called *efl-X.XX.X*.
78
79### Step 3: Installing Dependencies ###
80
81Before you can compile and install EFL, you will have to install some software packages EFL needs:
82
83```bash
84sudo zypper in gcc gcc-c++ doxygen libopenssl-devel systemd-devel libjpeg62-devel glib2-devel gstreamer-devel lua51-luajit-devel freetype2-devel fontconfig-devel fribidi-devel xorg-x11-devel giflib-devel libpng16-compat-devel libtiff-devel libpoppler-devel libspectre-devel libraw-devel librsvg-devel libudev-devel libmount-devel dbus-1-devel libpulse-devel libsndfile-devel libbullet-devel gstreamer-plugins-base-devel check-devel
85```
86
87### Step 4: Building and Installing ###
88
89Once you have installed all the packages EFL needs, ``cd`` into the *efl-X.XX.X* folder and run
90
91```bash
92./configure
93make
94sudo make install
95```
96
97This will configure the files needed for compiling, actually compile the software, and then install it.
98
99### Step 5: Carrying out Post Installation Tasks ###
100
101As you are not installing to */usr* but to */usr/local*, you will have to ensure that some files are visible to *dbus*:
102
103```bash
104sudo ln -s /usr/local/share/dbus-1/services/org.enlightenment.Ethumb.service /usr/share/dbus-1/services/org.enlightenment.Ethumb.service
105```
106
107You may also need to refresh your library path to make sure your apps can find the EFL libraries:
108
109```bash
110sudo ldconfig
111```
112
113## Installing from Git ##
114
115You can also get the bleeding edge version of EFL by cloning it from the git repository.
116
117### Step 1: Installing git and Cloning ###
118
119By default, *git* is not installed in openSUSE, so the first step is to install it:
120
121```bash
122sudo zypper install git
123```
124
125Next clone EFL's source code:
126
127```bash
128git clone https://git.enlightenment.org/core/efl.git
129```
130
131This will create a a directory called *efl/*.
132
133### Step 2: Installing Dependencies ###
134
135You will need to install some tools to build the configuration file:
136
137```bash
138sudo zypper in autoconf libtool gettext-tools
139```
140
141As well as the dependencies specific for EFL:
142
143```bash
144sudo zypper in gcc gcc-c++ doxygen libopenssl-devel systemd-devel libjpeg62-devel glib2-devel gstreamer-devel lua51-luajit-devel freetype2-devel fontconfig-devel fribidi-devel xorg-x11-devel giflib-devel libpng16-compat-devel libtiff-devel libpoppler-devel libspectre-devel libraw-devel librsvg-devel libudev-devel libmount-devel dbus-1-devel libpulse-devel libsndfile-devel libbullet-devel gstreamer-plugins-base-devel check-devel
145```
146
147### Step 3: Configuring the Software ###
148
149Now you can ``cd`` into the *efl\* directory and run the *autoreconf* script to create and configure the software ready for compilation:
150
151```bash
152./autogen.sh
153```
154
155Once configured, you can compile the software with:
156
157```bash
158make
159sudo make install
160```
161
162### Step 4: Carrying out Post Installation Tasks ###
163
164As you are not installing to */usr* but to */usr/local*, you will have to ensure that some files are visible to *dbus*:
165
166```bash
167sudo ln -s /usr/local/share/dbus-1/services/org.enlightenment.Ethumb.service /usr/share/dbus-1/services/org.enlightenment.Ethumb.service
168```
169
170You may also need to refresh your library path to make sure your apps can find the EFL libraries:
171
172```bash
173sudo ldconfig
174```
175
176## Troubleshooting ##
177
178If 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).
179
180## Installing on Other Operating Systems ##
181
182If 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/opensuse-start.txt b/pages/docs/distros/opensuse-start.txt
deleted file mode 100644
index 95abf9327..000000000
--- a/pages/docs/distros/opensuse-start.txt
+++ /dev/null
@@ -1,41 +0,0 @@
1~~Title: EFL on openSUSE~~
2==== openSUSE ====
3
4Enlightenment and EFL are available for multiple versions of openSUSE:
5
6 * openSUSE_13.1 (end-of-life Jan. 2016; Evergreen support ended Nov. 2016)
7 * openSUSE_13.2 (end-of-life Jan 17th 2017)
8 * openSUSE_Factory
9 * openSUSE_Factory_ARM
10 * openSUSE_Leap_42.1
11 * openSUSE_Leap_42.2
12 * openSUSE_Tumbleweed
13
14Installing Enlightenment, is easy on openSUSE!
15
16You can either select enlightenment from the installer (net install only) or install the enlightenment package from yast or zypper.
17
18For Leap 42.2 and Tumbleweed the latest stable version will be installed, for Leap 42.1 you may want to add the development repo as listed below but this may be unstable
19
20<note warning>The code below enables a development repo this should be considered unstable.</note>
21
22First get the repository on your system. The openSUSE version will be auto-detected by zypper:
23<code bash>
24#as root
25zypper addrepo -f obs://X11:Enlightenment:Factory enlightenment
26zypper refresh enlightenment
27</code>
28
29Now you can install the Enlightenment pattern (openSUSE meta-package):
30<code bash>
31zypper install -t pattern enlightenment
32</code>
33
34If you want to install EFL only:
35
36<code bash>
37zypper install efl
38</code>
39
40
41