Last Edited: 01 May 2008 by superuser
Importered from old WiKi -- 30/04-08 17:04.
Contents
Puppy Linux Mini How-to
          What is
         To install a package:
         To uninstall an installed package:
         Notes on installing 'local'

Puppy Linux Mini How-to

To the official Puppy Get How-to Page:

here!

(this one is only a test to demonstrate the use of the common left rand and of the language block for each page without using of HTML)

What is PupGet?

PupGet is the official package (software) installation system of Puppy Linux.<br>
Puppy offers the option to create your own live-CD, with only the applications you want. Puppy live-CD is created from a collection of packages∞ and a build script, collectively called Puppy Unleashed. Standard Puppy (puppy-X.X.X-mozilla.iso, where X.X.X is the version number) doesn't include all 3XX packages. Then what about all the "left over" packages? To add these 'official' applications to Puppy without creating your own CD, we use PupGet package manager.
Another way to add applications is to use the DotPup software installation system, where the software installed are NOT from Puppy Unleashed.

How to install or uninstall a PupGet package

To install a package:

Go to Start -> Setup -> PupGet package manager
When a window pops up, choose "Installor remove pkgs", then you'll see a two-pane window∞
Left pane shows a list of packages to install. They're "left overs" of that 319 package collection (packages from Unleashed that never made it into the live-CD, that is, are not in usr_cram.fs
When a window pops up, choose "Install or remove pkgs", then you'll see a usr_cram.fs∞
Hover mouse pointer over a package for extra information ("category" or "group" of it and how big it is)
Click on a package to highlight it > click on the "Add" button > highlighted package moves to the right pane > click "OK" > the package will be downloaded and installed.

To uninstall an installed package:

Any packages that you have previously installed will already be in the right pane
Highlight it >; click "Remove" >; it will move to the left side >; click "OK" to uninstall..

Notes on installing 'local' PupGet files

You can use PupGet package manager to get the files but they can also be downloaded from here∞ with any web browser or FTP program (alternative download site∞).

Steps:

Download the package to somewhere local (e.g, /root)
Open Pupget package manager, you should now see

the entry you added on the left pane. Click on the package to highlight
it -> click on the "Add" button -> highlighted package moves to
the right pane -> click "OK".

When asked where do you want to have the package downloaded, choose 'Local'. Then choose the location where your package is saved (e.g. /root). The installation will then begin.

You may need to create an entry in
/root/.packages/packages.txt if it's a newly published package that's
not listed in your PupGet package manager. E.g, add:

"abiword-2.2.7" "abiword-2.2.7: Wordprocessor" on "GTK2APPS 7960K" \
where 'abiword-2.2.7' should be the name of the file that you downloaded and '7960K' is the size of the file.

How to register any arbitrary package with PupGet

Here is some basic concept about PupGet. To start go to the /root/.packages directory and then follow the steps below.

Create an entry in "alienpackages.txt" for your package
Eg, say that you installed a package called "Torsmo", that is a single executable that installs into /usr/local/bin. and maybe an icon into /usr/local/lib/X11/mini-icons/.
You can put into "alienpackages.txt":
"torsmo-1.0" "torsmo-1.O: system monitor utility" on "XLIBAPPS 56K" \
Remember to add " \" on the end, that is, a space followed by a back-slash. You should also press the ENTER key on the end of the last line of the file, so that the cursor is on a new line, but do not put any blank lines.

A script to do so:

echo '"torsmo-1.0" "torsmo-1.O: system monitor utility" on "XLIBAPPS 56K" \' >> /root/.packages/alienpackages.txt
Create a list of the installed files
Here is what you would put into file "torsmo-1.0.files":
/usr/local/bin/torsmo
/usr/local/lib/X11/mini-icons/torsmo.xpm

A script to do so:

echo '/usr/local/bin/torsmo' > /root/.packages/torsmo-1.0.files
echo '/usr/local/lib/X11/mini-icons/torsmo.xpm' >> /root/.packages/torsmo-1.0.files

Faster way to register a DotPup (provided by JonathanMarsden):

It is a good idea to have your dotpup.sh register your package with the PupGet package manager as an alien package. Doing this requires the script to do two things:

Generate a list of all files contained in your package, in /root/.packages/PACKAGENAME.files
Add a one line entry to the list of alien packages in /root/.packages/alienpackages.txt in the appropriate format

Fortunately, much of this can be done using an enhanced dotpup.sh template which generates the file list from the dotpup.tar.gz file, and adds the relevant line to alienpackages.txt. Here is an example:

#!/bin/sh # # Generic dotpup.sh file


PUPNAME="joe"

PUPVERSION="3.3"

PUPINFO="Joe's Own Editor $PUPVERSION: A Free ASCII-Text Screen Editor"

PUPGETINFO="CONSAPPS 1695K"
# Untar the tarball

tar -zx --no-same-owner -C / -f dotpup.tar.gz
# Register with PupGet as an alien package

tar ztf dotpup.tar.gz >/root/.packages/${PUPNAME}-${PUPVERSION}.files

echo "\"${PUPNAME}-${PUPVERSION}\" \"${PUPNAME}-${PUPVERSION}: ${PUPINFO}\" on \"${PUPGETINFO}\" \\" \ >>/root/.packages/alienpackages.txt

By editing just the four settings at the top of the file - PUPNAME, PUPVERSION, PUPINFO and PUPGETINFO - this dotpup.sh template will correctly register many packages.

To know more about PupGet and Puppy Unleashed, take a look at Barry's page here. To learn how to create a PupGet package, see How to create a PupGet package.

PuppianL

Basics:
- About - Installation - Boot Puppy with ... - Getting Started

Software:
- Window Manager - File Manager - Software Manager - Package Manager

Hardware:
- Video - Sound - Sound Recording - Network - Input Devices - Others

Goodies:
- Games - Linux Tutorial - More

Links:
- Puppy - Others

Miscellaneous:
- Misc

Write self in the wiki:
- Prealable information∞

CategoryWikiLayout