ikiwiki (3.20130711) unstable; urgency=low
[ikiwiki] / doc / todo / Add_instructive_commit_messages_for_removing_pages.mdwn
1 As [[Add instructive commit messages for add _47_ edit pages]], but for `remove.pm`.
2
3 I use a `join()` since it at least looks like the plugin is able to remove several pages at once (`foreach` looping over file parameters), thus holding multiple entries in `@pages`. I haven't seen this happen, though.
4
5 > I feel that anything that shows a change should show what files were
6 > changed (at least as an easily accessible option), so mentioning
7 > filenames in commits is almost always clutter.
8
9 > It could be argued that there should be no message at all here, unless
10 > the user provides one (which they currently cannot), as is done when
11 > adding files. But the entire removal of a page from a wiki is a fairly
12 > unusual circumstance that is probably best highlighted as such in
13 > recentchanges. --[[Joey]]
14
15 Diff follows. --[[Daniel Andersson]]
16
17 [[!tag patch]]
18
19 ---
20
21         diff -r 4f2ad3a5377e Plugin/remove.pm
22         --- a/Plugin/remove.pm  Fri Jul 15 17:39:04 2011 +0200
23         +++ b/Plugin/remove.pm  Sat Jul 16 03:20:35 2011 +0200
24         @@ -228,7 +228,7 @@
25                                                 IkiWiki::rcs_remove($file);
26                                         }
27                                         IkiWiki::rcs_commit_staged(
28         -                                       message => gettext("removed"),
29         +                                       message => sprintf(gettext("remove %s"), join(', ', @files)),
30                                                 session => $session,
31                                         );
32                                         IkiWiki::enable_commit_hook();