aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFlorian Dold <florian.dold@gmail.com>2019-09-18 19:45:10 +0200
committerFlorian Dold <florian.dold@gmail.com>2019-09-18 19:45:10 +0200
commit389b5de09dc3720c22ac86d5cad4c1495fc5be58 (patch)
treef5fe6abaffcea3e9259fd70571e71caebbf61f6b
parenta18011012d27a183965baf5c95110598758b757f (diff)
downloadexchange-389b5de09dc3720c22ac86d5cad4c1495fc5be58.tar.gz
exchange-389b5de09dc3720c22ac86d5cad4c1495fc5be58.zip
use pre-built man and texinfo from docs.git
-rw-r--r--.gitignore1
-rw-r--r--.gitmodules4
-rwxr-xr-xbootstrap1
-rw-r--r--doc/Makefile.am32
-rw-r--r--doc/coding-style.txt65
-rw-r--r--doc/highlight.pack.js2
m---------doc/prebuilt0
-rw-r--r--doc/taler-auditor-exchange.145
-rw-r--r--doc/taler-auditor-sign.146
-rw-r--r--doc/taler-auditor.143
-rw-r--r--doc/taler-bank-transfer.155
-rw-r--r--doc/taler-config-generate.174
-rw-r--r--doc/taler-exchange-aggregator.137
-rw-r--r--doc/taler-exchange-benchmark.144
-rw-r--r--doc/taler-exchange-dbinit.147
-rw-r--r--doc/taler-exchange-httpd.192
-rw-r--r--doc/taler-exchange-keycheck.139
-rw-r--r--doc/taler-exchange-keyup.155
-rw-r--r--doc/taler-exchange-wire.134
-rw-r--r--doc/taler-exchange-wirewatch.141
-rw-r--r--doc/taler.conf.5248
21 files changed, 23 insertions, 982 deletions
diff --git a/.gitignore b/.gitignore
index c472f73fa..9827d74a6 100644
--- a/.gitignore
+++ b/.gitignore
@@ -101,6 +101,7 @@ doc/manual/manual.pg
101doc/manual/manual.toc 101doc/manual/manual.toc
102doc/manual/manual.tp 102doc/manual/manual.tp
103doc/manual/manual.vr 103doc/manual/manual.vr
104doc/prebuilt/*
104contrib/taler-exchange.tag 105contrib/taler-exchange.tag
105doxygen-doc/ 106doxygen-doc/
106src/lib/test_exchange_api_keys_cherry_picking 107src/lib/test_exchange_api_keys_cherry_picking
diff --git a/.gitmodules b/.gitmodules
index 7625aa983..de5e33058 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -1,3 +1,7 @@
1[submodule "doc/api"] 1[submodule "doc/api"]
2 path = doc/api 2 path = doc/api
3 url = git@git.taler.net:api 3 url = git@git.taler.net:api
4[submodule "doc/prebuilt"]
5 path = doc/prebuilt
6 url = https://git.taler.net/docs.git
7 branch = prebuilt
diff --git a/bootstrap b/bootstrap
index 4e7cc0537..6d01a1ffa 100755
--- a/bootstrap
+++ b/bootstrap
@@ -1,2 +1,3 @@
1#!/bin/sh 1#!/bin/sh
2autoreconf -if 2autoreconf -if
3git submodule update --init
diff --git a/doc/Makefile.am b/doc/Makefile.am
index c864bfb53..3c844e5c5 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -3,21 +3,23 @@
3SUBDIRS = . 3SUBDIRS = .
4 4
5man_MANS = \ 5man_MANS = \
6 taler-auditor.1 \ 6 prebuilt/man/taler-auditor.1 \
7 taler-auditor-exchange.1 \ 7 prebuilt/man/taler-auditor-exchange.1 \
8 taler-auditor-sign.1 \ 8 prebuilt/man/taler-auditor-sign.1 \
9 taler-bank-transfer.1 \ 9 prebuilt/man/taler-bank-transfer.1 \
10 taler-config-generate.1 \ 10 prebuilt/man/taler-config-generate.1 \
11 taler-exchange-aggregator.1 \ 11 prebuilt/man/taler-exchange-aggregator.1 \
12 taler-exchange-dbinit.1 \ 12 prebuilt/man/taler-exchange-dbinit.1 \
13 taler-exchange-httpd.1 \ 13 prebuilt/man/taler-exchange-httpd.1 \
14 taler-exchange-keyup.1 \ 14 prebuilt/man/taler-exchange-keyup.1 \
15 taler-exchange-keycheck.1 \ 15 prebuilt/man/taler-exchange-keycheck.1 \
16 taler-exchange-wire.1 \ 16 prebuilt/man/taler-exchange-wire.1 \
17 taler-exchange-wirewatch.1 \ 17 prebuilt/man/taler-exchange-wirewatch.1 \
18 taler-exchange-benchmark.1 \ 18 prebuilt/man/taler-exchange-benchmark.1 \
19 taler.conf.5 19 prebuilt/man/taler.conf.5
20
21info_TEXINFOS = \
22 prebuilt/texinfo/taler-exchange.texi
20 23
21EXTRA_DIST = \ 24EXTRA_DIST = \
22 coding-style.txt \
23 $(man_MANS) 25 $(man_MANS)
diff --git a/doc/coding-style.txt b/doc/coding-style.txt
deleted file mode 100644
index fe7bfed12..000000000
--- a/doc/coding-style.txt
+++ /dev/null
@@ -1,65 +0,0 @@
1These are the general coding style rules for Taler.
2
3* Baseline rules are to follow GNU guidelines, modified or extended
4 by the GNUnet style: https://gnunet.org/style
5
6Naming conventions:
7===================
8
9* include files (very similar to GNUnet):
10 + if installed, must start with "taler_" (exception: platform.h),
11 and MUST live in src/include/
12 + if NOT installed, must NOT start with "taler_" and
13 MUST NOT live in src/include/ and
14 SHOULD NOT be included from outside of their own directory
15 + end in "_lib" for "simple" libraries
16 + end in "_plugin" for plugins
17 + end in "_service" for libraries accessing a service, i.e. the exchange
18
19* binaries:
20 + taler-exchange-xxx: exchange programs
21 + taler-merchant-xxx: merchant programs (demos)
22 + taler-wallet-xxx: wallet programs
23 + plugins should be libtaler_plugin_xxx_yyy.so: plugin yyy for API xxx
24 + libtalerxxx: library for API xxx
25
26* logging
27 + tools use their full name in GNUNET_log_setup
28 (i.e. 'taler-exchange-keyup') and log using plain 'GNUNET_log'.
29 + pure libraries (without associated service) use 'GNUNET_log_from'
30 with the component set to their library name (without lib or '.so'),
31 which should also be their directory name (i.e. 'util')
32 + plugin libraries (without associated service) use 'GNUNET_log_from'
33 with the component set to their type and plugin name (without lib or '.so'),
34 which should also be their directory name (i.e. 'exchangedb-postgres')
35 + libraries with associated service) use 'GNUNET_log_from'
36 with the name of the service, which should also be their
37 directory name (i.e. 'exchange')
38
39* configuration
40 + same rules as for GNUnet
41
42* exported symbols
43 + must start with TALER_[SUBSYSTEMNAME]_ where SUBSYSTEMNAME
44 MUST match the subdirectory of src/ in which the symbol is defined
45 + from libtalerutil start just with TALER_, without subsystemname
46 + if scope is ONE binary and symbols are not in a shared library,
47 use binary-specific prefix (such as TMH = taler-exchange-httpd) for
48 globals, possibly followed by the subsystem (TMH_DB_xxx).
49
50* structs:
51 + structs that are 'packed' and do not contain pointers and are
52 thus suitable for hashing or similar operations are distinguished
53 by adding a "P" at the end of the name. (NEW) Note that this
54 convention does not hold for the GNUnet-structs (yet).
55 + structs that are used with a purpose for signatures, additionally
56 get an "S" at the end of the name.
57
58* private (library-internal) symbols (including structs and macros)
59 + must not start with TALER_ or any other prefix
60
61* testcases
62 + must be called "test_module-under-test_case-description.c"
63
64* performance tests
65 + must be called "perf_module-under-test_case-description.c"
diff --git a/doc/highlight.pack.js b/doc/highlight.pack.js
deleted file mode 100644
index b2f9ff270..000000000
--- a/doc/highlight.pack.js
+++ /dev/null
@@ -1,2 +0,0 @@
1/*! highlight.js v9.12.0 | BSD3 License | git.io/hljslicense */
2!function(e){var n="object"==typeof window&&window||"object"==typeof self&&self;"undefined"!=typeof exports?e(exports):n&&(n.hljs=e({}),"function"==typeof define&&define.amd&&define([],function(){return n.hljs}))}(function(e){function n(e){return e.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;")}function t(e){return e.nodeName.toLowerCase()}function r(e,n){var t=e&&e.exec(n);return t&&0===t.index}function a(e){return k.test(e)}function i(e){var n,t,r,i,o=e.className+" ";if(o+=e.parentNode?e.parentNode.className:"",t=B.exec(o))return w(t[1])?t[1]:"no-highlight";for(o=o.split(/\s+/),n=0,r=o.length;r>n;n++)if(i=o[n],a(i)||w(i))return i}function o(e){var n,t={},r=Array.prototype.slice.call(arguments,1);for(n in e)t[n]=e[n];return r.forEach(function(e){for(n in e)t[n]=e[n]}),t}function u(e){var n=[];return function r(e,a){for(var i=e.firstChild;i;i=i.nextSibling)3===i.nodeType?a+=i.nodeValue.length:1===i.nodeType&&(n.push({event:"start",offset:a,node:i}),a=r(i,a),t(i).match(/br|hr|img|input/)||n.push({event:"stop",offset:a,node:i}));return a}(e,0),n}function c(e,r,a){function i(){return e.length&&r.length?e[0].offset!==r[0].offset?e[0].offset<r[0].offset?e:r:"start"===r[0].event?e:r:e.length?e:r}function o(e){function r(e){return" "+e.nodeName+'="'+n(e.value).replace('"',"&quot;")+'"'}s+="<"+t(e)+E.map.call(e.attributes,r).join("")+">"}function u(e){s+="</"+t(e)+">"}function c(e){("start"===e.event?o:u)(e.node)}for(var l=0,s="",f=[];e.length||r.length;){var g=i();if(s+=n(a.substring(l,g[0].offset)),l=g[0].offset,g===e){f.reverse().forEach(u);do c(g.splice(0,1)[0]),g=i();while(g===e&&g.length&&g[0].offset===l);f.reverse().forEach(o)}else"start"===g[0].event?f.push(g[0].node):f.pop(),c(g.splice(0,1)[0])}return s+n(a.substr(l))}function l(e){return e.v&&!e.cached_variants&&(e.cached_variants=e.v.map(function(n){return o(e,{v:null},n)})),e.cached_variants||e.eW&&[o(e)]||[e]}function s(e){function n(e){return e&&e.source||e}function t(t,r){return new RegExp(n(t),"m"+(e.cI?"i":"")+(r?"g":""))}function r(a,i){if(!a.compiled){if(a.compiled=!0,a.k=a.k||a.bK,a.k){var o={},u=function(n,t){e.cI&&(t=t.toLowerCase()),t.split(" ").forEach(function(e){var t=e.split("|");o[t[0]]=[n,t[1]?Number(t[1]):1]})};"string"==typeof a.k?u("keyword",a.k):x(a.k).forEach(function(e){u(e,a.k[e])}),a.k=o}a.lR=t(a.l||/\w+/,!0),i&&(a.bK&&(a.b="\\b("+a.bK.split(" ").join("|")+")\\b"),a.b||(a.b=/\B|\b/),a.bR=t(a.b),a.e||a.eW||(a.e=/\B|\b/),a.e&&(a.eR=t(a.e)),a.tE=n(a.e)||"",a.eW&&i.tE&&(a.tE+=(a.e?"|":"")+i.tE)),a.i&&(a.iR=t(a.i)),null==a.r&&(a.r=1),a.c||(a.c=[]),a.c=Array.prototype.concat.apply([],a.c.map(function(e){return l("self"===e?a:e)})),a.c.forEach(function(e){r(e,a)}),a.starts&&r(a.starts,i);var c=a.c.map(function(e){return e.bK?"\\.?("+e.b+")\\.?":e.b}).concat([a.tE,a.i]).map(n).filter(Boolean);a.t=c.length?t(c.join("|"),!0):{exec:function(){return null}}}}r(e)}function f(e,t,a,i){function o(e,n){var t,a;for(t=0,a=n.c.length;a>t;t++)if(r(n.c[t].bR,e))return n.c[t]}function u(e,n){if(r(e.eR,n)){for(;e.endsParent&&e.parent;)e=e.parent;return e}return e.eW?u(e.parent,n):void 0}function c(e,n){return!a&&r(n.iR,e)}function l(e,n){var t=N.cI?n[0].toLowerCase():n[0];return e.k.hasOwnProperty(t)&&e.k[t]}function p(e,n,t,r){var a=r?"":I.classPrefix,i='<span class="'+a,o=t?"":C;return i+=e+'">',i+n+o}function h(){var e,t,r,a;if(!E.k)return n(k);for(a="",t=0,E.lR.lastIndex=0,r=E.lR.exec(k);r;)a+=n(k.substring(t,r.index)),e=l(E,r),e?(B+=e[1],a+=p(e[0],n(r[0]))):a+=n(r[0]),t=E.lR.lastIndex,r=E.lR.exec(k);return a+n(k.substr(t))}function d(){var e="string"==typeof E.sL;if(e&&!y[E.sL])return n(k);var t=e?f(E.sL,k,!0,x[E.sL]):g(k,E.sL.length?E.sL:void 0);return E.r>0&&(B+=t.r),e&&(x[E.sL]=t.top),p(t.language,t.value,!1,!0)}function b(){L+=null!=E.sL?d():h(),k=""}function v(e){L+=e.cN?p(e.cN,"",!0):"",E=Object.create(e,{parent:{value:E}})}function m(e,n){if(k+=e,null==n)return b(),0;var t=o(n,E);if(t)return t.skip?k+=n:(t.eB&&(k+=n),b(),t.rB||t.eB||(k=n)),v(t,n),t.rB?0:n.length;var r=u(E,n);if(r){var a=E;a.skip?k+=n:(a.rE||a.eE||(k+=n),b(),a.eE&&(k=n));do E.cN&&(L+=C),E.skip||(B+=E.r),E=E.parent;while(E!==r.parent);return r.starts&&v(r.starts,""),a.rE?0:n.length}if(c(n,E))throw new Error('Illegal lexeme "'+n+'" for mode "'+(E.cN||"<unnamed>")+'"');return k+=n,n.length||1}var N=w(e);if(!N)throw new Error('Unknown language: "'+e+'"');s(N);var R,E=i||N,x={},L="";for(R=E;R!==N;R=R.parent)R.cN&&(L=p(R.cN,"",!0)+L);var k="",B=0;try{for(var M,j,O=0;;){if(E.t.lastIndex=O,M=E.t.exec(t),!M)break;j=m(t.substring(O,M.index),M[0]),O=M.index+j}for(m(t.substr(O)),R=E;R.parent;R=R.parent)R.cN&&(L+=C);return{r:B,value:L,language:e,top:E}}catch(T){if(T.message&&-1!==T.message.indexOf("Illegal"))return{r:0,value:n(t)};throw T}}function g(e,t){t=t||I.languages||x(y);var r={r:0,value:n(e)},a=r;return t.filter(w).forEach(function(n){var t=f(n,e,!1);t.language=n,t.r>a.r&&(a=t),t.r>r.r&&(a=r,r=t)}),a.language&&(r.second_best=a),r}function p(e){return I.tabReplace||I.useBR?e.replace(M,function(e,n){return I.useBR&&"\n"===e?"<br>":I.tabReplace?n.replace(/\t/g,I.tabReplace):""}):e}function h(e,n,t){var r=n?L[n]:t,a=[e.trim()];return e.match(/\bhljs\b/)||a.push("hljs"),-1===e.indexOf(r)&&a.push(r),a.join(" ").trim()}function d(e){var n,t,r,o,l,s=i(e);a(s)||(I.useBR?(n=document.createElementNS("http://www.w3.org/1999/xhtml","div"),n.innerHTML=e.innerHTML.replace(/\n/g,"").replace(/<br[ \/]*>/g,"\n")):n=e,l=n.textContent,r=s?f(s,l,!0):g(l),t=u(n),t.length&&(o=document.createElementNS("http://www.w3.org/1999/xhtml","div"),o.innerHTML=r.value,r.value=c(t,u(o),l)),r.value=p(r.value),e.innerHTML=r.value,e.className=h(e.className,s,r.language),e.result={language:r.language,re:r.r},r.second_best&&(e.second_best={language:r.second_best.language,re:r.second_best.r}))}function b(e){I=o(I,e)}function v(){if(!v.called){v.called=!0;var e=document.querySelectorAll("pre code");E.forEach.call(e,d)}}function m(){addEventListener("DOMContentLoaded",v,!1),addEventListener("load",v,!1)}function N(n,t){var r=y[n]=t(e);r.aliases&&r.aliases.forEach(function(e){L[e]=n})}function R(){return x(y)}function w(e){return e=(e||"").toLowerCase(),y[e]||y[L[e]]}var E=[],x=Object.keys,y={},L={},k=/^(no-?highlight|plain|text)$/i,B=/\blang(?:uage)?-([\w-]+)\b/i,M=/((^(<[^>]+>|\t|)+|(?:\n)))/gm,C="</span>",I={classPrefix:"hljs-",tabReplace:null,useBR:!1,languages:void 0};return e.highlight=f,e.highlightAuto=g,e.fixMarkup=p,e.highlightBlock=d,e.configure=b,e.initHighlighting=v,e.initHighlightingOnLoad=m,e.registerLanguage=N,e.listLanguages=R,e.getLanguage=w,e.inherit=o,e.IR="[a-zA-Z]\\w*",e.UIR="[a-zA-Z_]\\w*",e.NR="\\b\\d+(\\.\\d+)?",e.CNR="(-?)(\\b0[xX][a-fA-F0-9]+|(\\b\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?)",e.BNR="\\b(0b[01]+)",e.RSR="!|!=|!==|%|%=|&|&&|&=|\\*|\\*=|\\+|\\+=|,|-|-=|/=|/|:|;|<<|<<=|<=|<|===|==|=|>>>=|>>=|>=|>>>|>>|>|\\?|\\[|\\{|\\(|\\^|\\^=|\\||\\|=|\\|\\||~",e.BE={b:"\\\\[\\s\\S]",r:0},e.ASM={cN:"string",b:"'",e:"'",i:"\\n",c:[e.BE]},e.QSM={cN:"string",b:'"',e:'"',i:"\\n",c:[e.BE]},e.PWM={b:/\b(a|an|the|are|I'm|isn't|don't|doesn't|won't|but|just|should|pretty|simply|enough|gonna|going|wtf|so|such|will|you|your|they|like|more)\b/},e.C=function(n,t,r){var a=e.inherit({cN:"comment",b:n,e:t,c:[]},r||{});return a.c.push(e.PWM),a.c.push({cN:"doctag",b:"(?:TODO|FIXME|NOTE|BUG|XXX):",r:0}),a},e.CLCM=e.C("//","$"),e.CBCM=e.C("/\\*","\\*/"),e.HCM=e.C("#","$"),e.NM={cN:"number",b:e.NR,r:0},e.CNM={cN:"number",b:e.CNR,r:0},e.BNM={cN:"number",b:e.BNR,r:0},e.CSSNM={cN:"number",b:e.NR+"(%|em|ex|ch|rem|vw|vh|vmin|vmax|cm|mm|in|pt|pc|px|deg|grad|rad|turn|s|ms|Hz|kHz|dpi|dpcm|dppx)?",r:0},e.RM={cN:"regexp",b:/\//,e:/\/[gimuy]*/,i:/\n/,c:[e.BE,{b:/\[/,e:/\]/,r:0,c:[e.BE]}]},e.TM={cN:"title",b:e.IR,r:0},e.UTM={cN:"title",b:e.UIR,r:0},e.METHOD_GUARD={b:"\\.\\s*"+e.UIR,r:0},e});hljs.registerLanguage("diff",function(e){return{aliases:["patch"],c:[{cN:"meta",r:10,v:[{b:/^@@ +\-\d+,\d+ +\+\d+,\d+ +@@$/},{b:/^\*\*\* +\d+,\d+ +\*\*\*\*$/},{b:/^\-\-\- +\d+,\d+ +\-\-\-\-$/}]},{cN:"comment",v:[{b:/Index: /,e:/$/},{b:/={3,}/,e:/$/},{b:/^\-{3}/,e:/$/},{b:/^\*{3} /,e:/$/},{b:/^\+{3}/,e:/$/},{b:/\*{5}/,e:/\*{5}$/}]},{cN:"addition",b:"^\\+",e:"$"},{cN:"deletion",b:"^\\-",e:"$"},{cN:"addition",b:"^\\!",e:"$"}]}});hljs.registerLanguage("nginx",function(e){var r={cN:"variable",v:[{b:/\$\d+/},{b:/\$\{/,e:/}/},{b:"[\\$\\@]"+e.UIR}]},b={eW:!0,l:"[a-z/_]+",k:{literal:"on off yes no true false none blocked debug info notice warn error crit select break last permanent redirect kqueue rtsig epoll poll /dev/poll"},r:0,i:"=>",c:[e.HCM,{cN:"string",c:[e.BE,r],v:[{b:/"/,e:/"/},{b:/'/,e:/'/}]},{b:"([a-z]+):/",e:"\\s",eW:!0,eE:!0,c:[r]},{cN:"regexp",c:[e.BE,r],v:[{b:"\\s\\^",e:"\\s|{|;",rE:!0},{b:"~\\*?\\s+",e:"\\s|{|;",rE:!0},{b:"\\*(\\.[a-z\\-]+)+"},{b:"([a-z\\-]+\\.)+\\*"}]},{cN:"number",b:"\\b\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}(:\\d{1,5})?\\b"},{cN:"number",b:"\\b\\d+[kKmMgGdshdwy]*\\b",r:0},r]};return{aliases:["nginxconf"],c:[e.HCM,{b:e.UIR+"\\s+{",rB:!0,e:"{",c:[{cN:"section",b:e.UIR}],r:0},{b:e.UIR+"\\s",e:";|{",rB:!0,c:[{cN:"attribute",b:e.UIR,starts:b}],r:0}],i:"[^\\s\\}]"}});hljs.registerLanguage("objectivec",function(e){var t={cN:"built_in",b:"\\b(AV|CA|CF|CG|CI|CL|CM|CN|CT|MK|MP|MTK|MTL|NS|SCN|SK|UI|WK|XC)\\w+"},_={keyword:"int float while char export sizeof typedef const struct for union unsigned long volatile static bool mutable if do return goto void enum else break extern asm case short default double register explicit signed typename this switch continue wchar_t inline readonly assign readwrite self @synchronized id typeof nonatomic super unichar IBOutlet IBAction strong weak copy in out inout bycopy byref oneway __strong __weak __block __autoreleasing @private @protected @public @try @property @end @throw @catch @finally @autoreleasepool @synthesize @dynamic @selector @optional @required @encode @package @import @defs @compatibility_alias __bridge __bridge_transfer __bridge_retained __bridge_retain __covariant __contravariant __kindof _Nonnull _Nullable _Null_unspecified __FUNCTION__ __PRETTY_FUNCTION__ __attribute__ getter setter retain unsafe_unretained nonnull nullable null_unspecified null_resettable class instancetype NS_DESIGNATED_INITIALIZER NS_UNAVAILABLE NS_REQUIRES_SUPER NS_RETURNS_INNER_POINTER NS_INLINE NS_AVAILABLE NS_DEPRECATED NS_ENUM NS_OPTIONS NS_SWIFT_UNAVAILABLE NS_ASSUME_NONNULL_BEGIN NS_ASSUME_NONNULL_END NS_REFINED_FOR_SWIFT NS_SWIFT_NAME NS_SWIFT_NOTHROW NS_DURING NS_HANDLER NS_ENDHANDLER NS_VALUERETURN NS_VOIDRETURN",literal:"false true FALSE TRUE nil YES NO NULL",built_in:"BOOL dispatch_once_t dispatch_queue_t dispatch_sync dispatch_async dispatch_once"},i=/[a-zA-Z@][a-zA-Z0-9_]*/,n="@interface @class @protocol @implementation";return{aliases:["mm","objc","obj-c"],k:_,l:i,i:"</",c:[t,e.CLCM,e.CBCM,e.CNM,e.QSM,{cN:"string",v:[{b:'@"',e:'"',i:"\\n",c:[e.BE]},{b:"'",e:"[^\\\\]'",i:"[^\\\\][^']"}]},{cN:"meta",b:"#",e:"$",c:[{cN:"meta-string",v:[{b:'"',e:'"'},{b:"<",e:">"}]}]},{cN:"class",b:"("+n.split(" ").join("|")+")\\b",e:"({|$)",eE:!0,k:n,l:i,c:[e.UTM]},{b:"\\."+e.UIR,r:0}]}});hljs.registerLanguage("ini",function(e){var b={cN:"string",c:[e.BE],v:[{b:"'''",e:"'''",r:10},{b:'"""',e:'"""',r:10},{b:'"',e:'"'},{b:"'",e:"'"}]};return{aliases:["toml"],cI:!0,i:/\S/,c:[e.C(";","$"),e.HCM,{cN:"section",b:/^\s*\[+/,e:/\]+/},{b:/^[a-z0-9\[\]_-]+\s*=\s*/,e:"$",rB:!0,c:[{cN:"attr",b:/[a-z0-9\[\]_-]+/},{b:/=/,eW:!0,r:0,c:[{cN:"literal",b:/\bon|off|true|false|yes|no\b/},{cN:"variable",v:[{b:/\$[\w\d"][\w\d_]*/},{b:/\$\{(.*?)}/}]},b,{cN:"number",b:/([\+\-]+)?[\d]+_[\d_]+/},e.NM]}]}]}});hljs.registerLanguage("javascript",function(e){var r="[A-Za-z$_][0-9A-Za-z$_]*",t={keyword:"in of if for while finally var new function do return void else break catch instanceof with throw case default try this switch continue typeof delete let yield const export super debugger as async await static import from as",literal:"true false null undefined NaN Infinity",built_in:"eval isFinite isNaN parseFloat parseInt decodeURI decodeURIComponent encodeURI encodeURIComponent escape unescape Object Function Boolean Error EvalError InternalError RangeError ReferenceError StopIteration SyntaxError TypeError URIError Number Math Date String RegExp Array Float32Array Float64Array Int16Array Int32Array Int8Array Uint16Array Uint32Array Uint8Array Uint8ClampedArray ArrayBuffer DataView JSON Intl arguments require module console window document Symbol Set Map WeakSet WeakMap Proxy Reflect Promise"},a={cN:"number",v:[{b:"\\b(0[bB][01]+)"},{b:"\\b(0[oO][0-7]+)"},{b:e.CNR}],r:0},n={cN:"subst",b:"\\$\\{",e:"\\}",k:t,c:[]},c={cN:"string",b:"`",e:"`",c:[e.BE,n]};n.c=[e.ASM,e.QSM,c,a,e.RM];var s=n.c.concat([e.CBCM,e.CLCM]);return{aliases:["js","jsx"],k:t,c:[{cN:"meta",r:10,b:/^\s*['"]use (strict|asm)['"]/},{cN:"meta",b:/^#!/,e:/$/},e.ASM,e.QSM,c,e.CLCM,e.CBCM,a,{b:/[{,]\s*/,r:0,c:[{b:r+"\\s*:",rB:!0,r:0,c:[{cN:"attr",b:r,r:0}]}]},{b:"("+e.RSR+"|\\b(case|return|throw)\\b)\\s*",k:"return throw case",c:[e.CLCM,e.CBCM,e.RM,{cN:"function",b:"(\\(.*?\\)|"+r+")\\s*=>",rB:!0,e:"\\s*=>",c:[{cN:"params",v:[{b:r},{b:/\(\s*\)/},{b:/\(/,e:/\)/,eB:!0,eE:!0,k:t,c:s}]}]},{b:/</,e:/(\/\w+|\w+\/)>/,sL:"xml",c:[{b:/<\w+\s*\/>/,skip:!0},{b:/<\w+/,e:/(\/\w+|\w+\/)>/,skip:!0,c:[{b:/<\w+\s*\/>/,skip:!0},"self"]}]}],r:0},{cN:"function",bK:"function",e:/\{/,eE:!0,c:[e.inherit(e.TM,{b:r}),{cN:"params",b:/\(/,e:/\)/,eB:!0,eE:!0,c:s}],i:/\[|%/},{b:/\$[(.]/},e.METHOD_GUARD,{cN:"class",bK:"class",e:/[{;=]/,eE:!0,i:/[:"\[\]]/,c:[{bK:"extends"},e.UTM]},{bK:"constructor",e:/\{/,eE:!0}],i:/#(?!!)/}});hljs.registerLanguage("python",function(e){var r={keyword:"and elif is global as in if from raise for except finally print import pass return exec else break not with class assert yield try while continue del or def lambda async await nonlocal|10 None True False",built_in:"Ellipsis NotImplemented"},b={cN:"meta",b:/^(>>>|\.\.\.) /},c={cN:"subst",b:/\{/,e:/\}/,k:r,i:/#/},a={cN:"string",c:[e.BE],v:[{b:/(u|b)?r?'''/,e:/'''/,c:[b],r:10},{b:/(u|b)?r?"""/,e:/"""/,c:[b],r:10},{b:/(fr|rf|f)'''/,e:/'''/,c:[b,c]},{b:/(fr|rf|f)"""/,e:/"""/,c:[b,c]},{b:/(u|r|ur)'/,e:/'/,r:10},{b:/(u|r|ur)"/,e:/"/,r:10},{b:/(b|br)'/,e:/'/},{b:/(b|br)"/,e:/"/},{b:/(fr|rf|f)'/,e:/'/,c:[c]},{b:/(fr|rf|f)"/,e:/"/,c:[c]},e.ASM,e.QSM]},s={cN:"number",r:0,v:[{b:e.BNR+"[lLjJ]?"},{b:"\\b(0o[0-7]+)[lLjJ]?"},{b:e.CNR+"[lLjJ]?"}]},i={cN:"params",b:/\(/,e:/\)/,c:["self",b,s,a]};return c.c=[a,s,b],{aliases:["py","gyp"],k:r,i:/(<\/|->|\?)|=>/,c:[b,s,a,e.HCM,{v:[{cN:"function",bK:"def"},{cN:"class",bK:"class"}],e:/:/,i:/[${=;\n,]/,c:[e.UTM,i,{b:/->/,eW:!0,k:"None"}]},{cN:"meta",b:/^[\t ]*@/,e:/$/},{b:/\b(print|exec)\(/}]}});hljs.registerLanguage("xml",function(s){var e="[A-Za-z0-9\\._:-]+",t={eW:!0,i:/</,r:0,c:[{cN:"attr",b:e,r:0},{b:/=\s*/,r:0,c:[{cN:"string",endsParent:!0,v:[{b:/"/,e:/"/},{b:/'/,e:/'/},{b:/[^\s"'=<>`]+/}]}]}]};return{aliases:["html","xhtml","rss","atom","xjb","xsd","xsl","plist"],cI:!0,c:[{cN:"meta",b:"<!DOCTYPE",e:">",r:10,c:[{b:"\\[",e:"\\]"}]},s.C("<!--","-->",{r:10}),{b:"<\\!\\[CDATA\\[",e:"\\]\\]>",r:10},{b:/<\?(php)?/,e:/\?>/,sL:"php",c:[{b:"/\\*",e:"\\*/",skip:!0}]},{cN:"tag",b:"<style(?=\\s|>|$)",e:">",k:{name:"style"},c:[t],starts:{e:"</style>",rE:!0,sL:["css","xml"]}},{cN:"tag",b:"<script(?=\\s|>|$)",e:">",k:{name:"script"},c:[t],starts:{e:"</script>",rE:!0,sL:["actionscript","javascript","handlebars","xml"]}},{cN:"meta",v:[{b:/<\?xml/,e:/\?>/,r:10},{b:/<\?\w+/,e:/\?>/}]},{cN:"tag",b:"</?",e:"/?>",c:[{cN:"name",b:/[^\/><\s]+/,r:0},t]}]}});hljs.registerLanguage("markdown",function(e){return{aliases:["md","mkdown","mkd"],c:[{cN:"section",v:[{b:"^#{1,6}",e:"$"},{b:"^.+?\\n[=-]{2,}$"}]},{b:"<",e:">",sL:"xml",r:0},{cN:"bullet",b:"^([*+-]|(\\d+\\.))\\s+"},{cN:"strong",b:"[*_]{2}.+?[*_]{2}"},{cN:"emphasis",v:[{b:"\\*.+?\\*"},{b:"_.+?_",r:0}]},{cN:"quote",b:"^>\\s+",e:"$"},{cN:"code",v:[{b:"^```w*s*$",e:"^```s*$"},{b:"`.+?`"},{b:"^( {4}| )",e:"$",r:0}]},{b:"^[-\\*]{3,}",e:"$"},{b:"\\[.+?\\][\\(\\[].*?[\\)\\]]",rB:!0,c:[{cN:"string",b:"\\[",e:"\\]",eB:!0,rE:!0,r:0},{cN:"link",b:"\\]\\(",e:"\\)",eB:!0,eE:!0},{cN:"symbol",b:"\\]\\[",e:"\\]",eB:!0,eE:!0}],r:10},{b:/^\[[^\n]+\]:/,rB:!0,c:[{cN:"symbol",b:/\[/,e:/\]/,eB:!0,eE:!0},{cN:"link",b:/:\s*/,e:/$/,eB:!0}]}]}});hljs.registerLanguage("php",function(e){var c={b:"\\$+[a-zA-Z_-ÿ][a-zA-Z0-9_-ÿ]*"},i={cN:"meta",b:/<\?(php)?|\?>/},t={cN:"string",c:[e.BE,i],v:[{b:'b"',e:'"'},{b:"b'",e:"'"},e.inherit(e.ASM,{i:null}),e.inherit(e.QSM,{i:null})]},a={v:[e.BNM,e.CNM]};return{aliases:["php3","php4","php5","php6"],cI:!0,k:"and include_once list abstract global private echo interface as static endswitch array null if endwhile or const for endforeach self var while isset public protected exit foreach throw elseif include __FILE__ empty require_once do xor return parent clone use __CLASS__ __LINE__ else break print eval new catch __METHOD__ case exception default die require __FUNCTION__ enddeclare final try switch continue endfor endif declare unset true false trait goto instanceof insteadof __DIR__ __NAMESPACE__ yield finally",c:[e.HCM,e.C("//","$",{c:[i]}),e.C("/\\*","\\*/",{c:[{cN:"doctag",b:"@[A-Za-z]+"}]}),e.C("__halt_compiler.+?;",!1,{eW:!0,k:"__halt_compiler",l:e.UIR}),{cN:"string",b:/<<<['"]?\w+['"]?$/,e:/^\w+;?$/,c:[e.BE,{cN:"subst",v:[{b:/\$\w+/},{b:/\{\$/,e:/\}/}]}]},i,{cN:"keyword",b:/\$this\b/},c,{b:/(::|->)+[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*/},{cN:"function",bK:"function",e:/[;{]/,eE:!0,i:"\\$|\\[|%",c:[e.UTM,{cN:"params",b:"\\(",e:"\\)",c:["self",c,e.CBCM,t,a]}]},{cN:"class",bK:"class interface",e:"{",eE:!0,i:/[:\(\$"]/,c:[{bK:"extends implements"},e.UTM]},{bK:"namespace",e:";",i:/[\.']/,c:[e.UTM]},{bK:"use",e:";",c:[e.UTM]},{b:"=>"},t,a]}});hljs.registerLanguage("tex",function(c){var e={cN:"tag",b:/\\/,r:0,c:[{cN:"name",v:[{b:/[a-zA-Zа-яА-я]+[*]?/},{b:/[^a-zA-Zа-яА-я0-9]/}],starts:{eW:!0,r:0,c:[{cN:"string",v:[{b:/\[/,e:/\]/},{b:/\{/,e:/\}/}]},{b:/\s*=\s*/,eW:!0,r:0,c:[{cN:"number",b:/-?\d*\.?\d+(pt|pc|mm|cm|in|dd|cc|ex|em)?/}]}]}}]};return{c:[e,{cN:"formula",c:[e],r:0,v:[{b:/\$\$/,e:/\$\$/},{b:/\$/,e:/\$/}]},c.C("%","$",{r:0})]}});hljs.registerLanguage("json",function(e){var i={literal:"true false null"},n=[e.QSM,e.CNM],r={e:",",eW:!0,eE:!0,c:n,k:i},t={b:"{",e:"}",c:[{cN:"attr",b:/"/,e:/"/,c:[e.BE],i:"\\n"},e.inherit(r,{b:/:/})],i:"\\S"},c={b:"\\[",e:"\\]",c:[e.inherit(r)],i:"\\S"};return n.splice(n.length,0,t,c),{c:n,k:i,i:"\\S"}});hljs.registerLanguage("perl",function(e){var t="getpwent getservent quotemeta msgrcv scalar kill dbmclose undef lc ma syswrite tr send umask sysopen shmwrite vec qx utime local oct semctl localtime readpipe do return format read sprintf dbmopen pop getpgrp not getpwnam rewinddir qqfileno qw endprotoent wait sethostent bless s|0 opendir continue each sleep endgrent shutdown dump chomp connect getsockname die socketpair close flock exists index shmgetsub for endpwent redo lstat msgctl setpgrp abs exit select print ref gethostbyaddr unshift fcntl syscall goto getnetbyaddr join gmtime symlink semget splice x|0 getpeername recv log setsockopt cos last reverse gethostbyname getgrnam study formline endhostent times chop length gethostent getnetent pack getprotoent getservbyname rand mkdir pos chmod y|0 substr endnetent printf next open msgsnd readdir use unlink getsockopt getpriority rindex wantarray hex system getservbyport endservent int chr untie rmdir prototype tell listen fork shmread ucfirst setprotoent else sysseek link getgrgid shmctl waitpid unpack getnetbyname reset chdir grep split require caller lcfirst until warn while values shift telldir getpwuid my getprotobynumber delete and sort uc defined srand accept package seekdir getprotobyname semop our rename seek if q|0 chroot sysread setpwent no crypt getc chown sqrt write setnetent setpriority foreach tie sin msgget map stat getlogin unless elsif truncate exec keys glob tied closedirioctl socket readlink eval xor readline binmode setservent eof ord bind alarm pipe atan2 getgrent exp time push setgrent gt lt or ne m|0 break given say state when",r={cN:"subst",b:"[$@]\\{",e:"\\}",k:t},s={b:"->{",e:"}"},n={v:[{b:/\$\d/},{b:/[\$%@](\^\w\b|#\w+(::\w+)*|{\w+}|\w+(::\w*)*)/},{b:/[\$%@][^\s\w{]/,r:0}]},i=[e.BE,r,n],o=[n,e.HCM,e.C("^\\=\\w","\\=cut",{eW:!0}),s,{cN:"string",c:i,v:[{b:"q[qwxr]?\\s*\\(",e:"\\)",r:5},{b:"q[qwxr]?\\s*\\[",e:"\\]",r:5},{b:"q[qwxr]?\\s*\\{",e:"\\}",r:5},{b:"q[qwxr]?\\s*\\|",e:"\\|",r:5},{b:"q[qwxr]?\\s*\\<",e:"\\>",r:5},{b:"qw\\s+q",e:"q",r:5},{b:"'",e:"'",c:[e.BE]},{b:'"',e:'"'},{b:"`",e:"`",c:[e.BE]},{b:"{\\w+}",c:[],r:0},{b:"-?\\w+\\s*\\=\\>",c:[],r:0}]},{cN:"number",b:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b",r:0},{b:"(\\/\\/|"+e.RSR+"|\\b(split|return|print|reverse|grep)\\b)\\s*",k:"split return print reverse grep",r:0,c:[e.HCM,{cN:"regexp",b:"(s|tr|y)/(\\\\.|[^/])*/(\\\\.|[^/])*/[a-z]*",r:10},{cN:"regexp",b:"(m|qr)?/",e:"/[a-z]*",c:[e.BE],r:0}]},{cN:"function",bK:"sub",e:"(\\s*\\(.*?\\))?[;{]",eE:!0,r:5,c:[e.TM]},{b:"-\\w\\b",r:0},{b:"^__DATA__$",e:"^__END__$",sL:"mojolicious",c:[{b:"^@@.*",e:"$",cN:"comment"}]}];return r.c=o,s.c=o,{aliases:["pl","pm"],l:/[\w\.]+/,k:t,c:o}});hljs.registerLanguage("ruby",function(e){var b="[a-zA-Z_]\\w*[!?=]?|[-+~]\\@|<<|>>|=~|===?|<=>|[<>]=?|\\*\\*|[-/+%^&*~`|]|\\[\\]=?",r={keyword:"and then defined module in return redo if BEGIN retry end for self when next until do begin unless END rescue else break undef not super class case require yield alias while ensure elsif or include attr_reader attr_writer attr_accessor",literal:"true false nil"},c={cN:"doctag",b:"@[A-Za-z]+"},a={b:"#<",e:">"},s=[e.C("#","$",{c:[c]}),e.C("^\\=begin","^\\=end",{c:[c],r:10}),e.C("^__END__","\\n$")],n={cN:"subst",b:"#\\{",e:"}",k:r},t={cN:"string",c:[e.BE,n],v:[{b:/'/,e:/'/},{b:/"/,e:/"/},{b:/`/,e:/`/},{b:"%[qQwWx]?\\(",e:"\\)"},{b:"%[qQwWx]?\\[",e:"\\]"},{b:"%[qQwWx]?{",e:"}"},{b:"%[qQwWx]?<",e:">"},{b:"%[qQwWx]?/",e:"/"},{b:"%[qQwWx]?%",e:"%"},{b:"%[qQwWx]?-",e:"-"},{b:"%[qQwWx]?\\|",e:"\\|"},{b:/\B\?(\\\d{1,3}|\\x[A-Fa-f0-9]{1,2}|\\u[A-Fa-f0-9]{4}|\\?\S)\b/},{b:/<<(-?)\w+$/,e:/^\s*\w+$/}]},i={cN:"params",b:"\\(",e:"\\)",endsParent:!0,k:r},d=[t,a,{cN:"class",bK:"class module",e:"$|;",i:/=/,c:[e.inherit(e.TM,{b:"[A-Za-z_]\\w*(::\\w+)*(\\?|\\!)?"}),{b:"<\\s*",c:[{b:"("+e.IR+"::)?"+e.IR}]}].concat(s)},{cN:"function",bK:"def",e:"$|;",c:[e.inherit(e.TM,{b:b}),i].concat(s)},{b:e.IR+"::"},{cN:"symbol",b:e.UIR+"(\\!|\\?)?:",r:0},{cN:"symbol",b:":(?!\\s)",c:[t,{b:b}],r:0},{cN:"number",b:"(\\b0[0-7_]+)|(\\b0x[0-9a-fA-F_]+)|(\\b[1-9][0-9_]*(\\.[0-9_]+)?)|[0_]\\b",r:0},{b:"(\\$\\W)|((\\$|\\@\\@?)(\\w+))"},{cN:"params",b:/\|/,e:/\|/,k:r},{b:"("+e.RSR+"|unless)\\s*",k:"unless",c:[a,{cN:"regexp",c:[e.BE,n],i:/\n/,v:[{b:"/",e:"/[a-z]*"},{b:"%r{",e:"}[a-z]*"},{b:"%r\\(",e:"\\)[a-z]*"},{b:"%r!",e:"![a-z]*"},{b:"%r\\[",e:"\\][a-z]*"}]}].concat(s),r:0}].concat(s);n.c=d,i.c=d;var l="[>?]>",o="[\\w#]+\\(\\w+\\):\\d+:\\d+>",u="(\\w+-)?\\d+\\.\\d+\\.\\d(p\\d+)?[^>]+>",w=[{b:/^\s*=>/,starts:{e:"$",c:d}},{cN:"meta",b:"^("+l+"|"+o+"|"+u+")",starts:{e:"$",c:d}}];return{aliases:["rb","gemspec","podspec","thor","irb"],k:r,i:/\/\*/,c:s.concat(w).concat(d)}});hljs.registerLanguage("makefile",function(e){var i={cN:"variable",v:[{b:"\\$\\("+e.UIR+"\\)",c:[e.BE]},{b:/\$[@%<?\^\+\*]/}]},r={cN:"string",b:/"/,e:/"/,c:[e.BE,i]},a={cN:"variable",b:/\$\([\w-]+\s/,e:/\)/,k:{built_in:"subst patsubst strip findstring filter filter-out sort word wordlist firstword lastword dir notdir suffix basename addsuffix addprefix join wildcard realpath abspath error warning shell origin flavor foreach if or and call eval file value"},c:[i]},n={b:"^"+e.UIR+"\\s*[:+?]?=",i:"\\n",rB:!0,c:[{b:"^"+e.UIR,e:"[:+?]?=",eE:!0}]},t={cN:"meta",b:/^\.PHONY:/,e:/$/,k:{"meta-keyword":".PHONY"},l:/[\.\w]+/},l={cN:"section",b:/^[^\s]+:/,e:/$/,c:[i]};return{aliases:["mk","mak"],k:"define endef undefine ifdef ifndef ifeq ifneq else endif include -include sinclude override export unexport private vpath",l:/[\w-]+/,c:[e.HCM,i,r,a,n,t,l]}});hljs.registerLanguage("typescript",function(e){var r={keyword:"in if for while finally var new function do return void else break catch instanceof with throw case default try this switch continue typeof delete let yield const class public private protected get set super static implements enum export import declare type namespace abstract as from extends async await",literal:"true false null undefined NaN Infinity",built_in:"eval isFinite isNaN parseFloat parseInt decodeURI decodeURIComponent encodeURI encodeURIComponent escape unescape Object Function Boolean Error EvalError InternalError RangeError ReferenceError StopIteration SyntaxError TypeError URIError Number Math Date String RegExp Array Float32Array Float64Array Int16Array Int32Array Int8Array Uint16Array Uint32Array Uint8Array Uint8ClampedArray ArrayBuffer DataView JSON Intl arguments require module console window document any number boolean string void Promise"};return{aliases:["ts"],k:r,c:[{cN:"meta",b:/^\s*['"]use strict['"]/},e.ASM,e.QSM,{cN:"string",b:"`",e:"`",c:[e.BE,{cN:"subst",b:"\\$\\{",e:"\\}"}]},e.CLCM,e.CBCM,{cN:"number",v:[{b:"\\b(0[bB][01]+)"},{b:"\\b(0[oO][0-7]+)"},{b:e.CNR}],r:0},{b:"("+e.RSR+"|\\b(case|return|throw)\\b)\\s*",k:"return throw case",c:[e.CLCM,e.CBCM,e.RM,{cN:"function",b:"(\\(.*?\\)|"+e.IR+")\\s*=>",rB:!0,e:"\\s*=>",c:[{cN:"params",v:[{b:e.IR},{b:/\(\s*\)/},{b:/\(/,e:/\)/,eB:!0,eE:!0,k:r,c:["self",e.CLCM,e.CBCM]}]}]}],r:0},{cN:"function",b:"function",e:/[\{;]/,eE:!0,k:r,c:["self",e.inherit(e.TM,{b:/[A-Za-z$_][0-9A-Za-z$_]*/}),{cN:"params",b:/\(/,e:/\)/,eB:!0,eE:!0,k:r,c:[e.CLCM,e.CBCM],i:/["'\(]/}],i:/%/,r:0},{bK:"constructor",e:/\{/,eE:!0,c:["self",{cN:"params",b:/\(/,e:/\)/,eB:!0,eE:!0,k:r,c:[e.CLCM,e.CBCM],i:/["'\(]/}]},{b:/module\./,k:{built_in:"module"},r:0},{bK:"module",e:/\{/,eE:!0},{bK:"interface",e:/\{/,eE:!0,k:"interface extends"},{b:/\$[(.]/},{b:"\\."+e.IR,r:0},{cN:"meta",b:"@[A-Za-z]+"}]}});hljs.registerLanguage("css",function(e){var c="[a-zA-Z-][a-zA-Z0-9_-]*",t={b:/[A-Z\_\.\-]+\s*:/,rB:!0,e:";",eW:!0,c:[{cN:"attribute",b:/\S/,e:":",eE:!0,starts:{eW:!0,eE:!0,c:[{b:/[\w-]+\(/,rB:!0,c:[{cN:"built_in",b:/[\w-]+/},{b:/\(/,e:/\)/,c:[e.ASM,e.QSM]}]},e.CSSNM,e.QSM,e.ASM,e.CBCM,{cN:"number",b:"#[0-9A-Fa-f]+"},{cN:"meta",b:"!important"}]}}]};return{cI:!0,i:/[=\/|'\$]/,c:[e.CBCM,{cN:"selector-id",b:/#[A-Za-z0-9_-]+/},{cN:"selector-class",b:/\.[A-Za-z0-9_-]+/},{cN:"selector-attr",b:/\[/,e:/\]/,i:"$"},{cN:"selector-pseudo",b:/:(:)?[a-zA-Z0-9\_\-\+\(\)"'.]+/},{b:"@(font-face|page)",l:"[a-z-]+",k:"font-face page"},{b:"@",e:"[{;]",i:/:/,c:[{cN:"keyword",b:/\w+/},{b:/\s/,eW:!0,eE:!0,r:0,c:[e.ASM,e.QSM,e.CSSNM]}]},{cN:"selector-tag",b:c,r:0},{b:"{",e:"}",i:/\S/,c:[e.CBCM,t]}]}});hljs.registerLanguage("java",function(e){var a="[À-ʸa-zA-Z_$][À-ʸa-zA-Z_$0-9]*",t=a+"(<"+a+"(\\s*,\\s*"+a+")*>)?",r="false synchronized int abstract float private char boolean static null if const for true while long strictfp finally protected import native final void enum else break transient catch instanceof byte super volatile case assert short package default double public try this switch continue throws protected public private module requires exports do",s="\\b(0[bB]([01]+[01_]+[01]+|[01]+)|0[xX]([a-fA-F0-9]+[a-fA-F0-9_]+[a-fA-F0-9]+|[a-fA-F0-9]+)|(([\\d]+[\\d_]+[\\d]+|[\\d]+)(\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))?|\\.([\\d]+[\\d_]+[\\d]+|[\\d]+))([eE][-+]?\\d+)?)[lLfF]?",c={cN:"number",b:s,r:0};return{aliases:["jsp"],k:r,i:/<\/|#/,c:[e.C("/\\*\\*","\\*/",{r:0,c:[{b:/\w+@/,r:0},{cN:"doctag",b:"@[A-Za-z]+"}]}),e.CLCM,e.CBCM,e.ASM,e.QSM,{cN:"class",bK:"class interface",e:/[{;=]/,eE:!0,k:"class interface",i:/[:"\[\]]/,c:[{bK:"extends implements"},e.UTM]},{bK:"new throw return else",r:0},{cN:"function",b:"("+t+"\\s+)+"+e.UIR+"\\s*\\(",rB:!0,e:/[{;=]/,eE:!0,k:r,c:[{b:e.UIR+"\\s*\\(",rB:!0,r:0,c:[e.UTM]},{cN:"params",b:/\(/,e:/\)/,k:r,r:0,c:[e.ASM,e.QSM,e.CNM,e.CBCM]},e.CLCM,e.CBCM]},c,{cN:"meta",b:"@[A-Za-z]+"}]}});hljs.registerLanguage("cpp",function(t){var e={cN:"keyword",b:"\\b[a-z\\d_]*_t\\b"},r={cN:"string",v:[{b:'(u8?|U)?L?"',e:'"',i:"\\n",c:[t.BE]},{b:'(u8?|U)?R"',e:'"',c:[t.BE]},{b:"'\\\\?.",e:"'",i:"."}]},s={cN:"number",v:[{b:"\\b(0b[01']+)"},{b:"(-?)\\b([\\d']+(\\.[\\d']*)?|\\.[\\d']+)(u|U|l|L|ul|UL|f|F|b|B)"},{b:"(-?)(\\b0[xX][a-fA-F0-9']+|(\\b[\\d']+(\\.[\\d']*)?|\\.[\\d']+)([eE][-+]?[\\d']+)?)"}],r:0},i={cN:"meta",b:/#\s*[a-z]+\b/,e:/$/,k:{"meta-keyword":"if else elif endif define undef warning error line pragma ifdef ifndef include"},c:[{b:/\\\n/,r:0},t.inherit(r,{cN:"meta-string"}),{cN:"meta-string",b:/<[^\n>]*>/,e:/$/,i:"\\n"},t.CLCM,t.CBCM]},a=t.IR+"\\s*\\(",c={keyword:"int float while private char catch import module export virtual operator sizeof dynamic_cast|10 typedef const_cast|10 const for static_cast|10 union namespace unsigned long volatile static protected bool template mutable if public friend do goto auto void enum else break extern using asm case typeid short reinterpret_cast|10 default double register explicit signed typename try this switch continue inline delete alignof constexpr decltype noexcept static_assert thread_local restrict _Bool complex _Complex _Imaginary atomic_bool atomic_char atomic_schar atomic_uchar atomic_short atomic_ushort atomic_int atomic_uint atomic_long atomic_ulong atomic_llong atomic_ullong new throw return and or not",built_in:"std string cin cout cerr clog stdin stdout stderr stringstream istringstream ostringstream auto_ptr deque list queue stack vector map set bitset multiset multimap unordered_set unordered_map unordered_multiset unordered_multimap array shared_ptr abort abs acos asin atan2 atan calloc ceil cosh cos exit exp fabs floor fmod fprintf fputs free frexp fscanf isalnum isalpha iscntrl isdigit isgraph islower isprint ispunct isspace isupper isxdigit tolower toupper labs ldexp log10 log malloc realloc memchr memcmp memcpy memset modf pow printf putchar puts scanf sinh sin snprintf sprintf sqrt sscanf strcat strchr strcmp strcpy strcspn strlen strncat strncmp strncpy strpbrk strrchr strspn strstr tanh tan vfprintf vprintf vsprintf endl initializer_list unique_ptr",literal:"true false nullptr NULL"},n=[e,t.CLCM,t.CBCM,s,r];return{aliases:["c","cc","h","c++","h++","hpp"],k:c,i:"</",c:n.concat([i,{b:"\\b(deque|list|queue|stack|vector|map|set|bitset|multiset|multimap|unordered_map|unordered_set|unordered_multiset|unordered_multimap|array)\\s*<",e:">",k:c,c:["self",e]},{b:t.IR+"::",k:c},{v:[{b:/=/,e:/;/},{b:/\(/,e:/\)/},{bK:"new throw return else",e:/;/}],k:c,c:n.concat([{b:/\(/,e:/\)/,k:c,c:n.concat(["self"]),r:0}]),r:0},{cN:"function",b:"("+t.IR+"[\\*&\\s]+)+"+a,rB:!0,e:/[{;=]/,eE:!0,k:c,i:/[^\w\s\*&]/,c:[{b:a,rB:!0,c:[t.TM],r:0},{cN:"params",b:/\(/,e:/\)/,k:c,r:0,c:[t.CLCM,t.CBCM,r,s,e]},t.CLCM,t.CBCM,i]},{cN:"class",bK:"class struct",e:/[{;:]/,c:[{b:/</,e:/>/,c:["self"]},t.TM]}]),exports:{preprocessor:i,strings:r,k:c}}});hljs.registerLanguage("bash",function(e){var t={cN:"variable",v:[{b:/\$[\w\d#@][\w\d_]*/},{b:/\$\{(.*?)}/}]},s={cN:"string",b:/"/,e:/"/,c:[e.BE,t,{cN:"variable",b:/\$\(/,e:/\)/,c:[e.BE]}]},a={cN:"string",b:/'/,e:/'/};return{aliases:["sh","zsh"],l:/\b-?[a-z\._]+\b/,k:{keyword:"if then else elif fi for while in do done case esac function",literal:"true false",built_in:"break cd continue eval exec exit export getopts hash pwd readonly return shift test times trap umask unset alias bind builtin caller command declare echo enable help let local logout mapfile printf read readarray source type typeset ulimit unalias set shopt autoload bg bindkey bye cap chdir clone comparguments compcall compctl compdescribe compfiles compgroups compquote comptags comptry compvalues dirs disable disown echotc echoti emulate fc fg float functions getcap getln history integer jobs kill limit log noglob popd print pushd pushln rehash sched setcap setopt stat suspend ttyctl unfunction unhash unlimit unsetopt vared wait whence where which zcompile zformat zftp zle zmodload zparseopts zprof zpty zregexparse zsocket zstyle ztcp",_:"-ne -eq -lt -gt -f -d -e -s -l -a"},c:[{cN:"meta",b:/^#![^\n]+sh\s*$/,r:10},{cN:"function",b:/\w[\w\d_]*\s*\(\s*\)\s*\{/,rB:!0,c:[e.inherit(e.TM,{b:/\w[\w\d_]*/})],r:0},e.HCM,s,a,t]}});hljs.registerLanguage("shell",function(s){return{aliases:["console"],c:[{cN:"meta",b:"^\\s{0,3}[\\w\\d\\[\\]()@-]*[>%$#]",starts:{e:"$",sL:"bash"}}]}});hljs.registerLanguage("http",function(e){var t="HTTP/[0-9\\.]+";return{aliases:["https"],i:"\\S",c:[{b:"^"+t,e:"$",c:[{cN:"number",b:"\\b\\d{3}\\b"}]},{b:"^[A-Z]+ (.*?) "+t+"$",rB:!0,e:"$",c:[{cN:"string",b:" ",e:" ",eB:!0,eE:!0},{b:t},{cN:"keyword",b:"[A-Z]+"}]},{cN:"attribute",b:"^\\w",e:": ",eE:!0,i:"\\n|\\s|=",starts:{e:"$",r:0}},{b:"\\n\\n",starts:{sL:[],eW:!0}}]}});hljs.registerLanguage("cs",function(e){var i={keyword:"abstract as base bool break byte case catch char checked const continue decimal default delegate do double enum event explicit extern finally fixed float for foreach goto if implicit in int interface internal is lock long nameof object operator out override params private protected public readonly ref sbyte sealed short sizeof stackalloc static string struct switch this try typeof uint ulong unchecked unsafe ushort using virtual void volatile while add alias ascending async await by descending dynamic equals from get global group into join let on orderby partial remove select set value var where yield",literal:"null false true"},t={cN:"string",b:'@"',e:'"',c:[{b:'""'}]},r=e.inherit(t,{i:/\n/}),a={cN:"subst",b:"{",e:"}",k:i},c=e.inherit(a,{i:/\n/}),n={cN:"string",b:/\$"/,e:'"',i:/\n/,c:[{b:"{{"},{b:"}}"},e.BE,c]},s={cN:"string",b:/\$@"/,e:'"',c:[{b:"{{"},{b:"}}"},{b:'""'},a]},o=e.inherit(s,{i:/\n/,c:[{b:"{{"},{b:"}}"},{b:'""'},c]});a.c=[s,n,t,e.ASM,e.QSM,e.CNM,e.CBCM],c.c=[o,n,r,e.ASM,e.QSM,e.CNM,e.inherit(e.CBCM,{i:/\n/})];var l={v:[s,n,t,e.ASM,e.QSM]},b=e.IR+"(<"+e.IR+"(\\s*,\\s*"+e.IR+")*>)?(\\[\\])?";return{aliases:["csharp"],k:i,i:/::/,c:[e.C("///","$",{rB:!0,c:[{cN:"doctag",v:[{b:"///",r:0},{b:"<!--|-->"},{b:"</?",e:">"}]}]}),e.CLCM,e.CBCM,{cN:"meta",b:"#",e:"$",k:{"meta-keyword":"if else elif endif define undef warning error line region endregion pragma checksum"}},l,e.CNM,{bK:"class interface",e:/[{;=]/,i:/[^\s:]/,c:[e.TM,e.CLCM,e.CBCM]},{bK:"namespace",e:/[{;=]/,i:/[^\s:]/,c:[e.inherit(e.TM,{b:"[a-zA-Z](\\.?\\w)*"}),e.CLCM,e.CBCM]},{cN:"meta",b:"^\\s*\\[",eB:!0,e:"\\]",eE:!0,c:[{cN:"meta-string",b:/"/,e:/"/}]},{bK:"new return throw await else",r:0},{cN:"function",b:"("+b+"\\s+)+"+e.IR+"\\s*\\(",rB:!0,e:/[{;=]/,eE:!0,k:i,c:[{b:e.IR+"\\s*\\(",rB:!0,c:[e.TM],r:0},{cN:"params",b:/\(/,e:/\)/,eB:!0,eE:!0,k:i,r:0,c:[l,e.CNM,e.CBCM]},e.CLCM,e.CBCM]}]}});hljs.registerLanguage("coffeescript",function(e){var c={keyword:"in if for while finally new do return else break catch instanceof throw try this switch continue typeof delete debugger super yield import export from as default await then unless until loop of by when and or is isnt not",literal:"true false null undefined yes no on off",built_in:"npm require console print module global window document"},n="[A-Za-z$_][0-9A-Za-z$_]*",r={cN:"subst",b:/#\{/,e:/}/,k:c},i=[e.BNM,e.inherit(e.CNM,{starts:{e:"(\\s*/)?",r:0}}),{cN:"string",v:[{b:/'''/,e:/'''/,c:[e.BE]},{b:/'/,e:/'/,c:[e.BE]},{b:/"""/,e:/"""/,c:[e.BE,r]},{b:/"/,e:/"/,c:[e.BE,r]}]},{cN:"regexp",v:[{b:"///",e:"///",c:[r,e.HCM]},{b:"//[gim]*",r:0},{b:/\/(?![ *])(\\\/|.)*?\/[gim]*(?=\W|$)/}]},{b:"@"+n},{sL:"javascript",eB:!0,eE:!0,v:[{b:"```",e:"```"},{b:"`",e:"`"}]}];r.c=i;var s=e.inherit(e.TM,{b:n}),t="(\\(.*\\))?\\s*\\B[-=]>",o={cN:"params",b:"\\([^\\(]",rB:!0,c:[{b:/\(/,e:/\)/,k:c,c:["self"].concat(i)}]};return{aliases:["coffee","cson","iced"],k:c,i:/\/\*/,c:i.concat([e.C("###","###"),e.HCM,{cN:"function",b:"^\\s*"+n+"\\s*=\\s*"+t,e:"[-=]>",rB:!0,c:[s,o]},{b:/[:\(,=]\s*/,r:0,c:[{cN:"function",b:t,e:"[-=]>",rB:!0,c:[o]}]},{cN:"class",bK:"class",e:"$",i:/[:="\[\]]/,c:[{bK:"extends",eW:!0,i:/[:="\[\]]/,c:[s]},s]},{b:n+":",e:":",rB:!0,rE:!0,r:0}])}});hljs.registerLanguage("sql",function(e){var t=e.C("--","$");return{cI:!0,i:/[<>{}*#]/,c:[{bK:"begin end start commit rollback savepoint lock alter create drop rename call delete do handler insert load replace select truncate update set show pragma grant merge describe use explain help declare prepare execute deallocate release unlock purge reset change stop analyze cache flush optimize repair kill install uninstall checksum restore check backup revoke comment",e:/;/,eW:!0,l:/[\w\.]+/,k:{keyword:"abort abs absolute acc acce accep accept access accessed accessible account acos action activate add addtime admin administer advanced advise aes_decrypt aes_encrypt after agent aggregate ali alia alias allocate allow alter always analyze ancillary and any anydata anydataset anyschema anytype apply archive archived archivelog are as asc ascii asin assembly assertion associate asynchronous at atan atn2 attr attri attrib attribu attribut attribute attributes audit authenticated authentication authid authors auto autoallocate autodblink autoextend automatic availability avg backup badfile basicfile before begin beginning benchmark between bfile bfile_base big bigfile bin binary_double binary_float binlog bit_and bit_count bit_length bit_or bit_xor bitmap blob_base block blocksize body both bound buffer_cache buffer_pool build bulk by byte byteordermark bytes cache caching call calling cancel capacity cascade cascaded case cast catalog category ceil ceiling chain change changed char_base char_length character_length characters characterset charindex charset charsetform charsetid check checksum checksum_agg child choose chr chunk class cleanup clear client clob clob_base clone close cluster_id cluster_probability cluster_set clustering coalesce coercibility col collate collation collect colu colum column column_value columns columns_updated comment commit compact compatibility compiled complete composite_limit compound compress compute concat concat_ws concurrent confirm conn connec connect connect_by_iscycle connect_by_isleaf connect_by_root connect_time connection consider consistent constant constraint constraints constructor container content contents context contributors controlfile conv convert convert_tz corr corr_k corr_s corresponding corruption cos cost count count_big counted covar_pop covar_samp cpu_per_call cpu_per_session crc32 create creation critical cross cube cume_dist curdate current current_date current_time current_timestamp current_user cursor curtime customdatum cycle data database databases datafile datafiles datalength date_add date_cache date_format date_sub dateadd datediff datefromparts datename datepart datetime2fromparts day day_to_second dayname dayofmonth dayofweek dayofyear days db_role_change dbtimezone ddl deallocate declare decode decompose decrement decrypt deduplicate def defa defau defaul default defaults deferred defi defin define degrees delayed delegate delete delete_all delimited demand dense_rank depth dequeue des_decrypt des_encrypt des_key_file desc descr descri describ describe descriptor deterministic diagnostics difference dimension direct_load directory disable disable_all disallow disassociate discardfile disconnect diskgroup distinct distinctrow distribute distributed div do document domain dotnet double downgrade drop dumpfile duplicate duration each edition editionable editions element ellipsis else elsif elt empty enable enable_all enclosed encode encoding encrypt end end-exec endian enforced engine engines enqueue enterprise entityescaping eomonth error errors escaped evalname evaluate event eventdata events except exception exceptions exchange exclude excluding execu execut execute exempt exists exit exp expire explain export export_set extended extent external external_1 external_2 externally extract failed failed_login_attempts failover failure far fast feature_set feature_value fetch field fields file file_name_convert filesystem_like_logging final finish first first_value fixed flash_cache flashback floor flush following follows for forall force form forma format found found_rows freelist freelists freepools fresh from from_base64 from_days ftp full function general generated get get_format get_lock getdate getutcdate global global_name globally go goto grant grants greatest group group_concat group_id grouping grouping_id groups gtid_subtract guarantee guard handler hash hashkeys having hea head headi headin heading heap help hex hierarchy high high_priority hosts hour http id ident_current ident_incr ident_seed identified identity idle_time if ifnull ignore iif ilike ilm immediate import in include including increment index indexes indexing indextype indicator indices inet6_aton inet6_ntoa inet_aton inet_ntoa infile initial initialized initially initrans inmemory inner innodb input insert install instance instantiable instr interface interleaved intersect into invalidate invisible is is_free_lock is_ipv4 is_ipv4_compat is_not is_not_null is_used_lock isdate isnull isolation iterate java join json json_exists keep keep_duplicates key keys kill language large last last_day last_insert_id last_value lax lcase lead leading least leaves left len lenght length less level levels library like like2 like4 likec limit lines link list listagg little ln load load_file lob lobs local localtime localtimestamp locate locator lock locked log log10 log2 logfile logfiles logging logical logical_reads_per_call logoff logon logs long loop low low_priority lower lpad lrtrim ltrim main make_set makedate maketime managed management manual map mapping mask master master_pos_wait match matched materialized max maxextents maximize maxinstances maxlen maxlogfiles maxloghistory maxlogmembers maxsize maxtrans md5 measures median medium member memcompress memory merge microsecond mid migration min minextents minimum mining minus minute minvalue missing mod mode model modification modify module monitoring month months mount move movement multiset mutex name name_const names nan national native natural nav nchar nclob nested never new newline next nextval no no_write_to_binlog noarchivelog noaudit nobadfile nocheck nocompress nocopy nocycle nodelay nodiscardfile noentityescaping noguarantee nokeep nologfile nomapping nomaxvalue nominimize nominvalue nomonitoring none noneditionable nonschema noorder nopr nopro noprom nopromp noprompt norely noresetlogs noreverse normal norowdependencies noschemacheck noswitch not nothing notice notrim novalidate now nowait nth_value nullif nulls num numb numbe nvarchar nvarchar2 object ocicoll ocidate ocidatetime ociduration ociinterval ociloblocator ocinumber ociref ocirefcursor ocirowid ocistring ocitype oct octet_length of off offline offset oid oidindex old on online only opaque open operations operator optimal optimize option optionally or oracle oracle_date oradata ord ordaudio orddicom orddoc order ordimage ordinality ordvideo organization orlany orlvary out outer outfile outline output over overflow overriding package pad parallel parallel_enable parameters parent parse partial partition partitions pascal passing password password_grace_time password_lock_time password_reuse_max password_reuse_time password_verify_function patch path patindex pctincrease pctthreshold pctused pctversion percent percent_rank percentile_cont percentile_disc performance period period_add period_diff permanent physical pi pipe pipelined pivot pluggable plugin policy position post_transaction pow power pragma prebuilt precedes preceding precision prediction prediction_cost prediction_details prediction_probability prediction_set prepare present preserve prior priority private private_sga privileges procedural procedure procedure_analyze processlist profiles project prompt protection public publishingservername purge quarter query quick quiesce quota quotename radians raise rand range rank raw read reads readsize rebuild record records recover recovery recursive recycle redo reduced ref reference referenced references referencing refresh regexp_like register regr_avgx regr_avgy regr_count regr_intercept regr_r2 regr_slope regr_sxx regr_sxy reject rekey relational relative relaylog release release_lock relies_on relocate rely rem remainder rename repair repeat replace replicate replication required reset resetlogs resize resource respect restore restricted result result_cache resumable resume retention return returning returns reuse reverse revoke right rlike role roles rollback rolling rollup round row row_count rowdependencies rowid rownum rows rtrim rules safe salt sample save savepoint sb1 sb2 sb4 scan schema schemacheck scn scope scroll sdo_georaster sdo_topo_geometry search sec_to_time second section securefile security seed segment select self sequence sequential serializable server servererror session session_user sessions_per_user set sets settings sha sha1 sha2 share shared shared_pool short show shrink shutdown si_averagecolor si_colorhistogram si_featurelist si_positionalcolor si_stillimage si_texture siblings sid sign sin size size_t sizes skip slave sleep smalldatetimefromparts smallfile snapshot some soname sort soundex source space sparse spfile split sql sql_big_result sql_buffer_result sql_cache sql_calc_found_rows sql_small_result sql_variant_property sqlcode sqldata sqlerror sqlname sqlstate sqrt square standalone standby start starting startup statement static statistics stats_binomial_test stats_crosstab stats_ks_test stats_mode stats_mw_test stats_one_way_anova stats_t_test_ stats_t_test_indep stats_t_test_one stats_t_test_paired stats_wsr_test status std stddev stddev_pop stddev_samp stdev stop storage store stored str str_to_date straight_join strcmp strict string struct stuff style subdate subpartition subpartitions substitutable substr substring subtime subtring_index subtype success sum suspend switch switchoffset switchover sync synchronous synonym sys sys_xmlagg sysasm sysaux sysdate sysdatetimeoffset sysdba sysoper system system_user sysutcdatetime table tables tablespace tan tdo template temporary terminated tertiary_weights test than then thread through tier ties time time_format time_zone timediff timefromparts timeout timestamp timestampadd timestampdiff timezone_abbr timezone_minute timezone_region to to_base64 to_date to_days to_seconds todatetimeoffset trace tracking transaction transactional translate translation treat trigger trigger_nestlevel triggers trim truncate try_cast try_convert try_parse type ub1 ub2 ub4 ucase unarchived unbounded uncompress under undo unhex unicode uniform uninstall union unique unix_timestamp unknown unlimited unlock unpivot unrecoverable unsafe unsigned until untrusted unusable unused update updated upgrade upped upper upsert url urowid usable usage use use_stored_outlines user user_data user_resources users using utc_date utc_timestamp uuid uuid_short validate validate_password_strength validation valist value values var var_samp varcharc vari varia variab variabl variable variables variance varp varraw varrawc varray verify version versions view virtual visible void wait wallet warning warnings week weekday weekofyear wellformed when whene whenev wheneve whenever where while whitespace with within without work wrapped xdb xml xmlagg xmlattributes xmlcast xmlcolattval xmlelement xmlexists xmlforest xmlindex xmlnamespaces xmlpi xmlquery xmlroot xmlschema xmlserialize xmltable xmltype xor year year_to_month years yearweek",literal:"true false null",built_in:"array bigint binary bit blob boolean char character date dec decimal float int int8 integer interval number numeric real record serial serial8 smallint text varchar varying void"},c:[{cN:"string",b:"'",e:"'",c:[e.BE,{b:"''"}]},{cN:"string",b:'"',e:'"',c:[e.BE,{b:'""'}]},{cN:"string",b:"`",e:"`",c:[e.BE]},e.CNM,e.CBCM,t]},e.CBCM,t]}});hljs.registerLanguage("apache",function(e){var r={cN:"number",b:"[\\$%]\\d+"};return{aliases:["apacheconf"],cI:!0,c:[e.HCM,{cN:"section",b:"</?",e:">"},{cN:"attribute",b:/\w+/,r:0,k:{nomarkup:"order deny allow setenv rewriterule rewriteengine rewritecond documentroot sethandler errordocument loadmodule options header listen serverroot servername"},starts:{e:/$/,r:0,k:{literal:"on off all"},c:[{cN:"meta",b:"\\s\\[",e:"\\]$"},{cN:"variable",b:"[\\$%]\\{",e:"\\}",c:["self",r]},r,e.QSM]}}],i:/\S/}}); \ No newline at end of file
diff --git a/doc/prebuilt b/doc/prebuilt
new file mode 160000
Subproject ca53235ccfa0458ebf11c204888ca370e20ec3f
diff --git a/doc/taler-auditor-exchange.1 b/doc/taler-auditor-exchange.1
deleted file mode 100644
index d038c37e0..000000000
--- a/doc/taler-auditor-exchange.1
+++ /dev/null
@@ -1,45 +0,0 @@
1.Dd November 3, 2018
2.Dd TALER-AUDITOR-EXCHANGE 1
3.Os
4.Sh NAME
5.Nm taler-auditor-exchange
6.Nd
7add or remove exchange from auditor's list
8.Sh SYNOPSIS
9.Nm
10.Op Fl h | \-help
11.Op Fl r | \-remove
12.Op Fl m Ar MASTERKEY | Fl \-exchange-key= Ns Ar MASTERKEY
13.Op Fl u Ar EXCHANGE_URL | Fl \-auditor-url= Ns Ar EXCHANGE_URL
14.Sh DESCRIPTION
15.Nm
16is a command line tool to be used by an auditor to add or remove an exchange from the list of exchange's audited by the auditor.
17You must add an exchange to that list before signing denomination keys with taler-auditor-sign or trying to audit it with taler-auditor or taler-wire-auditor.
18Afterwards the exchange will be visible via the /exchanges API of the taler-auditor-httpd.
19.Bl -tag -width Ds
20.It Fl m Ar MASTERKEY | Fl \-exchange-key= Ns Ar MASTERKEY
21Public key of the exchange in Crockford base32 encoding, for example as generated by gnunet-ecc -p.
22.It Fl h | \-help
23Print short help on options.
24.It Fl u Ar EXCHANGE_URL | Fl \-auditor-url= Ns Ar EXCHANGE_URL
25URL of the exchange.
26The exchange's HTTP API must be available at this address.
27.It Fl r | \-remove
28Instead of adding the exchange, remove it.
29Note that this will drop ALL data associated with that exchange, including existing auditing information.
30So use with extreme care!
31.Sh SEE ALSO
32.Xr gnunet-ecc 1 ,
33.Xr taler-auditor-sign 1 ,
34.Xr taler.conf 5
35.Sh BUGS
36We should optionally verify the correctness of this exchange's base URL and that it matches the master public key (note that the exchange may still be offline, so it should be possible to bypass such a verfication step).
37Furthermore, if we do verification, as a (less secure) convenience option, we should make
38.Fl
39m
40optional and obtain it from the base URL.
41.Pp
42Report bugs by using
43.Lk https://gnunet.org/bugs/
44or by sending electronic mail to
45.Aq Mt taler@gnu.org .
diff --git a/doc/taler-auditor-sign.1 b/doc/taler-auditor-sign.1
deleted file mode 100644
index 659dabca9..000000000
--- a/doc/taler-auditor-sign.1
+++ /dev/null
@@ -1,46 +0,0 @@
1.Dd
2.Dt TALER\-AUDITOR\-SIGN 1 "Mar 15, 2016" "GNU Taler"
3.Os
4.Sh NAME
5.Nm taler\-auditor\-sign
6.Nd
7Sign exchange denomination as auditor.
8.Sh SYNOPSIS
9.Nm
10.Op Fl a Ar FILE | Fl \-auditor-key= Ns Ar FILE
11.Op Fl h | \-help
12.Op Fl m Ar KEY | Fl \-exchange-key= Ns Ar KEY
13.Op Fl u Ar URL | Fl \-auditor-url= Ns Ar URL
14.Op Fl r Ar FILE | Fl \-exchange-request= Ns Ar FILE
15.Op Fl o Ar FILE | Fl \-output= Ns Ar FILE
16.Sh DESCRIPTION
17.Nm
18is a command line tool to be used by an auditor to sign that he is aware of certain keys being used by a exchange.
19Using this signature, the auditor affirms that he will verify that the exchange is properly accounting for those coins.
20.Pp
21The exchange for which keys were signed must have been added to the auditor using taler\-auditor\-exchange first!
22.Bl -tag -width Ds
23.It Fl a Ar FILE | Fl \-auditor-key= Ns Ar FILE
24Location of the private EdDSA auditor key.
25If it does not exist, it will be created.
26.It Fl h | \-help
27Print short help on options.
28.It Fl m Ar KEY | Fl \-exchange-key= Ns Ar KEY
29Public key of the exchange in Crockford base32 encoding, for example as generated by gnunet-ecc -p.
30.It Fl u Ar URL | Fl \-auditor-url= Ns Ar URL
31URL of the auditor.
32Provides informative link for the user to learn more about the auditor.
33.It Fl r Ar FILE | Fl \-exchange-request= Ns Ar FILE
34File with the exchange's denomination key signing request as generated by taler-exchange-keyup -o.
35.It Fl o Ar FILE | Fl \-output= Ns Ar FILE
36File where the auditor should write the EdDSA signature.
37.Sh SEE ALSO
38.Xr gnunet-ecc 1 ,
39.Xr taler-auditor-exchange 1 ,
40.Xr taler-exchange-keyup 1 ,
41.Xr taler.conf 5
42.Sh BUGS
43Report bugs by using
44.Lk https://gnunet.org/bugs/
45or by sending electronic mail to
46.Aq Mt taler@gnu.org .
diff --git a/doc/taler-auditor.1 b/doc/taler-auditor.1
deleted file mode 100644
index c0b82d64d..000000000
--- a/doc/taler-auditor.1
+++ /dev/null
@@ -1,43 +0,0 @@
1.Dd March 20, 2017
2.Dt TALER-AUDITOR 1
3.Os
4.Sh NAME
5.Nm taler-auditor
6.Nd
7Audit exchange
8.Sh SYNOPSIS
9.Nm
10.Op Fl h | \-help
11.Op Fl m Ar MASTER_KEY | Fl \-exchange-key= Ns Ar MASTER_KEY
12.Op Fl r | \-reset
13.Sh DESCRIPTION
14.Nm
15is a command line tool to be used by an auditor to audit an exchange's database and calculate the current financial state of the exchange (including revenue, amount expected in escrow and risk exposure).
16The audit is incremental.
17The first audit must be performed with the
18.Fl r
19option to initialize the tables.
20The tool reports inconsistencies in the balance or incorrect cryptographic signatures found in the database.
21It does NOT check with the bank to see that the incoming and outgoing wire transfers that the bank claims to have matches the exchange's database.
22Its options are as follows.
23.Bl -tag -wdith Ds
24.It Fl h | \-help
25Print short help on options.
26.It Fl m Ar KEY | Fl \-exchange-key= Ns Ar KEY
27Public master key of the exchange in Crockford base32 encoding, for example as generated by gnunet-ecc -p.
28If this option is missing, taler-auditor will use the MASTER_PUBLIC_KEY value from the "exchange" section of the configuration.
29.It Fl r | \-reset
30Reset the audit, starts everything from the beginning.
31Useful for testing and required for the first audit to setup auditor's tables.
32Note that if (just) the exchange key changes, the
33.Fl r
34option should not be used again.
35.Sh SEE ALSO
36.Xr gnunet-ecc 1 ,
37.Xr taler-auditor-sign 1 ,
38.Xr taler.conf 5
39.Sh BUGS
40Report bugs by using
41.Lk https://bugs.gnunet.org
42or by sending electronic mail to
43.Aq Mt taler@gnu.org .
diff --git a/doc/taler-bank-transfer.1 b/doc/taler-bank-transfer.1
deleted file mode 100644
index 2aab13fc8..000000000
--- a/doc/taler-bank-transfer.1
+++ /dev/null
@@ -1,55 +0,0 @@
1.Dd December 14, 2017
2.Dt TALER-BANK-TRANSFER 1
3.Os
4.Sh NAME
5.Nm taler-bank-transfer
6.Nd
7trigger a transfer at the bank
8.Sh SYNOPSIS
9.Nm
10.Op Fl a Ar VALUE | Fl \-amount= Ns Ar VALUE
11.Op Fl b Ar URL | Fl \-bank= Ns Ar URL
12.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME
13.Op Fl h | \-help
14.Op Fl D Ar ACCOUNT | Fl \-debit= Ns Ar ACCOUNT
15.Op Fl C Ar ACCOUNT | Fl \-credit= Ns Ar ACCOUNT
16.Op Fl s Ar STRING | Fl \-subject= Ns Ar STRING
17.Op Fl u Ar USERNAME | Fl \-user= Ns Ar USERNAME
18.Op Fl p Ar PASSPHRASE | Fl \-pass= Ns Ar PASSPHRASE
19.Op Fl v | \-version
20.Sh DESCRIPTION
21.Nm
22is a command line tool to trigger bank transfers.
23.Bl -tag -width Ds
24.It Fl a Ar VALUE | Fl \-amount= Ns Ar VALUE
25Amount to transfer.
26Given in the Taler\-typical format of CURRENCY:VALUE.FRACTION
27.It Fl b Ar URL | Fl \-bank= Ns Ar URL
28URL at which the bank is operation.
29.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME
30Use the given configuration file.
31.It Fl h | \-help
32Print short help on options.
33.It Fl D Ar ACCOUNT | Fl \-debit= Ns Ar ACCOUNT
34The money should be debited from ACCOUNT.
35Specifies the number of the account.
36.It Fl C Ar ACCOUNT | Fl \-credit= Ns Ar ACCOUNT
37The money should be credited to ACCOUNT.
38Specifies the number of the account.
39.It Fl s Ar STRING | Fl \-subject= Ns Ar STRING
40Use STRING for the wire transfer subject.
41.It Fl u Ar USERNAME | Fl \-user= Ns Ar USERNAME
42Specifies the username for authentication.
43.It Fl p Ar PASSPHRASE | Fl \-pass= Ns Ar PASSPHRASE
44Specifies the pass phrase for authentication.
45.It Fl v | \-version
46Print version information.
47.El
48.Sh SEE ALSO
49.Xr taler-bank-manage 1 ,
50.Xr taler.conf 5
51.Sh BUGS
52Report bugs by using
53.Lk https://gnunet.org/bugs/
54or by sending electronic mail to
55.Aq Mt taler@gnu.org
diff --git a/doc/taler-config-generate.1 b/doc/taler-config-generate.1
deleted file mode 100644
index 2410fb380..000000000
--- a/doc/taler-config-generate.1
+++ /dev/null
@@ -1,74 +0,0 @@
1.Dd May 5, 2016
2.Dt TALER-CONFIG-GENERATE 1
3.Os
4.Sh NAME
5.Nm taler-config-generate
6.Nd
7tool to simplify Taler configuration generation
8.Os
9.Sh SYNOPSIS
10.Nm
11.Op Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME
12.Op Fl C Ar CURRENCY | Fl \-currency= Ns Ar CURRENCY
13.Op Fl e | \-exchange
14.Op Fl f Ar AMOUNT | \-wirefee= Ns Ar AMOUNT
15.Op Fl m | \-merchant
16.Op Fl t | \-trusted
17.Op Fl w Ar WIREFORMAT | Fl \-wire Ar WIREFORMAT
18.Op Fl j Ar JSON | Fl \-wire-json-merchant= Ns Ar JSON
19.Op Fl J Ar JSON | Fl \-wire-json-exchange= Ns Ar JSON
20.Op Fl \-bank-uri
21.Op Fl \-exchange-bank-account
22.Op Fl \-merchant-bank-account
23.Op Fl h | \-help
24.Op Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL
25.Op Fl v | \-version
26.Sh DESCRIPTION
27.Nm
28can be used to generate configuration files for the Taler exchange or Taler merchants.
29.Bl -tag -width Ds
30.It Fl c Ar FILENAME | Fl \-config= Ns Ar FILENAME
31Location where to write the generated configuration.
32Existing file will be updated, not overwritten.
33.It Fl C Ar CURRENCY | Fl \-currency= Ns Ar CURRENCY
34Which currency should we use in the configuration.
35.It Fl e | \-exchange
36Generate configuration for a Taler exchange.
37.It Fl f Ar AMOUNT | \-wirefee= Ns Ar AMOUNT
38Setup wire transfer fees for the next 5 years for the exchange (for all wire methods).
39.It Fl m | \-merchant
40Generate configuration for a Taler merchant.
41.It Fl t | \-trusted
42Setup current exchange as trusted with current merchant.
43Generally only useful when configuring for testcases.
44.It Fl w Ar WIREFORMAT | Fl \-wire Ar WIREFORMAT
45Specifies which wire format to use (i.e. "test" or "sepa")
46.It Fl j Ar JSON | Fl \-wire-json-merchant= Ns Ar JSON
47Wire configuration to use for the merchant.
48.It Fl J Ar JSON | Fl \-wire-json-exchange= Ns Ar JSON
49Wire configuration to use for the exchange.
50.It Fl \-bank-uri
51Alternative to specify wire configuration to use for the exchange and merchant for the "test" wire method.
52Only useful if WIREFORMAT was set to "test".
53Specifies the URI of the bank.
54.It Fl \-exchange-bank-account
55Alternative to specify wire configuration to use for the exchange for the "test" wire method.
56Only useful if WIREFORMAT was set to "test".
57Specifies the bank account number of the exchange.
58.It Fl \-merchant-bank-account
59Alternative to specify wire configuration to use for the merchant for the "test" wire method.
60Only useful if WIREFORMAT was set to "test".
61Specifies the bank account number of the merchant.
62.It Fl h | \-help
63Shows this man page.
64.It Fl L Ar LOGLEVEL | Fl \-loglevel= Ns Ar LOGLEVEL
65Use LOGLEVEL for logging.
66Valid values are DEBUG, INFO, WARNING and ERROR.
67.It Fl v | \-version
68Print GNUnet version number.
69.El
70.Sh BUGS
71Report bugs by using
72.Lk https://gnunet.org/bugs/
73or by sending electronic mail to
74.Aq Mt taler@gnu.org .
diff --git a/doc/taler-exchange-aggregator.1 b/doc/taler-exchange-aggregator.1
deleted file mode 100644
index 481262143..000000000
--- a/doc/taler-exchange-aggregator.1
+++ /dev/null
@@ -1,37 +0,0 @@
1.Dd Mar 30, 2016
2.Dt TALER-EXCHANGE-AGGREGATOR 1
3.Os
4.Sh NAME
5.Nm taler-exchange-aggregator
6.Nd
7Aggregate and execute exchange transactions
8.Sh SYNOPSIS
9.Nm
10.Op Fl d Ar DIRNAME | Fl \-exchange-dir= Ns Ar DIRNAME
11.Op Fl h | \-help
12.Op Fl t | \-test
13.Op Fl v | \-version
14.Sh DESCRIPTION
15.Nm
16is a command line tool to run pending transactions from the Taler exchange.
17.Bl -tag -width Ds
18.It Fl d Ar DIRNAME | Fl \-exchange-dir= Ns Ar DIRNAME
19Use the configuration and other resources for the exchange to operate from
20.Ar DIRNAME .
21.It Fl h | \-help
22Print short help on options.
23.It Fl t | \-test
24Run in test mode and exit when idle.
25.It Fl v | \-version
26Print version information.
27.El
28.Sh SEE ALSO
29.Xr taler-exchange-dbinit 1 ,
30.Xr taler-exchange-keyup 1 ,
31.Xr taler-exchange-httpd 1 ,
32.Xr taler.conf 5 .
33.Sh BUGS
34Report bugs by using
35.Lk https://gnunet.org/bugs/
36or by sending electronic mail to
37.Aq Mt taler@gnu.org .
diff --git a/doc/taler-exchange-benchmark.1 b/doc/taler-exchange-benchmark.1
deleted file mode 100644
index fa0995711..000000000
--- a/doc/taler-exchange-benchmark.1
+++ /dev/null
@@ -1,44 +0,0 @@
1.Dd July 25, 2018
2.Dt TALER-EXCHANGE-BENCHMARK 1
3.Os
4.Sh NAME
5.Nm taler-exchange-benchmark
6.Nd
7Measure exchange performance
8.Sh SYNOPSIS
9.Nm
10.Op Fl c Ar CONFIG_FILENAME | Fl \-config= Ns Ar CONFIG_FILENAME
11.Op Fl b Ar BANK_URL | Fl --bank-url= Ns Ar BANK_URL
12.Op Fl n Ar HOWMANY_COINS | Fl \-coins-number= Ns Ar HOWMANY_COINS
13.Op Fl l Ar LOGLEVEL | Fl \-log\-level= Ns Ar LOGLEVEL
14.Op Fl h | \-help
15.Sh DESCRIPTION
16.Nm
17is a command line tool to measure the time spent to serve withdrawals/deposits/refreshes.
18It usually needs a dedicate configuration file where all the services - the exchange and the (fake)bank - listen to URLs not subject to any reverse proxy, as say Nginx.
19Moreover, the benchmark runs on a "volatile" database, that means that table are always erased during a single benchmark run.
20.Bl -tag -width Ds
21.It Fl c Ar CONFIG_FILENAME | Fl \-config= Ns Ar CONFIG_FILENAME
22(Mandatory) Use CONFIG_FILENAME.
23.It Fl b Ar BANK_URL | Fl --bank-url= Ns Ar BANK_URL
24(Mandatory) The URL where the fakebank listens at.
25Must match the host component in the exchange's escrow account "payto" URL.
26.It Fl n Ar HOWMANY_COINS | Fl \-coins-number= Ns Ar HOWMANY_COINS
27Defaults to 1.
28Specifies how many coins this benchmark should withdraw and spend.
29After being spent, each coin will be refreshed with a REFRESH_PROBABILITY probability, which is (hardcoded as) 0.1; future versions of this tool should offer this parameter as a CLI option.
30.It Fl l Ar LOGLEVEL | Fl \-log\-level= Ns Ar LOGLEVEL
31GNUnet-compatible log level, takes values "ERROR/WARNING/INFO/DEBUG"
32.It Fl h | \-help
33Prints a compiled-in help text.
34.El
35.Sh SEE ALSO
36.Xr taler-exchange-dbinit 1 ,
37.Xr taler-exchange-keyup 1 ,
38.Xr taler-exchange-httpd 1 ,
39.Xr taler.conf 5
40.Sh BUGS
41Report bugs by using
42.Lk https://gnunet.org/bugs/
43or by sending electronic mail to
44.Aq Mt taler@gnu.org .
diff --git a/doc/taler-exchange-dbinit.1 b/doc/taler-exchange-dbinit.1
deleted file mode 100644
index c534b01e7..000000000
--- a/doc/taler-exchange-dbinit.1
+++ /dev/null
@@ -1,47 +0,0 @@
1.Dd May 31, 2016
2.Dt TALER-EXCHANGE-DBINIT 1
3.Os
4.Sh NAME
5.Nm taler-exchange-dbinit
6.Nd Initialize Taler exchange database.
7.Sh SYNOPSIS
8.Nm
9.Op Fl d Ar DIRNAME | Fl -exchange-dir= Ns Ar DIRNAME
10.Op Fl h | -help
11.Op Fl g | -gc
12.Op Fl r | -reset
13.Op Fl v | -version
14.Sh DESCRIPTION
15.Nm
16is a command line tool to initialize the Taler exchange database.
17It creates the necessary tables and indices for the Taler exchange
18to operate.
19.Pp
20Its options are as follows:
21.Bl -tag -width indent
22.It Fl d Ar DIRNAME | Fl -exchange-dir= Ns Ar DIRNAME
23Use the configuration and other resources for the exchange to
24operate from
25.Ar DIRNAME .
26.It Fl h | -help
27Print short help on options.
28.It Fl g | -gc
29Garbage collect database.
30Deletes all unnecessary data in the database.
31.It Fl r | -reset
32Drop tables.
33Dangerous, will delete all existing data in the database before
34creating the tables.
35.It Fl v | -version
36Print version information.
37.El
38.Sh SEE ALSO
39.Xr taler-exchange-httpd 1 ,
40.Xr taler-exchange-keyup 1 ,
41.Xr taler-exchange-reservemod 1 ,
42.Xr taler.conf 5 .
43.Sh BUGS
44Report bugs by using
45.Lk https://bugs.gnunet.org
46or by sending electronic mail to
47.Aq Mt taler@gnu.org .
diff --git a/doc/taler-exchange-httpd.1 b/doc/taler-exchange-httpd.1
deleted file mode 100644
index 9cb178abf..000000000
--- a/doc/taler-exchange-httpd.1
+++ /dev/null
@@ -1,92 +0,0 @@
1.Dd April 22, 2015
2.Dt TALER-EXCHANGE-HTTPD 1
3.Os
4.Sh NAME
5.Nm taler-exchange-httpd
6.Nd Run Taler exchange (with RESTful API)
7.Sh SYNOPSIS
8.Nm
9.Op Fl C | -connection-close
10.Op Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
11.Op Fl f Ar FILENAME | Fl -file-input= Ns Ar FILENAME
12.Op Fl h | -help
13.Op Fl i | -init-db
14.Op Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
15.Op Fl t Ar SECONDS | Fl -timeout= Ns Ar SECONDS
16.Op Fl v | -version
17.Sh DESCRIPTION
18.Nm
19is a command line tool to run the Taler exchange (HTTP server).
20The required configuration, keys and database must exist before
21running this command.
22.Pp
23Its options are as follows:
24.Bl -tag -width indent
25.It Fl C | -connection-close
26Force each HTTP connection to be closed after each request (useful
27in combination with
28.Fl f
29to avoid having to wait for nc to time out).
30.It Fl c Ar FILENAME | Fl -config= Ns Ar FILENAME
31Use the configuration and other resources for the merchant to operate
32from FILENAME.
33.It Fl h | -help
34Print short help on options.
35.It Fl i | -init-db
36Initialize the database by creating tables and indices if necessary.
37.It Fl v | -version
38Print version information.
39.It Fl f Ar FILENAME | Fl -file-input= Ns Ar FILENAME
40This option is only available if the exchange was compiled with the
41configure option --enable-developer-mode.
42It is used for generating test cases against the exchange using AFL.
43When this option is present, the HTTP server will
44.Bl -enum -offset indent -compact
45.It
46terminate after the first client's HTTP connection is completed, and
47.It
48automatically start such a client using a helper process based on the
49.Xr nc 1
50or
51.Xr ncat 1
52binary using FILENAME as the standard input to the helper process.
53.El
54As a result, the process will effectively run with
55.Ar FILENAME
56as the input from an HTTP client and then immediately exit.
57This is useful to test taler-exchange-httpd against many different
58possible inputs in a controlled way.
59.It Fl t Ar SECONDS | Fl -timeout= Ns Ar SECONDS
60Specifies the number of SECONDS after which the HTTPD should
61close (idle) HTTP connections.
62.It Fl L Ar LOGLEVEL | Fl -loglevel= Ns Ar LOGLEVEL
63Specifies the log level to use.
64Accepted values are: DEBUG, INFO, WARNING, ERROR.
65.El
66.Sh SIGNALS
67.Nm
68responds to the following signals:
69.Bl -tag -width indent
70.It Dv SIGUSR1
71Sending a SIGUSR1 to the process will cause it to reload denomination
72and signing keys.
73.It Dv SIGTERM
74Sending a SIGTERM to the process will cause it to shutdown cleanly.
75.It Dv SIGHUP
76Sending a SIGHUP to the process will cause it to re-execute the
77taler-exchange-httpd binary in the PATH, passing it the existing
78listen socket.
79Then the old server process will automatically exit after it is done
80handling existing client connections; the new server process will
81accept and handle new client connections.
82.El
83.Sh SEE ALSO
84.Xr taler-exchange-dbinit 1 ,
85.Xr taler-exchange-keyup 1 ,
86.Xr taler-exchange-reservemod 1 ,
87.Xr taler.conf 5 .
88.Sh BUGS
89Report bugs by using
90.Lk https://gnunet.org/bugs
91or by sending electronic mail to
92.Aq Mt taler@gnu.org .
diff --git a/doc/taler-exchange-keycheck.1 b/doc/taler-exchange-keycheck.1
deleted file mode 100644
index ca97c3dad..000000000
--- a/doc/taler-exchange-keycheck.1
+++ /dev/null
@@ -1,39 +0,0 @@
1.Dd April 22, 2015
2.Dt TALER-EXCHANGE-KEYCHECK 1
3.Os
4.Sh NAME
5.Nm taler\-exchange\-keycheck
6.Nd check validity of Taler signing and denomination keys
7.Sh SYNOPSIS
8.Nm
9.Op Fl d Ar DIRNAME | Fl -exchange-dir= Ns Ar DIRNAME
10.Op Fl h | -help
11.Op Fl v | -version
12.Sh DESCRIPTION
13.Nm
14can be used to check if the signing and denomination keys in the
15operation directory are well-formed.
16This can be useful after importing fresh keys from the
17offline system to ensure that the files are correct.
18.Pp
19Its options are as follows:
20.Bl -tag -width indent
21.It Fl d Ar DIRNAME | Fl -exchange-dir= Ns Ar DIRNAME
22Use the configuration and other resources for the exchange
23to operate from
24.Ar DIRNAME .
25.It Fl h | -help
26Print short help on options.
27.It Fl v | -version
28Print version information.
29.El
30.Sh SEE ALSO
31.Xr taler-exchange-httpd 1 ,
32.Xr taler-exchange-keyup 1 ,
33.Xr taler-exchange-dbinit 1 ,
34.Xr taler.conf 5 .
35.Sh BUGS
36Report bugs by using
37.Lk https://gnunet.org/bugs/
38or by sending electronic mail to
39.Aq Mt taler@gnu.org .
diff --git a/doc/taler-exchange-keyup.1 b/doc/taler-exchange-keyup.1
deleted file mode 100644
index 61cca2fe2..000000000
--- a/doc/taler-exchange-keyup.1
+++ /dev/null
@@ -1,55 +0,0 @@
1.Dd April 7, 2017
2.Dt TALER\-EXCHANGE\-KEYUP 1
3.Os
4.Sh NAME
5.Nm taler\-exchange\-keyup
6.Nd setup Taler exchange denomination and signing keys
7.Sh SYNOPSIS
8.Nm
9.Op Fl d Ar DIRNAME | Fl -exchange-dir= Ns Ar DIRNAME
10.Op Fl h | -help
11.Op Fl m Ar FILE | Fl -master-key= Ns Ar FILE
12.Op Fl o Ar FILE | Fl -output= Ns Ar FILE
13.Op Fl r Ar DKH | Fl -revoke= Ns Ar DKH
14.Op Fl t Ar TIMESTAMP | Fl -time= Ns Ar TIMESTAMP
15.Op Fl v | -version
16.Sh DESCRIPTION
17.Nm
18is a command line tool to setup Taler denomination and signing keys.
19This tool requires access to the exchange's long-term offline signing
20key and should be run in a secure (offline) environment under strict
21controls.
22The resulting keys can then be copied to the main online directory
23where the Taler HTTP server operates.
24.Pp
25Its options are as follows:
26.Bl -tag -width indent
27.It Fl d Ar DIRNAME | Fl -exchange-dir= Ns Ar DIRNAME
28Use the configuration and other resources for the exchange to
29operate from
30.Ar DIRNAME .
31.It Fl h | -help
32Print short help on options.
33.It Fl m Ar FILE | Fl -master-key= Ns Ar FILE
34Location of the private EdDSA offline master key of the exchange.
35.It Fl o Ar FILE | Fl -output= Ns Ar FILE
36Where to write a denomination key signing request file to be given
37to the auditor.
38.It Fl r Ar DKH | Fl -revoke= Ns Ar DKH
39Revoke the denomination key where the denomination public key's hash is DKH.
40.It Fl t Ar TIMESTAMP | Fl -time= Ns Ar TIMESTAMP
41Operate as if the current time was
42.Ar TIMESTAMP .
43.It Fl v | -version
44Print version information.
45.El
46.Sh SEE ALSO
47.Xr taler-exchange-httpd 1 ,
48.Xr taler-exchange-keyup 1 ,
49.Xr taler-exchange-keycheck 1 ,
50.Xr taler.conf 5 .
51.Sh BUGS
52Report bugs by using
53.Lk https://gnunet.org/bugs/
54or by sending electronic mail to
55.Aq Mt taler@gnu.org .
diff --git a/doc/taler-exchange-wire.1 b/doc/taler-exchange-wire.1
deleted file mode 100644
index d49704462..000000000
--- a/doc/taler-exchange-wire.1
+++ /dev/null
@@ -1,34 +0,0 @@
1.Dd March 18, 2018
2.Dt TALER-EXCHANGE-WIRE 1
3.Os
4.Sh NAME
5.Nm taler-exchange-wire
6.Nd create the master-key signed responses to /wire
7.Sh SYNOPSIS
8.Nm
9.Op Fl h | -help
10.Op Fl m Ar MASTERKEYFILE | Fl -master= Ns Ar MASTERKEYFILE
11.Op Fl v | -version
12.Sh DESCRIPTION
13.Nm
14is used to create the exchange's reply to a /wire request.
15It converts the bank details into the appropriate signed response.
16This needs to be done using the long-term offline master key.
17.Pp
18Its options are as follows:
19.Bl -tag -width indent
20.It Fl h | -help
21Print short help on options.
22.It Fl m Ar MASTERKEYFILE | Fl -master= Ns Ar MASTERKEYFILE
23Specifies the name of the file containing the exchange's master key.
24.It Fl v | -version
25Print version information.
26.El
27.Sh SEE ALSO
28.Xr taler-exchange-httpd 1 ,
29.Xr taler.conf 5 .
30.Sh BUGS
31Report bugs by using
32.Lk https://gnunet.org/bugs/
33or by sending electronic mail to
34.Aq Mt taler@gnu.org .
diff --git a/doc/taler-exchange-wirewatch.1 b/doc/taler-exchange-wirewatch.1
deleted file mode 100644
index 447e1217b..000000000
--- a/doc/taler-exchange-wirewatch.1
+++ /dev/null
@@ -1,41 +0,0 @@
1.Dd May 5, 2017
2.Dt TALER-EXCHANGE-WIREWATCH 1
3.Os
4.Sh NAME
5.Nm taler-exchange-wirewatch
6.Nd watch for incoming wire transfers
7.Sh SYNOPSIS
8.Nm
9.Op Fl t Ar PLUGINNAME | Fl -type= Ns Ar PLUGINNAME
10.Op Fl h | -help
11.Op Fl T | -test
12.Op Fl r | -reset
13.Op Fl v | -version
14.Sh DESCRIPTION
15.Nm
16is a command line tool to import wire transactions into the
17Taler exchange database.
18.Pp
19Its options are as follows:
20.Bl -tag -width indent
21.It Fl t Ar PLUGINNAME | Fl -type= Ns Ar PLUGINNAME
22Use the specified wire plugin and its configuration to talk to the bank.
23.It Fl h | -help
24Print short help on options.
25.It Fl T | -test
26Run in test mode and exit when idle.
27.It Fl r | -reset
28Ignore our own database and start with transactions
29from the beginning of time.
30.It Fl v | -version
31Print version information.
32.El
33.Sh SEE ALSO
34.Xr taler-exchange-aggregator 1 ,
35.Xr taler-exchange-httpd 1 ,
36.Xr taler.conf 5 .
37.Sh BUGS
38Report bugs by using
39.Lk https://gnunet.org/bugs/
40or by sending electronic mail to
41.Aq Mt taler@gnu.org .
diff --git a/doc/taler.conf.5 b/doc/taler.conf.5
deleted file mode 100644
index 40e2d2d38..000000000
--- a/doc/taler.conf.5
+++ /dev/null
@@ -1,248 +0,0 @@
1.\" -*- mode: nroff -*-
2.Dd March 20, 2018
3.Dt TALER.CONF 5
4.Os
5.Sh NAME
6.Nm taler.conf
7.Nd
8Taler configuration file.
9.Sh DESCRIPTION
10The basic structure of the configuration file is the following.
11The file is split into sections.
12Every section begins with "[SECTIONNAME]" and contains a number of options of the form "OPTION=VALUE".
13Empty lines and lines beginning with a "#" are treated as comments.
14Files containing default values for many of the options described below are installed under $TALER\_PREFIX/share/taler/config.d/.
15The configuration file given with
16.Fl c
17to Taler binaries overrides these defaults.
18.Ss GLOBAL OPTIONS
19The following options are from the "[taler]" section and used by virtually all Taler components.
20.Bl -tag -width Ds
21.It CURRENCY
22Name of the currency, i.e. "EUR" for Euro.
23.El
24.Pp
25The "[PATHS]" section is special in that it contains paths that can be referenced using "$" in other configuration values that specify filenames.
26For Taler, it commonly contains the following paths:
27.Bl -tag -width Ds
28.It TALER_HOME
29Home directory of the user, usually "${HOME}".
30Can be overwritten by testcases by setting ${TALER_TEST_HOME}.
31.It TALER_DATA_HOME
32Where should Taler store its long-term data. Usually "${TALER_HOME}/.local/share/taler/"
33.It TALER_CONFIG_HOME
34Where is the Taler configuration kept.
35Usually "${TALER_HOME}/.config/taler/"
36.It TALER_CACHE_HOME
37Where should Taler store cached data.
38Usually "${TALER_HOME}/.cache/taler/"
39.It TALER_RUNTIME_DIR
40Where should Taler store system runtime data (like UNIX domain sockets).
41Usually "${TMP}/taler-system-runtime".
42.El
43.Ss EXCHANGE OPTIONS
44The following options are from the "[exchange]" section and used by most exchange tools.
45.Bl -tag -width Ds
46.It DB
47Plugin to use for the database, i.e. "postgres"
48.It PORT
49Port on which the HTTP server listens, i.e. 8080.
50.It MASTER_PUBLIC_KEY
51Crockford Base32-encoded master public key, public version of the exchange\'s long\-time offline signing key.
52.It MASTER_PRIV_FILE
53Location of the master private key on disk.
54Only used by tools that can be run offline (as the master key is for offline signing).
55.It BASE_URL
56Specifies the base URL under which the exchange can be reached.
57Added to wire transfers to enable tracking by merchants.
58.It SIGNKEY_DURATION
59For how long is a signing key valid?
60.It LEGAL_DURATION
61For how long are signatures with signing keys legally valid?
62.It LOOKAHEAD_SIGN
63How long do we generate denomination and signing keys ahead of time?
64.It LOOKAHEAD_PROVIDE
65How long into the future do we provide signing and denomination keys to clients?
66.El
67.Ss EXCHANGE POSTGRES BACKEND DATABASE OPTIONS
68The following options must be in section "[exchangedb\-postgres]" if the "postgres" plugin was selected for the database.
69.Bl -tag -width Ds
70.It CONFIG
71How to access the database, i.e. "postgres:///taler" to use the "taler" database.
72Testcases use "talercheck".
73.El
74.Ss MERCHANT OPTIONS
75The following options are from the "[merchant]" section and used by the merchant backend.
76.Bl -tag -width Ds
77.It DB
78Plugin to use for the database, i.e. "postgres"
79.It PORT
80Port on which the HTTP server listens, i.e. 8080.
81.It WIRE_TRANSFER_DELAY
82How quickly do we want the exchange to send us money?
83Note that wire transfer fees will be higher if we ask for money to be wired often.
84Given as a relative time, i.e. "5 s"
85.It DEFAULT_MAX_WIRE_FEE
86Maximum wire fee we are willing to accept from exchanges.
87Given as a Taler amount, i.e. "EUR:0.1"
88.It DEFAULT_MAX_DEPOSIT_FEE
89Maximum deposit fee we are willing to cover.
90Given as a Taler amount, i.e. "EUR:0.1"
91.El
92.Ss MERCHANT POSTGRES BACKEND DATABASE OPTIONS
93The following options must be in section "[merchantdb\-postgres]" if the "postgres" plugin was selected for the database.
94.Bl -tag -width Ds
95.It CONFIG
96How to access the database, i.e. "postgres:///taler" to use the "taler" database.
97Testcases use "talercheck".
98.El
99.Ss MERCHANT INSTANCES
100The merchant configuration must specify a set of instances, containing at least the "default" instance.
101The following options must be given in each "[instance-NAME]" section.
102.Bl -tag -width Ds
103.It KEYFILE
104Name of the file where the instance\'s private key is to be stored, i.e. "${TALER_CONFIG_HOME}/merchant/instance/name.priv"
105.It NAME
106Human-readable name of the instance, i.e. "Kudos Inc."
107.El
108Additionally, for instances that support tipping, the following options are required.
109.Bl -tag -width Ds
110.It TIP_EXCHANGE
111Base-URL of the exchange that holds the reserve for tipping, i.e. "https://exchange.demo.taler.net/"
112.It TIP_EXCHANGE_PRIV_FILENAME
113Filename with the private key granting access to the reserve, i.e. "${TALER_CONFIG_HOME}/merchant/reserve/tip.priv"
114.El
115.Ss KNOWN EXCHANGES (for merchants and wallets)
116The merchant configuration can include a list of known exchanges if the merchant wants to specify that certain exchanges are explicitly trusted.
117For each trusted exchange, a section [exchange-NAME] must exist, where NAME is a merchant-given name for the exchange.
118The following options must be given in each "[exchange-NAME]" section.
119.Bl -tag -width Ds
120.It BASE_URL
121Base URL of the exchange, i.e. "https://exchange.demo.taler.net/"
122.It MASTER_KEY
123Crockford Base32 encoded master public key, public version of the exchange\'s long\-time offline signing key
124.It CURRENCY
125Name of the currency for which this exchange is trusted, i.e. "KUDOS"
126.El
127.Ss KNOWN AUDITORS (for merchants and wallets)
128The merchant configuration can include a list of known exchanges if the merchant wants to specify that certain auditors are explicitly trusted.
129For each trusted exchange, a section [auditor-NAME] must exist, where NAME is a merchant-given name for the exchange.
130The following options must be given in each "[auditor-NAME]" section.
131.Bl -tag -width Ds
132.It BASE_URL
133Base URL of the auditor, i.e. "https://auditor.demo.taler.net/"
134.It AUDITOR_KEY
135Crockford Base32 encoded auditor public key.
136.It CURRENCY
137Name of the currency for which this auditor is trusted, i.e. "KUDOS"
138.El
139.Ss ACCOUNT OPTIONS (for exchanges and merchants)
140An exchange (or merchant) can have multiple bank accounts.
141The following options are for sections named "[account-SOMETHING]".
142The SOMETHING is arbitrary and should be chosen to uniquely identify the bank account for the operator.
143Additional authentication options may need to be specified in the account section depending on the PLUGIN used.
144.Bl -tag -width Ds
145.It URL
146Specifies the payto://-URL of the account.
147The general format is payto://METHOD/DETAILS.
148This option is used for exchanges and merchants.
149.It WIRE_RESPONSE
150Specifies the name of the file in which the /wire response for this account should be located.
151Used by the Taler exchange service and the taler\-exchange\-wire tool and the taler\-merchant\-httpd (to generate the files).
152.It PLUGIN
153Name of the plugin can be used to access the account (i.e. "taler-bank" or "ebics").
154Used by the merchant backend for back office operations (i.e. to identify incoming wire transfers) and by the exchange.
155.It ENABLE_DEBIT
156Must be set to YES for the accounts that the taler\-exchange\-aggregator should debit.
157Not used by merchants.
158.It ENABLE_CREDIT
159Must be set to YES for the accounts that the taler\-exchange\-wirewatch should check for credits.
160It is yet uncertain if the merchant implementation may check this flag as well.
161.It HONOR_instance
162Must be set to YES for the instances (where "instance" is the section name of the instance) of the merchant backend that should allow incoming wire transfers for this bank account.
163.It ACTIVE_instance
164Must be set to YES for the instances (where "instance" is the section name of the instance) of the merchant backend that should use this bank account in new offers/contracts.
165Setting ACTIVE_instance to YES requires also setting ENABLE_instance to YES.
166.El
167.Ss TALER-BANK AUTHENTICATION OPTIONS (for accounts)
168The following authentication options are supported by the "taler-bank" wire plugin.
169They must be specified in the "[account-]" section that uses the "taler-bank" plugin.
170.Bl -tag -width Ds
171.It TALER_BANK_AUTH_METHOD
172Authentication method to use.
173"none" or "basic" are currently supported.
174.It USERNAME
175Username to use for authentication.
176Used with the "basic" authentication method.
177.It PASSWORD
178Password to use for authentication.
179Used with the "basic" authentication method.
180.Ss EBICS AUTHENTICATION OPTIONS
181The following authentication options are supported by the "ebics" wire plugin.
182They must be specified in the "[account-]" section that uses the "ebics" plugin.
183.Bl -tag -width Ds
184.It NONE
185Currently the "ebics" implementation is incomplete and does not support authentication.
186.El
187.Ss EXCHANGE WIRE FEE OPTIONS
188For each supported wire method (i.e. "x-taler-bank" or "sepa"), sections named "[fees-METHOD]" state the (aggregate) wire transfer fee and the reserve closing fees charged by the exchange.
189Note that fees are specified using the name of the wire method, not by the plugin name.
190You need to replace "YEAR" in the option name by the calendar year for which the fee should apply.
191Usually, fees should be given for serveral years in advance.
192.Bl -tag -width Ds
193.It WIRE-FEE-YEAR
194Aggregate wire transfer fee merchants are charged in YEAR.
195Specified as a Taler amount using the usual amount syntax (CURRENCY:VALUE.FRACTION).
196.It CLOSING-FEE-YEAR
197Reserve closing fee customers are charged in YEAR.
198Specified as a Taler amount using the usual amount syntax (CURRENCY:VALUE.FRACTION).
199.El
200.Ss EXCHANGE COIN OPTIONS
201The following options must be in sections starting with "[coin_]" and are used by taler\-exchange\-keyup to create denomination keys.
202.Bl -tag -width Ds
203.It VALUE
204Value of the coin, i.e. "EUR:1.50" for 1 Euro and 50 Cents (per coin).
205.It DURATION_OVERLAP
206How much should validity periods for these coins overlap?
207.It DURATION_WITHDRAW
208How long should the same key be used for clients to withdraw coins of this value?
209.It DURATION_SPEND
210How long do clients have to spend these coins?
211.It FEE_WITHDRAW
212What fee is charged for withdrawl?
213.It FEE_DEPOSIT
214What fee is charged for depositing?
215.It FEE_REFRESH
216What fee is charged for refreshing?
217.It FEE_REFUND
218What fee is charged for refunds?
219When a coin is refunded, the deposit fee is returned.
220Instead, the refund fee is charged to the customer.
221.It RSA_KEYSIZE
222What is the RSA keysize modulos (in bits)?
223.El
224.Ss AUDITOR OPTIONS
225The following options must be in section "[auditor]" for the Taler auditor.
226.Bl -tag -width Ds
227.It DB
228Plugin to use for the database, i.e. "postgres"
229.It AUDITOR_PRIV_FILE
230Name of the file containing the auditor's private key
231.El
232.Ss AUDITOR POSTGRES BACKEND DATABASE OPTIONS
233The following options must be in section "[auditordb\-postgres]" if the "postgres" plugin was selected for the database.
234.Bl -tag -width Ds
235.It CONFIG
236How to access the database, i.e. "postgres:///taler" to use the "taler" database.
237Testcases use "talercheck".
238.El
239.Sh SEE ALSO
240.Xr taler-exchange-dbinit 1 ,
241.Xr taler-exchange-httpd 1 ,
242.Xr taler-exchange-keyup 1 ,
243.Xr taler-exchange-wire 1 .
244.Sh BUGS
245Report bugs by using
246.Lk https://gnunet.org/bugs/
247or by sending electronic mail to
248.Aq Mt taler@gnu.org .