                   _   __   ______    ___    ___   ______
                  | | / /  / _____|  |   \  /   | |  ___ \
                  | |/ /  | |   ___  | |\ \/ /| | | |   | |
                  |   <   | |  |_  | | | \__/ | | | |   | |
                  | |\ \  | |____| | | |      | | | |___| |
                  |_| \_\  \______/  |_|      |_| |______/

                     Knarf s German MiNT distribution

                           version 1.0-RELEASE

                              16. Juillet 1995

                    Frank Bartels (knarf@nasim.cube.net)


                    Traduction Francaise(approximative) : Lupin - Aout 1996
                    contact: -Email: Thierry  jmpatat@asi.fr
                             -Minitel: Lupin sur TEASER
                                       Lupin69 sur RTEL
                    Remarques: les phrases que je n'ai pu traduire sont
                               entoures par 3 ?.

apperu:

0. Remarque inportante
1. qu'est ce que KGMD?
2. pourquoi KGMD?
3. de quel quipement avez-vous besoin ?
4. que faire avant l'installation?
5. Observations  respecter aprs l'installation
6. Faire des modifications sur la distribution.

0. Remarque importante

   Si vous projetez d'installer KGMD, vous devez ABSOLUMENT lire ce texte
   en ENTIER avant de faire quoi que ce soit.

