Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 1 | Building Python using VC++ 6.0 or 5.0 |
Guido van Rossum | a29b360 | 2000-03-29 01:51:37 +0000 | [diff] [blame] | 2 | ------------------------------------- |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 3 | This directory is used to build Python for Win32 platforms, e.g. Windows |
| 4 | 95, 98 and NT. It requires Microsoft Visual C++ 6.x or 5.x. |
Guido van Rossum | 15b239f | 1998-05-26 14:16:23 +0000 | [diff] [blame] | 5 | (For other Windows platforms and compilers, see ../PC/readme.txt.) |
| 6 | |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 7 | All you need to do is open the workspace "pcbuild.dsw" in MSVC++, select |
| 8 | the Debug or Release setting (using Build -> Set Active Configuration...), |
| 9 | and build the projects. |
Guido van Rossum | 15b239f | 1998-05-26 14:16:23 +0000 | [diff] [blame] | 10 | |
Tim Peters | befc97c | 2001-01-18 19:01:39 +0000 | [diff] [blame] | 11 | The proper order to build subprojects: |
Guido van Rossum | 15b239f | 1998-05-26 14:16:23 +0000 | [diff] [blame] | 12 | |
Tim Peters | 97c9640 | 2001-01-17 23:23:13 +0000 | [diff] [blame] | 13 | 1) pythoncore (this builds the main Python DLL and library files, |
Tim Peters | befc97c | 2001-01-18 19:01:39 +0000 | [diff] [blame] | 14 | python21.{dll, lib} in Release mode) |
| 15 | NOTE: in previous releases, this subproject was |
| 16 | named after the release number, e.g. python20. |
Guido van Rossum | 15b239f | 1998-05-26 14:16:23 +0000 | [diff] [blame] | 17 | |
Tim Peters | befc97c | 2001-01-18 19:01:39 +0000 | [diff] [blame] | 18 | 2) python (this builds the main Python executable, |
| 19 | python.exe in Release mode) |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 20 | |
| 21 | 3) the other subprojects, as desired or needed (note: you probably don't |
| 22 | want to build most of the other subprojects, unless you're building an |
| 23 | entire Python distribution from scratch, or specifically making changes |
| 24 | to the subsystems they implement; see SUBPROJECTS below) |
Guido van Rossum | 15b239f | 1998-05-26 14:16:23 +0000 | [diff] [blame] | 25 | |
| 26 | When using the Debug setting, the output files have a _d added to |
Tim Peters | 97c9640 | 2001-01-17 23:23:13 +0000 | [diff] [blame] | 27 | their name: python21_d.dll, python_d.exe, parser_d.pyd, and so on. |
Guido van Rossum | e79cf32 | 1998-07-07 22:35:03 +0000 | [diff] [blame] | 28 | |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 29 | SUBPROJECTS |
| 30 | ----------- |
Tim Peters | 610a827 | 2000-07-01 02:51:23 +0000 | [diff] [blame] | 31 | These subprojects should build out of the box. Subprojects other than the |
Tim Peters | befc97c | 2001-01-18 19:01:39 +0000 | [diff] [blame] | 32 | main ones (pythoncore, python, pythonw) generally build a DLL (renamed to |
Tim Peters | 610a827 | 2000-07-01 02:51:23 +0000 | [diff] [blame] | 33 | .pyd) from a specific module so that users don't have to load the code |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 34 | supporting that module unless they import the module. |
Guido van Rossum | e79cf32 | 1998-07-07 22:35:03 +0000 | [diff] [blame] | 35 | |
Tim Peters | 97c9640 | 2001-01-17 23:23:13 +0000 | [diff] [blame] | 36 | pythoncore |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 37 | .dll and .lib |
| 38 | python |
| 39 | .exe |
| 40 | pythonw |
| 41 | pythonw.exe, a variant of python.exe that doesn't pop up a DOS box |
Tim Peters | 0d7ce4e | 2003-03-21 01:55:41 +0000 | [diff] [blame] | 42 | _csv |
| 43 | C support for the comma-separated values module |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 44 | _socket |
| 45 | socketmodule.c |
| 46 | _sre |
| 47 | Unicode-aware regular expression engine |
Tim Peters | b16c56f | 2001-02-02 21:24:51 +0000 | [diff] [blame] | 48 | _symtable |
| 49 | the _symtable module, symtablemodule.c |
Tim Peters | d66595f | 2001-02-04 03:09:53 +0000 | [diff] [blame] | 50 | _testcapi |
Tim Peters | b16c56f | 2001-02-02 21:24:51 +0000 | [diff] [blame] | 51 | tests of the Python C API, run via Lib/test/test_capi.py, and |
Tim Peters | d66595f | 2001-02-04 03:09:53 +0000 | [diff] [blame] | 52 | implemented by module Modules/_testcapimodule.c |
Tim Peters | 2a799bf | 2002-12-16 20:18:38 +0000 | [diff] [blame] | 53 | datetime |
| 54 | datetimemodule.c |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 55 | mmap |
| 56 | mmapmodule.c |
| 57 | parser |
| 58 | the parser module |
Tim Peters | b012a15 | 2002-02-13 23:56:46 +0000 | [diff] [blame] | 59 | pyexpat |
| 60 | Python wrapper for accelerated XML parsing, which incorporates stable |
| 61 | code from the Expat project: http://sourceforge.net/projects/expat/ |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 62 | select |
| 63 | selectmodule.c |
Tim Peters | 19f52c2 | 2001-01-24 10:07:22 +0000 | [diff] [blame] | 64 | unicodedata |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 65 | large tables of Unicode data |
| 66 | winreg |
| 67 | Windows registry API |
| 68 | winsound |
| 69 | play sounds (typically .wav files) under Windows |
| 70 | |
| 71 | The following subprojects will generally NOT build out of the box. They |
| 72 | wrap code Python doesn't control, and you'll need to download the base |
Tim Peters | aff1284 | 2000-08-25 06:52:44 +0000 | [diff] [blame] | 73 | packages first and unpack them into siblings of PCbuilds's parent |
| 74 | directory; for example, if your PCbuild is .......\dist\src\PCbuild\, |
| 75 | unpack into new subdirectories of dist\. |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 76 | |
| 77 | _tkinter |
Tim Peters | 077736b | 2002-11-14 23:24:40 +0000 | [diff] [blame] | 78 | Python wrapper for the Tk windowing system. Requires building |
| 79 | Tcl/Tk first. Following are instructions for Tcl/Tk 8.4.1: |
| 80 | |
| 81 | Get source |
| 82 | ---------- |
| 83 | Go to |
| 84 | http://prdownloads.sourceforge.net/tcl/ |
| 85 | and download |
| 86 | tcl841-src.zip |
| 87 | tk841-src.zip |
| 88 | Unzip into |
| 89 | dist\tcl8.4.1\ |
Tim Peters | 6c62995 | 2002-11-15 18:36:11 +0000 | [diff] [blame] | 90 | dist\tk8.4.1\ |
Tim Peters | 077736b | 2002-11-14 23:24:40 +0000 | [diff] [blame] | 91 | respectively. |
| 92 | |
Tim Peters | 6c62995 | 2002-11-15 18:36:11 +0000 | [diff] [blame] | 93 | Build Tcl first (done here w/ MSVC 6 on Win2K; also Win98SE) |
| 94 | --------------- |
Tim Peters | 077736b | 2002-11-14 23:24:40 +0000 | [diff] [blame] | 95 | cd dist\tcl8.4.1\win |
| 96 | run vcvars32.bat [necessary even on Win2K] |
| 97 | nmake -f makefile.vc |
| 98 | nmake -f makefile.vc INSTALLDIR=..\..\tcl84 install |
| 99 | |
| 100 | XXX Should we compile with OPTS=threads? |
| 101 | |
| 102 | XXX Some tests failed in "nmake -f makefile.vc test". |
| 103 | |
Tim Peters | 077736b | 2002-11-14 23:24:40 +0000 | [diff] [blame] | 104 | Build Tk |
Tim Peters | 6c62995 | 2002-11-15 18:36:11 +0000 | [diff] [blame] | 105 | -------- |
Tim Peters | 077736b | 2002-11-14 23:24:40 +0000 | [diff] [blame] | 106 | cd dist\tk8.4.1\win |
| 107 | nmake -f makefile.vc TCLDIR=..\..\tcl8.4.1 |
| 108 | nmake -f makefile.vc TCLDIR=..\..\tcl8.4.1 INSTALLDIR=..\..\tcl84 install |
| 109 | |
| 110 | XXX Should we compile with OPTS=threads? |
| 111 | |
| 112 | XXX Some tests failed in "nmake -f makefile.vc test". |
| 113 | |
| 114 | XXX Our installer copies a lot of stuff out of the Tcl/Tk install |
| 115 | XXX directory. Is all of that really needed for Python use of Tcl/Tk? |
| 116 | |
Tim Peters | a406b58 | 2002-11-19 17:38:27 +0000 | [diff] [blame] | 117 | Make sure the installer matches |
| 118 | ------------------------------- |
| 119 | Ensure that the Wise compiler vrbl _TCLDIR_ is set to the name of |
| 120 | the common Tcl/Tk installation directory (tcl84 for the instructions |
| 121 | above). This is needed so the installer can copy various Tcl/Tk |
| 122 | files into the Python distribution. |
| 123 | |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 124 | |
| 125 | zlib |
Tim Peters | ee826f8 | 2001-01-31 19:39:44 +0000 | [diff] [blame] | 126 | Python wrapper for the zlib compression library. Get the source code |
Tim Peters | 6077f64 | 2002-03-13 21:51:55 +0000 | [diff] [blame] | 127 | for version 1.1.4 from a convenient mirror at: |
| 128 | http://www.gzip.org/zlib/ |
| 129 | Unpack into dist\zlib-1.1.4. |
Tim Peters | ee826f8 | 2001-01-31 19:39:44 +0000 | [diff] [blame] | 130 | A custom pre-link step in the zlib project settings should manage to |
Tim Peters | 6077f64 | 2002-03-13 21:51:55 +0000 | [diff] [blame] | 131 | build zlib-1.1.4\zlib.lib by magic before zlib.pyd (or zlib_d.pyd) is |
Tim Peters | ee826f8 | 2001-01-31 19:39:44 +0000 | [diff] [blame] | 132 | linked in PCbuild\. |
| 133 | However, the zlib project is not smart enough to remove anything under |
Tim Peters | 6077f64 | 2002-03-13 21:51:55 +0000 | [diff] [blame] | 134 | zlib-1.1.4\ when you do a clean, so if you want to rebuild zlib.lib |
| 135 | you need to clean up zlib-1.1.4\ by hand. |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 136 | |
Tim Peters | b0ead4e | 2002-11-09 04:48:58 +0000 | [diff] [blame] | 137 | bz2 |
| 138 | Python wrapper for the libbz2 compression library. Homepage |
| 139 | http://sources.redhat.com/bzip2/ |
| 140 | Download the source tarball, bzip2-1.0.2.tar.gz. |
Tim Peters | 077736b | 2002-11-14 23:24:40 +0000 | [diff] [blame] | 141 | Unpack into dist\bzip2-1.0.2. WARNING: If you're using WinZip, you |
Tim Peters | b0ead4e | 2002-11-09 04:48:58 +0000 | [diff] [blame] | 142 | must disable its "TAR file smart CR/LF conversion" feature (under |
| 143 | Options -> Configuration -> Miscellaneous -> Other) for the duration. |
Tim Peters | 077736b | 2002-11-14 23:24:40 +0000 | [diff] [blame] | 144 | |
Tim Peters | b0ead4e | 2002-11-09 04:48:58 +0000 | [diff] [blame] | 145 | Don't bother trying to use libbz2.dsp with MSVC. After 10 minutes |
| 146 | of fiddling, I couldn't get it to work. Perhaps it works with |
| 147 | MSVC 5 (I used MSVC 6). It's better to run the by-hand makefile |
Tim Peters | 077736b | 2002-11-14 23:24:40 +0000 | [diff] [blame] | 148 | anyway, because it runs a helpful test step at the end. |
| 149 | |
Tim Peters | b0ead4e | 2002-11-09 04:48:58 +0000 | [diff] [blame] | 150 | cd into dist\bzip2-1.0.2, and run |
| 151 | nmake -f makefile.msc |
| 152 | [Note that if you're running Win9X, you'll need to run vcvars32.bat |
| 153 | before running nmake (this batch file is in your MSVC installation). |
| 154 | TODO: make this work like zlib (in particular, MSVC runs the prelink |
| 155 | step in an enviroment that already has the correct envars set up). |
| 156 | ] |
Tim Peters | 077736b | 2002-11-14 23:24:40 +0000 | [diff] [blame] | 157 | The make step shouldn't yield any warnings or errors, and should end |
Tim Peters | b0ead4e | 2002-11-09 04:48:58 +0000 | [diff] [blame] | 158 | by displaying 6 blocks each terminated with |
| 159 | FC: no differences encountered |
| 160 | If FC finds differences, see the warning abou WinZip above (when I |
| 161 | first tried it, sample3.ref failed due to CRLF conversion). |
Tim Peters | 077736b | 2002-11-14 23:24:40 +0000 | [diff] [blame] | 162 | |
Tim Peters | b0ead4e | 2002-11-09 04:48:58 +0000 | [diff] [blame] | 163 | All of this managed to build bzip2-1.0.2\libbz2.lib, which the Python |
| 164 | project links in. |
| 165 | |
| 166 | |
Tim Peters | 78e35f9 | 2002-11-22 20:00:34 +0000 | [diff] [blame] | 167 | _bsddb |
Tim Peters | 0064026 | 2003-01-24 15:31:31 +0000 | [diff] [blame] | 168 | Go to Sleepycat's download page: |
| 169 | http://www.sleepycat.com/download/ |
Tim Peters | b0ead4e | 2002-11-09 04:48:58 +0000 | [diff] [blame] | 170 | |
Tim Peters | 0064026 | 2003-01-24 15:31:31 +0000 | [diff] [blame] | 171 | and download version 4.1.25. The file name is db-4.1.25.NC.zip. |
| 172 | XXX with or without strong cryptography? I picked "without". |
Tim Peters | 78e35f9 | 2002-11-22 20:00:34 +0000 | [diff] [blame] | 173 | |
Tim Peters | 0064026 | 2003-01-24 15:31:31 +0000 | [diff] [blame] | 174 | Unpack into |
| 175 | dist\db-4.1.25 |
Tim Peters | 78e35f9 | 2002-11-22 20:00:34 +0000 | [diff] [blame] | 176 | |
Tim Peters | 0064026 | 2003-01-24 15:31:31 +0000 | [diff] [blame] | 177 | [If using WinZip to unpack the db-4.1.25.NC distro, that requires |
| 178 | renaming the directory (to remove ".NC") after unpacking. |
| 179 | ] |
| 180 | |
| 181 | Open |
| 182 | dist\db-4.1.25\docs\index.html |
| 183 | |
| 184 | and follow the Windows instructions for building the Sleepycat |
| 185 | software. Note that Berkeley_DB.dsw is in the build_win32 subdirectory. |
| 186 | Build the Release version ("build_all -- Win32 Release"). |
| 187 | |
| 188 | XXX We're actually linking against Release_static\libdb41s.lib. |
Tim Peters | 84c7a3f | 2002-11-23 18:48:06 +0000 | [diff] [blame] | 189 | XXX This yields the following warnings: |
| 190 | """ |
| 191 | Compiling... |
| 192 | _bsddb.c |
| 193 | Linking... |
| 194 | Creating library ./_bsddb.lib and object ./_bsddb.exp |
| 195 | LINK : warning LNK4049: locally defined symbol "_malloc" imported |
| 196 | LINK : warning LNK4049: locally defined symbol "_free" imported |
| 197 | LINK : warning LNK4049: locally defined symbol "_fclose" imported |
| 198 | LINK : warning LNK4049: locally defined symbol "_fopen" imported |
| 199 | _bsddb.pyd - 0 error(s), 4 warning(s) |
| 200 | """ |
| 201 | XXX This isn't encouraging, but I don't know what to do about it. |
Tim Peters | 78e35f9 | 2002-11-22 20:00:34 +0000 | [diff] [blame] | 202 | |
Tim Peters | 0064026 | 2003-01-24 15:31:31 +0000 | [diff] [blame] | 203 | To run extensive tests, pass "-u bsddb" to regrtest.py. test_bsddb3.py |
| 204 | is then enabled. Running in verbose mode may be helpful. |
| 205 | |
| 206 | XXX The test_bsddb3 tests don't always pass, on Windows (according to |
| 207 | XXX me) or on Linux (according to Barry). I had much better luck |
| 208 | XXX on Win2K than on Win98SE. The common failure mode across platforms |
| 209 | XXX is |
| 210 | XXX DBAgainError: (11, 'Resource temporarily unavailable -- unable |
| 211 | XXX to join the environment') |
| 212 | XXX |
| 213 | XXX and it appears timing-dependent. On Win2K I also saw this once: |
| 214 | XXX |
| 215 | XXX test02_SimpleLocks (bsddb.test.test_thread.HashSimpleThreaded) ... |
| 216 | XXX Exception in thread reader 1: |
| 217 | XXX Traceback (most recent call last): |
| 218 | XXX File "C:\Code\python\lib\threading.py", line 411, in __bootstrap |
| 219 | XXX self.run() |
| 220 | XXX File "C:\Code\python\lib\threading.py", line 399, in run |
| 221 | XXX apply(self.__target, self.__args, self.__kwargs) |
| 222 | XXX File "C:\Code\python\lib\bsddb\test\test_thread.py", line 268, in |
| 223 | XXX readerThread |
| 224 | XXX rec = c.next() |
| 225 | XXX DBLockDeadlockError: (-30996, 'DB_LOCK_DEADLOCK: Locker killed |
| 226 | XXX to resolve a deadlock') |
Tim Peters | ad8605d | 2003-01-29 00:38:42 +0000 | [diff] [blame] | 227 | XXX |
| 228 | XXX I'm told that DBLockDeadlockError is expected at times. It |
| 229 | XXX doesn't cause a test to fail when it happens (exceptions in |
| 230 | XXX threads are invisible to unittest). |
Tim Peters | 0064026 | 2003-01-24 15:31:31 +0000 | [diff] [blame] | 231 | |
Tim Peters | e8bcb25 | 2002-12-04 02:39:52 +0000 | [diff] [blame] | 232 | |
Mark Hammond | f229f9f | 2002-12-03 05:47:26 +0000 | [diff] [blame] | 233 | _ssl |
Tim Peters | e8bcb25 | 2002-12-04 02:39:52 +0000 | [diff] [blame] | 234 | Python wrapper for the secure sockets library. |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 235 | |
Mark Hammond | f229f9f | 2002-12-03 05:47:26 +0000 | [diff] [blame] | 236 | Get the latest source code for OpenSSL from |
| 237 | http://www.openssl.org |
| 238 | |
Tim Peters | e8bcb25 | 2002-12-04 02:39:52 +0000 | [diff] [blame] | 239 | You (probably) don't want the "engine" code. For example, get |
| 240 | openssl-0.9.6g.tar.gz |
| 241 | not |
| 242 | openssl-engine-0.9.6g.tar.gz |
| 243 | |
Mark Hammond | f229f9f | 2002-12-03 05:47:26 +0000 | [diff] [blame] | 244 | Unpack into the "dist" directory, retaining the folder name from |
| 245 | the archive - for example, the latest stable OpenSSL will install as |
| 246 | dist/openssl-0.9.6g |
| 247 | |
| 248 | You can (theoretically) use any version of OpenSSL you like - the |
| 249 | build process will automatically select the latest version. |
| 250 | |
| 251 | You must also install ActivePerl from |
| 252 | http://www.activestate.com/Products/ActivePerl/ |
Tim Peters | e8bcb25 | 2002-12-04 02:39:52 +0000 | [diff] [blame] | 253 | as this is used by the OpenSSL build process. Complain to them <wink>. |
Mark Hammond | f229f9f | 2002-12-03 05:47:26 +0000 | [diff] [blame] | 254 | |
| 255 | The MSVC project simply invokes PCBuild/build_ssl.py to perform |
Tim Peters | e8bcb25 | 2002-12-04 02:39:52 +0000 | [diff] [blame] | 256 | the build. This Python script locates and builds your OpenSSL |
Mark Hammond | f229f9f | 2002-12-03 05:47:26 +0000 | [diff] [blame] | 257 | installation, then invokes a simple makefile to build the final .pyd. |
| 258 | |
Tim Peters | 6ee68d2 | 2002-12-04 03:16:37 +0000 | [diff] [blame] | 259 | Win9x users: see "Win9x note" below. |
| 260 | |
Mark Hammond | f229f9f | 2002-12-03 05:47:26 +0000 | [diff] [blame] | 261 | build_ssl.py attempts to catch the most common errors (such as not |
| 262 | being able to find OpenSSL sources, or not being able to find a Perl |
| 263 | that works with OpenSSL) and give a reasonable error message. |
| 264 | If you have a problem that doesn't seem to be handled correctly |
| 265 | (eg, you know you have ActivePerl but we can't find it), please take |
| 266 | a peek at build_ssl.py and suggest patches. Note that build_ssl.py |
| 267 | should be able to be run directly from the command-line. |
| 268 | |
Tim Peters | e8bcb25 | 2002-12-04 02:39:52 +0000 | [diff] [blame] | 269 | build_ssl.py/MSVC isn't clever enough to clean OpenSSL - you must do |
| 270 | this by hand. |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 271 | |
Tim Peters | 6ee68d2 | 2002-12-04 03:16:37 +0000 | [diff] [blame] | 272 | Win9x note: If, near the start of the build process, you see |
| 273 | something like |
| 274 | |
| 275 | C:\Code\openssl-0.9.6g>set OPTS=no-asm |
| 276 | Out of environment space |
| 277 | |
Tim Peters | 21d77f5 | 2002-12-04 04:00:12 +0000 | [diff] [blame] | 278 | then you're in trouble, and will probably also see these errors near |
Tim Peters | 6ee68d2 | 2002-12-04 03:16:37 +0000 | [diff] [blame] | 279 | the end of the process: |
| 280 | |
| 281 | NMAKE : fatal error U1073: don't know how to make |
| 282 | 'crypto\md5\asm\m5_win32.asm' |
| 283 | Stop. |
| 284 | NMAKE : fatal error U1073: don't know how to make |
| 285 | 'C:\Code\openssl-0.9.6g/out32/libeay32.lib' |
| 286 | Stop. |
| 287 | |
| 288 | You need more environment space. Win9x only has room for 256 bytes |
| 289 | by default, and especially after installing ActivePerl (which fiddles |
| 290 | the PATH envar), you're likely to run out. KB Q230205 |
| 291 | |
| 292 | http://support.microsoft.com/default.aspx?scid=KB;en-us;q230205 |
| 293 | |
| 294 | explains how to edit CONFIG.SYS to cure this. |
| 295 | |
| 296 | |
Tim Peters | f9a4a6e | 2000-07-01 20:38:27 +0000 | [diff] [blame] | 297 | YOUR OWN EXTENSION DLLs |
Tim Peters | 4b5fb07 | 2000-07-01 00:03:43 +0000 | [diff] [blame] | 298 | ----------------------- |
| 299 | If you want to create your own extension module DLL, there's an example |
| 300 | with easy-to-follow instructions in ../PC/example/; read the file |
| 301 | readme.txt there first. |