Tcl Manual Markup Language

Everything should be working OK again now; site is back online. Sorry for
taking so long to get this fixed.

(BTW, re: using an older snapshot -- sorry, I didn't have an older
snapshot available. The output had already gotten mangled by the time I
realized there was a problem.)

There seem to be some, which stop for this presentation of the tcl/tk
docs. This site has value.

The tcl core nroff macros may change. Did not happen often, but happens,
as the case shows. That may break the HTML pages rebuild from cvs, as this
time. That happens. The converter has to be ajusted by hand work. I know.

It would be nice, if the last successful converted version of the docs are
still available, until the convertion process works again. Rather an only
almost recent tmml version of the docs then none.

Logged In: NO

TCL Manual mirror...

http://www.davidmarshall.net/doc/tcl/index.html

Logged In: NO

I use http://tmml.sourceforge.net/doc/tcl/ like a fiend. I am going
through withdrawals. Google cache just isn't cutting it for me. Until
this is fixed is it possible to supply the older man pages?

Followup: .DS / .DE changes should be OK: From the chatlog:

(16:28:55) jenglish From my notes:
(16:29:03) jenglish # .DS / .DE pair.
# This is sometimes used as a wrapper around .CS/.CE;
# Other times it's used in place of .CS/.CE.
# Sometimes it's used to get a multi-column list;
# I think this should map to EXAMPLE, or possibly SYNTAX.
# Sometimes it's used to get a multi-column list.
(16:29:34) dkf_ I've been regularizing its usage
(16:29:36) jenglish Which one of these is it now?
(16:29:57) dkf_ It's now only ever tables
(16:30:17) dkf_ and in those cases it always has a .ta as the first
directive (and only) within it
(16:30:35) jenglish OK, that was the heuristic I was using before.
(16:31:02) jenglish (I think. Memory fuzzy. But that sounds familiar.)
(16:31:23) dkf_ syntax is marked up usually in the line following a .TP
(16:32:06) jenglish Yep: I have:
(16:32:08) jenglish troffparse::declareMacro .ta {*} {
insertPI "TABSTOPS" [set *]
if {
[llength ${*}] >= 1
&& [string match "DISPLAY" [lindex [dombuild::ancestorGIs] 0]]
} {
# this is *probably* a multi-column simple list;
# it *might* also be a 2-part definition list if $cols == 2
set cols [expr {[llength ${*}] + 1}]
startTag SL cols $cols SEPARATOR "\t"
}
}
(16:32:25) jenglish erm, sorry.
(16:32:54) dkf_ I don't think the core does that other case
(16:33:43) jenglish Translated into English that means: "If you see a .ta
directive, and you're in a <DISPLAY> (==> "the last thing you saw was
probably a .DS"), then the author probably wants a multi-column simple
list.
(16:34:30) jenglish ("multi-column simple lists" turn into HTML tables at
the end of the nroff => tmml => HTML pipeline.)
.)
(16:35:19) dkf_ yep

See also:

2007-11-01 Donal K. Fellows <donal.k.fellows@man.ac.uk>

* tools/tcltk-man2html.tcl (output-directive): Convert .DS/.DE
pairs
into tables since that is now all that they are used for.

Revert, please!

Logged In: NO

This s a great tool that did use quite a bit. When will this site be up
and running again? Incaase it is not obvious this is in relation to the TCL
reference page.

Thanks and have a good day.

smattei@spheris.com