[Tcl-bugs] [ tktoolkit-Bugs-3604346 ] Checkin [a7eee0499a] broke Ttk docs.

[SourceForge.net <no...@so...>]

Bugs item #3604346, was opened at 2013-02-12 11:48
Message generated for change (Comment added) made by stwo
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=112997&aid=3604346&group_id=12997

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: 84. Unix Build
Group: None
Status: Open
Resolution: None
Priority: 5
Private: No
Submitted By: Stuart Cassoff (stwo)
Assigned to: Donal K. Fellows (dkf)
Summary: Checkin [a7eee0499a] broke Ttk docs.

Initial Comment:
Ever since checkin [a7eee0499a], the "::" in Ttk manpage names is replaced with an underscore upon install.
This breaks prior assumptions about manpage names and makes manpages hard to find unless one knows the secret.

$ apropos ttk | grep treeview
ttk::treeview (n) - hierarchical multicolumn data display widget
$ man ttk::treeview
man: no entry for ttk::treeview in the manual.

Also, the manpage brought up with 'man ttk_treeview' makes no mention of 'ttk_treeview', only 'ttk::treeview'.

Not cool. Why was this done? For huge base of Cygwin users?

----------------------------------------------------------------------

>Comment By: Stuart Cassoff (stwo)
Date: 2013-02-18 08:02

Message:
This has also affected oo, platform and tdbc, possibly others.
I don't know which pages out of sync but everything I've seen so far is
consistent with using :: in all the special places.
I think this change should be undone and any broken man pages fixed.

----------------------------------------------------------------------

Comment By: Donal K. Fellows (dkf)
Date: 2013-02-13 01:08

Message:
The one thing I can say for sure is that it wasn't done for the solitary
Cygwin user. :-)

There's a nasty mess with manual page names and so on; there's a bunch of
inconsistencies (also in Tcl, where some of the things described have
“::” in their names) and I don't know if the attempts to fix things
have helped. What we want is for the names described in manual pages (in
things like SEE ALSO sections) to both correspond to names used in
programming and also for them to be the names that you would look up the
page by. (It's far less critical in the HTML version of the documentation;
people don't look up web pages by name.)

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=112997&aid=3604346&group_id=12997