You still need to a) rename
, b) change all links in all topics accordingly. The same is likely true for the other renames.
The upshot is this section makes sense for upgrades where someone has already done the renaming work above but it actually makes installing twiki harder for a new install.
Follow On Bug: if WebHome
doesn't exist twiki assumes the web doesn't exist, which is not necessarily true.
Hmmm. Some alternative strategies:
- Document a big warning telling you what you have to do if you change this setting
- Remove the setting from configure
- Automate the rename
3 is really hard to do, because
makes a point of being "TWiki independent" - it doesn't import or use any TWiki features. 2 means you have to set this some other way - either by editing LocalSite
.cfg manually or by moving the setting into TWikiPreferences
- which still leaves the problem of what to do with the existing topics, since the rename isn't automated from there either.
Note that this same problem exists for all topic handles, so WebNotify
are also vulnerable.
Documentation fix, SVN 4422, is the only realistic solution.
Improved Doc fix: add a TOC to the configure page, put "must modify for every install & upgrade" items at the top, "usually not changed" in the middle, and "only touch these if you know what you're doing" at the bottom.
Manipulation of topics is out of scope for
in Dakar. Deferred. CC