Website Summary Files Commits Branches @commit @diff @stats
path: root / cgitrc.5.txt
diff options
context:
space:
mode:
Commit786609bd36c07b85dbf905fc8c36eba7132122d7 (patch)
Author
 Jason A. Donenfeld <Jason@zx2c4.com>
2014-01-13 16:24:40 +0100
Committer
 Jason A. Donenfeld <Jason@zx2c4.com>
2014-01-14 02:00:07 +0100
Files03d3a49c01b89e7122bdde4ad088fc225a819e7b /cgitrc.5.txt
cgit-786609bd36c07b85dbf905fc8c36eba7132122d7.tar
cgit-786609bd36c07b85dbf905fc8c36eba7132122d7.tar.gz
cgit-786609bd36c07b85dbf905fc8c36eba7132122d7.zip
Parente942a1622bddf3338096393c3906c1adc871d198 (diff)
filter: add page source to email filter
Since the email filter is called from lots of places, the script might benefit from knowing the origin. That way it can modify its contents and/or size depending. Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
1 files changed, 8 insertions, 7 deletions
-rw-r--r--cgitrc.5.txt15
diff --git a/cgitrc.5.txt b/cgitrc.5.txt
index b7dc5a4..6a926aa 100644
--- a/cgitrc.5.txt
+++ b/cgitrc.5.txt
@@ -121,9 +121,9 @@ email-filter::
Specifies a command which will be invoked to format names and email
address of committers, authors, and taggers, as represented in various
places throughout the cgit interface. This command will receive an
- email address as its only command line argument, and the text to
- format on STDIN. It is to write the formatted text back out onto
- STDOUT. Default value: none. See also: "FILTER API".
+ email address and an origin page string as its command line arguments,
+ and the text to format on STDIN. It is to write the formatted text back
+ out onto STDOUT. Default value: none. See also: "FILTER API".
embedded::
Flag which, when set to "1", will make cgit generate a html fragment
@@ -620,10 +620,11 @@ commit filter::
expected on standard output.
email filter::
- This filter is given a single parameter: the email address of the
- relevent user. The filter will then receive the text string to format
- on standard input and is expected to write to standard output the
- formatted text to be included in the page.
+ This filter is given two parameters: the email address of the relevent
+ author and a string indicating the originating page. The filter will
+ then receive the text string to format on standard input and is
+ expected to write to standard output the formatted text to be included
+ in the page.
source filter::
This filter is given a single parameter: the filename of the source