I got some additional input from Doug Stevenson on the documentation-discuss
alias,
so I'm now considering using the following manpage sections:
man1 - tclsh.1 & wish.1
man1t - manpages for tcl and tk built-in commands (ie everything currently in
mann)
man3 - libtcl.3 & libtk.3
man3tcl - libtcl.so API manpages
man3tk - libtk.so API manpages
Below is an updated draft of the ARC 1-pager.
- Dermot
###############################################
Tcl/Tk upgrade to 8.4.14
1. Summary
This fast-track increments the versions of Tcl and Tk in Solaris
from, in both cases, 8.3.3 to 8.4.14 and moves the packages from
/usr/sfw to /usr.
Patch release binding is requested.
2. Discussion
Tcl is a popular open source scripting language and Tk is an
open source GUI toolkit commonly used with Tcl. The versions
currently delivered with Solaris are 6 years old. Later versions
are explicitly required by Hgk, a Mercurial extension, which is in
turn required by the Mercurial Plugin for NetBeans (currently
under development).
Versions 8.4.14 are the latest stable version of Tcl and Tk,
being released in October 2006.
It is common practise to include the version number as part of
the installed executable's filename. Therefore the command names
will change from tclsh8.3 (Tcl shell) and wish8.3 (Tk windowing
shell) to tclsh8.4 and wish8.4. While this convention allows
multiple versions of Tcl/Tk to be simultaneously installed, it
is not proposed to retain the older versions with this upgrade.
Additionally, symbolic links without version suffixes (tclsh and
wish) will also be added (these were not provided in Solaris
previously).
As with the current versions of Tcl and Tk, the tkConfig.sh and
tclConfig.sh scripts will be provided. These build-time
convenience scripts are intended to be used by other packages
which require Tcl and/or Tk, such as PostgreSQL.
The current (8.3.3) versions in Solaris are classified as
External and the new versions will be classified as Uncommitted.
Compatibility between versions is not guaranteed.
Both packages will also be moved from /usr/sfw to /usr so that
the commands and libraries can be located in the default path.
Tcl and Tk include a large number of manpages - 939 in total,
of which 600 are links. The default behavior when building
the packages is to install the manpages as follows:
/usr/share/man/man1 - manpages for tclsh and wish commands (2)
/usr/share/man/man3 - manpages for API calls to libtcl.so
and libtk.so (758)
/usr/share/man/mann - manpages for built-in commands in
Tcl and Tk shells (179)
As the "mann" section is not generally used in Solaris, it is
proposed to install these manpages in a new section "man1t".
Also, the main bulk of the man3 manpages will be installed in
new sections "man3tcl" and "man3tk" - only the library
introduction manpages libtcl.3 and libtk.3 will remain in "man3".
3. Interfaces
Exported Interfaces
===================
SUNWTcl Uncommitted Package name (unchanged)
SUNWTk Uncommitted Package name (unchanged)
/usr/bin/tclsh8.4 Uncommitted Command
/usr/bin/tclsh Uncommitted Symbolic link
/usr/bin/wish8.4 Uncommitted Command
/usr/bin/wish Uncommitted Symbolic link
/usr/include/tcl.h Uncommitted Header file
/usr/include/tclDecls.h Uncommitted Header file
/usr/include/tclPlatDecls.h Uncommitted Header file
/usr/include/tk.h Uncommitted Header file
/usr/include/tkDecls.h Uncommitted Header file
/usr/include/tkPlatDecls.h Uncommitted Header file
/usr/lib/libtcl8.4.so Uncommitted Library
/usr/lib/libtk8.4.so Uncommitted Library
/usr/lib/tkConfig.sh Uncommitted Configuration script
/usr/lib/tclConfig.sh Uncommitted Configuration script
** In addition, see ATTACHMENT A for a list of all 939 manpages
(ATTACHMENT A - tcltk_manpage_list.txt: list of all manpages to be install -
NOT INCLUDED HERE)
(ATTACHMENT B - tcltk_manpages.tar.gz: tarball of all Tcl/Tk manpages - NOT
INCLUDED HERE)
This message posted from opensolaris.org
