Using the working compiled program
"myprogram" as an example, make the filesystem as shown on the left of
figure 1:

• Create folder
         
  /root/myprogram/FILESYSTEM
• Copy
        /usr/local/bin/myprogram
       to   
  /root/myprogram/FILESYSTEM/usr/local/bin/myprogram
• Same with all other
  files that myprogram needs
   
• Optional: Create a
  /root/myprogram/resources folder, if needed, see "hidden features" below
• Create icon:
         
  /root/myprogram/my-icon.xpm
  (or locate one you like in /usr/local/lob/x11/mini-icons)
• Create startscript
        
  /root/myprogram/run-myprogram       for
  example:  

   
       
    Use this code, if "myprogram" is in
/usr/bin or /usr/local/bin

   
        This
opens an orange terminal and runs myprogram

     
       Use this code, if
"myprogram" is
not in one of the Folders, that are in $PATH
(such as /usr/local/bin)

• Make it executable:
          chmod 755
  /root/myprogram/run-myprogram
• Optional:(advanced):create
  /root/myprogram/resource   and add scripts that will be run as
  the pup installs, see diagram below, and NOTES.
• Finally, drag
         
  /root/myprogram
          to the
  Dotpup-wizard.
• More notes: The first letter of Alien packages or
  dotpups must be UPPER case to avoid problems with pupget.  Not:
   openssh.pup  But:
  Openssh.pup 

FIGURE 1
 
Running the wizard:

• Drop the above folder
  on the Dotpup wizard
• Choose "standard"
  (target directory: usr/local/myprogram) or "relocatable" (to install
  the program to another location) 
• Unless myprogram is
  big, like OpenOffice, use "standard." Relocatable
  will let you choose another target directory.
   
• Choose the icon
• Choose any hidden
  config files needed
• Choose the
  application, that will be visible in the menus:
  (pick the run-script you made, not the binary inside /FILESYSTEM)
    
• The next steps
  automatically create a .desktop file   (an
  XDG-menu-definition):
• First, choose a
  category according to the Freedesktop-standard
• If you like, you now
  can edit the XDG-menu, or just exit the window
• Your Dotpup is ready
  for (testing) upload.

NOTES:
You can add 3 scripts that will run during Dotpup-installation:

- prepreinstall.sh

This is run before anything else.

As the Dotpup is not extracted yet, you cannot access embedded
pictures.

- preinstall.sh

Runs after the folder selection for relocatable Dotpups.

Same restrictions as above.

- postinstall.sh

runs after the Dotpup was installed from the final location.

---------------------------------
The first letter of Alien packages (one
that replaces applications on the original Puppy CD)
must be UPPER case to avoid problems with pupget.  Not:
 openssh.pup  But:
Openssh.pup
--------------------------------- 
Menu-entries:

/usr/local/myprogram/run-myprogram will appear in the dotpups-menu.

Since Puppy 2.14, this is depreciated, but the wizard also allows you
to create a ".desktop" file.

Puppy since 2.14 will use this to add a menu-entry in the correct
category.

----------------------------------
When this Pup is installed:
myprogram.tgz is extracted to
/usr/local (so you have the file /usr/local/myprogram/myprogram).

FILESYSTEM.tgz is extracted to /

Overwrite: If the files in FILESYSTEM.tgz already exist, and a message
will pop
up.  

Desktop-Menus are updated, and a symbolic Link will
be added to /usr/local/bin, so that your program seems to be in the
PATH, this way you can start it in rxvt without typing the full
patname.

All files and symlinks will be registered to PupGet.

---------------------------------
A dotpup can be created by hand easily as well, see here: http://puppylinux.org/wikka/dpup
For Puppy 2.14 and up users: http://www.puppyos.com/development/createpet.htm
---------------------------------
 
Download:

http://puppyfiles.org/dotpupsde/dotpups/System_Utilities/Dotpup-Wizard-mu06.pup
(25 kb)