        Instrukce pro instalaci okenního manažera Window Maker

PODPOROVANÉ PLATFORMY
=====================
("Podporované" znamená, že už to na dané platformě někdo zprovoznil...)

- Intel GNU/Linux Conectiva 5.9 (beta)
- Intel GNU/Linux Slackware
- Intel GNU/Linux Debian
- Intel GNU/Linux ostatní distribuce
- Sparc GNU/Linux RedHat 5.1
- PowerPC GNU/MkLinux
- Alpha GNU/Linux RedHat 5.1
- FreeBSD
- NetBSD
- OpenBSD
- BSDI 4.0
- Solaris 2.5.1, 2.5.2
- Solaris 2.6.0
- Solaris 2.7beta
- SCO Unix
- SGI Irix 5.x, 6.5
- OSF/1
- HP-UX
- AIX 3.2.5
- AIX 4.1.4 / IBM PowerPC
- AIX 4.3.1 / IBM CC compiler
- AIX 4.3.2 / IBM PowerPC
- AIX 5.3
- DEC Alpha/Digital UNIX 4.x
- XFree86 / OS/2
- Corel NetWinder
- SunOS 4.x
- PowerMac / Power MachTen 4.1.1 over MacOS
- Amiga 3000 running RedHat Linux 5.1 (Rawhide)
- IBM S/390 s Linuxem
- iBook s OS Darwin

Patche pro rozběhání na jiných platformách jsou vítané.

POŽADAVKY
=========

Následující software je potřebný/nezbytný pro běh Window Makeru:

- X11R6.x
        Window Maker může být zkompilován na starších verzích X, jako
        je X11R5 (Solaris) nebo X11R4 (OpenWindows), ale nebude to pracovat
        100% spolehlivě. Na těchto systémech nebudou fungovat ikony
        aplikací a budete mít problémy s používáním doku. Upgrade
        uživatelských knihoven (Xlib, Xt atd.) zlepší tyto problémy pokud
        nemůžete aktualizovat váš X server.

Následující software je potřebný ke zkompilování Window Makeru:

- Zákládní běžné věci
        Když budete komplivat Window Maker, tak se ujistěte, že máte gcc
        (nebo jiný ANCI C kompilátor) a nainstalované hlavičkové soubory
        pro X. Hlavně pro začátečníky v Linuxu: musíte nainstalovat všechny
        X-devel balíky a gcc. Jinak nebudete schopni zkompilovat žádný
        program s grafickým rozhraním, tedy ani Window Maker.

- autoconf, automake a libtool
        Tyto nástroje NEJSOU POTŘEBA, ale když máte jeden nebo dva nebo
        všechny tři nainstalované, tak se UJISTĚTE, že máte přesně
        následující VERZE:
                autoconf 2.13
                automake 1.4
                libtool 1.3
        Máte-li odlišnou verzi, tak ji dočasně přejmenujte, nebo ji rovnou
        odinstalujte z vašeho systému. Pokud nebudete programovat, tak ji
        stejně nebudete potřebovat, takže ji můžete bezpečně odinstalovat.

Pozn. libProblist už není potřeba ke zkompilování Window Makeru, protože
        libProblist byl přímo zabudován do WINGs. Z toho důvodu už není
        potřeba ani lex (flex) a yacc (nebo bison).


NEPOVINNÉ
=========

Tyto knihovny nejsou nutné pro běh Windo Makeru, ale jsou podporované, když
je budete chtít použít. Tyto verze jsou používané vývojovým týmem, který
garantuje, že budou fungovat. Ostatní verze by měli fungovat také.

- libXPM 4.7 nebo novější
        Starší verze nemusí fungovat!!!
        Dostupné na ftp://sunsite.unc.edu/pub/Linux/libs/X/

        Je zde zabudovaná podpora pro soubory XPM, ale nenačte obrázky s
        nestandardním formátem kódování.

- libpng 0.96 nebo novější a zlib
        Pro podporu PNG obrázků
        http://www.cdrom.com/pub/png/

- libtiff 3.4 nebo novější
        Pro podporu TIFF obrázků
        Dostupné na ftp://ftp.sgi.com/graphics/tiff

