==== notes for debian on ppc hardware ====

(specifically a lombard powerbook (aka 1999,bronze keyboard), which generates most of these question/answer routines)
NOTE: this "works for me". it might, or might not work for you. these are assembled as notes, and assume some familiarity with both debian, and the hardware, its not really a step by step guide or install manual. 

As of 2007 most of this no longer neccesary esp. if using a distro like ubuntu

==== references /docs ====
  * the debian install manual http://www.debian.org/releases/stable/installmanual
  * boot images, instructions http://debian-imac.sourceforge.net
should import the old debian on lombard pages (now disapeared)

==== kernels ====

build + install -> [[kernel_notes]]


==== wireless ====
  * tested with d-link dwl650
  * http://linux-wlan.org prism2_cs driver, and benh's 2.4.20 kernel
  * enable 'wireless LAN (non hamradio)' in network device support, and 'PCMCIA/Cardbus support' in 'General setup'
  * host-ap drivers >> for running the machine as an access point. http://hostap.epitest.fi/
  * access point utils _> http://ap-utils.polesye.net/ (the dlink dwl1000-ap uses ap-nwn)
  * how about airport / hermes?


==== audio ====
  * add users to group 'audio' or make /dev/dsp world readable
  * OSS (Open Sound System)
  * kernel options; enable sound, DMA support, OSS, persistent DMA buffers. (compiled in, not as modules)
  * ALSA (Advanced Linux Sound Architecture)
  * not yet.
  * HOWTO -> http://www.linuxorbit.com/modules.php?op=modload&name=Sections&file=index&req=printpage&artid=541

==== MOL (mac on linux) ====
for all those os9 'legacy' applications that havent been ported to OsX, or GNU/Linux yet.,...
  * see KernelNotes for building + install the modules
  * su -c "startmol -a"
  * see config for sartup disk + permissions
  * USB device handling?
	
==== german kezboard ====
there is quite an amount of accurate, inaccurate and dangerously misleading info about settin up keymaps in console + Xfree86. this will add to the noise.

==== XFree86 ====
  * mouse 3button emulation
  * modify /etc/sysctl.conf to allow the f11 and f12 keys to correspond to centre + right mouse buttons.
<code>
# Enable mouse button emulation
dev.mac_hid.mouse_button_emulation = 1
dev.mac_hid.mouse_button2_keycode = 87
dev.mac_hid.mouse_button3_keycode = 88
</code>

  * usefull commands
    * 'xhost +' to enable all connections to host (ie. disable security!)
  * hardware acceleration
    * ati mach64
    * see notes on getting DRI working for accelerated OpenGL  http://www.geekounet.org/powerbook/driplusxv.html
  * keyboard
  * to get the modifiers working (required for: @|~}{}[],etc)
	
<code>
cat <<EOF |xmodmap -
clear mod1
keycode 64 = Mode_switch
keycode 113 = Alt_L
clear mod4
add mod1 = Meta_L
EOF
</code>

or...

1. change XF86config-4 to look like this for keyboard:

<code>
Section "InputDevice"
        Identifier      "Generic Keyboard"
        Driver          "keyboard"
        Option          "CoreKeyboard"
        Option          "LeftAlt"       "Meta"
        Option          "RightAlt"      "Meta"
        Option          "ScrollLock"    "Compose"
        Option          "RightCtl"      "Control"
        Option          "XkbRules"      "xfree86"
        # We don't use macintosh!
        # Option        "XkbModel"      "macintosh"
        # German Layout ("de")
        Option          "XkbLayout"     "de"
        Option          "XkbVariant"    "nodeadkeys"
EndSection
</code>

2. change your /etc/X11/xkb/keycodes/xfree86 to look
like this: 

<code>
    // Map Applekey to AltGr
    //  = 113;
     = 115;

    // we dont need those on Apples
    // Microsoft keyboard extra keys
    //  = 115;
    //  = 116;
    // 
    = 117;

    // Use Keypad-Enter as Delete-Key
    // This is the key left of cursor-left
    //  = 107;
     = 108;
    
    //  = 108;
     = 107;

</code> 

3. Restart your X-Server ... et voila! This worked straight away 
on my X11 server. With this you don't need any xmodmap lines.


==== PPC java ====
since we are using a g3 mac laptop as the dedicated [[reprap]] machine, this page will contain some rants about dealing with the ppc peculiarity. first up, java. the [[https://help.ubuntu.com/community/Java|ubuntu java]] page suggests using the IBM jdk. Hint: the package you want to install (after adding the medibuntu repository and key) is ''ibm-j2sdk1.5''.

you also need the following packages (further details may ba found at http://packages.ubuntu.com/)
  * libstdc++5 (which is missing from the IBM jdk requirements)
  * ant-optional (for javah task)
  * libx11-dev (and all its dependencies)
  * mesa-common-dev (for glext.h)

the java3d source
  * register at https://java3d.dev.java.net/ and follow the instructions for checkingout vecmath, j3d-core and j3d-core-utils.
  * run ant in vecmath, then j3d-core directories
 
note that the java3d source packages are called ''j3d-*'', don't confuse this with the j3d.org site and it's utility libraries. one of which you also need.