missing NULL terminator in set_config_x
[geda-gaf.git] / docs / wiki / geda-suse_rpm_installation.html
blob84ead782396850340cbb6def291e534ff1ef4778
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html>
4 <head>
5 <link rel="stylesheet" media="screen" type="text/css" href="./style.css" />
6 <link rel="stylesheet" media="screen" type="text/css" href="./design.css" />
7 <link rel="stylesheet" media="print" type="text/css" href="./print.css" />
9 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
10 </head>
11 <body>
13 <p>
14 <em>Translations of this page are also available in the following languages:</em> <a href="geda-suse_rpm_installation.ru.html" class="wikilink1" title="geda-suse_rpm_installation.ru.html">Русский</a>.
15 </p>
17 <h1 class="sectionedit1" id="installing_geda_rpm_packages_on_suse">Installing gEDA rpm packages on SuSE</h1>
18 <div class="level1">
20 </div>
21 <!-- EDIT1 SECTION "Installing gEDA rpm packages on SuSE" [124-177] -->
22 <h2 class="sectionedit2" id="available_rpm_packages">Available rpm packages</h2>
23 <div class="level2">
24 <ul>
25 <li class="level1"><div class="li"> geda (1.6.1)</div>
26 </li>
27 <li class="level1"><div class="li"> gerbv (2.3.0)</div>
28 </li>
29 <li class="level1"><div class="li"> pcb (20091103)</div>
30 </li>
31 <li class="level1"><div class="li"> ng-spice-rework (20)</div>
32 </li>
33 <li class="level1"><div class="li"> gnucap (0.35)</div>
34 </li>
35 <li class="level1"><div class="li"> gspiceui (0.9.98)</div>
36 </li>
37 <li class="level1"><div class="li"> gwave (20090213)</div>
38 </li>
39 <li class="level1"><div class="li"> gtkwave (3.3.3)</div>
40 </li>
41 <li class="level1"><div class="li"> dinotrace (9.4a)</div>
42 </li>
43 <li class="level1"><div class="li"> verilog (0.9.1)</div>
44 </li>
45 <li class="level1"><div class="li"> wcalc (1.1)</div>
46 </li>
47 <li class="level1"><div class="li"> xgsch2pcb (0.1.3)</div>
48 </li>
49 <li class="level1"><div class="li"> electronics-menu (1.0)</div>
50 </li>
51 </ul>
53 </div>
54 <!-- EDIT2 SECTION "Available rpm packages" [178-482] -->
55 <h2 class="sectionedit3" id="installing_packages_from_the_suse_build_service">Installing Packages from the SuSE Build Service</h2>
56 <div class="level2">
57 <ol>
58 <li class="level1"><div class="li"> Start Yast and go to “Change Installation Source”</div>
59 </li>
60 <li class="level1 node"><div class="li"> Add a HTTP source with the following properties:</div>
61 <ul>
62 <li class="level3"><div class="li"> <strong>Servername:</strong> software.opensuse.org</div>
63 </li>
64 <li class="level3"><div class="li"> <strong>Directory:</strong> /download/repositories/science/openSUSE_11.0/ (Choose the directory for your distribution)</div>
65 </li>
66 </ul>
67 </li>
68 <li class="level1"><div class="li"> Start “Install Software” in Yast, goto “Search” and look for gEDA. All packages appear.</div>
69 </li>
70 <li class="level1"><div class="li"> Install the packages as usual.</div>
71 </li>
72 </ol>
74 <p>
75 For more informations read the <a href="http://en.opensuse.org/Build_Service/User" class="urlextern" title="http://en.opensuse.org/Build_Service/User" rel="nofollow"> generic installation notes</a> of the <a href="http://en.opensuse.org/Build_Service" class="urlextern" title="http://en.opensuse.org/Build_Service" rel="nofollow"> OpenSuSE Build Service</a>
76 </p>
78 <p>
79 You can also browse through repositories first:
80 <a href="http://software.opensuse.org/download/science/openSUSE_11.0/repodata/" class="urlextern" title="http://software.opensuse.org/download/science/openSUSE_11.0/repodata/" rel="nofollow"> openSUSE_11.0 repo</a>,
81 <a href="http://software.opensuse.org/download/science/openSUSE_11.1/repodata/" class="urlextern" title="http://software.opensuse.org/download/science/openSUSE_11.1/repodata/" rel="nofollow"> openSUSE_11.1 repo</a>.
82 <a href="http://software.opensuse.org/download/science/openSUSE_11.2/repodata/" class="urlextern" title="http://software.opensuse.org/download/science/openSUSE_11.2/repodata/" rel="nofollow"> openSUSE_11.2 repo</a>.
83 </p>
85 </div>
86 <!-- EDIT3 SECTION "Installing Packages from the SuSE Build Service" [483-1470] -->
87 <h2 class="sectionedit4" id="distribution_specific_notes">Distribution specific notes</h2>
88 <div class="level2">
90 <p>
91 Each distribution version has it&#039;s own issues. Please read the notes below.
92 </p>
94 </div>
95 <!-- EDIT4 SECTION "Distribution specific notes" [1471-1588] -->
96 <h3 class="sectionedit5" id="opensuse_110">openSUSE 11.0</h3>
97 <div class="level3">
98 <ul>
99 <li class="level1"><div class="li"></div>
100 </li>
101 </ul>
103 </div>
104 <!-- EDIT5 SECTION "openSUSE 11.0" [1589-1621] -->
105 <h3 class="sectionedit6" id="opensuse_111">openSUSE 11.1</h3>
106 <div class="level3">
107 <ul>
108 <li class="level1"><div class="li"> currently no electronics menu, all programs show up in the Education→Science menu</div>
109 </li>
110 <li class="level1"><div class="li"></div>
111 </li>
112 </ul>
114 </div>
115 <!-- EDIT6 SECTION "openSUSE 11.1" [1622-1741] -->
116 <h3 class="sectionedit7" id="opensuse_112">openSUSE 11.2</h3>
117 <div class="level3">
118 <ul>
119 <li class="level1"><div class="li"> currently no electronics menu, all programs show up in the Education→Science menu</div>
120 </li>
121 <li class="level1"><div class="li"></div>
122 </li>
123 </ul>
125 </div>
126 <!-- EDIT7 SECTION "openSUSE 11.2" [1742-1861] -->
127 <h2 class="sectionedit8" id="desktop_integration">Desktop Integration</h2>
128 <div class="level2">
131 This is a summary how the gEDA and other electronic packages are integrated into the desktop of openSUSE.
132 </p>
134 </div>
135 <!-- EDIT8 SECTION "Desktop Integration" [1862-2001] -->
136 <h3 class="sectionedit9" id="electronics_menu">Electronics Menu</h3>
137 <div class="level3">
140 Unfortunately the openSUSE distribution does not provide a electronics menu entry for all the nice gEDA programs.
141 Peter Clifton has created a menu entry for electronics. This menu package is available in the <strong>electronics-menu</strong> rpm.
142 It contains the menu item and some icons for it. The menu category is called <strong>Edutainment</strong><strong>Electronics</strong> in openSUSE.
143 </p>
146 If it is installed, it looks like this in KDE (manually combined with gimp):
147 </p>
150 <a href="media/geda/suse_electronics_menu.png" class="media" target="_blank" title="geda:suse_electronics_menu.png"><img src="media/geda/suse_electronics_menu.png" class="media" alt="" /></a>
151 </p>
153 </div>
154 <!-- EDIT9 SECTION "Electronics Menu" [2002-2504] -->
155 <h3 class="sectionedit10" id="notes_about_rpm_spec_file">Notes about rpm spec file</h3>
156 <div class="level3">
159 openSUSE calls it&#039;s <em>SuSEconfig</em> program after every installation of rpm packages with YaST.
160 Thus it&#039;s not necessary to integrate all configuration calls into the <em>post</em> and <em>postun</em> rpm sections.
161 </p>
164 The only additions in the <abbr title="specification">spec</abbr> files are for the <em>Shared MIME Info</em>. It is described in this openSUSE <a href="http://en.opensuse.org/Packaging/SUSE_Package_Conventions/Specific_Packages#10.1.3._Shared_MIME_Info" class="urlextern" title="http://en.opensuse.org/Packaging/SUSE_Package_Conventions/Specific_Packages#10.1.3._Shared_MIME_Info" rel="nofollow">SUSE_Package_Conventions/Specific_Packages</a>
165 article.
166 </p>
167 <pre class="code">PreReq: shared-mime-info
168 [...]</pre>
169 <pre class="code">%post
170 if test -f %{_bindir}/update-mime-database ; then
171 %{_bindir}/update-mime-database %{_datadir}/mime &gt;/dev/null
172 fi</pre>
173 <pre class="code">%postun
174 if test -f %{_bindir}/update-mime-database ; then
175 %{_bindir}/update-mime-database %{_datadir}/mime &gt;/dev/null
176 fi</pre>
179 Another addition is required to install the mimelnks properly in the KDE environment.
180 KDE does not take care of the mimelnks installed in <em>/usr/share/mimelnk/</em>, thus they have to be copied to
181 the KDE directory <em>/opt/kde3/mimelnk/</em>. This is done in the rpm <abbr title="specification">spec</abbr> file inside the %install section
182 </p>
183 <pre class="code">%install
184 %makeinstall
185 kdemimedir=$(kde-config --install mime)
186 if test %{_datadir} != $kdemimedir ; then
187 mkdir -p $RPM_BUILD_ROOT$kdemimedir
188 mv $RPM_BUILD_ROOT%{_datadir}/mimelnk/* $RPM_BUILD_ROOT$kdemimedir
189 rmdir $RPM_BUILD_ROOT%{_datadir}/mimelnk
190 fi</pre>
192 </div>
193 <!-- EDIT10 SECTION "Notes about rpm spec file" [2505-3901] -->
194 <h3 class="sectionedit11" id="installing_rpm_packages_manually">Installing rpm packages manually</h3>
195 <div class="level3">
198 For those who don&#039;t use YaST for installation the SuSEconfig command has to be executed manually after installing or removing any rpm package.
199 You can either call the toplevel SuSEconfig command
200 </p>
201 <pre class="code">/sbin/SuSEconfig</pre>
204 or call only the two required subconfiguration tools
205 </p>
206 <pre class="code">/sbin/conf.d/SuSEconfig.desktop-file-utils</pre>
209 which calls
210 </p>
211 <pre class="code">/usr/bin/update-desktop-database</pre>
215 </p>
216 <pre class="code">/sbin/conf.d/SuSEconfig.gtk2</pre>
219 which calls
220 </p>
221 <pre class="code">/usr/bin/gtk-update-icon-cache --quiet --ignore-theme-index --remove-empty-cache &quot;$SUBDIR&quot;</pre>
223 </div>
224 <!-- EDIT11 SECTION "Installing rpm packages manually" [3902-] --></body>
225 </html>