- libjpeg 6.0.1 nebo novější
        Pro podporu JPEG obrázků
        http://www.ijg.org/

- libgif 2.2 nebo libungif
        Pro podporu GIF obrázků
        Dostupné na ftp://prtr-13.ucsc.edu/pub/libungif/

- libHermes 1.3.2 nebo novější
        Pro rychlejší konverzi obrázků (používá knihovna wraster)
        Používá se pouze v některých konverzích - pro TrueColor zobrazení
        http://www.clanlib.org/hermes/

-GNU xgettxt
        Když chcete používat češtinu nebo jiné jazyky kromě angličtiny,
        tak potřebujete GNU xgettext.
        Ostatní verze nejsou kompatibilní a nebudou fungovat
        GNU verze je dostupná na ftp://ftp.gnu.org


KONFIGURAČNÍ NASTAVENÍ
======================

Tyto volby mohou být předané konfiguračnímu skriptu jako argumenty za
účelem povolení/zakázání určité vlastnosti Window Makera.

Příklad:

./configura --enable-kde --enable-gnome

nakonfiguruje Window Maker s podporou KDE a GNOME

Seznam ostatních možností dostanete spuštěním ./configure --help

--with-libs-from
        specifikuje, které další adresáře s knihovnami se mají 
        prohledávat. Řetězec -L musí předcházet každému adresáři,
        např:
        --with-libs-from="-L/opt/libs -L/usr/local/lib"

--with-incs-from
        určuje, které další adresáře s hlavičkovými soubory se mají
        prohledat. Řetězec -I musí předcházet každému adresáři,
        např:
        --with-incs-from="-I/opt/headers -I/usr/local/include"

--enable-single-icon
        umožňuje skrýt všechny ikony aplikací WM_CLASS+WM_INSTANCE
        do jedné jediné. Tato vlastnost není podporovaná ze strany vývojářů.
        Když budete mít s touto funkcí problémy, tak se obraťte na jejího
        autora: Christopher Seawood <cls@seawood.org>

--disable-shm
        zakáže používání zdílené paměti MIT. To trochu zpomalí generování
        textur, ale v některých případech se to jeví jako nezbytnost z důvodu
        chyby, která způsobuje špatné zobrazování ikon a textur.

--disable-motif
        zakáže podporu pokynů pro okenní manažer mwm.

--enable-openlook
        povolí podporu pokynů pro okenní manažer OPEN LOOK(tm).

--enable-gnome
        povolí podporu pokynů pro GNOME.

--enable-kde
        povolí podporu pokynů pro KDE.

--enable-lite
        odstraní nástroje a funkce, které jsou už dostupné v desktopových
        prosředích KDE a GNOME. Odstraní se: seznam oken, menu aplikací,
        výběr více oken. Uvědomte si, že takto už nebudete schopni ukončit
        samotný Window Maker pomocí aplikačního menu. Budete muset zabít Window
        Maker z textové konzole nebo ho ukončit z KDE nebo GNOME.
        Nedoporučuje se povolit tuto vlastnost.

--enable-modelock
        podpora pro XKB nastavení jazyka. Když nevíte, o co jde, tak to
        pravděpodobně nebudete potřebovat.

--enable-sound
        povolí podporu modulu zvukových efektů.

--disable-xpm
        zakáže podporu knihovny XPM, pokud je dostupná na vašem systému.

--disable-png
        zakáže podporu knihovny PNG.

--disable-tiff
        zakáže podporu knihovny TIFF.

--disable-gif
        zakáže podporu knihovny GIF.

--disable-jpeg
        zakáže podporu knihovny JPEG.

--disable-shape
        zakáže tvarovaná okna (pro oclock, xeyes, atd.).

POŽADAVKY PRO SPECIFICKÉ PLATFORMY
==================================

-DEC/Alpha

        Následující mail není přeložen, ale hovoří se v něm, že pravděpodobně
        není potřeba konfigurovat Window Maker na Alphě s volbou --disable-shm.

-------------------------------------------------------------------------------
        From: Anton Ivanov <aivanov@eu.level3.net>
        To: Marcelo E. Magallon <mmagallo@debian.org>
        Subject: Re: Is the WindowMaker package working ok on Alpha?

