From 1d78b726d5853ab8302d2d48402e744376afa053 Mon Sep 17 00:00:00 2001
From: adnano <me@adnano.co>
Date: Fri, 3 Sep 2021 01:04:06 -0400
Subject: [PATCH] docs: Move feeds after tasks

---
 docs/kiln.1.scd | 70 +++++++++++++++++++++++++++++--------------------
 1 file changed, 42 insertions(+), 28 deletions(-)

diff --git a/docs/kiln.1.scd b/docs/kiln.1.scd
index 1923995..b654aae 100644
--- a/docs/kiln.1.scd
+++ b/docs/kiln.1.scd
@@ -185,33 +185,6 @@ The following keys are supported:
 Site URLs may contain paths, but should not end with a trailing slash. Multiple
 site URLs may be specified for sites that are available at multiple locations.
 
-## FEEDS
-
-Feeds can be specified in [[tasks.feeds]] for every task needing them.
-
-Example feed configuration:
-
-	```
-	# This will generate a feed which will be written to public/blog/atom.xml
-	[[tasks.feeds]]
-	input_dir = "blog"
-	title = "My Blog"
-	template = "atom.xml"
-	output = "blog/atom.xml"
-	```
-
-*input_dir*
-	the content folder for which the feed will be generated
-
-*title*
-	the title of the feed, accessible via {{ .Title }} in the template
-
-*template*
-	the template to use for the feed
-
-*output*
-	the absolute path for the rendered feed
-
 ## PERMALINKS
 
 Permalinks can be used to rewrite page paths. Permalinks are specified in the
@@ -382,6 +355,47 @@ configuration makes use of the *markdown*(1) comand to convert Markdown to HTML.
 	output_dir = "public"
 	```
 
+## FEEDS
+
+Feeds can be specified in the [[tasks.feeds]] array of tables. Multiple feeds
+can be specified per task.
+
+Example feed configuration:
+
+	```
+	[[tasks]]
+	# ...
+
+	# This generates a feed for the files in content/blog
+	# and writes it to blog/atom.xml (relative to the output directory)
+	[[tasks.feeds]]
+	input_dir = "blog"
+	title = "My Blog"
+	template = "atom.xml"
+	output = "blog/atom.xml"
+
+	# You can generate multiple feeds per task
+	# The generated feed can be written anywhere
+	# Here it is written to feed.xml (relative to the output directory)
+	[[tasks.feeds]]
+	input_dir = "blog"
+	title = "My Blog"
+	template = "custom_feed.xml"
+	output = "feed.xml"
+	```
+
+*input_dir*
+	the content folder with which to populate the feed
+
+*title*
+	the title of the feed, accessible via {{ .Title }} in the feed template
+
+*template*
+	the template to use for the feed
+
+*output*
+	the output path for the rendered feed
+
 # TEMPLATES
 
 Templates have certain data and functions available to them.
@@ -673,7 +687,7 @@ Feed templates are provided with the following data:
 :  Title of the feed
 |  Permalink
 :  The permanent link to the feed directory
-|  Entries
+|  Pages
 :  List of pages in this feed
 
 ## PARTIAL TEMPLATES