Tinderbox User-to-User Forum (for formal tech support please email: info@eastgate.com)
http://www.eastgate.com/Tinderbox/forum//YaBB.cgi
Tinderbox Users >> Documentation and Tutorials >> ^file^ and deprecation
http://www.eastgate.com/Tinderbox/forum//YaBB.cgi?num=1313403124

Message started by Mark Anderson on Aug 15th, 2011, 6:12am

Title: ^file^ and deprecation
Post by Mark Anderson on Aug 15th, 2011, 6:12am

Note: this is something only of note to more advanced users!

I've 'un-deprecated' ^file()^. Why? Currently (v5.9.3) action code can't replicate all the necessary data ($HTMLExportFileName + $HTMLExportExtension). The effect can be seen here. The issue arises, for a reason, due to TB's consideration of file naming collisions on export.

In certain more advanced use of TB it can be useful to construct pointers to other pages where the implicit relative paths of ^linkTo()^ or ^url()^ are not desirable. Thus it is necessary to know the exported file's name pre-export. I would stress this is something the basic user is not going to encounter.

A feature suggestion is to let action evaluation of $HTMLExportFileName return the currently predicted filename. The change can be annotated with a warning to users about possible ambiguity if the value is stored. Those affected will only be export users who'll need to have looked into this aspect before use, so I see now downside to the change plus it allows planned reduction in the number of active export codes.

Sode note: I'll feed this through to the TB Cookbook and other pertinent resources.

Tinderbox User-to-User Forum (for formal tech support please email: info@eastgate.com) » Powered by YaBB 2.2.1!
YaBB © 2000-2008. All Rights Reserved.