[ Main Table Of Contents | Table Of Contents | Keyword Index ]

famfamfam_devguide(n) 1 doc "FamFamFam Icon Sets For Tcl"

Name

famfamfam_devguide - FamFamFam - The Developer's Guide

Table Of Contents

Synopsis

  • package require Tk 8.5
  • package require Tcl 8.5
  • package require img::png
  • package require famfamfam ?1.1?

Description

Welcome to famfamfam, a set of packages providing access to the same-named icon sets created by Mark James, at http://www.famfamfam.com/lab/icons/

This document is a guide for developers working on FamFamFam, i.e. maintainers fixing bugs, extending the package's functionality, etc.

Please read

  1. FamFamFam - How To Get The Sources and

  2. FamFamFam - The Installer's Guide

first, if that was not done already. Here we assume that the sources are already available in a directory of your choice, and that you not only know how to build and install them, but also have all the necessary requisites to actually do so. The guide to the sources in particular also explains which source code management system is used, where to find it, how to set it up, etc.

Playing with FamFamFam

We currently do not have demo applications.

Developing for FamFamFam

Architecture & Concepts

This set of packages doesn't have much of an architecture and no special concepts.

We have a single internal package which provides a command for the declaration of icon sets and generates an API from the specified arguments for the new icon set.

On top of that we have the packages for the icon sets just declaring themselves, i.e. using this internal package to do the heavy lifting.

architecture

The icons are accessed by name and are returned in the form of a Tk photo image. The images are generated lazily, i.e. on demand and then cached.

Directory structure

Helpers
Documentation
"doc/"

This directory contains the documentation sources. The texts are written in doctools format, whereas any figures are done with tklib's dia(gram) package and application.

"embedded/"

This directory contains the documentation converted to regular manpages (nroff) and HTML. It is called embedded because these files, while derived, are part of the fossil repository, i.e. embedded into it. This enables fossil to access and display these files when serving the repositories' web interface. The "Command Reference" link at http://chiselapp.com/user/andreas_kupries/repository/famfamfam/home is, for example, accessing the generated HTML.

Demonstration Application and Framework
Package Code, General structure

We have one ".tcl" file per package, internal and icon sets. The icon set packages additionally each have a directory named like their file, but without the extension ".tcl", containing the actual image files of the icons.

pkg_dependencies

Package Code, Per Package
famfamfam
"core.tcl"
famfamfam::flags
"flags.tcl"
"flags"
famfamfam::mini
"mini.tcl"
"mini"
famfamfam::mint
"mint.tcl"
"mint"
famfamfam::silk
"silk.tcl"
"silk"

Bugs, Ideas, Feedback

This document, and the package it describes, will undoubtedly contain bugs and other problems. Please report such at the FamFamFam Tcl Tracker. Please also report any ideas for enhancements you may have for either package and/or documentation.

Keywords

famfamfam, icons, images

Category

Icon sets