1. qu'est ce que KGMD?

   KGMD est la distribution MINT allemande Knarf. Avec cette
   distribution, tout utilisateur Atari devrait pouvoir installer
   un MINT multi-tache propre.
   Le multi-tache sera aussi parfait que possible, et aprs
   l'installation chacun devrait se sentir comme sur une vraie machine UNIX.

   Une des rgles de cette distribution est:
   Pas de fichiers binaires sans le fichier source correspondant.
   Pour chaque binaire sont disponibles les diffs.
   Chacun a donc, par principe, la possibilit de reproduire le binaire
    100%. Pour certains cela ne parait pas trs important ("sous TOS je
   n'ai pas non plus de sources?"), d'autres y attachent beaucoup
   d'importance.

   Les programmes dont les sources ne sont pas librement disponibles
   ne sont pas dans cette distributions.

2. pourquoi KGMD?

   KGMD a t cr, parce que toujours plus d'utilisateurs s'interressent
    MINT, mais la documentation est relativement insuffisante. Beaucoup
   d'utilisateurs ont aussi des problmes avec la langue anglaise.
   A l'utilisation cela ne demande pas beaucoup, mais un programme
   d'installation dans sa langue maternelle est plus pratique.
   Les programmes demeurent comprhensibles en anglais, cela ne donne rien
   de pire qu'un systme d'exploitation en allemand
   (Alle Speicher gespuelt(Novell),Alle Dateien nicht loeschen? N/J (MS-DOS),
   Meinen Sie '='oder'=='? (SINIX C-Compiler), Kellerspeicher ueberflutet, ...).

   A travers la documentation insuffisante, beaucoup ont chou 
   l'installation de ce Compilateur. Sans elle on ne peut pas travailler
   sous MiNT.
   ???Es wird eben meistens davon ausgegangen, dass man sich bereits mit UNIX
   beschaeftigt hat. Letzteres ist natuerlich auch bei dieser Distribution von grossem
   Vorteil, aber es ist nicht Bedingung.???
   De meme, c'est pour beaucoup un travail difficile, avec les nombreux
   fichiers qui sont ncessaires pour une installation complte, de garder une
   vue d'ensemble.
   Seuls quelques rares ftp anonymes mettent  disposition de l'utilisateur
   interress tous les fichiers ncessaires. Les MailBox n'ont souvent pas
   la capacit ncessaire pour de telles donnes  distribuer.
   De meme dans la plupart des MailBox les fichiers ont leur nom sous la
   forme 8+3, ce qui occasionne souvent une perte d'information.

3. de quel quipement avez-vous besoin ?

   Il est toujours dur de rpondre  une telle question. En principe,
   MiNT est naturellement capable de tourner sur tous les ordinateurs Atari.
   En pratique, pour pouvoir travailler raisonnablement avec KGMD, la 
   configuration suivante est ncessaire:

   - 4 Mo Ram
   - une partition libre du disque dur, dont la taille aprs l'installation
     de KGMD doit laisser au moins 10Mo de libre pour travailler.
     Les diffrentes parties du kit occupent, aprs installation, les
     tailles suivantes:

     - Basic   12 Mo
     - Compiler 7 Mo
     - Manual   6 Mo
     - Net      4 Mo
     - X11     14 Mo

   La vitesse de l'ordinateur joue naturellement un role essentiel.
   Nammoins, MINT est acceptable sur un ST  8MHz. Certains se
   plaindront chez eux d'une certaine lenteur de compilation,
   ???aber fast keine Anwendung verlaesst sich auf eine bestimmte
   Rechnergeschwindigkeit. Lediglich die Ansteuerung der seriellen
   Schnittstelle(n) birgt auf langsamen Rechnern Probleme.???

4. que faire avant l'installation?

   - d'abord une partition suffisament grosse doit etre libre
     pour que la distribution puisse y etre installe. Cette Partition
     doit etre une partition gemdos pour marcher, donc la lettre
     correspondante du lecteur doit apparaitre sur le bureau.
     Pendant l'installation, cette partition sera convertie en
     une partition Minix, ce qui veut dire que toutes les donnes
     de cette partition seront perdues.

   - Les paquets individuels de la distribution (basic, manual,
     compiler, net et x11) seront copis dans n'importe quel
     rpertoire du disque dur. SVP notez ce de chemin, il vous
     sera demand pendant l'installation.
     
     Ces grosses archives portent des noms comme basic.aa, basic.ab, etc..
     Ils seront automatiquement rassembls pendant l'installation.
     Pour un travail minimal, seule l'archive basic est ncessaire.
     Les packages installs seront seulement ceux prsent dans le
     rpertoire que vous indiquerez. Ainsi, si vous ne voulez pas certaines
     parties de la distribution, ne les mettez pas dans le rpertoire.

   - Copiez le contenu de l'archive `instflpy.zoo'  sur une disquette
     vide, si vous n'avez encore aucune disquette de boot(minimint).
     Vous pouvez galement copier le contenu de cette archive dans un
     rpertoire du disque dur.
     Vrifiez bien que cette partition du disque dur ne contienne aucun
     fichier avec un nom tel que *.XDD dans le rpertoire
     `<lecteur>:\', `<lecteur>:\MINT\' et `<lecteur>:\MULTITOS!
     Sinon ces drivers seront chargs pendant l'installation
     ce qui peut donner des rsulats imprvus(et genant).

   - Dmarrez de nouveau votre ordinateur en dsactivant tous les
     programmes additionnels du dossiers AUTO ainsi que les accessoires.
     Seul le driver du disque dur est ncessaire. Un selecteur de Boot peut
     s'en occuper.

   - Depuis le bureau, lancez maintenant KGMDINST.TOS de votre disquette de boot
     ou de votre rpertoire d'installation, fichier cr au dcompactage de
     instflpy.zoo.  Un Ramdisk dynamique est automatiquement cr,
     sur lequel seront copis les utilitaires ncessaires  l'installation.
     Le script d'installation s'occupe de toute l'installation, vous aurez
     seulement  rpondre  quelques questions.
     A la Fin de l'installation vous vous trouverez sous un shell qui vous
     permettra de faire la dernire partie de l'installation.

   - Sur la nouvelle partition Minix cre, se trouve un rpertoire
     portant le nom `boot'. Il y a aussi 2 rpertoires 'auto' et 'multitos'.
     Dans le rpertoire `auto se trouve 2 noyaux MINT:
     `mint.prg` et `mint030.prg.
     Copiez un des 2 noyaux dans votre dossier 'auto'.
     Si vous utilisez un FALCON ou un TT, prenez 'MINT030.Prg'
     sinon prenez 'MINT.Prg'.
     Donnez au noyau MINT dans le dossier 'auto' un nom parlant, par exemple
     `mintkgmd.prg'.

     En supposant que vous ayez un TT et que la Partition `f' soit
     la Partition Minix installe, tapez les commandes suivantes:

     # cd /f/boot/auto
     # cp mint030.prg /c/auto/mintkgmd.prg

     Maintenant, allez dans le rpertoire `multitos'. De ce rpertoire vous
     copierez le programme `init.prg', le driver `minix.xfs  et
     le fichier de configuration `mintkgmd.cnf` dans /usr/multitos (un
     lien symbolique sur le rpertoire Multitos du lecteur de boot).
     Les autres fichiers ne sont pas ncessaires pour le moment.

     # cd /f/boot/multitos
     # cp init.prg minix.xfs mintkgmd.cnf /usr/multitos


     Vrifiez bien que sur le lecteur de boot (habituellement C:)
     ne se trouve aucun rpertoire 'mint', et qu' la racine de C: il
     n'y ait aucun fichier comme 'mint.cnf', '*.xfs' ou '*.xdd'.

     Vous devrier installer un slecteur de boot(par ex:XBOOT), et
     maintenant vous pouvez rebooter. Crez une nouvelle configuration
     avec le slecteur de boot (le nom 'KGMD' est idal).
     Incluez le programme du dossier auto `mintkgmd.prg'.
     Je vous conseille aussi le programme HSMODEM qui devra etre lanc
     *avant* MiNT. Tout les autres programmes du dossier AUTO, dans cette
     nouvelle configuration, ne sont pas perdu.
     Vrifiez bien que le fichier 'mintkgmd.cnf' a bien t copi sous
     le nom 'mint.cnf'.

     Si vous n'utilisez pas de slecteur de boot, copiez uniquement
     le fichier `mintkgmd.cnf' dans /usr/multitos sous le nom 'mint.cnf':

     # cd /usr/multitos
     # cp mintkgmd.cnf mint.cnf

     Activez, si ncessaire, HSMODEM dans le dossier auto:

     # cd /c/auto
     # mv drvin.prx drvin.prg
     # mv mfp.prx mfp.prg
     # [etc...]

     Remarquez bien que, dans le dossier AUTO, les programmes placs
     physiquement aprs `mintkgmd.prg' ne seront pas lancs .
     Cette fonctionnalit est normale et voulue. Les possesseurs de
     Falcon voulant utiliser BlowUp devront renommer 'Mintkgmd.prg' en
     'mint.prg' ou en 'mintnp.prg'.

     Aprs le Reboot, vous ne devez pas etre inquiet de voir un rapport
     de boot suivi d'un Login-Prompt. Rappelez-vous, a la fin du programme
     d'installation, que vous avez tap pour 'root' et 'utilisateur normal'
     un mot de passe pour chacun d'eux.
     Foullez un peu dans l'arborescence des rpertoire, lisez les conseils
     dans /usr/src/KGMD et vous apprendrez  connaitre ce nouveau systme
     d'exploitation.
     Essayez les combinaisons de touches ALT-F1  ALT-F10 et jetez un oeil
     dans le rpertoire /etc/ttytab.
     Ressayez le boot prcdent pour comprendre, aprs avoir inspect les
     fichiers usr/multitos/mintkgmd.cnf et /etc/rc*.
     Copiez, si ncessaire, de nouveau drivers du rpertoire 'boot' de votre
     partition Minix vers votre lecteur de boot.
     Observez bien les fichiers /etc/*.sample et configurez les pour des
     conditions locals, en particulier le fichier /etc/fstab.

5. Observations  respecter aprs l'installation

   Voici quelques point  considrer. Tout d'abord, quelques ides recues
   vont etre dtruites. Bien que cela semble dur  entendre, elles sont
   simples:

   - Le GEM coute de la mmoire, du temps machine et rend le Systme
     instable. Le GEM sera seulement lanc quand vous en aurez besoin.
     Pour Multitos, cela est aussi valable.
     Les 2 programmes ne pourront etres arrets, 'aprs' le Gem, il faudra
     rebooter.

   - La souris sera mise de cot. Nous apprendrons, avec un diteur de texte
     ???umzugehen??? qui semble d'abord compliqu, mais qui devient pratique
     et rapide aprs un peu de temps pass, au point de se demander si on ne
     va pas vendre sa souris.

   - Les lettres de lecteur et les Backslashes(\) dans les noms de chemins
     sont absolument tabou. On travaillera toujours sur le lecteur u:.

   - ???Abenteuerliche Konstrukte aus der DOSen Welt, wie etwa *.* sind
     schlicht und ergreifend aus dem Gedaechtnis zu streichen.
     Wildcards und Regular Expressions funktionieren nach Regeln,
     nicht nach Mondstand. Merke: *.* passt auf READ.ME, nicht aber
     auf README.???

   - On aura comme fin de ligne LF au lieu de l'habituel CRLF sur Atari.

   - ???Der zu verwendende Zeichensatz ist ISO-8859-1. Die Virtuellen
     Consolen stellen diesen Zeichensatz zur Verfuegung. Eine
     Codierung nach irgendeiner aus der Luft gegriffenen,
     modifizierten IBM Codepage ist nicht erwuenscht.???

   - Dans tous les cas, la compression de fichier sera une combinaison
     de l'utilisation detar et gzip, ce sont l les seules possibilits
     permises et sures pour travailler.
     En cas d'urgence, on peut aussi utiliser ZOO, mais les autres
     compacteurs (STZIP ou LHARC) sont absolument impropres (NdT:  cause
     des noms de fichiers long respectant les masjuscules/miniscules).

   - Ne travaillez comme root que si c'est absolument ncessaire.
     Utilisez  `su'  au lieu de vous logger comme root. Vous viterez
     ainsi de gros accidents.

6. Faire des modifications sur la distribution:

  -  Pour installer vos propres programmes sur la partition Minix, utilisez
     l'arborescence de rpertoire dans /usr/local!

   - Ne faites des changements sur les fichiers installs que si vous
     savez exactement ce que vous faites. Notez absolument tous les
     changements effectus.

   - Notez les changements des fichiers de configurations sous /etc.

   - Si vous respectez ces rgles, vous n'aurez aucune difficult pour
     installez les futures version. Ne faites de changement que dans /home
     et /usr/local et seulement si ncessaire.
     Quelques fichier sous /etc et /var sont  sauvegarder, ce qui vous
     permettra de vous entrainer aprs une nouvelle installation.

Amusez vous bien!!
