Purpose: to discuss the tklib script library/module from http://tcllib.sourceforge.net/ , its uses, policies, ''got-chas'', etc.
----

Currently tklib includes the following packages:

   * [cursor] - ::cursor::display , ::cursor::propagate , ::cursor::restore , 
   * [tcl-only datefield] : a tcl/tk only clone of iwidgets datefield widget. 
----

List here the serious candidates for inclusion in tklib (these already exist in the appropriate SourceForge project):

   * [BWidgets]
   * [mclistbox]
   * [scwoop]
   * [text::sync]
   * [tkpiechart]
   * [widget]
   * [efftcl] from the [BOOK Effective Tcl - Writing Better Programs in Tcl and Tk]

Remember to list only items that come in Tk scripting - compiled widgets like
[tkimg], [tkhtml], [tktable], [tktreectrl], [blt], [tix], [vu], [tkdnd], etc. belong in the various [Batteries Included] distributions.

And some pieces of code here on the wiki that might be useful to add to tklib
would include: 

   * [console for Unix]
   * [RS]'s [keyboard widget] for unicode virtual keyboard entry
   * Perhaps [A wiki-like markup language for the text widget]
   * [A Little Hex Editor Widget]
   * [Read-only text widget]
   * [Scrolling Widgets With a Scale]
   * [dial widget]
   * [pan] add panning to any widget with xview/yview (including blt::graph)

I encourage people to list other useful Tk related widgets and add-ons that are not already a part of some other extension.

In particular, look around the wiki - I suspect there's a number of wonderful possibilities here.

For instance, check out [Commonly requested widgets] - if you can find well written versions of these, putting them into tklib would be a wonderful idea.
Do be careful to verify the licensing status of the code, and '''GET PERMISSION FROM THE AUTHOR''' before adding code to the library though.

----
If you read the [tcllib] page, you will find information about content
requirements, submission guidelines, etc. for your software.

However, recently [tclguy] summaried the process on news:comp.lang.tcl as:

   1. say you want to add a module in one of the forums where the admins hang out (the Wiki chat, http://www.tcl.tk/, comp.lang.tcl, the tcllib developers mailing list are all possible locations)

   1. get a [SourceForge] developer login.

   1. Send it to one of the tklib administrators, asking them to add you as a member to the tklib cvs list.

   1. Create a new module in tklib.

   1. Add it to the tklib Makefile module list.

   1. Add in your code.

   1. Hopefully add in documentation and test cases, and perhaps even some demo code.

   1.  Commit the changes.  Be certain to add relevant comments to the CVS and hopefully the tklib ChangeLog.

----

See also [tcllib] for the policies and discussions relating to another module of this project, which has tcl-only procedures.

----
[Category Package] |
[Category GUI] |
[Category Widget]