blob: 779843535e0f2e7db979db0e70c4a4e9867a12c1 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
|
$Id: RELEASE,v 5.0c 2010/09/21 18:17:28 lehman stable $
RELEASE NOTES FOR VERSION 5.0
* Backwards compatibility
This release introduces some changes which are not backwards
compatible out of the box. In order to ease the transition to the
new version, I've implemented a 'version' option which emulates
older versions of csquotes.
It is quite possible that you do not need to set this option at
all, even though you have older documents using csquotes. You
only need the 'version' option in older documents if:
- you are using the <punct> argument of \blockquote and/or
- you have redefined any of the old
'\mk(pre|mid|fin)(text|block|disp)punct' hooks.
If these conditions do not apply and you run 5.0 with the default
settings, the output will be similar to 4.4. There is absolutely
no need to set 'version=4.4' if you didn't use the old hooks and
the <punct> argument of \blockquote anyway.
I've also removed some legacy aliases. This is rather old stuff
from csquotes 3.x and even 2.x which has been marked as
depreciated for some time. Setting 'version=4.4' will restore
them as well.
* Punctuation look-ahead
This release comes with a new punctuation look-ahead feature,
i.e., in addition to the <punct> argument of advanced quotation
commands like \textquote, these commands can now scan ahead for
trailing punctuation after their last argument and move it around
if desired.
This is required by quoting conventions such as the US quotation
style which requires that a period or a comma immediately after a
closing quotation mark be moved inside the quotes even if it is
not part of the quoted text.
The implementation of the look-ahead feature also implies a new
interpretation of the optional <punct> argument supported by
certain quotation commands. In previous version, the <punct>
argument was intended for terminal punctuation which is NOT part
of the quoted text. Starting with this release, it is intended
for punctuation which IS part of the quoted text (but may need to
be moved around).
The modified syntax is more intuitive to use because terminal
punctuation which is NOT part of the quoted text is simply placed
after the last argument of the command, i.e.:
\textquote[citation][.]{quoted text}
becomes:
\textquote[citation]{quoted text}.
All of this is discussed at length in the manual. See the
changelog in the manual for pointers to the relevant sections.
* Revised quotation hooks
The old quotation hooks:
\mkpretextpunct
\mkmidtextpunct
\mkfintextpunct
\mkpreblockpunct
\mkmidblockpunct
\mkfinblockpunct
\mkpredisppunct
\mkmiddisppunct
\mkfindisppunct
have been removed and are replaced by new hooks:
\mktextquote
\mkblockquote
\mkbegdispquote
\mkenddispquote
which are much more powerful while being more intuitive to use.
If you have been using the old hooks in some documents, set
'version=4.4' to emulate the old interface.
|