> Hi,
> 
>  I was reading some docs on the WindowMaker tarball, and found this:
> 
>  | - DEC/Alpha machines
>  |         You might need to pass the --disable-shm flag to configure,
>  |         like ./configure --disable-shm
> 
>  is anyone having problems with WindowMaker on Alpha?  Can someone
>  please test this?  Should the flag be passed when building on Alpha?

Disclaimer: alphas under my command have never run X and are least likely to 
suddenly start running it anytime soon.

        Alpha used to have some ridiculously low amount of shared memory
configured. 
So quite a lot of apps used to barf. Namely - cdrecord, mysql server, etc.

        Check where is yours at the moment and raise it to a more appropriate
value by either catting to the appropriate /proc entry or changing the
/usr/src/linux/include/asm/shmparam.h.

        Otherwise the shared memory on alpha should be fully functional and I
see no reason to disable it. Mine are bumped up to 32 or more on most
machines.

        And If I recall correctly the comments in that file are actually
wrong. Value is not bytes, but in machine size word. For alpha *8.

        As I said - I do not run X on them so all #include "stdisclaimer.h"
apply.

-------------------------------------------------------------------------------

- SCO Unix - configure spusťte takto:
        CFLAGS="-belf -DANSICPP" ./configure

- SunOS, Solaris
        Když máte naistalovaný gcc, tak configure spusťte takto:
        CPP_PATH="gcc -E -x c" ./configure
        Preprocesoru cpp od Sunu chybějí některé vlastnosti, které Window Maker
        potřebuje, a to může způsobit problémy během parsování konfiguračních
        souborů. Je možné, že budete muset použít --with-libs-from a
        --with-incs-from k nahrazení adresáře s libtiff.
        Někdo doporučuje použít /usr/local/lib jako první cestu v LD_LIBRARY_PATH.

        Když máte Ultra Creator 3D nebo jinou high-end grafickou kartu, tak se
        ujistěte, že X server startuje s 24 bitovou barevnou hloubkou, jinak
        můžete mít problémy s pomícháním barev. Toto je chyba Window Makeru,
        která bude odstraněna.

- GNU/Linux obecně
        Ujistěte se, že soubor /etc/ld.so.conf obsahuje řádek "/usr/local/lib".
        Odinstalujte jakoukoliv starší verzi balíčku Window Makeru před instalací
        novější verze.
        Nezapomeňte spustit ldconfig po instalaci Window Makeru.

- RedHat GNU/Linux
        RedHat má několik obtěžujících chyb. Pokud ho používáte dodržujte několik
        následujících kroků, jinak vám Window Maker nebude fungovat.

        * pokud máte nainstalovaný Window Maker z distribuce RedHat, tak ho před
        upgradem odinstalujte

        * ujistěte se, že nemáte systémové proměnné LANG a LINGUAS nastavené
        na en_RN

        * ujistěte se, že vaše systémová proměnná PATH obsahuje položku
        /usr/local/bin

        * ujistěte se, že soubor /etc/ld.so.conf obsahuje řádek "/usr/local/lib"
        před tím, než spustíte ldconfig (na konci instalace)

        * pokud máte problémy, které se projevují chybovou hláškou, která
        obsahuje text --no-reexec, tak odinstalujte libtool-1.2b a nainstalujte
        si novější verzi libtool-1.3. libtool-1.3 můžete nalézt na adrese:
        ftp.gnu.org  .    Přečtěte si také odstavec ŘEŠENÍ PROBLÉMÚ.

        * pokud máte nainstalovaný balíček Window Maker od RedHatu a nyní
        instalujete novou verzi "ručně" (kompilováním zdrojových kódů), tak
        nejprve odinstalujte stávající balíček.

        * ujistěte se, že se na vašem systému nachází symbolický link z
        /usr/include/X11 na /usr/X11R6/include/X11. Pokud tomu tak není, tak
        na příkazovou řádku napište:

         ln -s /usr/X11R6/include/X11 /usr/include/X11

        * ujistěte se, že máte symbolický link /lib/cpp ukazující na cpp
        program

        Pokud pochybujete o nějakém z předcházejích kroků, tak neváhejte
        kontaktovat uživatelskou podporu distribuce RedHat. Oni vám laskavě
        zodpoví všechny vaše dotazy zohledňující váš systém. Oni vědí
        mnohem více o vašem (jejich) systému než my (my nepoužíváme
        RedHat).

