scheme-api: Add show-uri and show-file functions to (gschem util).
[geda-gaf/peter-b.git] / docs / wiki / geda-cygwin.html
blobb2233766032d15199ca405925bdb32457481bf8a
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 <title></title>
6 <link rel="stylesheet" media="screen" type="text/css" href="./style.css" />
7 <link rel="stylesheet" media="screen" type="text/css" href="./design.css" />
8 <link rel="stylesheet" media="print" type="text/css" href="./print.css" />
10 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
11 </head>
12 <body>
15 <h1 class="sectionedit74"><a name="installing_geda_gaf_on_windows_-_the_cygwin_way" id="installing_geda_gaf_on_windows_-_the_cygwin_way">Installing gEDA/gaf on Windows - the Cygwin way</a></h1>
16 <div class="level1">
18 <p>
20 This guide describes one way to build gEDA/gaf (gschem and friends) on
21 the Windows operating system. It uses Cygwin as the layer between
22 Windows and the *nix world (ie gcc, make, bash etc…).
23 </p>
25 </div>
26 <!-- EDIT74 SECTION "Installing gEDA/gaf on Windows - the Cygwin way" [1-258] -->
27 <h2 class="sectionedit75"><a name="instructions" id="instructions">Instructions</a></h2>
28 <div class="level2">
30 <p>
32 <strong>1. Download and run setup.exe from cygwin website:</strong>
33 <a href="http://www.cygwin.com" class="urlextern" title="http://www.cygwin.com" rel="nofollow">http://www.cygwin.com</a>.
34 </p>
36 <p>
37 In the package selection dialog, select the following packages:
38 </p>
40 <p>
41 (Hint: press the “view” button once to arrange the list in
42 alphabetical order)
44 </p>
45 <pre class="code">atk-devel
46 crypt
47 file
48 gcc
49 gtk2-x11-devel
50 guile-devel
51 libgmp-devel
52 libtool1.5
53 make
54 pango-devel
55 patchutils
56 pcre-devel
57 pcre-doc
58 pkg-config
59 xorg-x11-devel
60 xorg-x11-fscl
61 xterm</pre>
63 <p>
65 <strong>2. Append these lines to your .bash_profile:</strong>
67 </p>
68 <pre class="code">export LD_LIBRARY_PATH=$HOME/geda/lib:$LD_LIBRARY_PATH
69 export PATH=$HOME/geda/bin:$PATH
70 export PKG_CONFIG_PATH=$HOME/geda/lib/pkgconfig:$PKG_CONFIG_PATH</pre>
72 <p>
74 Update your environment:
75 </p>
76 <pre class="code">$ source .bash_profile</pre>
78 <p>
80 <strong>3. Go to the <a href="http://www.geda.seul.org/sources.html" class="urlextern" title="http://www.geda.seul.org/sources.html" rel="nofollow">gEDA sources download page</a>.</strong>
81 </p>
83 <p>
84 From the gEDA/gaf group, download <strong>only</strong> the packages which have a date
85 as its version. The necessary dependencies were already
86 installed in step 1. However, if you haven&#039;t installed or built the libstroke package, be sure to add
88 </p>
89 <pre class="code">--disable-stroke</pre>
91 <p>
93 to the opts= line. Add the following options to the opts= line in the Makefile
95 </p>
96 <pre class="code">--disable-update-mime-database --disable-update-desktop-database --disable-nls</pre>
98 <p>
99 <strong>4. Go to the download directory and type:</strong>
100 </p>
101 <pre class="code">$ make open
102 $ make install
103 ( ...patience... )</pre>
107 <strong>5. Now, to properly view the documentation from the help menu of gschem:</strong>
108 </p>
111 Locate the executables of your browser and <acronym title="Portable Document Format">PDF</acronym> reader and create links
112 from /usr/bin. Examples:
113 </p>
114 <pre class="code">$ ln -s &quot;c:\Program Files\Internet Explorer\iexplore.exe&quot; /usr/bin/iexplore
115 $ ln -s &quot;c:\Program Files\Firefox\firefox.exe&quot; /usr/bin/firefox
116 $ ln -s &quot;c:\Program Files\Adobe\Acrobat 7.0\Reader\AcroRd32.exe&quot; /usr/bin/acroread</pre>
120 Try:
121 </p>
122 <pre class="code">$ iexplore
123 ( Microsoft Internet Explorer appears )
124 $ firefox
125 ( Firefox appears - if installed )
126 $ acroread
127 ( Adobe Acrobat Reader appears )
128 $ gschemdoc -m
129 ( gEDA documentation appears )</pre>
133 <strong>6. Finally, start the X server:</strong>
134 </p>
135 <pre class="code">$ startx</pre>
139 Have fun!
140 </p>
142 </div>
143 <!-- EDIT75 SECTION "Instructions" [259-] --></body>
144 </html>