Index: trunk/INSTALL =================================================================== --- trunk/INSTALL (revision 33450) +++ trunk/INSTALL (revision 33451) @@ -1,3 +1,10 @@ +NOTE: This file is the generic description. For per host system type details, + please look in doc/INSTALL.* + +NOTE: If you are packaging pcb-rnd for an OS distribution, please read + doc/developer/packaging.txt carefully and please try to follow the + conventions documented in doc/developer/packaging/ + 1. Configure Run ./configure. Index: trunk/doc/UNIX.txt =================================================================== --- trunk/doc/UNIX.txt (revision 33450) +++ trunk/doc/UNIX.txt (nonexistent) @@ -1,38 +0,0 @@ -State on UNIX systems -~~~~~~~~~~~~~~~~~~~~~ - -Source releases starting from 1.1.2 should compile and run out-of-the-box -on old UNIX systems, such as IRIX. Does NOT require any GNU installed. - -Requirements: - - x11 and motif (for the GUI) - - an awk implementation that supports gsub(), e.g. nawk - -1. ./configure - -2. make - -Considerations listed in ../INSTALL apply. - -The above procedure has been tested on IRIX 5.3 on IP22. - -Expected compilation times [minute:second]: - -pcb-rnd ./configure compile, -O0 compile -O3 system ------------------------------------------------------------------------------------ -1.1.2 1:55 7:40 14:27 IRIX 5.3, IP22 @ 100 MHz -2.3.1 0:20 1:47 7:52 AIX 7, Power7 - - -3. per UNIX system notes - -3.1. AIX - -It is possible to compile pcb-rnd using gtk2.0 but due to a non-standard -AIX libc header, this needs extra CFLAGS for configure: - - ./configure CFLAGS=-D_LINUX_SOURCE_COMPAT - -Without that, gtk is not detected becaus eof name clash between gtk and -AIX libc on func_data. - Index: trunk/doc/windows.html =================================================================== --- trunk/doc/windows.html (revision 33450) +++ trunk/doc/windows.html (nonexistent) @@ -1,95 +0,0 @@ - - - -

pcb-rnd on windows

- -

We have a pack in beta testing. It should work on any windows version -from 7 up. (It does _not_ work on XP.) - -

IMPORTANT: if you use the windows version of pcb-rnd, please send me -an email to: pcb-rnd-win (at) igor2.repo.hu - -

I will use this for sampling user demand. If there are no emails, that -means there are no windows users which means it is not worth investing -time in compiling windows releases. - -

1. download the binary pack and install

- -

Download a -win32.zip from the -binary releases page - - -

Unpack the zip anywhere, and run pcb-rnd from bin: -

