13.1. Guidelines

It is strongly recommended and expected that theme tarballs are labeled for the pekwm version they are made and tested with. The filename format should be theme_name-pekwm_version.[tar.gz|tgz|tar.bz2|tbz]. For example silly_theme-pekwm_0.1.5.tar.bz2.

It is also highly recommended that theme directories are named in a similar fashion. However, for stable releases this is not mandatory, the tarball filename is enough. If you're building for a GIT revision, mention it in as many places as possible.

The silly theme from above would contain a directory structure as follows:

silly_theme-pekwm_0.1.5/
pekwm_0.1.5/theme
pekwm_0.1.5/menubg.png
pekwm_0.1.5/submenu.png

The theme file header should contain at least the themes name, the pekwm version the theme is for, address to reach the theme maker/porter or get an updated theme, and a last modified date. Changelog entries won't hurt if you aren't the original theme author. For example:

# silly, a PekWM 0.1.5 theme by shared (themes@adresh.com)
# This theme is available from hewphoria.com.
# Last modified 20060529.

# Extract this theme directory under ~/.pekwm/themes/ and the
# themes menu will pick it up automatically.

# Changelog:
# 2006-05-29 HAX0ROFUNIVERSE <hawt@haxorland.invalid>
#  * REWROTE EVERYTHING WITH CAPS LOCK ON,
#    CAPS LOCK IS CRUISE CONTROL FOR COOL!

Try to stick to the theme syntax and rather than deleting entries please use the EMPTY texture.