- PowerPC MkLinux
        Budete potřebovat poslední verzi Xpma. Starší verze pravděpodobně 
        obsahují chybu, která způsobuje zamrznutí systému.

- Debian GNU/Linux
        Pokud chcete podporu JPEG a TIFF, tak se ujistěte, že máte nainstalovány
        balíčky libtiff-dev a libjpeg-dev.

- SuSE GNU/Linux
        Pokud máte již nainstalován baliček Window Maker od SuSE, tak ho
        odstraňte než se pustíte do kompilace Window Makeru. když tak
        neučiníte, budete mít problémy.

- MetroX (neznámá verze)
        Metrox obsahuje chybu, která zapřičiňuje, že obrázky, které jsou
        nastaveny jako pozadí, jsou poškozeny. Pokud používáte Metrox a
        máte podivné problémy s texturami, tak nepoužívejte textury v
        titulcích nebo používejte jiný X server.

INSTALACE
=========

Nejjednodušší způsob, jak nainstalovat Window Maker, je spustit skript
Install nebo Install.cs (ten s vámi komunikuje česky). Oba skripty
vás jednoduše provedou celou instalací.

        su
        Install.cs

Poznámka: tato metoda neposkytuje všechny možnosti konfigurace a pokud
          se setkáte s nějakými problémy, tak stejně budete muset
          použít následující způsob kompilace.

Kompilace Window Makeru
-----------------------
        Pro osvědčený způsob zadejte následující příkazy v shellu:

        ./configure
        make

pak se přihlašte jako root a zadejte:

        make install
        ldconfig

pokud nejste programátor a nebudete ladit Window Maker, tak se můžete zbavit
ladících symbolů v binárních souborech a zmenšit jejich velikost:

        make install-strip
        ldconfig

Takto zkompilujete a nainstalujete Window Maker se standartními parametry.

Pokud chcete upravit některé vlastnosti, tak musíte učinit následující:

        1. (volitelné) Podívejte se na část MOŽNOSTI KONFIGURACE, kde jsou
        uvedené možnosti konfigurace. Nebo spusťte:

        ./configure --help

        tak dostanete kompletní seznam všech dostupných možností konfigurace.

        2. Spusťte ./configure s možností, kterou jste si vybrali. Například,
        pokud chcete použít možnost --enable-kde, tak zadejte:

        ./configure --enable-kde

        3. (volitelné) Otevřete soubor ./src/wconfig.h vaším oblíbeným editorem
        a upravte některé možnosti, které si přejete změnit.

        4. Kompilace. Zadejte pouze:

        make

        5. Přihlaste se jako root (pokud tak nemůžetet učinit, tak si přečtěte
        část "Nemám rootovské helso :-(") a nainstalujte Window Maker na váš
        systém:

        su root
        make install

Nastavení specifické pro uživatele
----------------------------------

Tyto instrukce nejsou povinné, pokud upgradujete Window Maker ze starší
verze na novější a pokud není uvedeno jinak v souboru NEWS.

Každý uživatel na vašem systému, který si přeje používat Window Maker musí
udělat následující:

        1. Nainsatlovat konfigurační soubory Window Makeru do jeho domovského
        adresáře:

        wmaker.inst

        wmaker.inst nainstaluje konfigurační soubory a nastaví X server tak,
        aby automaticky spouštěl Window Maker při jejich spuštění.

        To je všechno, přátelé.

        Informace o konfiguraci a spoustě ostatních věcí vám poskytne:

        man wmaker

Pro hlubší úvod do Window Makeru si přečtěte Uživatelskou příručku (User Guide).

Měli byste se také podívat na FAQ (Frequently Asked Questions = často kladené 
otázky), pokud budete mít nějaké problémy/potíže jak při samotné kompilaci,
tak s užíváním Window Makeru.

Instalování speciálního balíčku
-------------------------------

Rozbalte WindowMaker-extra-<číslo_verze>.tar.gz v adresáři /usr/local/share

