Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id 57B92200D21 for ; Mon, 16 Oct 2017 19:11:31 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id 561ED1609EF; Mon, 16 Oct 2017 17:11:31 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id 04D51160BEA for ; Mon, 16 Oct 2017 19:11:28 +0200 (CEST) Received: (qmail 60456 invoked by uid 500); 16 Oct 2017 17:11:28 -0000 Mailing-List: contact notifications-help@freemarker.incubator.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@freemarker.incubator.apache.org Delivered-To: mailing list notifications@freemarker.incubator.apache.org Received: (qmail 60441 invoked by uid 99); 16 Oct 2017 17:11:28 -0000 Received: from pnap-us-west-generic-nat.apache.org (HELO spamd1-us-west.apache.org) (209.188.14.142) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 16 Oct 2017 17:11:28 +0000 Received: from localhost (localhost [127.0.0.1]) by spamd1-us-west.apache.org (ASF Mail Server at spamd1-us-west.apache.org) with ESMTP id 2AB79C0B85 for ; Mon, 16 Oct 2017 17:11:27 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd1-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: -4.221 X-Spam-Level: X-Spam-Status: No, score=-4.221 tagged_above=-999 required=6.31 tests=[KAM_ASCII_DIVIDERS=0.8, KAM_SHORT=0.001, RCVD_IN_DNSWL_HI=-5, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, RP_MATCHES_RCVD=-0.001, SPF_PASS=-0.001] autolearn=disabled Received: from mx1-lw-us.apache.org ([10.40.0.8]) by localhost (spamd1-us-west.apache.org [10.40.0.7]) (amavisd-new, port 10024) with ESMTP id nXRdRlJ45gxE for ; Mon, 16 Oct 2017 17:11:18 +0000 (UTC) Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by mx1-lw-us.apache.org (ASF Mail Server at mx1-lw-us.apache.org) with SMTP id 550556115B for ; Mon, 16 Oct 2017 17:10:56 +0000 (UTC) Received: (qmail 55909 invoked by uid 99); 16 Oct 2017 17:10:56 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 16 Oct 2017 17:10:56 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id A18FCDFFD7; Mon, 16 Oct 2017 17:10:52 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit From: woonsan@apache.org To: notifications@freemarker.incubator.apache.org Date: Mon, 16 Oct 2017 17:11:01 -0000 Message-Id: In-Reply-To: <872d1e0622a04445a6100aaeb304982b@git.apache.org> References: <872d1e0622a04445a6100aaeb304982b@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [10/51] [partial] incubator-freemarker-site git commit: Revert "in 2.3.27 release process, uploading the release documentation" archived-at: Mon, 16 Oct 2017 17:11:31 -0000 http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/e4f6354d/docs/ref_directive_alphaidx.html ---------------------------------------------------------------------- diff --git a/docs/ref_directive_alphaidx.html b/docs/ref_directive_alphaidx.html index 2f17e01..378e390 100644 --- a/docs/ref_directive_alphaidx.html +++ b/docs/ref_directive_alphaidx.html @@ -1,22 +1,4 @@ - @@ -31,7 +13,16 @@ under the License. - + + + @@ -40,12 +31,12 @@ under the License.
Manual
Bookmarks:
+
Manual
Search form
Bookmarks:
- - + +

Alphabetical index

