Go to the first, previous, next, last section, table of contents.

7 Publisher

Publisher is a separate project under CVS.
To obtain it you should execute a cvs get publisher command under the directory `~/cvs_working_area/'.

Publisher is a tool to automatically delete or move files and directories. When you launch Publisher it doesn't know what it can do. It reads it in a configuration file, written in XML. After reading the configuration file Publisher knows how to do several actions or TARGETs, and asks you which TARGET you choose to perform.
Since Publisher first parses an XML file, you can use its code as a starting point for a general purpose XML parser.

7.1 How Publisher works

When you launch publisher it opens the XML configuration file and builds a syntax tree of what is contained in the file. Then it 'executes' the root of the tree: The effect is that of displaying a menu with some TARGETs (corresponding to the <TARGET> tag of the XML file). You choose a TARGET by pressing a key on you keyboards and Publisher executes all the ACTIONs that are needed to perform that TARGET.

7.2 Code Maintenance

7.2.1 How to add an ACTION tag <FOO>

You have to do the following:

• Edit the `/publisher/conf' file and add to the DTD of the document the appropriate ELEMENT. You have to:
  • add the FOO element as a possible sibling of the TARGET element,
  • add the FOO element as a legitimate element by itself
  • specify an attribute list (ATTLIST) for the FOO element, if you plan to insert attibutes inside the FOO tag (as in : <FOO TYPE="z" COLOR="black">).
• Edit the `/publisher/incl/publisher.h' file and add a FOO_TAG value in the xml_tag_type enumeration.
• Edit the `/publisher/src/publisher.c' file and modify the xml_tag_node::xml_tag_node() method adding the line:
  else if( name == "FOO" ) ttype = FOO_TAB; at the end of it.
• Always in the `/publisher/src/publisher.c' file, modify the xml_tag_node::execute() method adding the actions that you need to do when the <FOO> tag is encountered.

Go to the first, previous, next, last section, table of contents.