Tento soubor si můžete sehnat na adrese: ftp://ftp.windowmaker.org. Instalace
tohoto souboru vůbec není nutná. tento balíček obsahuje několik ikon a témat.
Hledejte poslední dostupnou verzi. V balíčku také naleznete soubor
WindowMaker-extra.readme, který vám poradí, co máte udělat.

Nemám rootovské helso :-(
-------------------------

Pokud nemáte superuživatelská privilegia (nemůžete se přihlásit jako root),
tak nezoufejte, protože můžete nainstalovat Window Maker do vašeho vlastního
domovského adresáře. K tomu musíte použít volbu --prefix při spuštění
./configure. Také musíte použít volbu --with-appspath, která specifikuje
cestu pro WPrefs.app.
Příklad:

./configure --prefix=/home/karel --with-appspath=/home/karel/GNUstep/Apps

Potom přidejte adresář /home/karel/bin do systémové proměnné PATH a adresář
/home/karel/lib do sytémové proměnné LD_LIBRARY_PATH a nakonec spusťte
~/bin/wmaker.inst.

Samozřejmě, že adresář /home/karel bude ve vašem případě nahrazen vaším
vlastním domovským adresářem.


UPGRADE
=======

Pokud upgradujete ze starší verze Window Makeru:

        1. Nakonfigurujte a zkompilujte Window Maker jako obvykle.
        2. Nainstalujte Window Maker (ale nespouštějte wmaker.inst).
        3. Přečtěte si soubor NEWS a aktualizujte vaše konfigurační soubory,
           pokud je to nezbytné.

ŘEŠENÍ PROBLÉMÚ
===============

Pokud máte nějaké problémy během konfigurace (když běží configure), jako
například neschopnost použít knihovnu grafického formátu, o kterém víte, že
ho máte nainstalován, tak se podívejte do souboru config.log. Možná zde
najdete příčinu svých problémů.

== Error with loading fonts, even if they exist.

Zkuste kompilaci bez podpory NLS (národního prostředí).

== Error when configuring

ltconfig: unrecognized option `--no-reexec'
Try `ltconfig --help' for more information.
configure: error: libtool configure failed

odstraňte volbu --no-reexec ze souboru aclocal.mc a spusťte znovu configure.
Také zkontrolujte, zda verze autoconfu a automaku, které máte nainsatlované
odpovídají níže uvedeným hodnotám:
autoconf 2.13
automake 1.4
libtool 1.3

Poznámka: nemůže to být libtool 1.2b, ale musí to být libtool 1.3 ze stránek
GNU.

== configure doesn't detect libtiff, or other graphic libraries.

Smažte soubor config.cache, pak znovu spusťte configure s následujícími
volbami (a jinými, které používáte):
--with-libs-from="-L/usr/local/lib"
--with-incs-from="-I/usr/local/include -I/usr/local/include/tiff"
Na příslušná místa vložte cesty k vaším grafickým knihovnám a odpovídajícím
hlavičkovým souborům. Můžete zadat několik cest do těchto voleb, jako je to
ve výše uvedeném příkladě --with-incs-from. Jenom je nezapomeňte oddělit
mezerou.

== configure doesn't detect libXpm.

* Zkontrolujte, jestli máte symbolický link ze souboru libXpm.so.4.9 na
  soubor libXpm.so

== Segmentation fault on startup

* Zkontrolujte, jestli verze knihovny libXPM je vyšší než 4.7

* Zkontrolujte, zda-li máte upravenou verzi ~/GNUstep/Defaults/WindowMaker
  Pokud si nejste jisti, tak zkuste přejmenovat ~/GNUstep na ~/GNUtmp a
  spusťte wmaker.inst

== "...: your machine is misconfigured. gethostname() returned (none)"

* Jméno vašeho počítače je nastaveno nesprávně, protože začíná uvozovkami.
  Spusťte man hostname a zde se dozvíte, jak změnit jméno vašeho počítače.

== The root menu contains only 2 entries. ("XTerm" and "Exit...")

* Window Maker nemůže nalézt cpp (preprocesor jazyka C). Pokud se váš cpp
  nenachází v /lib/cpp, tak otevřte soubor src/config.h a nastavte správně
  cestu CPP_PATH.

== checking lex output file root... configure: error: cannot find output from true; giving up

* Přečtěte si odstavec POŽADAVKY na začátku tohoto souboru.

MÍSTNÍ NASTAVENÍ / INTERNACIONALIZACE
=====================================

Window Maker má podporu národních jazyků. Aby jste ji povolili, tak
musíte zkompilovat Window Maker s několika dalšími parametry.
Seznam podporovaných jazyků naleznete v souboru ./po/README.

0 - Musíte mít nainstalovaný balíček GNU gettextu. Tento balíček
    můžete nalézt na ftp://prep.ai.mit.edu/pub/gnu/gettext-nnn.tar.gz

Kroky 1,2 a 3 můžete vynechat, pokud používáte skript Install.cs nebo
skript Install.

1 - Vyberte si jazyky, které budete chtít používat. Zadejte seznam
    těchto jazyků do systémové proměnné LINGUAS. Angličtina je
    podporována vždy. Příklady

    C - shell:

        setenv LINGUAS "pt ja de"

    Bash(sh):

        export LINGUAS
        LINGUAS="pt ja de"

    Přečtěte si soubor po/README pokud chcete přeložit Window Maker
    pro nějaký další jazyk.

2 - Navíc, pokud váš jazyk používá multi-byte znaky, například Japonština
    nebo Korejština, tak musíte nastavit volbu the MultiByteText na YES
    v souboru ~/GNUstep/Defaults/WMGLOBAL

3 - Nakonfigurujte, zkompilujte a nainstalujte Window Maker jako obvykle.

4 - Národní prostředí si můžete změnit i za běhu Window Makeru. Systémovou
    proměnnou LANG nastavíte na vámi zvolenou hodnotu. Například, pokud
    chcete použít portugalské prostředí, musíte spustit:

    C - shell:

        setenv LANG pt

    Bourne shell a podobné:

        export LANG
        LANG=pt

    Nakonec musíte restartovat/spustit Window Maker.

    Poznámka: Když máte nastavenou systémovou proměnnou LC_TYPE, tak jí
    musíte zrušit před spuštěním Window Makeru.

    Window Maker hledá soubory s definicí menu v tomto pořadí (pro
    brazilskou portugalštinu):

        menu.pt_BR
        menu.pt
        menu

5 - Pokud si vyberete jazyk, který používá multi-byte znaky, tak musíte
    příslušným způsobem nastavit fonty. Přečtěte si manuálové stránky
    o XCreateFontSet k získání většího množství informací o daném
    problému. Musíte změnit v souboru ~/GNUstep/Default/WindowMaker
    nastavení fontů pro titulky, menu, atd. Fonty pro dialogy nastavíte
    v souboru ~/GNUstep/Default/WMGLOBAL. Řetězce %d ve jménech fontů
    nemusí být odstraněné. Také můžete použít skript wsetfont, který
    toto vše učiní za vás. Pokud se ho rozhodnote použít, tak si k němu
    přečtěte instrukce tak, že spustíte wsetfont bez argumentů.

    Příklad části souboru ~/GNUstep/Default/WindowMaker:

        WindowTitleFont = "-*-helvetica-bold-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
        MenuTitleFont = "-*-helvetica-bold-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
        MenuTextFont = "-*-helvetica-medium-r-normal-*-12-*,-*-*-medium-r-normal-*-14-*";
        IconTitleFont = "-*-helvetica-medium-r-normal-*-8-*,-*-*-medium-r-normal-*-12-*";
        ClipTitleFont = "-*-helvetica-bold-r-normal-*-10-*,-*-*-medium-r-normal-*-12-*";
        DisplayFont = "-*-helvetica-medium-r-normal-*-12-*,-*-*-medium-r-normal-*-12-*";

    a souboru ~/GNUstep/Default/WMGLOBAL:

        SystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";
        BoldSystemFont = "-*-*-medium-r-normal-*-%d-*-*-*-*-*-*-*";

    Tyto dva fonty jsou používány v aplikacích, které používají WINGs (WindowMaker a
    WPrefs.app).

    Skript wsetfont vám umožní nastavit fonty mnohem jednoduším způsobem. Podívejte
    se na jeho manuálové stránku k získání bližších informací.