There is a continuing confusion on the usage of the "similar" Tiddler access functions of the TiddlyWiki class:
- addTiddler - saveTiddler
- fetchTiddler - getTiddler
- deleteTiddler - deleteTiddler
(see #150).
To avoid future confusion mark the "low level functions" addTiddler,fetchTiddler and deleteTiddler as such, and encourage people to use/hijack the corresponding high level function. E.g. with a comment like this:
//# Rarely call/hijack this low level function but getTiddler
this.fetchTiddler = function(title) {
return tiddlers[title];
};
//# Rarely call/hijack this low level function but removeTiddler
this.deleteTiddler = function(title) {
delete this.slices[title];
delete tiddlers[title];
};
//# Rarely call/hijack this low level function but saveTiddler
this.addTiddler = function(tiddler) {
delete this.slices[tiddler.title];
tiddlers[tiddler.title] = tiddler;
};
(BTW: One may consider getting rid (deprecate) getTiddler since it adds nothing essential to fetchTiddler, but on the other hand keeping it ensures the clean split between low and high level functions)