@@ -87,10 +78,6 @@ under the License.
  • - continue -
    • - -
  • default
    • @@ -233,7 +220,7 @@ under the License.

    Overview

    Handy stuff

    Community

    Edited with XMLMind XML Editor

    Last generated: -, for Freemarker 2.3.27

    +, for Freemarker 2.3.26

    © 1999–2017 The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.

    http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/e4f6354d/docs/ref_directive_assign.html ---------------------------------------------------------------------- diff --git a/docs/ref_directive_assign.html b/docs/ref_directive_assign.html index 5174cc8..c28449b 100644 --- a/docs/ref_directive_assign.html +++ b/docs/ref_directive_assign.html @@ -1,22 +1,4 @@ - @@ -31,7 +13,16 @@ under the License. - + + + @@ -40,12 +31,12 @@ under the License.
    Manual
    Bookmarks:
    +
    Manual
    Search form
    Bookmarks:
    - - + +

    assign

    @@ -238,7 +229,7 @@ ${x}

    Overview

    Handy stuff

    Community

    Edited with XMLMind XML Editor

    Last generated: -, for Freemarker 2.3.27

    +, for Freemarker 2.3.26

    © 1999–2017 The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.

    http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/e4f6354d/docs/ref_directive_attempt.html ---------------------------------------------------------------------- diff --git a/docs/ref_directive_attempt.html b/docs/ref_directive_attempt.html index ae895ac..5dced75 100644 --- a/docs/ref_directive_attempt.html +++ b/docs/ref_directive_attempt.html @@ -1,22 +1,4 @@ - @@ -31,7 +13,16 @@ under the License. - + + + @@ -40,12 +31,12 @@ under the License.
    Manual
    Bookmarks:
    +
    Manual
    Search form
    Bookmarks:
    - - + +

    attempt, recover

    @@ -121,15 +112,13 @@ under the License. outputted even if the outputting of a certain part of the page fails. If an error occurs during the execution of the attempt block, then - the output of the attempt - block is rolled back (and the error is logged, with the default - configuration at least), and the + the template execution is not aborted, but the + recover block is + executed instead of the attempt + block. If no error occurs during the + execution of the attempt + block, then the recover block is - executed instead, then template execution continues normally after - the recover block. If - no error occurs during the execution of the - attempt block, then - the recover block is ignored. A simple example:

    @@ -142,9 +131,8 @@ under the License. </#attempt> Primary content continued
    -

    If the thisMayFails variable doesn't exist - (or any other error occurs at that place), then the output - is:

    +

    If the thisMayFails variable doesn't exist, + then the output is:

    @@ -179,14 +167,15 @@ Primary content continued
    for handling undefined variables (for that use missing value handler operators). It can handle all kind of errors that occurs when the block is executed (i.e. not syntactical errors, which are - detected earlier). It meant to enclose bigger template fragments, - where error can occur at various points. For example, you have a - part in your template that deals with printing advertisements, but - that's not the primary content of the page, so you don't want your - whole page be down just because some error occurs with the printing - of the advertisements (say, because of a database server outage). So - you put the whole advertisement printing into an - attempt block.

    + detected earlier). And it's meant to enclose bigger template + fragments, where error can occur at various points. For example, you + have a part in your template that deals with printing + advertisements, but that's not the primary content of the page, so + you don't want your whole page be down just because some error + occurs with the printing of the advertisements (say, because of a + temporal database server faliure). So you put the whole + advertisement printing into an attempt + block.

    In some environments programmers configure FreeMarker so that it doesn't abort template execution for certain errors, but @@ -201,24 +190,15 @@ Primary content continued

    references to special variable are started with dot (for example: ${.error}).

    -

    By default errors occurring - inside an attempt - block are logged with - ERROR level, despite that the template recovers - from them. This is because attempt is not meant - to be a general purpose error handler mechanism, like - try is in Java. It's for decreasing the impact of - unexpected errors on the visitors, by making it possible that only - part of the page is going down, instead of the whole page. But it's - still an error, something that needs the attention of the operators. - (The way this error is reported can be customized with the - attempt_exception_reporter configuration setting, - since FreeMarker 2.3.27.)

    +

    Errors occurring during template + execution are always logged, even if they occur inside + an attempt + block.

    Overview

    Handy stuff

    Community

    Edited with XMLMind XML Editor

    Last generated: -, for Freemarker 2.3.27

    +, for Freemarker 2.3.26

    © 1999–2017 The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.

    http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/e4f6354d/docs/ref_directive_autoesc.html ---------------------------------------------------------------------- diff --git a/docs/ref_directive_autoesc.html b/docs/ref_directive_autoesc.html index 0fca747..65eeeb3 100644 --- a/docs/ref_directive_autoesc.html +++ b/docs/ref_directive_autoesc.html @@ -1,22 +1,4 @@ - @@ -31,7 +13,16 @@ under the License. - + + + @@ -40,12 +31,12 @@ under the License.
    Manual
    Bookmarks:
    +
    Manual
    Search form
    Bookmarks:
    - - + +

    autoesc

    @@ -126,7 +117,7 @@ ${"&"}

    Overview

    Handy stuff

    Community

    Edited with XMLMind XML Editor

    Last generated: -, for Freemarker 2.3.27

    +, for Freemarker 2.3.26

    © 1999–2017 The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.

    http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/e4f6354d/docs/ref_directive_compress.html ---------------------------------------------------------------------- diff --git a/docs/ref_directive_compress.html b/docs/ref_directive_compress.html index 84a0924..01d9b6c 100644 --- a/docs/ref_directive_compress.html +++ b/docs/ref_directive_compress.html @@ -1,22 +1,4 @@ - @@ -31,7 +13,16 @@ under the License. - + + + @@ -40,12 +31,12 @@ under the License.
    Manual
    Bookmarks:
    +
    Manual
    Search form
    Bookmarks:
    - - + +

    compress

    @@ -108,7 +99,7 @@ I said, test only)

    Overview

    Handy stuff

    Community

    Edited with XMLMind XML Editor

    Last generated: -, for Freemarker 2.3.27

    +, for Freemarker 2.3.26

    © 1999–2017 The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.

    http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/e4f6354d/docs/ref_directive_escape.html ---------------------------------------------------------------------- diff --git a/docs/ref_directive_escape.html b/docs/ref_directive_escape.html index 81c72ae..6515cea 100644 --- a/docs/ref_directive_escape.html +++ b/docs/ref_directive_escape.html @@ -1,22 +1,4 @@ - @@ -31,7 +13,16 @@ under the License. - + + + @@ -40,12 +31,12 @@ under the License.
    Manual
    Bookmarks:
    +
    Manual
    Search form
    Bookmarks:
    - - + +

    escape, noescape (deprecated)

    @@ -233,7 +224,7 @@ m2: &lt;test&gt;

    Overview

    Handy stuff

    Community

    Edited with XMLMind XML Editor

    Last generated: -, for Freemarker 2.3.27

    +, for Freemarker 2.3.26

    © 1999–2017 The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.

    http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/e4f6354d/docs/ref_directive_flush.html ---------------------------------------------------------------------- diff --git a/docs/ref_directive_flush.html b/docs/ref_directive_flush.html index 6fb4e55..5ed7094 100644 --- a/docs/ref_directive_flush.html +++ b/docs/ref_directive_flush.html @@ -1,22 +1,4 @@ - @@ -31,7 +13,16 @@ under the License. - + + + @@ -40,12 +31,12 @@ under the License.
    Manual
    Bookmarks:
    +
    Manual
    Search form
    Bookmarks:
    - - + +

    flush

    @@ -97,7 +88,7 @@ under the License.

    Overview

    Handy stuff

    Community

    Edited with XMLMind XML Editor

    Last generated: -, for Freemarker 2.3.27

    +, for Freemarker 2.3.26

    © 1999–2017 The Apache Software Foundation. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation.