summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/csquotes/RELEASE
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.