From 0f06504422792d7132b7644caf4dabf19d957659 Mon Sep 17 00:00:00 2001
From: Joey Hess <joey@kodama.kitenet.net>
Date: Sun, 3 Aug 2008 14:36:17 -0400
Subject: [PATCH] remove description_html, add link

---
 IkiWiki/Plugin/anonok.pm     |  3 +--
 IkiWiki/Plugin/attachment.pm |  6 +-----
 IkiWiki/Plugin/lockedit.pm   |  3 +--
 IkiWiki/Plugin/websetup.pm   | 11 ++++++++++-
 debian/changelog             |  1 +
 doc/plugins/write.mdwn       |  3 ++-
 6 files changed, 16 insertions(+), 11 deletions(-)

diff --git a/IkiWiki/Plugin/anonok.pm b/IkiWiki/Plugin/anonok.pm
index 9d21fe367..ccc0d59b9 100644
--- a/IkiWiki/Plugin/anonok.pm
+++ b/IkiWiki/Plugin/anonok.pm
@@ -16,8 +16,7 @@ sub getsetup () { #{{{
 			type => "pagespec",
 			example => "*/discussion",
 			description => "PageSpec to limit which pages anonymous users can edit",
-			description_html => htmllink("", "", "ikiwiki/PageSpec", noimageinline => 1).
-				" to limit which pages anonymous users can edit",
+			link => "ikiwiki/PageSpec",
 			safe => 1,
 			rebuild => 0,
 		},
diff --git a/IkiWiki/Plugin/attachment.pm b/IkiWiki/Plugin/attachment.pm
index 27f984c29..63f0b73c3 100644
--- a/IkiWiki/Plugin/attachment.pm
+++ b/IkiWiki/Plugin/attachment.pm
@@ -25,11 +25,7 @@ sub getsetup () { #{{{
 			type => "pagespec",
 			example => "mimetype(image/*) and maxsize(50kb)",
 			description => "enhanced PageSpec specifying what attachments are allowed",
-			description_html => htmllink("", "", 
-				"ikiwiki/PageSpec/attachment", 
-				noimageinline => 1,
-				linktext => "enhanced PageSpec",
-				)." specifying what attachments are allowed",
+			link => "ikiwiki/PageSpec/attachment",
 			safe => 1,
 			rebuild => 0,
 		},
diff --git a/IkiWiki/Plugin/lockedit.pm b/IkiWiki/Plugin/lockedit.pm
index 93a525677..525fcb0e5 100644
--- a/IkiWiki/Plugin/lockedit.pm
+++ b/IkiWiki/Plugin/lockedit.pm
@@ -18,8 +18,7 @@ sub getsetup () { #{{{
 			type => "pagespec",
 			example => "!*/Discussion",
 			description => "PageSpec controlling which pages are locked",
-			description_html => htmllink("", "", "ikiwiki/PageSpec", noimageinline => 1).
-				" controlling which pages are locked",
+			link => "ikiwiki/PageSpec",
 			safe => 1,
 			rebuild => 0,
 		},
diff --git a/IkiWiki/Plugin/websetup.pm b/IkiWiki/Plugin/websetup.pm
index c22516eec..8ef336b03 100644
--- a/IkiWiki/Plugin/websetup.pm
+++ b/IkiWiki/Plugin/websetup.pm
@@ -100,7 +100,16 @@ sub showfields ($$$@) { #{{{
 		my $key=shift @show;
 		my %info=%{shift @show};
 
-		my $description=exists $info{description_html} ? $info{description_html} : $info{description};
+		my $description=$info{description};
+		if (exists $info{link} && length $info{link}) {
+			if ($info{link} =~ /^\w+:\/\//) {
+				$description="<a href=\"$info{link}\">$description</a>";
+			}
+			else {
+				$description=htmllink("", "", $info{link}, noimageinline => 1, linktext => $description);
+			}
+		}
+
 		my $value=$config{$key};
 		# multiple plugins can have the same field
 		my $name=defined $plugin ? $plugin.".".$key : $key;
diff --git a/debian/changelog b/debian/changelog
index b784c95b2..729f55849 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -12,6 +12,7 @@ ikiwiki (2.60) UNRELEASED; urgency=low
   * ikiwiki-update-wikilist: Add -r switch to remove. Default behavior is now
     always to add.
   * Start moving admin preferences from the web interface to the setup file.
+  * websetup: New plugin providing a setup form on the web.
   * ikiwiki-makerepo: Bail if both srcdir and repository are not specified.
     Closes: #493628
 
diff --git a/doc/plugins/write.mdwn b/doc/plugins/write.mdwn
index b31722dd7..48a94ec8b 100644
--- a/doc/plugins/write.mdwn
+++ b/doc/plugins/write.mdwn
@@ -402,7 +402,8 @@ describing the option. For example:
   hash of these.
 * `example` can be set to an example value.
 * `description` is a short description of the option.
-* `description_html` is an optional short description, that can contain html
+* `link` is a link to further information about the option. This can either
+  be a wikilink, or an url.
 * `safe` should be false if the option should not be displayed in unsafe
   configuration methods, such as the web interface. Anything that specifies
   a command to run, a path on disk, or a regexp should be marked as unsafe.
-- 
2.44.0