diff --git a/Slint.md b/Slint.md new file mode 100644 index 0000000..e069327 --- /dev/null +++ b/Slint.md @@ -0,0 +1,210 @@ +## Preamble + +I'll prefix commands exicuted in the console as normal user with a dollar sign and those needing super user with a hash +mark, or number sine. +After console commands press enter. +For example: + + $ mkdir fubar +means that as normal user you'll type mkdir and press enter, which makes the fubar directory. + +Hopefully that should be obvious, but there it is. So here we go. + + +## Multilib + +First get the multi-lib stuff. In a console, in the user's home directory, and as normal user make a directory called alien. + + $ mkdir alien + $ cd alien + $ wget http://tty1.uk/scripts/slackware/alien-multilib-rsync.sh +$ chmod 755 alien-multilib-rsync.sh + + +Running the script requires super user access. The su command gives your normal user root access, and after typing it will require your root password. Notice the hash mark that now appears in your prompt to replace the dollar sign. + + $ su + +And to run it: + + # ./alien-multilib-rsync.sh + +When it's done downloading and installing the multi-lib compatible stuff, you'll be returned to the command prompt. It's always a good idea to exit the super user access when you don't need it, as normal user access is not likely to allow you to break your system without trying to. + + # exit + +To exit this directory and return to your home directory: + + $ cd + + +## Blacklisting Packages + +Blacklist the following in /etc/slapt-get/slapt-getrc by simulating an upgrade. CAUTION: you do not want to answer yes to the question to continue, you're only doing this to see what packages you're going to blacklist so say no after taking note of the packages that are to be upgraded. From the home directory and as normal user do the following: + + $ su + # slapt-get -upgrade + +Again, after taking note of the eleven packages that are listed to be upgraded, say no and be returned to the prompt. + + # cd /etc/slapt-get + +I'm going to choose Nano as the editor since I use it and hey, I'm holding the big bad-ass black sword, so there... hahhahahahaha! Using your favorite editor go into the slapt-getrc and look for the line that says: + + EXCLUDE= + + +In Nano you can just arrow down or use control plus w for the where is command and type in all capital letters EXCLUDE and press enter and be taken to the line you need to modify. There will be some stuff there, so go to the end of it. Add an entry for each of the eleven packages of which you took note on this line, with a control char (shifted 6) before and a comma to separate. The line should look like this: + + EXCLUDE=^devs,^kernel-huge-*,-i?86-,^zzz-settings,^gcc,^gcc-g++,^gcc-gfortran,^gcc-gnat,^gcc-go,^gcc-java,^gcc-objc,^glibc,^glibc-i18n,^glibc-profile,^glibc-solibs + +Save and exit the file. In Nano you use the control plus x key combination, press y to save, and press enter to accept the suggested file name. You'll be returned to the command prompt. + +Now you can upgrade without undoing your multi-lib install. This does mean, however that you'll need to run the script in your aliend directory if there are major upgrades as Slapt-get will no longer handle them. + +exit the root: + + # exit + + +## Audiogame-manager Dependencies + +I am assuming you already have Audiogame-Manager, so we're going to use it to see what your system does and doesn't have for it's successful exicution. Yes yes, I know, a hatchet would come in handy right about now, and you really should have one around the house somewhere ya know? 'cause when it comes to exicutions... + +Go to the directory where you have Audiogame-Manager and type: + + $ ./audiogame-manager -c + +You should get a checklist of everything that Audiogame-Manager needs, and whether the dependencies have been met. Take note of the ones you don't have, but we'll save WINE and Winetricks for last. Return to the root of the home directory and do the following: + + $ su + # sbopkg + +A nice menu comes up and you'll want to choose the first option, which is to sync with the repository, and when that's done, arrow down to the search option, press enter on that, and type the name of one of the packages other then WINE, or Winetricks. You'llsee if, for example you type: + + xclip + +that there are results for that, so arrow to the first match and press enter. You'll see that it isn't installed, and that there are several options. Go to the bottom option which is to download build, and install and press enter. + +On the next menu go down to the bottom option and again press enter. You'll be told that the package has been added to the cue, so press enter again, and the process will begin. When done, press enter again, and navigate back up the menus with escape until you're at the main menu. + +Repeat the process for all the other packages you may need. You'll find that you have most of them and Sbopkg will have the ones you don't have by default. When done installing what Audiogame-manager needs, again, excluding for now WINE and Winetricks,just press escape until the program exits. +Once the dependencies minus WINE and Winetricks are installed, there will still be a couple of things to do, so just press escape until Sbopkg completes the last install. + + +## Wine and Winetricks + +Now we have to edit a file and add some text to it so that we can help to minimize the text that the Mate Terminal will spew out when WINE starts. from your home directory you'll get root access again: + + $ su + +now we're going to edit a file, and, like the alien-multilib-rsync.sh file we downloaded before, we'll make sure it's executible. So type: + + # nano /etc/rc.d/rc.local + +At the bottom of the file, add the following: + + sysctl vm.mmap_min_addr=4096 + +Save and exit the file. Next, type the following: + + # chmod 755 /etc/rc.d/rc.local + +and you're returned to your root prompt. We want to return to normal user status so type: + + # exit + +Next we have to do a little more to suppress some of WINE's barfiness by downgrading a package that complains a lot and will slow WINE to a crawl as far as installing and starting games. Slint shipts with Fontconfig 2.1.13, but we have to go to the Slackware ftp site and get the earlier 32-bit package. We'll use wget to do it in one go. From your home directory as normal user do the following: + + $ cd Downloads + +Notice the capital d in downloads. Now type: + + $ wget ftp://ftp.slackware.com/pub/slackware/slackware-14.2/slackware/x/fontconfig-2.11.1-i486-2.txz + +Once the package is downloaded do the following as root: + + $ su + # installpkg fontconfig-2.11.1-i486-2.txz + +This will install this version of the package over the other one. It's version is 2.1.11, and it shouldn't be messed with by upgrading as it wasn't installed with Slapt-get, but if it ever is, just keep this one handy and reinstall if necessary. + + +I like to do things from my home directory as a reference, but if you've followed along, you're in your Downloads directory, and as root, so from here: + + # exit + $ cd + +Remember Sbopkg? well we're going to return there but first we have to add a line to a file, so that when the editor comes up during the next thing we're going to do, it'll be Nano, unless you like VI, which is the default one with Slint and indeed with Slackware. i use Nano so we'll make that one the editor that sbopkg calls. Remember that big black sword? Yeah, how could ya not... + +From your home directory again, gain root access with su as before: + + $ su + # nano /etc/sbopkg/sbopkg.conf + +Add the following to the end of the file; Capitalization is important: + + export EDITOR=nano + +Save and exit the file. + +Now, we're ready to install WINE. Still from your home directory, you still have root access since we didn't exit yet, so type: + + # sbopkg + +Now, as before, we are going to use Sbopkg to search for, and install WINE itself. But a teeny bit of explanation here, because you'll be looking at and yes, editing another file. This one will be the slackbuild associated with WINE, and tells the package manager how to download, build the source files, and in our case whether we want to compile for 32-bit, or 64-bit or as in our case, both. + +We're going to get Sbopkg to download a local copy of the slackbuild file so we can modify it, and then get the package manager to use our modified file instead of the default one. Being in the Sbopkg program now, we arrow down to the search option and press enter. Enter the search terms, in this case the word wine, I just used lower case and press enter. + +As before, Sbopkg brought up a list of matches, and the one we will want is in the system directory and will be either WINE or WINE Staging. Either will work, but Staging may have some glitches in it, although I've gotten both to build. Also, the Staging build will take a lot longer, and this process will take a while anyway, so have you some goodies or whatever will keep you busy for at least an hour maybe more depending on the speed of your computer. + +For the purpose of this how-to, I'm going to assume the stable version. So arrow down to where you hear system wine is not an emulator and press enter. Here you will get the message about WINE not being installed, and several options. Arrow down to custom customize the .info or slackbuild and press enter. Select the first option by pressing enter on it, which will create the local copy of the slackbuild. You'll be put in your editor, in our case Nano. + +This file is pretty good size, but you will need to pay attention to only two lines, which you could search for, but you're a Slackware user, and don't mind a bit of exploration right? heeehe. So arrow down until you encounter the line beginning with: + + WIN32 + +Yes, you can use the control plus w for where is, long as you find it. Examine this line and you'll see that at the end of it is the word yes in lower case, followed by a right brace. That's good, it tells us that the compiler will build 32-bit stuff, which we want. Make sure you're at the beginning of the line when you arrow down to the next line, which begins with: + + WIN64 + +This line looks the same, only there's a no in the place where we saw a yes in the previous line. As you may expect, we do want that no to be a yes, so go to the end of this line with the end key, and without removing anything else, change that no to yes, Then save the file. + +This will return you to the menu. press escape to go back to the previous menu. From this menu arrow down to process download build and install wine and press enter. Another menu is presented and here, just arrow down to the last option and press enter. You'll here that a cue has been added with an okay button. Just press enter here, and shut your speech up. You can check it from time to time, but there shouldn't be any problems because you already installed the dependencies, so while the process chugs along you can have a lunch break while you wait. + +When the process does finish, you'll have a message telling you this, with an okay button,upon which you'll press enter. Press escape until you get to the main menu, but don't exit the program yet, as there's one more thing we need for WINE to work correctly. + +From the main menu, arrow down again to the search option, and press enter. Type: + + winetricks + +into the search box and press enter. Arrow down until you find the correct match, and press enter. + +From here, just arrow down to the process download build and install option, press enter on that, and then enter again to start the cued process. + +This will take considerable less time, about as quickly as you can shut speech up and again you'll have an okay window to let you know it completed. Now you can press escape until you're returned to a command prompt. To get back to your normal user access type: + + # exit + + +## Final Notes + +Everything from this point has been done in the console, the X-windows environment wasn't mentioned, but from here on out, you'll be doing things there, as that's where all the graphical user stuff happens, including WINE, and all your audio games. + +Audiogame-Manager will not be described further from here, as it has it's own fine documentation found at . + +When you start Audiogame-Manager, you should know that it will call Qjoypad, which will allow you to configure a game controller, such as a joystick for whatever game you want to play. Qjoypad pops up a floating window, for setting up your game controller for whatever game you're playing and is good for computers not using a desktop manager like Mate, but adds a little complexity if you do use Mate. + +You can quickly press escape to dismiss Qjoypad, but if you have a controller it really does enhance your gaming experience, And there's a how-to specifically for eyes-free configuration right on your Slint system in the /usr/doc/qjoypad 4.3.1 directory. + +Since I do use the Mate desktop, I just make sure that Qjoypad is already running by pressing the alt plus f2 keys to get the run dialog, and type: + + qj + +and autocomplete should fill in the name of the file. Press enter, and you should be returned to the terminal. + +If using Mate, you can have Qjoypad running in the background, and using the top pannel, you can get back that floating window whenever you need it and dismiss it as well, unless you're running something like Ratpoison, a very cool anti-mouse window manager with no desktop. In this case, Qjoypad will be there and will have nowhere to hide as it were. + +WINE will still spew errors, about FontConfig not being able to find various files after choosing the game you want to play with Audiogame-Manager, but you can ignore these messages by shutting up your speech. + +Hope this helps people and happy audio gaming, especially with Audiogame-Manager