start a shell (cmd.exe), cd to where you unpacked it, cd bin, pcb-rnd -
create a shortcut icon (TODO: what's needed for the exe to find the dlls?) -

- -

-IMPORTANT: Please make sure there's no space in the full path where you unpack. - - -

2. limitations

- -

pcb-rnd is a package designed for UNIX. The windows port does not -change the UNIX aspect of pcb-rnd, thus a few things are different from -a normal windows application: -

pcb-rnd works from config files, not from the registry -
pcb-rnd will figure the users home directory and will look for .pcb-rnd/ - in there for the user configs -
if anything breaks, try to run pcb-rnd from the command line: run a cmd.exe - and cd to the bin dir within the installation root and run pcb-rnd from - there watching what it prints to the console. -

- -

The usual pcb-rnd policies apply: -

pcb-rnd speaks English - there's no internalization, no unicode or utf -
some keyboard shortcuts may not work if your keyboard layout is not set - to English -
pcb-rnd uses the keyboard and the command line heavily -

- -

There are a few limitations specific to the current windows pack: -

there can not be space in the path where the pack is unzipped -
UNC paths (\\server\something) may fail randomly -
it does not support opengl, it is always doing software rendering -
some of the export formats (e.g. png) are not yet supported on windows -
there is no fp_wget support because there's no wget in the pack - (may work with busybox wget, busybox shipped in the pack, testing required) -
gsch2pcb-rnd is not supported -
import schematics with gnetlist has not been tested yet - (importing tEDAx netlist should work) -
the windows port may have some overhead; if you find pcb-rnd slow, - please try it on Linux. -

- -

3. Cross compilation from Linux to win32

- -(developers may need this, if you are an user, it is safe to skip.) - -

There is an svn repo that hosts all the sources for the dependencies. From -this, the binary DLLs can be compiled (this step may need some manual -intervention, autotools is not very nice for cross compilation). The result -is the "ultimate hidlib dependency pack" (uhdp), 90+ megabytes of dlls -with gtk, glib, gettext and whatnot. - -

The uhdp has two versions: the smaller one, with the dlls only, is part -of the pack downloaded by end users for installation. The bigger one, -called the developer pack, also contains the installed headers, .a and -.la files and can be used as "sysroot" for cross-compiling pcb-rnd -(or other software) against. - -

The uhdp can be donwloaded from http://repo.hu/projects/hidlib.w32 - -

The normal process is: -

download and unpack the binary developer vesion of uhdp (so you don't need - to spend long hours compiling all the deps) -
follow these - - steps for cross-compiling pcb-rnd -

- Index: trunk/doc/mac.txt =================================================================== --- trunk/doc/mac.txt (revision 33450) +++ trunk/doc/mac.txt (nonexistent) @@ -1,30 +0,0 @@ -State on MacOSX -~~~~~~~~~~~~~~~ - -Source releases starting from 1.1.0 should compile and run out-of-the-box. - -Requirements for GUI: x11 and gtk+ - - X11 server and client libraries for OS X are available from the XQuartz - download and install - - gtk+ is available from brew - * brew install dependencies (gtk+ and libgd) with the following commands - brew install libgd - brew install gtk+ - brew install pkg-config - * if you want to use gEDA with PCB-RND you may want to install it as well - via brew - brew install homebrew/science/geda-gaf - -Known issues: - - application window opens behind other windows; it seems to be a gtk bug - that can not be worked around from the application - - slow rendering and error messages about invalid numerics on the console - -Considerations listed in ../INSTALL apply. - -pcb-rnd is reported to work at least on the following versions: - -macOS xquartz ----------------------------- -10.14.3 majove 2.7.11 - Index: trunk/doc/INSTALL.UNIX.txt =================================================================== --- trunk/doc/INSTALL.UNIX.txt (nonexistent) +++ trunk/doc/INSTALL.UNIX.txt (revision 33451) @@ -0,0 +1,38 @@ +State on UNIX systems +~~~~~~~~~~~~~~~~~~~~~ + +Source releases starting from 1.1.2 should compile and run out-of-the-box +on old UNIX systems, such as IRIX. Does NOT require any GNU installed. + +Requirements: + - x11 and motif (for the GUI) + - an awk implementation that supports gsub(), e.g. nawk + +1. ./configure + +2. make + +Considerations listed in ../INSTALL apply. + +The above procedure has been tested on IRIX 5.3 on IP22. + +Expected compilation times [minute:second]: + +pcb-rnd ./configure compile, -O0 compile -O3 system +----------------------------------------------------------------------------------- +1.1.2 1:55 7:40 14:27 IRIX 5.3, IP22 @ 100 MHz +2.3.1 0:20 1:47 7:52 AIX 7, Power7 + + +3. per UNIX system notes + +3.1. AIX + +It is possible to compile pcb-rnd using gtk2.0 but due to a non-standard +AIX libc header, this needs extra CFLAGS for configure: + + ./configure CFLAGS=-D_LINUX_SOURCE_COMPAT + +Without that, gtk is not detected becaus eof name clash between gtk and +AIX libc on func_data. + Index: trunk/doc/INSTALL.mac.txt =================================================================== --- trunk/doc/INSTALL.mac.txt (nonexistent) +++ trunk/doc/INSTALL.mac.txt (revision 33451) @@ -0,0 +1,30 @@ +State on MacOSX +~~~~~~~~~~~~~~~ + +Source releases starting from 1.1.0 should compile and run out-of-the-box. + +Requirements for GUI: x11 and gtk+ + - X11 server and client libraries for OS X are available from the XQuartz + download and install + - gtk+ is available from brew + * brew install dependencies (gtk+ and libgd) with the following commands + brew install libgd + brew install gtk+ + brew install pkg-config + * if you want to use gEDA with PCB-RND you may want to install it as well + via brew + brew install homebrew/science/geda-gaf + +Known issues: + - application window opens behind other windows; it seems to be a gtk bug + that can not be worked around from the application + - slow rendering and error messages about invalid numerics on the console + +Considerations listed in ../INSTALL apply. + +pcb-rnd is reported to work at least on the following versions: + +macOS xquartz +---------------------------- +10.14.3 majove 2.7.11 + Index: trunk/doc/INSTALL.win32.html =================================================================== --- trunk/doc/INSTALL.win32.html (nonexistent) +++ trunk/doc/INSTALL.win32.html (revision 33451) @@ -0,0 +1,95 @@ + + + +

pcb-rnd on windows

+ +

We have a pack in beta testing. It should work on any windows version +from 7 up. (It does _not_ work on XP.) + +

IMPORTANT: if you use the windows version of pcb-rnd, please send me +an email to: pcb-rnd-win (at) igor2.repo.hu + +

I will use this for sampling user demand. If there are no emails, that +means there are no windows users which means it is not worth investing +time in compiling windows releases. + +

1. download the binary pack and install

+ +

Download a -win32.zip from the +binary releases page + + +

Unpack the zip anywhere, and run pcb-rnd from bin: +

start a shell (cmd.exe), cd to where you unpacked it, cd bin, pcb-rnd +
create a shortcut icon (TODO: what's needed for the exe to find the dlls?) +

+ +

+IMPORTANT: Please make sure there's no space in the full path where you unpack. + + +

2. limitations

+ +

pcb-rnd is a package designed for UNIX. The windows port does not +change the UNIX aspect of pcb-rnd, thus a few things are different from +a normal windows application: +

pcb-rnd works from config files, not from the registry +
pcb-rnd will figure the users home directory and will look for .pcb-rnd/ + in there for the user configs +
if anything breaks, try to run pcb-rnd from the command line: run a cmd.exe + and cd to the bin dir within the installation root and run pcb-rnd from + there watching what it prints to the console. +

+ +

The usual pcb-rnd policies apply: +

pcb-rnd speaks English - there's no internalization, no unicode or utf +
some keyboard shortcuts may not work if your keyboard layout is not set + to English +
pcb-rnd uses the keyboard and the command line heavily +

+ +

There are a few limitations specific to the current windows pack: +

there can not be space in the path where the pack is unzipped +
UNC paths (\\server\something) may fail randomly +
it does not support opengl, it is always doing software rendering +
some of the export formats (e.g. png) are not yet supported on windows +
there is no fp_wget support because there's no wget in the pack + (may work with busybox wget, busybox shipped in the pack, testing required) +
gsch2pcb-rnd is not supported +
import schematics with gnetlist has not been tested yet + (importing tEDAx netlist should work) +
the windows port may have some overhead; if you find pcb-rnd slow, + please try it on Linux. +

+ +

3. Cross compilation from Linux to win32

+ +(developers may need this, if you are an user, it is safe to skip.) + +

There is an svn repo that hosts all the sources for the dependencies. From +this, the binary DLLs can be compiled (this step may need some manual +intervention, autotools is not very nice for cross compilation). The result +is the "ultimate hidlib dependency pack" (uhdp), 90+ megabytes of dlls +with gtk, glib, gettext and whatnot. + +

The uhdp has two versions: the smaller one, with the dlls only, is part +of the pack downloaded by end users for installation. The bigger one, +called the developer pack, also contains the installed headers, .a and +.la files and can be used as "sysroot" for cross-compiling pcb-rnd +(or other software) against. + +

The uhdp can be donwloaded from http://repo.hu/projects/hidlib.w32 + +

The normal process is: +

download and unpack the binary developer vesion of uhdp (so you don't need + to spend long hours compiling all the deps) +
follow these + + steps for cross-compiling pcb-rnd +

+ Index: trunk/doc/index.html =================================================================== --- trunk/doc/index.html (revision 33450) +++ trunk/doc/index.html (revision 33451) @@ -66,9 +66,9 @@ Linux desktop (various distributions, from source)
official packages in Debian, Ubuntu, Fedora, Mageia, Kali, Parrot, PureOS, Raspbian (full list) -
Mac OS X -
Windows (7, 8, 10) -
IRIX 5.3, AIX 7 +
Mac OS X +
Windows (7, 8, 10) +
IRIX 5.3, AIX 7
OpenBSD (Likely: any BSD not older than 25 years)
(Likely: any 90's or newer UNIX system with motif)
Screen resolution as small as 800x600 Index: trunk/doc/news.html =================================================================== --- trunk/doc/news.html (revision 33450) +++ trunk/doc/news.html (revision 33451) @@ -102,7 +102,7 @@
windows - A windows version (from current svn head, pretty much what 2.1.4 is going to be) + A windows version (from current svn head, pretty much what 2.1.4 is going to be) is available