[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [MiNT] 1-18 release - userfriendliness



On 12/14/12 13:54, Jo Even Skarstein wrote:
Now that 1-18 is about to be released I think it's time do discuss how to make the releases more user-friendly and easier to install/upgrade. This is still an issue for the less experienced users, 20 years after MultiTOS.

There are several issues that needs to be addressed:

1. The docs are a mess. 20 years of notes tossed in a couple of directories.
2. The release archive is quite messy too, with all possible variants of the binaries in the same directories.
3. Setting up a network with MiNT is actually very simple, but there are no docs explaining how.
4. How do you transfer MiNT to an Atari with no networking? The archive doesn't fit on a floppy.

A few weeks ago I made a simple FreeMiNT-setup for the Falcon/TT after a discussion on Atari-forum (see thread here: http://atari-forum.com/viewtopic.php?f=27&t=24218). This discussion pretty much sums up the typical problems you face when you start to familiarize yourself with MiNT. I posted some brief instructions on how to install MiNT from scratch, and realized that most of the things the new user has to do could easily be skipped with a slightly better distribution.

You can see the result here: http://atari.nvg.org/VanillaMiNT/. About 15 people has installed this on their Falcon/TT with very few problems. It does contain some stuff that's not part of FreeMiNT itself (Teradesk and DHCP client) but I think the principle works fine. I suggest that the build-process should end up with something similar - a zip archive that is easily transferred with floppies and installed simply by extracting them.

If there's any interest my crude network configuration utility could be included as well.


Hi Jo Even,

Nice work.

1. I'm open to documentation updates and re-organization of them, so if there's any ideas on moving stuff around let me know. 2. Yes, this is partly what I want to fix in 1.19 where we'll only have one specific build type and multiple tarballs (or zips). Things like mint000.zip which contains everything for a 68000 processor, or mint030.zip for basic TT's and Falcon's, and so on. 3. I think I remember seeing WongCK's got something here on a web page, but maybe we can put it into a text document. 4. Indeed. Part of 2. should fix that, but I see your VanillaMINT has done it to two floppies.

Attached is what I do for the current release archive. If you want to make updates to that, and post it back to the list I can integrate things.

Alan.


#!/bin/sh
DESTDIR=$DEST/mint/$MINTVER
AUTODIR=$DEST/auto
DOCDIR=$DEST/doc
XIFDIR=$DEST/driver/xif
XFSDIR=$DEST/driver/xfs
XDDDIR=$DEST/driver/xdd
FONTDIR=$DEST/fonts
TOOLSDIR=$DEST/tools
USBDIR=$DEST/usb
mkdir -p $DESTDIR $AUTODIR $XIFDIR $DOCDIR $XFSDIR $XDDDIR $USBDIR

if [ "$MINTVER" == "1-17-0" ]; then
	cp doc/readme.1.17.0 $DESTDIR/README.1-17-0
fi
cp doc/examples/mint.cnf $DESTDIR
cp COPYING COPYING.GPL COPYING.LGPL COPYING.MiNT $DEST

# DOCS
cp -R doc/* $DOCDIR
find $DOCDIR -name CVS -print | xargs rm -rf

cp ./sys/xfs/aranym/README $XFSDIR/aranym.txt
cp ./sys/xfs/hostfs/README $XFSDIR/hostfs.txt
cp ./sys/xfs/ext2fs/Readme $XFSDIR/ext2.txt
cp ./sys/xfs/minixfs/README $XFSDIR/minix.txt
cp ./sys/xfs/nfs/README	$XFSDIR/nfs.txt
cp ./sys/xdd/audio/README $XDDDIR/audiodev.txt
cp ./sys/xdd/dsp56k/README_MiNT $XDDDIR/dsp56k.txt
cp ./sys/xdd/flop-raw/README $XDDDIR/flop_raw.txt
cp ./sys/xdd/mfp/README $XDDDIR/mfp.txt
cp ./sys/xdd/mfp/ports.txt $XDDDIR/ports.txt
cp ./sys/xdd/nfstderr/README $XDDDIR/nfstderr.txt
cp ./sys/xdd/scc/README $XDDDIR/scc.txt
cp ./sys/xdd/uart/README $XDDDIR/uart.txt
cp ./sys/xdd/xconout2/README $XDDDIR/xconout2.txt
cp ./sys/sockets/README $XDDDIR/inet4.txt
cp ./sys/sockets/xif/daynaport/README $XIFDIR/scsilink.txt
cp ./sys/sockets/xif/ethernat/README $XIFDIR/ethernat.txt
cp ./sys/sockets/xif/nfeth/README $XIFDIR/nfeth.txt
cp ./sys/sockets/xif/BIODMA.txt $XIFDIR/biodma.txt
cp ./sys/sockets/xif/DE600.txt $XIFDIR/de600.txt
cp ./sys/sockets/xif/DIAL.txt $XIFDIR/dial.txt
cp ./sys/sockets/xif/LANCE.txt $XIFDIR/lance.txt
cp ./sys/sockets/xif/PAMs_DMA.txt $XIFDIR/pamsdma.txt
cp ./sys/sockets/xif/PLIP.txt $XIFDIR/plip.txt
cp ./sys/sockets/xif/SLIP.txt $XIFDIR/slip.txt
cp ./sys/sockets/xif/PPP.txt $XIFDIR/ppp.txt

# usb
cp ./sys/usb/src.km/loader/loader.prg $USBDIR 
cp ./sys/usb/src.km/.compile*/usb*.km $USBDIR
cp ./sys/usb/src.km/ucd/*/*.ucd $USBDIR
cp ./sys/usb/src.km/udd/*/*.udd $USBDIR

# XFS
cp sys/xfs/*/*.xfs $XFSDIR
rm -f $XFSDIR/Makefile*

# XDD
cp sys/xdd/*/*.xdd $XDDDIR
cp sys/sockets/*.xdd $XDDDIR

# AUTO
cp sys/.compile*/*.prg $AUTODIR

cp sys/sockets/xif/*.xif $XIFDIR
cp sys/sockets/xif/*/*.xif $XIFDIR

mkdir -p $DEST/keyboard
cp sys/tbl/*/*tbl $DEST/keyboard

mkdir -p $DESTDIR/xaaes/widgets
mkdir -p $DESTDIR/xaaes/xobj
mkdir -p $DESTDIR/xaaes/img/{8b,hc}
mkdir -p $DESTDIR/xaaes/gradient
mkdir -p $DESTDIR/xaaes/pal

cp xaaes/src.km/*.km $DESTDIR/xaaes
cp xaaes/src.km/{*.cnf,*.rsc,*.rsm,*.rsl,*.txt,xa_help.*,xaaes.cnf,xaloader/xaloader.prg} $DESTDIR/xaaes
cp xaaes/src.km/adi/whlmoose/*.adi $DESTDIR/xaaes
#cp xaaes/src.km/widgets/{*.hrd,*.rsc} $DESTDIR/xaaes/widgets
#cp xaaes/src.km/xobj/{*.hrd,*.rsc} $DESTDIR/xaaes/xobj
cp xaaes/src.km/widgets/*.rsc $DESTDIR/xaaes/widgets
cp xaaes/src.km/xobj/*.rsc $DESTDIR/xaaes/xobj
cp xaaes/src.km/img/8b/*.img $DESTDIR/xaaes/img/8b
cp xaaes/src.km/img/hc/*.img $DESTDIR/xaaes/img/hc
cp xaaes/src.km/gradient/*.grd $DESTDIR/xaaes/gradient
cp xaaes/src.km/pal/*.pal $DESTDIR/xaaes/pal

# fonts
mkdir -p $FONTDIR/{cs,ru}
cp fonts/cs/*.fnt $FONTDIR/cs
cp fonts/ru/*.fnt $FONTDIR/ru

# ozk
#cp xaaes/src.km/xad/whlmoose/*.xad $DESTDIR/xaaes
#cp xaaes/src.km/xam/rezchg/src/{*.xam,*.rsc} $DESTDIR/xaaes

# TOOLS
#mkdir -p $TOOLSDIR/cops
#cp tools/cops/*.app $TOOLSDIR/cops
#cp -R tools/cops/rsc/* $TOOLSDIR/cops/
#find $TOOLSDIR -name CVS -print | xargs rm -rf

# FSETTER
mkdir -p $TOOLSDIR/fsetter
cp tools/fsetter/{*.app,*.rsc} $TOOLSDIR/fsetter

# GLUESTIK
mkdir -p $TOOLSDIR/gluestik
cp tools/gluestik/*.prg $TOOLSDIR/gluestik

# LPFLUSH
mkdir -p $TOOLSDIR/lpflush
cp tools/lpflush/lpflush $TOOLSDIR/lpflush

# MGW
mkdir -p $TOOLSDIR/mgw/examples
cp tools/mgw/*prg $TOOLSDIR/mgw/
cp tools/mgw/examples/* $TOOLSDIR/mgw/examples/

# MKFATFS
mkdir -p $TOOLSDIR/mkfatfs
cp tools/mkfatfs/mkfatfs $TOOLSDIR/mkfatfs

# SYSCTL
mkdir -p $TOOLSDIR/sysctl
cp tools/sysctl/sysctl $TOOLSDIR/sysctl

# TOSWIN2
mkdir -p $TOOLSDIR/toswin2
cp tools/toswin2/{BUGS,FAQ,NEWS,README.terminfo,toswin2.app,toswin2.rsc,tw-call/tw-call.app,twterm.src} $TOOLSDIR/toswin2/
mkdir -p $TOOLSDIR/toswin2/english
cp tools/toswin2/english/* $TOOLSDIR/toswin2/english

# MKTBL
mkdir -p $TOOLSDIR/mktbl
cp tools/mktbl/mktbl $TOOLSDIR/mktbl/

m68k-atari-mint-strip $AUTODIR/*.prg
m68k-atari-mint-strip $DESTDIR/*
m68k-atari-mint-strip $XIFDIR/*
m68k-atari-mint-strip $XDDDIR/*
m68k-atari-mint-strip $XFSDIR/*
m68k-atari-mint-strip $DESTDIR/xaaes/*
find $TOOLSDIR -name *.app -print | xargs m68k-atari-mint-strip