summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/haunt.texi13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/haunt.texi b/doc/haunt.texi
index a612f35..cfeff16 100644
--- a/doc/haunt.texi
+++ b/doc/haunt.texi
@@ -560,6 +560,19 @@ Transform the title of @var{post} into a URL slug suitable for the
file name of a web page.
@end deffn
+The original @code{post-slug} procedure above has some less than ideal
+behavior. One issue is that version numbers like ``1.2.3'' get
+transformed to ``123'' rather than something more sensible like
+``1-2-3''. Unfortunately, changing this behavior would mean breaking
+the URLs for existing Haunt sites. Instead, users may opt-in to using
+@code{post-slug-v2} by passing it as the @code{#:make-slug} argument
+to @code{make-site}. @xref{Sites} for more information.
+
+@deffn {Procedure} post-slug-v2 post
+Transform the title of @var{post} into a URL slug. This second
+revision does a better job than the original.
+@end deffn
+
@defvr {Variable} %default-date
The default date of a post when no other date is specified in the
metadata association list.