summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/reledmac/doc-include/migrate-mac.dtx
blob: e8e006ff717463bdf6535e6e639a3767065c1c35 (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
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
% \subsection{Migrating from \edmac to \ledmac} \label{sec:lastuser}
%
% If you have never used \edmac, ignore this section. If you have used
% \edmac{} and are starting on a completely new document, ignore this section.
% Only read this section if you are converting an original \edmac{}
% document to use \ledmac.
%
%    The package still provides the original \cs{text} command, but it is
% (a) deprecated, and
% (b) its name has been changed\footnote{A name like \cs{text} is  likely to be defined by
% other \LaTeX\ packages (it certainly is by the AMS packages) and it
% seems sensible to try and avoid clashes with other definitions.}
% to \cs{critext};
% use the \cs{edtext} macro instead. However, if you do
% use \cs{critext} (the new name for \cs{text}), the following is a reminder.
%
%
% \DescribeMacro{\critext}
% Within numbered paragraphs, footnotes and endnotes are generated
% by forms of the \cs{critext} macro:
% \begin{verse}
% \cs{critext}\marg{lemma}\meta{commands}\verb"/"
% \end{verse}
%
%
% The \meta{lemma} argument is the lemma in the main text: \cs{critext}
% both prints this as part of the text, and makes it available to the
% \meta{commands} you specify to generate notes. The \verb"/" at the
% end terminates the command; it is part of the macro's definition so
% that spaces after the macro will be treated as significant.
%
% For example:
% \egstart
% \begin{verbatim}
% I saw my friend \critext{Smith}
% \Afootnote{Jones C, D.}/
% on Tuesday.
% \end{verbatim}
% \egmid
% 1\enspace I saw my friend\\
% 2\enspace Smith on Tuesday.\smallskip
% \hrule width 1.5cm
% \strut {\bf 2} Smith] Jones C, D.
% \egend
%
% The lemma \verb"Smith" is printed as part of this sentence in
% the text, and is also made available to the footnote
% that specifies a variant, \verb"Jones C, D". The footnote macro
% is supplied with the line number at which the lemma appears
% in the main text.
%
% The \meta{lemma} may contain further \cs{critext} commands.
%  Nesting makes
% it possible to print an explanatory note on a long passage together with
% notes on variants for individual words within the passage. For
% example:
% \egstart
% \begin{verbatim}
% \critext{I saw my friend
%   \critext{Smith}{\Afootnote{Jones
%   C, D.}/ on Tuesday.}
%   \Bfootnote{The date was
%   July 16, 1954.}
% /
% \end{verbatim}
% \egmid
% 1\enspace I saw my friend\\
% 2\enspace Smith on Tuesday.\smallskip
% \hrule width 1.5cm
% \strut {\bf 2} Smith] Jones C, D.\smallskip
% \hrule width 1.5cm
% \strut {\bf 1--2} I saw my friend \\
% Smith on Tuesday.] The\\ date was
% July 16, 1954.
% \egend
%
% However, \cs{critext} cannot handle overlapping but unnested
% notes---for example, one note covering lines 10--15, and another
% covering 12--18; a \cs{critext} that starts in the \meta{lemma}
% argument of another \cs{critext} must end there, too. (The
% \cs{lemma} and \cs{linenum} commands may be used to
% generate overlapping notes if necessary.)
%
% The second argument of the \cs{critext} macro, \meta{commands},
% is the same as the second argument to the \cs{edtext} macro.
%
%
% It is possible to define aliases for \cs{critext}, which
% can be easier to type. You can make a single character substitute
% for \cs{critext} by saying this:
% \begin{verbatim}
% \catcode`\<=\active
% \let<=\critext
% \end{verbatim}
%
% Then you might say \verb"<{Smith}\variant{Jones}/". This of course
% destroys the ability to use \verb"<" in any new macro definitions, so
% long as it remains in effect; hence it should be used with care.
%
% Changing the character at the end of the command requires more work:
% \begin{verbatim}
% \catcode`\<=\active
% \def\xtext#1#2>{\critext{#1}{#2}/}
% \let<=\xtext
% \end{verbatim}
% This allows you to say \verb"<{Smith}\Afootnote{Jones}>".
%
% Aliases for \cs{critext}
% of the first kind shown here also can't be nested---that is,
% you can't use the alias in the text that forms the first argument
% to \cs{critext}. (See \reff{text} to find out why.) Aliases of
% the second kind may be nested without any problem.
%
%
% If you really have to use \cs{critext} in any of the tabular or
% array environments, then \cs{edtext} must not be used in the same
% environment. If you use \cs{critext} in one of these environments
% then you have to issue the declaration \cs{usingcritext} beforehand.
% The declaration \cs{usingedtext} must be issued to revert to the
% default assumption that \cs{edtext} will be used.
% \subsection{Migration from \ledmac to \eledmac}\label{migration}
% In \eledmac, some changes were made in the code to allow easy customization.
% This may cause problems for people who have already made their own. The next sections explain how to handle this.
%
%
% If you have created your own series using \cs{addfootins} and \cs{addfootinsX}, you must use instead the \cs{newseries} command (see \reff{newseries}), and remove any \cs{Xfootnote} command.
%
% If you have customized the \cs{XXXXXXfmt} command, please check whether you can achieve the same by the commands documented for display options (\reff{displayoptions}) or \cs{Xfootnote} options (\reff{Xfootnoteopt}). Otherwise please add a new ticket on Github to request a new function for doing this.\footnote{\url{https://github.com/maieul/ledmac/issues}}
%
% If for some reason you do not want to make the modifications to use the new functions of \eledmac, you can continue using your own \cs{XXXXXfmt} command, but you must replace:
% \begin{verbatim}
% \renewcommand*{XXXXfmt}[3]
% \end{verbatim}
% with
% \begin{verbatim}
% \renewcommandx*{XXXXfmt}[4][4=Z]
% \end{verbatim}
% If you do not make that, you will get a spurious \verb+[X]+, where X is series letter.
%
% If you used a \cs{protect} command inside a \cs{footnote} command inside a numbered section, you must change the \cs{protect} to \cs{noexpand}. Otherwise the command after the \cs{protect} will be discarded.
% \subsection{Migration to eledmac 1.5.1}\label{change151}
% The version 1.5.1 corrects a bug in \verb+stanzaindentsrepetition+ (cf. \reff{stanzaindentsrepetition}). This bug had two consequences:
% \begin{enumerate}
% \item \verb+stanzaindentsrepetition+ did not work when its value was greater than 2.
% \item \verb+stanzaindentsrepetition+ worked wrong when its value was equal to 2.
% \end{enumerate}
%
% So, if you used \verb+stanzaindentsrepetition+ with a value equal to 2, you had to change your \cs{setstanzaindents}. Explanation:
% \begin{verbatim}
% \setcounter{stanzaindentsrepetition}{2}
% \setstanzaindents{5,1,0}
% \end{verbatim}
% This code, in versions prior to 1.5.1, made the first line have an indentation of 0, the second line of 1, the third verse of 0, the fourth verse of 1 and so forth.
%
% But this code should have instead achieved quite the contrary: the first line would have an indentation of 1, the second line of 0, the third line of 1, the fourth line of 0 an so forth.
%
% So version 1.5.1 corrected this bug. If you want to keep the former presentation, you must change:
% \begin{verbatim}
% \setcounter{stanzaindentsrepetition}{2}
% \setstanzaindents{5,1,0}
% \end{verbatim}
% to:
% \begin{verbatim}
% \setcounter{stanzaindentsrepetition}{2}
% \setstanzaindents{5,0,1}
% \end{verbatim}
% \subsection{Migration to eledmac 1.12.0}
% The migration to eledmac 1.12.0 is easy:
% \begin{itemize}
%    \item You must first delete all the auxiliary files, then compile your document three times as usual.
%    \item If you have modified \cs{l@reg}, which is not advisable, you must rename it to \cs{@nl@reg}.
% \end{itemize}
%
% There is an additional problem. If you have put text into brackets just after \cs{pstart} or \cs{pend}, this text will be considered to be an optional argument of \cs{pstart} or \cs{pend} (see \reff{pstart:optionalarg}).
% If so, add a \cs{relax} between \cs{pstart}/\cs{pend} and the first bracket.

% The version 1.12.0 also introduce a better way to handle sectional divisions inside numbered text. Please read \reff{eledsection}.
% \subsection{Migration to eledmac 17.1}
% This version changes the default setting of \cs{Xpstart}.
% Henceforth, pstart numbers will be printed in footnotes within the section of text where you have called \cs{numberpstarttrue}.

% We do not see any reason to print them in the other sections. However, if you want to print the \cs{pstart} numbers in every footnote, whatever the section, without having to use \cs{numberpstarttrue}, you can use
% \cs{Xpstarteverytime}.
% \subsection{Migration to eledmac 1.21.0}
% \subsubsection{\cs{Xledsetnormalparstuff}\ and \cs{ledsetnormalparstuffX}}
% The \cs{ledsetnormalparstuff} has been split into two different commands:
% \begin{itemize}
%  \item \cs{Xledsetnormalparstuff} for critical notes;
%  \item \cs{ledsetnormalparstuffX} for familiar notes.
% \end{itemize}
% Both commands can take an optional argument which is the series letter.
% If you have redefined \cs{ledsetnormalparstuff} or any of the commands which call them, you must change them accordingly.
% \subsubsection{Endnotes}
% In any case, delete the \verb+.end+ file before the next run.
%
% \label{oldprintnpnumspace} The previous version of \Eledmac{} had a bug: there were two spaces between the starting page number and the starting line number, but only one space between the ending page number and the ending line number.
%
% As a matter of fact, a spurious space was added after the first \cs{printnpnum}.
% This spurious space has been deleted.
% However, if you want to keep the previous spurious space, you may load the package with the \verb+oldprintnpnumspace+ option.
%
% If you have redefined \cs{endprint}, you must:
% \begin{itemize}
%  \item Contact us and ask for the feature that required your hack, in order to avoid such a hack in the future.
%  \item Use the new fifth argument.
%  \item Add \verb+\xdef\@currentseries{#4}+ at the beginning of your own command.
% \end{itemize}
% \subsection{Migration to eledmac 1.22.0}
% The \cs{ledinnote} command now takes a first optional argument, which is the label for the hyperreference.
% If you have redefined it, change your redefinition, and check whether you can
% avoid this redefinition by only redefining \cs{ledinnotemark}.
% \subsection{Migration to eledmac 1.23.0}
% You must delete the numbered auxiliary files before compiling with the new version of \eledmac.
%
% \subsection{Migration from \eledmac to \reledmac}\label{migratereledmac}
% There are many changes in \reledmac which require the user to make modifications.
%
%
% \subsubsection{Risk of `no room for a new'}
% The risk to obtain a `no room for a new something' error is greater in \reledmac than it is in \eledmac. See \reff{noroom} in order to know how to limit it.
% \subsubsection{Multiple indices with memoir}
% \Eledmac and \ledmac used the specific indexing tools of the \ltxclass{memoir} class designed to produce multiple indices.
% However, \eledmac could also use \package{imakeidx} or \package{indextools} tools independently of the \ltxclass{memoir} class.
% This system forced to maintain redundant code.
% Since \reledmac, we use only the \package{imakeidx} or \package{indextools} tools.
%
% Consequently: Users of \package{memoir}are invited to use \package{indextool} or \package{imakeidx} to produce multiple indices.

% \subsubsection{Deprecated commands and options}
%The table of deprecated commands and their alternatives follows.
% Note that the way some commands must be used may have changed.
% Please read the handbook.
%
% \begin{longtable}{p{0.45\textwidth}p{0.45\textwidth}}
% \emph{Deprecated command} 	& \emph{Replaced with} \\
% \hline
% \endhead
% \cs{addfootins}		& \cs{newseries} \\
% \cs{addfootinsX}		& \cs{newseries} \\
% \cs{critext}			& \cs{edtext}			 \\
% \cs{falseverse}		& \cs{newverse}    \\
% \cs{interparanoteglue} & \cs{Xafternote} and \cs{afternoteX} \\
% \cs{ledchapter} 		& \cs{eledchapter} \\
% \cs{ledsection}		& \cs{eledsection} \\
% \cs{ledsetnormalparstuff}	& \cs{Xledsetnormalparstuff} and \cs{ledsetnormalparstuffX}      \\
% \cs{ledsubsection}		& \cs{eledsubsection} \\
% \cs{ledsubsubsection}		& \cs{eledsubsubsection} \\
% \cs{noeledsec}		& Package option \verb+noeledsec+ \\
% \cs{noendnotes} 		& Package option \verb+noendnotes+ \\
% \cs{pageparbreak}		& \cs{ledpb} \\
% \end{longtable}
%
% The \verb+ledsecnolinenumber+ option has been removed, because it was related to deprecated commands.
%
% The \verb+oldprintnpnumspace+ option has been removed too, because it was related to a historical bug.
% The \cs{usingedtext} and \cs{usingcritext} commands are also deprecated.
%
% \subsubsection{\cs{renewcommand}\ replaced by command}
% Many uses of \cs{renewcommand} have been replaced with uses of specific commands. Please read handbook about specific commands.
%
% \begin{longtable}{p{0.45\textwidth}p{0.45\textwidth}}
% \emph{Deprecated \cs{renewcommand}} & \emph{Replaced with} \\
% \endhead
% \cs{@led@extranofeet} & \cs{newseries}\\
% \cs{apprefprefixmore} & \cs{setapprefprefixmore} \\
% \cs{apprefprefixsingle} & \cs{setapprefprefixsingle} \\
% \cs{endstanzaextra} & Optional argument of \expandafter\cs\expandafter{\&}\\
% \cs{hangingsymbol} & \cs{sethangingsymbol}\\
% \cs{ledfootinsdim}		& \cs{Xmaxhnotes} and \cs{maxhnotesX} 	\\
% \cs{parafootftmsep}	  & \cs{Xparafootsep} and \cs{parafootsepX} \\
% \cs{notenumfont}  		& \cs{Xnotenumfont}, \cs{Xendnotenumfont} and \cs{notenumfontX} \\
% \cs{notefontsetup}    & \cs{Xnotefontsize}, \cs{Xendnotefontsize} and \cs{notefontsizeX} \\
% \cs{sidenotesep} & \cs{setsidenotsep} \\
% \cs{startstanzahook} & Optional argument of \cs{stanza} \\
% \cs{symplinenum} & \cs{Xsymlinenum}\\
% \end{longtable}
% \subsubsection{Commands the names of which have been changed}
% \label{eledmac-compat}
% In order to help the migration from \eledmac to \reledmac, you may load \reledmac with \verb+eledmac-compat+ option.
% However, it is advised not to, and to change the command names themselves instead.
% In many cases, you use only a few of them, except the \cs{footparagraph} command.
%
%
% \begin{longtable}{p{0.45\textwidth}p{0.45\textwidth}}
% \emph{Old command} 	& \emph{New command} 	 \\
% \hline
% \endhead
%\cs{footparagraph}	& \cs{Xarrangement}	 \\
% \cs{footnormal}	& \cs{Xarrangement}	 \\
% \cs{foottwocol}	& \cs{Xarrangement}	 \\
% \cs{footthreecol}	& \cs{Xarrangement}	 \\
% \hline
% \cs{footparagraphX}	& \cs{arrangementX}	 \\
% \cs{footnormalX}	& \cs{arrangementX}	 \\
% \cs{foottwocolX}	& \cs{arrangementX}	 \\
% \cs{footthreecolX}	& \cs{arrangementX}	 \\
% \hline
% \cs{afterlemmaseparator} & \cs{Xafterlemmaseparator}\\
% \cs{afternote} & \cs{Xafternote} and \cs{afternoteX} \\
% \cs{afternumberinfootnote} & \cs{Xafternumber} \\
% \cs{afterXrule} 	& \cs{Xafterrule} \\
% \cs{afterXsymlinenum} & \cs{Xaftersymlinenum} \\
% \cs{beforelemmaseparator} & \cs{Xbeforelemmaseparator} \\
% \cs{beforenumberinfootnote} & \cs{Xbeforenumber} \\
% \cs{beforeXnotes} & \cs{Xbeforenotes} \\
% \cs{beforeXsymlinenum} & \cs{Xbeforesymlinenum} \\
% \cs{bhookXnote} & \cs{Xbhookendnote}\\
% \cs{bhookXnote} & \cs{Xbhooknote} \\
% \cs{boxendlinenum} & \cs{Xboxendlinenum}\\
% \cs{boxlinenum} & \cs{Xboxlinenum} \\
% \cs{boxlinenumalign} & \cs{Xboxlinenumalign} \\
% \cs{boxstartlinenum} & \cs{Xboxstartlinenum} \\
% \cs{boxsymlinenum} & \cs{Xboxsymlinenum} \\
% \cs{boxXendlinenum} & \cs{Xendboxlinenum} \\
% \cs{boxXendlinenumalign} & \cs{Xendboxlinenumalign} \\%
%  \cs{boxXendstartlinenum} & \cs{boxXendstartlinenum} \\
%  \cs{letboxXendendlinenum} & \cs{Xendletboxendlinenum} \\
% \cs{hsizetwocol} & \cs{Xhsizetwocol} \\
% \cs{hsizethreecol} & \cs{Xhsizethreecol} \\
% \cs{inplaceoflemmaseparator} & \cs{Xinplaceoflemmaseparator} \\
% \cs{inplaceofnumber} & \cs{Xinplaceofnumber} \\
% \cs{lemmaseparator} & \cs{Xlemmaseparator} \\
% \cs{maxhXnotes} & \cs{Xmaxhnotes} \\
% \cs{morethantwolines} & \cs{Xmorethantwolines} \\
% \cs{nonumberinfootnote} & \cs{Xnonumber} \\
% \cs{notesXwidthliketwocolumns} & \cs{noteswidthliketwocolumnsX} \\
% \cs{noXlemmaseparator} & \cs{Xnolemmaseparator} \\
% \cs{numberonlyfirstinline} & \cs{Xnumberonlyfirstinline} \\
% \cs{numberonlyfirstintwolines} & \cs{Xnumberonlyfirstintwolines} \\
% \cs{nonbreakableafternumber} & \cs{Xnonbreakableafternumber} \\
% \cs{onlyXpstart} & \cs{Xonlypstart} \\
% \cs{parafootsep} & \cs{Xparafootsep} and \cs{parafootsepX} \\
% \cs{pstartinfootnote} & \cs{Xpstart} \\
% \cs{pstartinfootnoteeverytime} & \cs{Xpstarteverytime} \\
% \cs{symlinenum} & \cs{Xsymlinenum} \\
% \cs{twolines} & \cs{Xtwolines} \\
% \cs{twolinesbutnotmore} & \cs{Xtwolinesbutnotmore} \\
% \cs{twolinesonlyinsamepage} & \cs{Xtwolinesonlyinsamepage} \\
% \cs{txtbeforeXnotes} & \cs{Xtxtbeforenotes} \\
% \cs{XendXafterlemmaseparator} & \cs{Xendafterlemmaseparator} \\
% \cs{XendXbeforelemmaseparator} & \cs{Xendbeforelemmaseparator} \\
% \cs{XendXinplaceoflemmaseparator} & \cs{Xendinplaceoflemmaseparator} \\
% \cs{XendXlemmaseparator} & \cs{Xendlemmaseparator} \\
% \cs{XendXmorethantwolines} & \cs{Xendmorethantwolines} \\
% \cs{XendXtwolines} & \cs{Xendtwolines} \\
% \cs{Xnonumberinfootnote} & \cs{Xnonumber} \\
% \hline
% \cs{lineref}	& \cs{edlineref} \\
% \end{longtable}
% \subsubsection{Endnotes}
% With \reledmac, there is now one auxiliary file for each endnotes set (.Aend, .Bend, .Cend etc.). If you have overridden \cs{doendnotes} (which you should not have done) you must adapt your code.
% \subsubsection{Z Series}
% The `Z' series of notes has been removed. Only five series are provided now by default: A, B, C, D, E.
% \subsubsection{Internal commands}
% Users who have overriden internal commands, which is wrong, must adapt according to the following. Or better, they should not override any of such commands and use \reledmac options instead.
% \begin{itemize}
%   \item If you have modified \cs{Xfootfmt}, note that the fourth argument is now mandatory.
%   \item \cs{unvxh} has been replaced with \cs{Xunvxh} and \cs{unvxhX} with two mandatory arguments.
% \end{itemize}
% \subsection{Migration to \reledmac~2.1.0}
% \Reledmac~2.1.0 fix some bugs when using \cs{Xbhooknote} and \cs{bhooknoteX} not in order to execute code at the beginning of each notes, but to insert content of at the beginning of each notes.
%
% People who use these commands to do it, which is not the original idea, must change the following:
% \begin{enumerate}
% \item Horizontal space is no longer automatically added after the content of the \cs{Xbhooknote}/\cs{bhooknoteX} argument.
% You must include it manually.
% So instead of \cs{Xbhooknote}\arg{content}, use \cs{Xbhooknote}\arg{content\ }.
%  \item Indent is no longer automatically added before the content of the \cs{Xbhooknote}/\cs{bhooknoteX} argument.
%  If you want to keep it, add \cs{indent} to the argument of \cs{Xbhooknote}/\cs{bhooknoteX}.
% \end{enumerate}
% \subsection{Migration to \reledmac~2.1.3}
% \Reledmac~2.1.3 fix an historical bug,  (style in \ledmac~0.7!) which doubled the space before the rules of paragraphed familiar footnotes.
% Consequently, if you use paragraphed familiar footnotes, you should maybe adapt it, playing with \cs{beforenotesX}.
% \subsection{Migration to \reledmac~2.3.0}\label{mac2.3.0migration}
% Before \reledmac~2.3.0, for typesetting verse, any empty line was considered a paragraph inside verses. Counting empty lines this created breaking verse, hanging verses, and also added spurious vertical spaces.
% Version 2.3.0 disables paragraph in stanza. If you want vertical space, use the optional argument of \cs{stanza} or \cs{endverse}.
% \subsection{Migration to \reledmac~2.4.0}
% It is not mandatory, but  strongly recommended, to change any \cs{renewcommand}\arg{\textbackslash endashchar}\marg{…} to the use of \cs{Xlinerangeseparator} or / and \cs{Xendlinerangeseparator} (\reff{linerangeseparator}).
% \subsection{Migration to \reledmac~2.5.0}
% It is strongly recommended to stop redefining \cs{printnpnum} and to use the hooks documented in \reff{pagelineendnotes}.
%
% \cs{xlineref} does not print anymore the side flag (R for right side), because it is incompatible with numerical test. Use \cs{xflagref} to obtain it.
%
% The \cs{printlines} and \cs{printendlines} commands take now an eighth argument, which is the side flag. It is strongly recommended to NEVER redefine these two commands and to use the setting commands instead (or to ask for new setting commands if the actual does not answer to  your needs). However, if you have done it, just change your redefinition to have a new argument.
%
%
% It is strongly recommended to stop redefining \cs{fullstop} and to use \cs{Xsublinesep} instead.
% \subsection{Migration to \reledmac~2.7.0}
% \cs{SErefonlypage} (introduced in \reledmac~2.5.0) added an parenthesis after the page number. This was just an error, linked to a bad imitation of \cs{SErefwithpage}. That has been deleted. And so, the \cs{XendafterpagenumberSErefonlypage} to set it was also deleted.
%
% \cs{rigidbalance} is split to two new commands: \cs{Xrigidbalance} for critical footnotes and \cs{rigidbalanceX} for familiar footnotes. If you have redefined it --- but why should you have ?---, you should split your single redefinition in two redefinitions.
%
%
% \subsection{Migration to \reledmac~2.7.2}
% \cs{Xhsize} is already defined in the \package{floatrow} package.
% It becomes \cs{Xwidth}, and, consequently, \cs{hsizeX} becomes \cs{widthX}.
%
% The ancient names are temporarily maintained as aliases.
% \subsection{Migration to \reledmac~2.8.0}
% \Reledmac~2.8.0 fix spurious indents for paragraphed critical and familiar footnotes in \env{ledgroup} and \ledgroup{minipage}. You can re-establish the indent with \cs{Xparindent} and \cs{parindentX}.
% \subsection{Migration to \reledmac~2.13.1}
% \Reledmac~2.5.0 added a bug, which makes the right flag to be printed on the right side of critical footnotes, even if not explicitly requested by using \cs{Xlineflag}.
%
% Version 2.13.1 solves this issue. Please use \cs{Xlineflag} if you want to add the right flag.
%
% \subsection{Migration to \reledmac~2.18.0}
% After updating reledmac, and before any new compilation, you need to clean your \verb|.aux| files, if you use \cs{edlabel} or related.
% \subsection{Migration to \reledmac~2.21.0}
% Previously, there was a bug, which meant that the description in the handbook was incorrect. If you wrote
% \begin{verbatim}
%   The \edtext{creature\edindex{elephant} was quite
%    unafraid}{\Afootnote{Of the mouse, that is.}}
% \end{verbatim}
% \enquote{elephant} was indexed in the main text and in the critical footnotes.
% With the new version of \reledmac, it is indexed only in main text.
% If you also want to index it in critical footnotes, do
% \begin{verbatim}
%   The \edtext{creature\edindex{elephant} was quite
%    unafraid}{\Afootnote{\edindex{elephant}Of the mouse, that is.}}
% \end{verbatim}
% \subsection{Migration to \reledmac~2.24.0}
% When using \cs{labelpstarttrue}, a spurious space\footnote{See \url{https://github.com/maieul/ledmac/issues/673\#issuecomment-322457149} for an example.} was introduced after the pstart number (only for normal typesetting, not while typesetting in parallel).
% The new version of the package has deleted this spurious space.
% If you consider that it was NOT a spurious space, you should add it manually in your definition of \cs{thepstart}.
% \subsection{Migration to \reledmac~2.26.0}
% You must delete your \verb+.aux+ file after having upgraded to this new version of \reledmac.
% \subsection{Migration to \reledmac~2.27.1}
This release fixes spurious space in \cs{hidenumbering}.
%If you considered this spurious space as normal, you must insert it manually using.
\begin{verbatim}
xx\hidenumbering\ xx
\end{verbatim}

%To get the space after \verb+xx+.

% \subsection{Migration to \reledmac~2.30.0}

If you have multiple annotations for the same line, these are now separated with a comma in the margin. You can use \cs{setlinenumannotationsep} to change the separator.

% \subsection{Migration to \reledmac~2.31.1}
%If you use \cs{Xgroupbyline}, the indentation of the notes has been deleted, in order to have the same behavior as for normal critical notes.
%
%Use \cs{Xparindent} to restore indentation.
% \subsection{Migration to \reledmac~2.32.7}
% For paragraphed familiar footnotes, the separator between notes was \cs{Xparafootsep} instead of \cs{parafootsepX}. This release fixes this bug. You may adapte your settings.