Subject: [Boost-docs] How best to abbreviate calls to Unicode symbols using Quickbook
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2010-09-07 11:39:53
Using Unicode values is a bit 'write-only', so giving a symbol a name seems
I've noted a mix of using Unicode symbols both as MACRO defs and as
templates, for example:
[def __ceilR '''⌉''']
and as templates
[template Alpha'''Α'''] [/ ? Greek capital letter alpha] // in
but one could also use
[def __Alpha '''Α''']
"The empty brackets after the template identifier (alpha) indicates no
arguments. If the template body does not look like a template argument list,
we can elide the empty brackets."
So we can write just [alpha] or __alpha
Obviously there is a case for templates when a parameter is involved, for
[template ceil[x] '''⌈'''[x]'''⌉''']
But it seems more consistent to use templates for both?
(I vaguely remember having to use [space] but perhaps that has disappeared?)
QuickBook docs say
The difference with macros are
* The explicit template expansion syntax. This is an advantage because,
now, we don't have to use obscure naming conventions like double underscores
(e.g. __alpha__) to avoid unwanted macro replacement.
* The template is expanded at the point where it is invoked. A macro is
expanded immediately at its point of declaration. This is subtle and can
cause a slight difference in behavior especially if you refer to other
macros and templates in the body.
My instinct is to use templates - though missing the closing ] has caused me
Are there other issues that I am not aware of?
-- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow_at_[hidden]
This archive was generated by hypermail 2.1.7 : 2017-11-11 08:50:41 UTC