Add tootips info

[kpg123]

If the XML files in Products/ZenModel/data were to add an extra attribute (eg 'description') to the 'property' tag, then it should be possible to add tooltips info automatically into webpages and also to extract the information out into tables for the Docbook XML documentation.

Benefits:

1. Provides the reference information about what the property is for where the user needs it, when the user needs it. The user doesn't have to find the admin manual, find the correct table and then find the zproperty and hope that it's up-to-date with the code.

2. Have a single source of reference information and all other presentations are based on this data.

3. Can automatically extract out the information for documentation so that as part of the release process the references can be updated with an automated process.

Risks:

The risk revolves around the addition of the extra attribute causing the XML parser to become confused and break.

Concept:

The outline of the idea is:

1. Edit the Products/ZenModle/data XML files (eg data, event) to add the 'description' attribute and take the description from the existing XML documentation.

2. Edit the import/export functions to be able to track the description data. This might be in ImportRM.py and/or in zenPropertyManager.py. It would need to check if the new entry was null or not, and not do anything if the description was empty.

3. Add a new function in zenPropertyManager.py to return the description (eg zenPropertyDesc)

3. Edit the zPropertyEdit.pt file to add a call to zenPropertyDesc(prop) to add the tooltip (ie HTML 'title' attribute)

4. Create an XSL transformation to create the DocBook XML table. (An example that assumes the new attribute is called 'description' is attached to the ticket.)

An example usage for the XML transformation from the command line:

xsltproc --stringparam title "Device" zproperty_to_docbook.xsl devices.xml

5. Update the Docbook documentation to use the new table.