From 1d5ba6cf51275ddcb26312b440b8680f8a52c2b2 Mon Sep 17 00:00:00 2001 From: Joey Hess Date: Tue, 5 Aug 2008 20:20:24 -0400 Subject: [PATCH] some doc updates for websetup warning about old style setup files --- doc/plugins/websetup.mdwn | 10 ++++++++++ doc/todo/online_configuration.mdwn | 2 +- 2 files changed, 11 insertions(+), 1 deletion(-) diff --git a/doc/plugins/websetup.mdwn b/doc/plugins/websetup.mdwn index 11cc6ad1e..694429fe1 100644 --- a/doc/plugins/websetup.mdwn +++ b/doc/plugins/websetup.mdwn @@ -5,6 +5,12 @@ This plugin allows wiki admins to configure the wiki using a web interface, rather than editing the setup file directly. A "Wiki Setup" button is added to the admins' preferences page. +Warning: This plugin rewrites your setup file. Any comments or unusual +things (such as perl code) in the setup file will not be preserved. Also, +it will only work correctly with new format setup files, as introduced in +ikiwiki 2.60. Older setup files have a "wrappers" section, which will not +be properly preserved if this plugin is used. + Most settings can be modified using the web interface. Plugins can be enabled and disabled using it too. Some settings are not considered safe enough to be manipulated over the web; these are still shown, by default, @@ -14,3 +20,7 @@ configured via the web. Plugins that should not be enabled/disabled via the web interface can be listed in `websetup_force_plugins` in the setup file. + +When the setup is saved, the setup file will be rewritten with the new +settings, and the wiki will be refreshed, or rebuilt, to make the setip +changes take effect. diff --git a/doc/todo/online_configuration.mdwn b/doc/todo/online_configuration.mdwn index 8263c5d56..02a8c6e5f 100644 --- a/doc/todo/online_configuration.mdwn +++ b/doc/todo/online_configuration.mdwn @@ -25,4 +25,4 @@ writing to a subsidiary setup file. However, this would mean that any comments in the file would be lost, and that it couldn't be used if the setup file had weird stuff (perl code, etc). -[[!tag wishlist]] +[[!tag wishlist done]] -- 2.32.0.93.g670b81a890