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 93183200BD3 for ; Tue, 6 Dec 2016 23:30:07 +0100 (CET) Received: by cust-asf.ponee.io (Postfix) id 91C13160B29; Tue, 6 Dec 2016 22:30:07 +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 E710D160B17 for ; Tue, 6 Dec 2016 23:30:06 +0100 (CET) Received: (qmail 31924 invoked by uid 500); 6 Dec 2016 22:30:06 -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 31915 invoked by uid 99); 6 Dec 2016 22:30:06 -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; Tue, 06 Dec 2016 22:30:06 +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 BB63CD395B for ; Tue, 6 Dec 2016 22:30:05 +0000 (UTC) X-Virus-Scanned: Debian amavisd-new at spamd1-us-west.apache.org X-Spam-Flag: NO X-Spam-Score: -6.219 X-Spam-Level: X-Spam-Status: No, score=-6.219 tagged_above=-999 required=6.31 tests=[KAM_ASCII_DIVIDERS=0.8, KAM_LAZY_DOMAIN_SECURITY=1, RCVD_IN_DNSWL_HI=-5, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, RP_MATCHES_RCVD=-2.999] autolearn=disabled Received: from mx1-lw-eu.apache.org ([10.40.0.8]) by localhost (spamd1-us-west.apache.org [10.40.0.7]) (amavisd-new, port 10024) with ESMTP id DyortuhTKrs7 for ; Tue, 6 Dec 2016 22:30:04 +0000 (UTC) Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by mx1-lw-eu.apache.org (ASF Mail Server at mx1-lw-eu.apache.org) with SMTP id 3A2EC5FDB6 for ; Tue, 6 Dec 2016 22:29:58 +0000 (UTC) Received: (qmail 29265 invoked by uid 99); 6 Dec 2016 22:29:57 -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; Tue, 06 Dec 2016 22:29:57 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id B9F47F2139; Tue, 6 Dec 2016 22:29:56 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: ddekany@apache.org To: notifications@freemarker.incubator.apache.org Date: Tue, 06 Dec 2016 22:30:01 -0000 Message-Id: In-Reply-To: <05bcaa7349b249bca60d129188d4364f@git.apache.org> References: <05bcaa7349b249bca60d129188d4364f@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [06/24] incubator-freemarker git commit: grammar, phrasing fixes archived-at: Tue, 06 Dec 2016 22:30:07 -0000 grammar, phrasing fixes Project: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/repo Commit: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/commit/0815e14f Tree: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/tree/0815e14f Diff: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/diff/0815e14f Branch: refs/heads/2.3 Commit: 0815e14ffc1e0b91a51fa62b69cef412b0a82ccb Parents: b64ab13 Author: ratherblue Authored: Mon Jul 25 23:19:18 2016 -0700 Committer: ratherblue Committed: Mon Jul 25 23:19:18 2016 -0700 ---------------------------------------------------------------------- src/manual/en_US/book.xml | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/incubator-freemarker/blob/0815e14f/src/manual/en_US/book.xml ---------------------------------------------------------------------- diff --git a/src/manual/en_US/book.xml b/src/manual/en_US/book.xml index 2938787..b93691a 100644 --- a/src/manual/en_US/book.xml +++ b/src/manual/en_US/book.xml @@ -759,18 +759,18 @@ All Rights Reserved. Note that since FreeMarker does not interpret text outside FTL tags, interpolations and FTL comments, above you could use the FTL - tags inside a HTML attributes without problem. + tags inside HTML attributes without problem.
Using built-ins - The so called built-ins are like subvariables (or rather like - methods, if you know that Java term) that aren't coming coming from - the data-model, but added by FreeMarker to the values. To make it - unambiguous where the subvarable comes from, to access them you have + The so-called built-ins are like subvariables (or rather like + methods, if you know that Java term) that aren't coming from + the data-model, but added by FreeMarker to the values. In order to make it + clear where subvariables comes from, you have to use ? (question mark) instead of - . (dot). . (dot) to access them. Examples with some of the most commonly used built-ins: @@ -875,17 +875,17 @@ All Rights Reserved. The data-model often has variables that are optional (i.e., sometimes missing). To spot some typical human mistakes, FreeMarker - doesn't tolerate the referring to missing variables, unless you tell + doesn't tolerate references to missing variables unless you tell explicitly what to do if the variable is missing. Here we will show the two most typical ways of doing that. Note for programmers: A non-existent variable and a variable with null - value is the same for FreeMarker, so the "missing" term used here + value is the same for FreeMarker. The "missing" term used here covers both cases. Wherever you refer to a variable, you can specify a default - value for the case the variable is missing, by following the + value for the case the variable is missing by following the variable name with a ! and the default value. Like in the following example, when user is missing from data model, the template will behave like if