The formatGmTime function has been removed from Func.pm (latest code in CVS) without prior deprecation. While no plugins are currently using it, removal does mean that any plugin author trying to write a plugin that formats times according to the TWiki standard has to DIY, if their plugin is to work with older releases of TWiki. Please, either re-instate formatGmTime and deprecate it for a release (i.e. remove it in Dakaar) or document a workaround for those plugin authors who wanted to use it (like me).

Also, can you please document functions added to Func.pm by using a field "Since: " in the documentation e.g "Since: 1 Apr 2004" so we can see when functionality was introduced and what can be used and what can't with older twikis?

Thank you,

-- CrawfordCurrie - 24 Mar 2004

eeek, sorry, my bad

I'll put it back, and as penance will add the Since: field ...

is there a better syntactical way to mark deprecated? I'm logging a warning, but i'd rather some language based keyword..

-- SvenDowideit - 24 Mar 2004

I would not highlight deprecated functions that large. Something along these lines would be fine:

Description:

Format the time to GM time. NOTE: This function is DEPRECATED and might be removed in a future release; use formatTime() instead

Regarding the "Since" field, some functions in Func.pm already have a "Introduced" field, listing the VERSION number of the TWiki::Plugins module. This is documented at the top of FuncDotPm. Example:

Introduced:

VERSION 1.020 (Feb 2004)

The VERSION number is more useful then the date alone since the Plugin author can use Fun modules conditionally depending on the $TWiki::Plugins::VERSION. Sven, if you find time could you change that?

-- PeterThoeny - 24 Mar 2004

Ok, I've added the TWiki::Plugins::VERSION to the Since field (as Since is more standard (see javadocs)) and will look at toning down the deprecated (and we should use lowercase deprecated as that is also more standard than allcaps

-- SvenDowideit - 26 Mar 2004

Are all the SINCE cells supposed to be right aligned?

• Nope - don't know wassup with it though - -- SvenDowideit - 31 Mar 2004
  • Probably table cell align magic with leading space -- PeterThoeny - 31 Mar 2004

-- SamHasler - 31 Mar 2004

|  TWiki::Plugins::VERSION 1.000 (7 Dec 2002) |
 ^ 2 spaces here                             ^ 1 space here

TablePlugin bases the alignment on the difference between # of leading and trailing spaces. You put one more leading than trailing space, so you get a right-alighned cell.

-- WalterMundt - 31 Mar 2004

The cell align problem is fixed now.

-- PeterThoeny - 01 Apr 2004

I remnoved this from CairoRelease since it is irrelevant to Beijing.

-- CrawfordCurrie - 20 Aug 2004