Difference between revisions of "Editorial Update/Textual Amendments/Repeals/Higher Level Repeals"

From Legislation Community Editorial Wiki
Jump to navigation Jump to search
 
(442 intermediate revisions by 5 users not shown)
Line 1: Line 1:
==Repeal of whole Part, Chapter, Schedule etc.==
+
==OVERVIEW==
  
<ol><li> From the ‘Update Overview’ page <strong>select the ‘Details’ button</strong> next to the update task you are going to complete.  
+
Repeals at higher level can include groups of provisions, Parts, Chapters, Schedules or the whole item of legislation. 
 +
For a whole extent, wholly in force higher level repeal where there are no substantive savings, the text can be completely removed and replaced with a dotty line. This type of repeal may be carried out by the [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Auto_repeal_function|Auto Repeal]] function on the Editorial Site. It is not necessary to check the amended provision out in XMetaL, unless you need to edit the auto annotation after the <strong>Auto Repeal</strong> has been carried out. If you need to repeal a range of provisions, you can use the [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Batch_Repeal_Function_.E2.80.93_repealing_ranges_of_provisions|Batch Repeal]] function.
  
[[File:Higher Level Repeals - image 1.png|link=]]
+
For higher level repeals where the text should remain intact (e.g. where the repeal is for a limited extent, specified purposes or there are substantive savings), it is possible to carry out a retained text repeal in the Editorial System where brackets will be included around the retained text an annotation will be inserted at top level, or the repeal may be carried out in XMetaL by inserting the repeal annotation in a suitable location and leaving the text untouched (i.e. no square brackets around retained text). The choice of approach will depend on the type of repeal and is explained further in the [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#EDITORIAL_APPROACH|Editorial Approach]] section below.
  
<li> The ‘Update Details’ page for high level amendments will show a list of the high level amendments to be completed for the Point in Time you are editing (there may be more than one).  The task details given are the same as for provision level amendments. However, to preview the amended provision you will need to select ‘Preview Legislation’.  <strong>Directly under the task details you will be presented with the Table of Contents for the Act you are updating</strong>. The Table of Contents can be used to check out individual provisions, whole Parts, Schedules or even the whole Act. <strong>insert image</strong></li>
+
Higher level repeals may also come into force in stages that need to be applied <strong>incrementally</strong> across various <strong>PiTs</strong>.
  
<li> Use the link in the amendments list to link to the ‘affecting provision’ and <strong>check the amendment instructions</strong>. For example, if the amendment is in a repeal Schedule find the reference to the repeal you are carrying out.</li> 
+
If you are not sure about any aspect of your higher level repeal, for example whether the text should be retained or not, or whether the retained text should be retained with brackets, or where the F-note should go, consult a <strong>Review Editor</strong>.
  
<li> <strong>Scroll down the Table of Contents</strong> and to find the Part or relevant heading level to be repealed. Next to the heading of the Part, Chapter or Schedule to be repealed <strong>you will see a button labelled ‘Auto Repeal’ – select this button</strong>.<strong>insert image</strong></li>
+
===Before you carry out a higher level repeal===
  
<li> On selecting ‘Auto Repeal’ you will be asked to confirm this is what you want to do. <strong>Select ‘OK’ to continue</strong> or ‘cancel’ to stop the process. On selecting OK the system will automatically carry out the repeal for you – this may take a few moments. <strong>insert image</strong>
+
Before carrying out a higher level repeal, make sure that you have researched the <strong>effects spreadsheet</strong> to check the type of effect, the commencement status, the extent and whether there are any savings, so that you are clear about whether text needs to be retained or not, and if text does need to be retained whether it needs to be surrounded by square brackets or not.
  
Note: You do not have to check out the file to carry out the automatic repeals.</li>
+
Use the [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Decision-making_Process_for_Higher_Level_Repeals|Decision-making Process for Higher Level Repeals]] and the [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#EDITORIAL_APPROACH|Editorial Approach]] sections to help you to decide on the correct approach to take before you go to the relevant part of the [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#EDITORIAL_PROCESSES|Editorial Processes]] section, which will explain how to carry out the repeal in the Editorial System.
  
<li> Check that the high level repeal task has been set to ‘edit complete’.</li>
+
<strong>Note:</strong> Be careful to check that the TOES details are correct e.g. if the repeal has been recorded as for specified purposes in TOES that the repeal really is for specified purposes only and not just for a range of provisions. If any of the details are incorrect, TOES may need to be corrected (speak to a <strong>Review Editor</strong>).
  
==Repeal of a whole Act==
+
===Decision-making process for Higher Level Repeals===
  
<ol><li> From the ‘Update Overview’ page <strong>select the ‘Details’ button</strong> next to the update task you are going to complete.
+
{|class=wikitable style="width: 95%;"
 +
|-
 +
|1. <strong>Does the repeal apply to all provisions or only some?</strong> Is the auto repeal or batch repeal functionality therefore the best way to achieve the desired result?
  
Note: At the current time the ‘continue update’ button is not working in relation to the high level amendments. This will be fixed in due course.</li>
+
However, before leaping in to use either auto repeal or batch repeal, consider the following&#8230;
  
<li> The ‘Update Details’ page for high level amendments will show a list of the high level amendments to be completed for the Point in Time you are editing (there may be more than one).  The details given are the same as for provision level amendments. However, the preview facility usually seen under the list of amendments won’t be available until you have completed the amendment. If you want to preview the amended provision at this stage you will need to select the ‘Preview Legislation’.  <strong>Instead, directly under the table you will be presented with the Table of Contents for the Act in question</strong>.</li>
+
2. <strong>Is the repeal of any or all of those provisions qualified in some way?</strong> Does it only apply for specified purposes, or in relation to a limited extent or territorial application, or are there substantive (as opposed to common form) savings that might make us think twice before dotty-lining the text and instead push us towards retaining text?
  
<li> Use the link in the amendments list to link to the ‘affecting provision’ and <strong>check the amendment instructions</strong>. For example, if the amendment is in a repeal Schedule find the reference to the repeal you are carrying out.</li> 
+
3. <strong>If the repeal itself is not qualified, then has it been brought wholly into force or is its commencement qualified?</strong> Is it only in force for specified purposes, or in relation to a limited extent or territorial application, or only in relation to some of its provisions and not others?  Does the commencement order contain substantive savings which make us think twice before sweeping the text away?
  
<li> At the top of the Table of Contents you will <strong>see a button labelled ‘Auto Repeal’ – select this button</strong>.</li>
+
4. <strong>Has anything already been repealed and, if so, what’s the best way to repeal the remainder?</strong> For example, if one or two provisions have been wholly repealed in a Part and then the Part is repealed (with no qualification), then we would just do a whole Part repeal and not repeal the remaining provisions individually.  (After all, users can always see what the situation was before the last repeal in the previous versions).  But if the Part repeal had been qualified as “in so far as not already repealed” then that forces us to work out what the remaining provisions are and then batch repeal them.
  
<li> On selecting ‘Auto Repeal’ you will be asked to confirm this is what you want to do. <strong>Select ‘OK’ to continue</strong> or ‘cancel’ to stop the process. On selecting OK the system will automatically carry out the repeal for you – this may take a few moments.
+
5. <strong>What happens next?</strong> Is there anything in TOES coming along in a future PiT (further amendments to our repealed provisions) which might make us think that we need to approach the repeal more cautiously and perhaps recognise that the savings we may have dismissed as common form are more substantive than we gave them credit for?  Perhaps it may just be easier for the user to make sense of what’s going on if, rather than removing the text, we decide to retain the text for now in order to apply the future amendments to the saved repealed provisions?
 +
|}
  
Note: You do not have to check out the file to carry out the automatic repeals.</li>
+
==EDITORIAL APPROACH==
  
<li> Check that the high level repeal task has been set to ‘edit complete’.</li>
+
===Whole repeals that are wholly in force===
 +
 +
Where the repeal of the entire Part, Chapter, Schedule or whole item of legislation is wholly in force, covers the whole extent and there are no savings to be considered (see Caveat), you can use the [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Auto_Repeal_function|Auto Repeal function]]. The amendments are automatically generated by the Editorial System when the <strong>Auto Repeal</strong> button has been selected from the High Level <strong>Update Details</strong> page.
  
==What to expect==  
+
====Things to look out for====
  
<li> On completing the amendment the layout of the page will change  - where the Table of Contents had been previously you will now see the standard preview panes (‘current’, initial’ and XML). The ‘current’ tab will show the latest version of the ‘Parent’ Heading e.g. ‘Part 1’.  Directly below the heading will be a single dotted line and the commentary annotation giving authority for your repeal.</li>
+
=====Errors in the automatically generated annotation=====
  
<li> To check the version history and see how the amendment would look in the context of the whole Act, <strong>select the preview legislation button and check</strong>:
+
When you [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Auto_Repeal_function|auto repeal]] a whole item of legislation, you will need to check that the correct type of legislation is referenced as the affected provision in the annotation (i.e. for secondary legislation, ‘Instrument’ should be amended as appropriate to ‘Order’, ‘Rules’ or ‘Regulations’ (See [[Preparation_Tasks/Record_Effects#Citing_Provisions_in_Secondary_Legislation|Citing Provisions in Secondary Legislation]]).
  
*a. On opening the ‘Parent Heading’ from the Table of Contents  -  directly below the heading will be a single dotted line and the commentary giving authority for your repeal.  On the ‘Timeline of Changes’ you will see a new version has been created as at the date of the Point in Time you have been editing.  
+
<strong>Note:</strong> for an Act of Adjournal, Act of Sederunt or Archbishops’ Instrument, the word ‘Instrument’ is correct and does not need to be changed.
  
*b. On opening one of the ‘child provisions’ from the  Table of Contents (e.g. a provision that falls under the parent heading), you should see a single dotted line appearing immediately after the provision number (there <u>won’t</u> be an f-note reference).  The annotation will appear in a pink box. On the Timeline of Changes you will see a start date as at the date of the Point in Time you have been editing.
+
{|class="wikitable" style="border-left:solid 2px red;border-right:solid 2px red;border-top:solid 2px red;border-bottom:solid 2px red; background-color:#e6f2ff;
 +
|-
 +
|<strong>WARNING:</strong> Look out for a bug in the auto repeal function whereby the annotation that is generated when Regulations are auto repealed says “Regulation revoked” rather than “Regulations revoked”. Look out for this and correct as necessary (NB also double check for this potential issue when revoking Rules).
 +
|}
  
Note:  There is a bug on legislation.gov.uk where for Schedules the provision number may not be displayed and you will just see a dotted line.  This is a known issue and will be fixed in due course.</li>
+
Also check that the commencing provision of the amending legislation is present in the annotation and add it in if it is missing.
  
<li> Select the select <strong>Return to Task Overview</strong> to continue to apply further updates or complete the Point in Time.</li>
+
You can edit the annotation using the <strong>Edit</strong> button to the right of the annotation in <strong>Preview</strong> to edit it without having to check the provision out again in XMetaL. Click <strong>Update</strong> when you have finished making your changes to the text of the annotation (this will also generate any hyperlinks if necessary). You only need to check the provision out to edit the annotation where a hyperlink doesn't work because two same level sub-provisions are being cited (e.g. reg. 1(2)(3)), or if the wrong provision has been highlighted as being the  [[Editorial_Update/XMetaL_and_XML_tagging#Operative_Attribute | operative provision]]. See more on fixing broken hyperlinks [[Editorial_Update/XMetaL_and_XML_tagging#Fixing_hyperlinks |here]].
  
<li> You should find that the bar chart diagram has turned green indicating  that either part or all the amendments within the provision at that point in time have been completed.</li>
+
=====Location of F-note reference, annotation and dotty lines=====
  
<li> If there are no more effects to be applied to your Act you can <strong>Complete update > Last step</strong>.</li></ol>
+
When you preview the completed amendment, you should make sure that the text of the repealed Part/Chapter/Schedule or whole item of legislation has been replaced by a dotty line. On opening the <strong>Parent Level</strong> from the <strong>ToC</strong>, directly below the heading there will be a single dotty line and following that will be the annotation giving authority for your repeal.  On the <strong>Timeline of Changes</strong> you will see a new version has been created as at the date of the <strong>PiT</strong> of the repeal:
 +
 
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|<strong>Whole repeal of a whole item of legislation</strong>
 +
 
 +
 
 +
https://www.legislation.gov.uk/nisr/2015/205/2016-04-01
 +
 
 +
|-
 +
|[[File:High_Level_Repeals_2.png|900px]]
 +
|}
 +
 
 +
Note also that the word ‘(revoked)’ has been added to the end of the legislation title in the locations that have been highlighted. The word ‘revoked’ should only be present in these locations where a full repeal has been carried out, not for a retained text repeal. The top title is contained within the <code>dc:title</code> element, which is part of the metadata and we are unable to edit this directly, however if we make amendment to the legislation title, this should also be carried through into this top title. If an item of legislation is inadvertently fully repealed when text should have been retained, and the repeal needs to be corrected, we need to make sure that the word ‘(revoked)’ is removed from the legislation title <strong>and</strong> the top title.
 +
 
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|<strong>Whole repeal of a Schedule</strong>
 +
 
 +
https://www.legislation.gov.uk/uksi/2010/490/schedule/1/2017-11-30
 +
 
 +
|-
 +
|[[File:High_Level_Repeals_3.png|900px]]
 +
|}
 +
 
 +
An example of the format of one of the revoked <strong>Child Provisions</strong> within the Schedule is:
 +
 
 +
https://www.legislation.gov.uk/uksi/2010/490/schedule/1/paragraph/1/2017-11-30
 +
 
 +
The provisions have a single dotty line appearing immediately after the provision number. There isn’t an F-note reference, but the annotation still appears below. On the Timeline of Changes there is a start date as at the date of the <strong>PiT</strong> of the repeal.
 +
 
 +
 
 +
See an example of a whole repeal of a Chapter here:
 +
 
 +
https://www.legislation.gov.uk/uksi/2019/657/part/3/chapter/2/2020-12-31
 +
 
 +
Child provision within the repealed Chapter: https://www.legislation.gov.uk/uksi/2019/657/regulation/54/2020-12-31
 +
 
 +
=====Partially dotty lined Explanatory Notes when using the auto repeal function to revoke secondary legislation =====
 +
 
 +
{|class="wikitable" style="border-left:solid 2px red;border-right:solid 2px red;border-top:solid 2px red;border-bottom:solid 2px red; background-color:#e6f2ff;
 +
|-
 +
|There is currently a bug in the auto repeal facility which means that sometimes the Explanatory Note (EN) is left intact and still appears at the end of the revoked SI and sometimes the EN gets dotty lined and no longer appears at the end of the revoked SI. This is described in more detail under [[Editorial_Update/Approach_to_Update,_Specific_Update_Issues_and_Update_Troubleshooting#Check_Explanatory_Note_when_wholly_revoking_secondary_legislation_using_auto_repeal_-_has_EN_been_partially_dotty_lined.3F|Specific Update Issues]].
 +
|}
 +
 
 +
====<u>Caveat: what happens where there are savings</u>====
 +
 
 +
If your repeal is wholly in force and whole extent (so that all the text will be omitted upon repeal) but you think the [[Editorial_Principles#Savings|savings]] are so substantial that text should be retained, consult a <strong>Review Editor</strong> about how to proceed.
 +
 
 +
Where there are <strong>[[Editorial_Principles#Substantive_savings|substantive]]</strong> (as opposed to <strong>[[Editorial_Principles#Common_Form_savings_.28and_other_qualifiers.29|common form]]</strong>) savings, we may need to pause before going ahead and removing and dotty-lining the text and take some time to consider whether text should be retained.
 +
 
 +
If the legislation is repealed but continued for specified purposes and at the same time there are large insertions as so continued, it is probably useful to website users to retain text so that it can still be referred to easily (see examples [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Substantive_savings|below]]). 
 +
 
 +
Also, even where savings appear to be common form we should consider whether there anything in TOES coming along at a future PiT (further amendments to our repealed provisions) that might require the text to be retained so that we can apply future amendments to the saved repealed provisions. For smaller amendments in saved repealed documents it’s probably sufficient just to mention them as appended commentary to the main repealed annotation. Consult a <strong>Review Editor</strong> if you are not sure. 
 +
 
 +
See also the Scenarios section below, for an example of how we dealt with a [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Dealing_with_a_document_that_has_been_wholly_repealed_with_savings_and_the_saved_version_subsequently_gets_amended|document that was repealed with savings where text wasn't retained but the saved version was subsequently amended]].
 +
 
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|See, for example, the repeal of [https://www.legislation.gov.uk/ukpga/1967/86/part/III/crossheading/creation-of-public-paths 1967 c. 86, ss. 30-38]:
 +
 
 +
This repeal is subject to <strong>substantive</strong> savings in [https://www.legislation.gov.uk/asp/2003/2/schedule/2/paragraph/7/2005-02-09 2003 asp 2, Sch. 2 para. 7], which leaves those provisions in effect for a whole class of specified rights, which justified the text being retained:
 +
 
 +
“Notwithstanding the repeal of section 30 to 38, those sections continue to have effect—
 +
(a) to the extent that the rights and facilities afforded to the public under those sections are not secured by section 1 above;
 +
(b) in relation to land in respect of which access rights are, under section 6 above, not exercisable; and
 +
(c) in relation to rights of way.”
 +
 
 +
 
 +
Contrast this with the repeal of [https://www.legislation.gov.uk/ukpga/1967/86/part/II 1967 c. 86, Pt. 2]:
 +
 
 +
This repeal is subject to [https://www.legislation.gov.uk/asp/2003/2/schedule/2/paragraph/6/2005-02-09 2003 asp 2, Sch. 2 para. 6], but these savings are more <strong>common form</strong> and transitional and therefore do not justify retaining the text:
 +
 
 +
“The coming into force of the repeal of Part II does not—
 +
(a) prevent compensation thereafter being claimed or becoming payable under section 21 of the Act (compensation for depreciation or disturbance as a result of access order to be assessed only after five years' operation of order); or
 +
(b) otherwise affect the operation thereafter of sections 21 to 23 and 70 of that Act in relation to claims for or payment of compensation.”
 +
 
 +
Note that transitional arrangements smooth the change in the law for certain persons or purposes and, it doesn’t really matter how long that transitional period is, the transitional arrangements will eventually come to an end and the new law will prevail.  A substantive saving would result in these amendments not applying to certain persons or things etc at all and the old law continuing indefinitely in relation to those persons or things etc. 
 +
|}
 +
 
 +
 
 +
=====Substantive savings=====
 +
 
 +
If there are [[Editorial_Principles#Substantive_savings|substantive savings]] that mean that text should not be removed, you should carry out a [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Retained_text_repeal_.28text_retained_with_square_brackets.29|retained text repeal]], for example:
 +
 
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|<strong>Example 1:</strong> https://www.legislation.gov.uk/ukpga/2002/21/part/1
 +
 
 +
|-
 +
|[[File:High_Level_Repeals_4.png|900px]]
 +
|}
 +
 
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|<strong>Example 2:</strong> https://www.legislation.gov.uk/ukpga/1972/68/introduction/2020-01-31 (whole Act retained text repeal that is subject to temporary savings):
 +
 
 +
|-
 +
|[[File:High_Level_Repeals_5.png|900px]]
 +
|}
 +
 
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|<strong>Example 3:</strong> https://www.legislation.gov.uk/uksi/2013/1119 (retained text whole Order, note position of closing square bracket for the retained text repeal when the whole document is opened - at the end of Sch. 9 and before the Explanatory Note):
 +
 
 +
|-
 +
|[[File:High_Level_Repeals_6.png|900px]]
 +
|}
 +
 
 +
=====Common form savings=====
 +
 
 +
Where there is a repeal with a [[Editorial_Principles#Common_Form_savings_.28and_other_qualifiers.29|common form saving]], you should remove the text. If further amendments come along later, we can apply these as appended commentary to the repeal annotation for later amendments to saved provisions.
 +
 
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|<strong>Example 1:</strong> http://www.legislation.gov.uk/ssi/2007/577/introduction
 +
 
 +
|-
 +
|[[File:High_Level_Repeals_7.png|750px]]
 +
|}
 +
 
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|<strong>Example 2:</strong> https://www.legislation.gov.uk/nisr/2020/55
 +
 
 +
|-
 +
|[[File:High_Level_Repeals_8.png|750px]]
 +
|}
 +
 
 +
===Whole repeals that are not wholly in force===
 +
 
 +
====Scenarios where a whole repeal is brought into force incrementally over time====
 +
 
 +
A repeal may not be wholly in force straight away but instead may be brought into force incrementally over time.  It may be brought into force incrementally in one of three ways, or in a combination of all three:
 +
 
 +
<strong>Case 1.</strong> It may be brought into force for some, but not all, of its purposes.
 +
 
 +
<strong>Case 2.</strong> It may be brought into force for a part, but not all, of its extent or territorial application.
 +
 
 +
<strong>Case 3.</strong> It may be brought into force for some, but not all, of the provisions it affects.
 +
 
 +
As the repeal is brought further into force our aim should be to ensure that the F-note telling the story of its coming into force is accurate and that relevant child provisions are dealt with appropriately at each stage.
 +
 
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|<strong>Approach in each case the first time the repeal is partially brought into force</strong>
 +
 
 +
<u><i>Case 1 - Specified purposes:</u></i> If the repeal is commenced only for specified purposes, leave the text intact and insert an F-note at top level. The F-note will only be visible at the top level and not in individual child provisions.
 +
 
 +
But, where the repeal has been commenced for specified purposes in relation only to specified individual provisions, then (in addition to the top level F-note) we should perform retained text repeals of those individual child provisions as well and these should share the same F-note as the top level.
 +
 
 +
<u><i>Case 2 - Partial extent (or territorial application):</u></i> If the repeal is commenced only for a part of its extent (or territorial application), carry out a retained text repeal of words in the heading and cut and paste the closing bracket to the end of the item of legislation or Chapter/Part/Schedule, so that the whole text of the item of legislation or Chapter/Part/Schedule is retained with square brackets around it. The F-note reference will be situated at the beginning of the heading and a derived annotation will be viewable in individual child provisions.
 +
 
 +
(Please see the [[Editorial Update/Textual Amendments/Repeals/Higher Level Repeals#tna-HLRWarning|Warning]] below re high level retained text repeals).
 +
 
 +
However, where the repeal has been commenced for a limited extent/TA only in relation to specified individual provisions, then those specified provisions should be retained text repealed and an F-note should be inserted at the top level.
 +
 
 +
You will also need to consider more [[Editorial_Update/Limited_Extent_Amendments#Is_your_amendment_a_limited_extent_repeal_of_a_higher_level_provision_.28e.g._a_heading_and_range_of_provisions.2C_or_a_Chapter.2C_Part_or_Schedule_or_whole_document.29.3F|complex scenarios where there are existing limited amendments in the child provisions and tailor your approach appropriately]].
 +
 
 +
<u><i>Case 3 - Specified provisions:</u></i> If the repeal is commenced only for specified provisions, an F-note for the repeal should be inserted at top level and each specified provision should also be repealed in the usual way resulting in a dotty line (either individually or using the batch repeal functionality). The individually repealed provisions should share the same F-note as the top level.
 +
|}
 +
 
 +
=====Subsequent approach as repeal comes further into force=====
 +
 
 +
Thereafter, as the repeal comes further into force, the top level F-note should be checked (and corrected if necessary) and action taken at individual child provision level as appropriate. 
 +
 
 +
When the repeal is finally brought wholly into force it may be appropriate at that stage to dotty line the whole text.  If the auto repeal button or batch repeal page is not available at that stage, then you can use the workaround described [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Workaround_where_auto_repeal_function_is_not_available|below]]. If this workaround doesn't work, a story should be raised with TSO to help out.
 +
 
 +
Once the auto-repeal has been carried out you may need to remove the brackets of previous retained text repeals performed at both heading and child levels, as these won’t be removed automatically by the auto-repeal process.
 +
 
 +
At the final Point in Time, when the repeal is wholly in force, the higher level provision should look as though it has been wholly repealed: there should be no opening or closing brackets left and the text should have been removed and dotty-lined.
 +
<div id="tna-HLRWarning"></div>
 +
{|class="wikitable" style="border-left:solid 2px red;border-right:solid 2px red;border-top:solid 2px red;border-bottom:solid 2px red; background-color:#e6f2ff;
 +
|-
 +
|<strong>WARNING:</strong> When a higher level retained text repeal is brought into force in so far as not already in force, <strong>do not</strong> change the attributes for the retained text repeal from =true to =false as this will wipe out structural xml tagging as well as text and make the document incoherent. You need instead to carry out an auto-repeal or batch repeal to dotty line the text and check that the F-note accurately reflects the story of the repeal from start to finish.
 +
|}
 +
 
 +
This guidance outlines the most common way to approach these types of repeals. There may be variations that mean that a more tailored approach may be necessary. If you are not sure of the approach to use, consult a <strong>Review Editor</strong>.
 +
 
 +
<div id="tna-Example1"></div>
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|<strong>Example 1:</strong> Incremental repeal of 1965 c. 64, which is repealed for specified provisions and extents beginning on 1/10/2006:
 +
 
 +
 
 +
https://www.legislation.gov.uk/ukpga/1965/64/2014-12-15
 +
 
 +
|-
 +
|[[File:High_Level_Repeals_9.png|750px]]
 +
 
 +
 
 +
<strong>Note:</strong> The F-note reference is at the beginning of the enacting text. The text of all provisions that are not affected by the repeal is untouched.
 +
 
 +
 
 +
To look more closely at what happens to one of the affected provisions, see s.8 (which is repealed on1/10/2006 for E. by Commencement Order S.I. 2006/2504). The text of the affected provision is retained with square brackets around the retained text:
 +
 
 +
 
 +
https://www.legislation.gov.uk/ukpga/1965/64/section/8/2006-10-01
 +
 
 +
 
 +
Then on 1/10/2008, s. 8 is also repealed for W. by Commencement Order S.I. 2007/2386, bringing the repeal fully into force for the whole extent. The text of the affected provision is removed and dotty-lined:
 +
 
 +
 
 +
https://www.legislation.gov.uk/ukpga/1965/64/section/8/2008-10-01
 +
|}
 +
<div id="tna-Example1"></div>
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|
 +
 
 +
<strong>Example 2:</strong> Incremental repeal of S.I. 2020/353, beginning on 11.7.2020 (Regulations revoked for the revocation of reg. 5 for all purposes and regs. 4(4)-(6), 7A, 10-14 for specified purposes):
 +
 
 +
 
 +
http://www.legislation.gov.uk/wsi/2020/353/introduction/2020-07-11
 +
 
 +
 
 +
To look more closely at what happens to one of the affected provisions see reg. 4. Regs. 4(4)-(6), 7A are retained with square brackets and the top level annotation is carried through to the provision:
 +
 
 +
 
 +
https://www.legislation.gov.uk/wsi/2020/353/regulation/4/2020-07-11
 +
 
 +
 
 +
At the next PiT (13/7/2020), the Regulations are fully revoked:
 +
 
 +
 
 +
https://www.legislation.gov.uk/wsi/2020/353/introduction/2020-07-13
 +
https://www.legislation.gov.uk/wsi/2020/353/regulation/4/2020-07-13
 +
 
 +
 
 +
<strong>Note:</strong> The top level F-note reference is now located at the end of the title and the text of all provisions has been revoked and replaced with a dotty line. The annotation text has been amended to include the date of the whole revocation and the words ‘in so far as not already in force’.
 +
|}
 +
<div id="tna-Example1"></div>
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|
 +
<strong>Example 3:</strong> 1965 c. 4, Sch. 3 was omitted for specified purposes ("except to the extent it applies to either or both of the Medical Research Council or the Science and Technology Facilities Council") on 31.10.2018, as brought into force by SI 2018/1054, reg. 2(d)(ii). When the effect was applied, the in force date qualification was changed from "specified purposes" to the following, to make it clearer to the end user:
 +
 
 +
 
 +
Sch. 3 omitted (31.10.2018 <span style = "color:red;">except to the extent it applies to either or both of the Medical Research Council or the Science and Technology Facilities Council</span>) by virtue of Higher Education and Research Act 2017 (c. 29), s. 124(5), Sch. 12 para. 4(5); S.I. 2018/1054, reg. 2(d)(ii)
 +
 
 +
 
 +
https://www.legislation.gov.uk/ukpga/1965/4/schedule/3
 +
 
 +
|}
 +
 
 +
===Partial repeals that are wholly in force===
 +
 
 +
====<u>Ceases to have effect</u>====
 +
 
 +
<strong>Approach:</strong> Carry out retained text repeal with square brackets (if you can), F-note at top level.
 +
 
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|Example: https://www.legislation.gov.uk/ssi/2016/346/2020-04-07
 +
 
 +
|-
 +
|[[File:High_Level_Repeals_10.png|750px]]
 +
|}
 +
 
 +
<strong>Note:</strong> all ‘ceases to have effect’ repeals need to be carried out with retained text in square brackets, whether temporary or not. Also note wording ‘by virtue of’ in annotation.
 +
 
 +
====<u>“Repealed for specified purposes” or “repealed in part”</u>====
 +
 
 +
This is where the drafter has specified a higher level provision (e.g. Act or Part) or range of provisions as repealed or revoked but then qualified this in some way, as explained in more detail on the Record Effects page: [[Preparation_Tasks/Record_Effects#Qualifications_of_the_type_of_effect_.E2.80.93_.E2.80.9C.28except_for_.5Bspecified_provisions.5D.29.E2.80.9D_or_.E2.80.9Cin_part.E2.80.9D.2F.E2.80.9Cfor_specified_purposes.E2.80.9D|Qualifications of the type of effect – “(except for [specified provisions])” or “in part”/“for specified purposes”]] (not where the repeal is only in force for specified purposes, which is dealt with in the [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Whole_repeals_that_are_not_wholly_in_force|Whole repeals that are not wholly in force]] section above).
 +
 
 +
<strong>Approach:</strong> Carry out retained text repeal with square brackets (if you can), F-note at top level
 +
 
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|<strong>Example 1:</strong> Regulations ‘revoked in part’
 +
 
 +
 
 +
https://www.legislation.gov.uk/uksi/2005/18/2007-10-19
 +
 
 +
 
 +
<strong>Note:</strong> In this example, ‘revoked in part’ was changed to ‘revoked (except in their application to the profession of company auditor)’, to make it clearer to the end user.
 +
 
 +
|-
 +
|[[File:High_Level_Repeals_12.png]]
 +
|}
 +
 
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|<strong>Example 2:</strong> Regulations ‘revoked in part’ https://www.legislation.gov.uk/uksi/2005/1971/introduction
 +
|}
 +
 
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|<strong>Example 3:</strong> Schedule ‘revoked in part’ where the relevant part of the Schedule was fully revoked
 +
 
 +
See the affecting provision SI 2012/3118, Sch. 3, which revokes SI 2010/2214, reg. 54(1) and Sch. 5 "insofar as they relate to the Energy Performance of Buildings (Certificates and Inspections) (England and Wales) Regulations 2007":
 +
 
 +
https://www.legislation.gov.uk/uksi/2012/3118/schedule/3/made
 +
 
 +
The part of Sch. 5 relating to the Energy Performance of Buildings (Certificates and Inspections) (England and Wales) Regulations 2007 was fully revoked:
 +
 
 +
https://www.legislation.gov.uk/uksi/2010/2214/schedule/5/2013-01-09 
 +
|}
 +
 
 +
<strong>Note:</strong> sometimes ‘revoked in part’ (or ‘repealed in part’) may have been recorded as the type of effect when certain provisions only have been revoked/repealed and it would be more appropriate to use the type of effect ‘revoked (except for…)’ (or ‘repealed (except for…)’) (see below). If you think the type of effect may need to be amended consult a <strong>Review Editor</strong>.
 +
 
 +
====<u>“repealed (except for&#8230;)”</u>====
 +
 
 +
<strong>Approach:</strong> Repeal the provisions that are fully repealed and leave the text intact for excepted provisions (with square brackets where appropriate i.e. where text is left intact for specified purposes or extent, otherwise leave excepted provisions untouched), insert the F-note for the repeal at top level.
 +
 
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|<strong>Example 1:</strong> https://www.legislation.gov.uk/nisr/2013/71/2015-04-01
 +
 
 +
|-
 +
|[[File:High_Level_Repeals_13.png|750px]]
 +
 
 +
 
 +
In this example, the excepted provision (reg. 28) is excepted for specified purposes only, so the text has been retained with square brackets around it https://www.legislation.gov.uk/nisr/2013/71/regulation/28/2015-04-01
 +
|}
 +
 
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|<strong>Example 2:</strong> https://www.legislation.gov.uk/nisr/2013/207/2015-07-01
 +
 
 +
 
 +
In this example, the text of reg. 9(2) has been retained (no brackets required as the text is fully retained) https://www.legislation.gov.uk/nisr/2013/207/regulation/9/2015-07-01
 +
|}
 +
 
 +
{|class=wikitable style="width: 95%;"
 +
|-
 +
|<strong>Example 3:</strong> https://www.legislation.gov.uk/uksi/2002/501/2010-04-01
 +
|}
 +
 
 +
====<u>Limited extent or territorial application</u>====
 +
 
 +
<strong>Approach:</strong> Carry out [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Retained_text_repeal_.28text_retained_with_square_brackets.29|retained text repeal with square brackets]] (if you can), F-note at top level, using the limited extent repeal option in XMetaL:
 +
 
 +
https://www.legislation.gov.uk/uksi/2020/91/introduction/2024-01-01
 +
 
 +
https://www.legislation.gov.uk/uksi/1992/548/schedule/1/part/IV/2003-04-01
 +
 
 +
If it is impractical to carry out a retained text repeal in this manner (for example if the checked out fragment is too large), then you will have to just insert an F-note repeal annotation instead, making sure that the annotation contains an indication of its limited extent/TA.
 +
 
 +
You will also need to consider more [[Editorial_Update/Limited_Extent_Amendments#Is_your_amendment_a_limited_extent_repeal_of_a_higher_level_provision_.28e.g._a_heading_and_range_of_provisions.2C_or_a_Chapter.2C_Part_or_Schedule_or_whole_document.29.3F|complex scenarios where there are existing limited amendments in the child provisions and tailor your approach appropriately]].
 +
 
 +
More examples of limited extent repeals can be found in the [[Editorial_Update/Limited_Extent_Amendments|limited extent amendments]] pages.
 +
 
 +
===Partial repeals that are not wholly in force===
 +
 
 +
* partial repeal commenced for specified purposes
 +
* partial repeal commenced for limited extent/territorial application
 +
* partial repeal commenced for specified provisions
 +
 
 +
Where the commencement of a partial repeal is incremental, the annotation for the repeal should be updated as the repeal is commenced further. You will need to check the auto annotation to make sure it reflects the story so far, and dotty line or add retain text brackets as appropriate.
 +
 
 +
<!--Examples needed-->
 +
 
 +
===Incremental repeals===
 +
 
 +
The term “incremental repeal” is used to describe a repeal that takes place in stages, it may be a whole repeal that is commenced incrementally over time, or a partial repeal that is wholly in force or also commenced over time, as follows:
 +
 
 +
<strong>[[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Whole_repeals_-_Not_wholly_in_force|Whole repeals - not wholly in force]]</strong>
 +
 
 +
A whole repeal may not be wholly in force straight away, but instead may be brought into force incrementally over time. It may be brought into force incrementally in one of three ways, or in a combination of all three:
 +
 
 +
* it may be brought into force for some, but not all, of its purposes.
 +
 
 +
* it may be brought into force for a part, but not all, of its extent or territorial application.
 +
 
 +
* it may be brought into force for some, but not all, of the provisions it affects.
 +
 
 +
As the repeal is brought further into force our aim should be to ensure that the F-note telling the story of its coming into force is accurate and that relevant child provisions are dealt with appropriately at each stage.
 +
 
 +
See further detail: 
 +
 
 +
[[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Scenarios_where_a_whole_repeal_is_brought_into_force_incrementally_over_time|Scenarios where a repeal is brought into force incrementally over time]]
 +
 
 +
[[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Subsequent_approach_as_repeal_comes_further_into_force|Subsequent approach as repeal comes further into force]]
 +
 
 +
<strong>[[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Partial_repeals_-_Wholly_in_force|Partial repeals - wholly in force]]</strong>
 +
 
 +
A repeal may be wholly in force but only only be partial, i.e. repealed for a limited extent, for specified purposes, repealed in part (or "except for" certain provisions), or “ceases to have effect”, the repeal of that high level may subsequently be made for further jurisdictions, purposes or provisions, which may eventually lead to the whole repeal of that high level; this is another form of incremental repeal.
 +
 
 +
The Limited Extent page explains how to  [[Editorial_Update/Limited_Extent_Amendments#Updating_an_existing_limited_extent_amendment_when_an_identical_amendment_is_applied_for_another_jurisdiction|update an existing limited extent amendment when an identical amendment is applied for another jurisdiction]], which includes advice on [[Editorial_Update/Limited_Extent_Amendments#Amendment_now_fully_extends_to_all_jurisdictions|what to do when the amendment now fully extends to all jurisdictions]]. The principles are similar for other types of partial repeal, whereby the details for the subsequent repeal(s) will be merged into one annotation and any relevant child provisions dealt with as appropriate. 
 +
 
 +
<strong>[[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Partial_repeals_-_Not_wholly_in_force|Partial repeals - not wholly in force]]</strong>
 +
 
 +
Partial repeals may also be brought into force incrementally over time. Where the commencement of a partial repeal is incremental, the annotation for the repeal will be updated as the repeal is commenced further. Editors should check the auto annotation to make sure it reflects the story so far, and dotty line or add retain text brackets as appropriate.
 +
 
 +
 
 +
====What happens when an incremental repeal leads to the whole revocation of a document====
 +
 
 +
If a whole document has been revoked incrementally, and the latest stage in that incremental revocation means that the whole document is revoked, editors need to make sure that the title of the document is amended to include “(revoked)” at the end of it, which should then automatically be reflected in the dc:title at the top of the document:
 +
 
 +
 
 +
[[File:High_Level_Repeals_2.png|900px]]
 +
 
 +
<!--====An example of a repeal of a whole Part brought into force incrementally====
 +
This is an example of the repeal of 1968 c. 34, Pt. 1 which is a very complicated example involving limited extent repeals as well as incremental commencement.  It is worth paying it some attention.
 +
 
 +
Pt. 1 (which extends to EWS and is comprised of ss. 1-8) is repealed in a very complicated fashion.
 +
 
 +
See TOES data here:
 +
https://editorial.legislation.gov.uk/changes/affected/ukpga/1968/34/data.xls?extended=full-with-co
 +
 
 +
<ol><li>
 +
Pt. 1 repealed for S only with exceptions:
 +
<br>
 +
<br>
 +
Pt. 01 repealed (except ss. 4, 5 and s. 8(1)(3) for specified purposes) for S only by 2006 asp011, Sch. 02 para. 008(01) (with s. 0054). Commenced by 2006 SSI0482, art. 002 (with art. 004(02)(03)) on 06/10/2006 (wholly in force).
 +
<br><br>
 +
<strong>Note:</strong> At the time this amendment was carried out, the retained text batch repeal functionality was not available so this was done as limited extent repeals individually in each of ss. 1-3, 6, 7, 8 as Pt. 1 was only repealed in part.
 +
<br>
 +
<br>
 +
Pt. 1 was checked out and limited extent repeals carried out in each provision.  The annotation was amended to add “(except ss. 4, 5 and s. 8(1)(3) for specified purposes)” which should have been imported from the type of effect in TOES, but wasn’t (issue was raised with TSO about this).  The first repeal tag was moved to just before the provision number (although needed to be moved back again before un-retaining the text later on).
 +
<br>
 +
<br>
 +
[[File:Commencing_amendments_6.png|1000 px]]
 +
<br>
 +
<br>
 +
See how it looks here:
 +
http://www.legislation.gov.uk/ukpga/1968/34/part/I/2006-10-06?timeline=true</li>
 +
 
 +
<li>
 +
Pt. 1 then repealed for EW but brought into force for W only with exceptions:
 +
<br><br>
 +
Pt. 01 repealed for E+W by 2006 c. 045, Sch. 04 (with s. 0001(02) 58(01) 59 60). Commenced by 2007 WSI1030, art. 002(01)(m) on 27/03/2007 (Other - for W. except for the repeals of ss. 2, 3, 6, 7, 8)
 +
<br>
 +
<br>
 +
Again Pt. 1 was checked out and provisions amended individually as follows:
 +
# insert an F-note annotation in s. 1 (otherwise we’d end up with two sets of brackets which looks messy)
 +
# do limited extent repeals in each of ss. 4, 5
 +
 
 +
See how it looks here:
 +
http://www.legislation.gov.uk/ukpga/1968/34/part/I/2007-03-27?timeline=true</li>
 +
<li>
 +
Then Pt. 1 repealed with the same exceptions for E only:
 +
2007 SI0499, art. 002(02)(m) on 06/04/2007 (Other - for E. except for the repeals of ss. 2, 3, 6, 7, 8).
 +
<br>
 +
<br>
 +
Just because this PiT says “Auto annotations” and allows us to go immediately to the <strong>Next Step</strong> if we choose to, it doesn’t mean there is nothing for us to do in this PiT.  The note next to the auto annotation effect is warning us: “This effect has been brought further into force in this point in time. Please check that the new commencement details have been added correctly to the existing annotation.”  And in fact there’s more to do than just check the annotation:
 +
<br>
 +
<br>
 +
We can get rid of the text of s. 1.  by changing the <strong>retain text= true</strong> attribute in the S limited extent repeal tags to <strong>retain text = false</strong>.  Before this the opening repeal tag needed to be moved to just before the first sub-provision number (i.e. where it was first positioned when we did the limited extent repeal before it was moved in front of the provision number).  The other inserted F-note commentary was left where it was.
 +
<br>
 +
<br>
 +
An auto annotation was also inserted in the Pt. 1 heading: this auto annotation is not needed as we already have the annotations in ss. 1, 4, 5, so it can be deleted.
 +
<br><br>
 +
[[File:Commencing_amendments_7.png|1000 px]]
 +
<br>
 +
<br>
 +
[[File:Commencing_amendments_8.png|1000 px]]
 +
<br>
 +
<br>
 +
[[File:Commencing_amendments_9.png|1000 px]]
 +
<br>
 +
<br>
 +
[[File:Commencing_amendments_10.png|1000 px]]
 +
<br>
 +
<br>
 +
The F-note for the EW repeal of s. 1 and for ss. 4, 5 should have changed automatically, but the annotation contained repetition, so was changed from “(27.3.2007 for W. except for the repeals of ss. 2, 3, 6, 7, 8, 6.4.2007 for E. except for the repeals of ss. 2, 3, 6, 7, 8)” to “(27.3.2007 for W. and 6.4.2007 for E. except for the repeals of ss. 2, 3, 6, 7, 8)”.
 +
<br>
 +
So, at this point ss. 2, 3, 6, 7, 8 remain in force for EW and ss. 4, 5 and 8(1)(3) (for spec purps) are in force for S.
 +
<br>
 +
<br>
 +
See how it looks here:
 +
http://www.legislation.gov.uk/ukpga/1968/34/part/I/2007-04-06?timeline=true</li>
 +
 
 +
<li>
 +
Then the excepted provs were wiped out for E:
 +
2007 SI2711, art. 002(b)(i) art. 003 on 01/10/2007 (Other - for E. in so far as not already in force).
 +
<br>
 +
<br>
 +
So it is necessary to go into ss. 2, 3, 6, 7, 8 and insert an F-note annotation.  Again, we wouldn't want to do limited extent repeals for these as we would end up with two sets of brackets.
 +
<br>
 +
<br>
 +
An auto annotation had again been added at Pt. 1 heading level, but this time rather than deleting, it was cut and pasted into s. 2 and then copied and pasted into ss. 3, 6, 7, 8,  Each time putting it before the existing limited extent repeal tagging.
 +
<br>
 +
<br>
 +
And the annotation wording was again amended to avoid that repetition.<br>
 +
See how it looks here:
 +
http://www.legislation.gov.uk/ukpga/1968/34/part/I/2007-10-01?timeline=true</li>
 +
<li>
 +
Then the excepted provs are wiped out for W:
 +
<br><br>
 +
2007 WSI3065 art. 002(b)(i) art. 003 on 24/10/2007 (Other - for W. in so far as not already in force).
 +
<br>
 +
<br>
 +
In ss. 2, 3, 6, 7 the text was removed by changing the original S limited extent repeal tags to retain text=false.  The limited extent repeal tag had to be moved back to its original position in front of the first sub-provision number.  The EW repeal commentary was automatically changed.
 +
<br>
 +
<br>
 +
[[File:Commencing_amendments_11.png|1000 px]]
 +
<br>
 +
<br>
 +
In s. 8 which is still partially in force for S, dotty lines were placed in s. 8(2)(4)(5) and s. 8(1)(3) was left intact.  To do this, the dotty lines in of s. 1 were copied and pasted into the relevant sub-provisions of s. 8, being careful not to delete the closing limited extent repeal tag at the end of s. 8(5).
 +
<br><br>
 +
[[File:Commencing_amendments_12.png|1000 px]]
 +
<br>
 +
<br>
 +
<ukl:Text>. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .</ukl:Text>
 +
<br>
 +
<br>
 +
Again, an auto annotation was added at Pt. 1 heading level, but was not need so it was deleted.
 +
<br>
 +
<br>
 +
So in the end ss. 4, 5 were left in force for S only and s. 8(1)(3) in force for S for spec purps and everything else had been wholly repealed:
 +
<br><br>
 +
[[File:Commencing_amendments_13.png|1000 px]]
 +
<br>
 +
<br>
 +
See how it looks here:
 +
http://www.legislation.gov.uk/ukpga/1968/34/part/I/2007-10-24?timeline=true&view=extent
 +
<br>
 +
<br>
 +
<strong>Note:</strong> the first repeal effect was originally entered in TOES as “repealed in part,” which was not very useful, so had to be changed in the TOES data before update began.  If you find the type of effect “repealed in part” in your update task, please refer it to a <strong>Review Editor</strong> or to Richard as the TOES data may need correcting.-->
 +
 
 +
===Cross-headings===
 +
 
 +
If your update task involves the repeal of a cross-heading itself, this will be carried out from the High Level Update Details page. Check out the cross-heading from the High Level Table of Contents and carry out a repeal of words of the cross-heading text. For example, to repeal the cross-heading "Interest and royalty payments" you would select the "Check out for edit" button next to this cross-heading in the Table of Contents:
 +
<br>
 +
<br>
 +
[[File:batch_repeal_cross_heading_7.png|900px]]
 +
<br>
 +
<br>
 +
Next, you need to carry out a [[Editorial_Update/Textual_Amendments/Repeals/Provision_Level_Repeals#Carrying_out_a_repeal_of_words_in_XMetaL|repeal of words]] on the text within the cross-heading <code>ukl:title</code> tags in XMetaL:
 +
<br>
 +
<br>
 +
[[File:batch_repeal_cross_heading_8.png|900px]]
 +
<br>
 +
<br>
 +
The repealed cross-heading should like like this when you preview it on the website:
 +
[[File:cross-heading_repeal_6.png|900px]]
 +
<br>
 +
<br>
 +
 
 +
====Repealing a range of provisions underneath a cross-heading====
 +
If your update task involves repealing a cross-heading and the provision (or range of provisions) that comes after it, once you have carried out the repeal of words in the cross-heading <code>ukl:title</code> tags, you can repeal the provision (or range of provisions) individually using the usual method for [[Editorial_Update/Textual_Amendments/Repeals/Provision_Level_Repeals#Carrying_out_the_repeal_of_a_provision_or_sub-provision_in_XMetaL|repealing a provision]] (highlighting the same task in the Task Manager each time). You can also use the batch repeal function to repeal the range of provisions, but please read the Warning and guidance that follows this first:
 +
 
 +
{|class="wikitable" style="border-left:solid 2px red;border-right:solid 2px red;border-top:solid 2px red;border-bottom:solid 2px red; background-color:#e6f2ff;
 +
|-
 +
|<strong>WARNING:</strong>The batch repeal function does not currently work correctly at cross-heading level, therefore do not select any cross-headings as part of a batch-repeal. (If you did include the cross-heading in the batch repeal, this would result in a single dotty line after the cross-heading, which is incorrect because the repealed provisions should also be visible, see example [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#tna-websiteview|below]])
 +
|}
 +
 
 +
If you do want to use the [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Batch_Repeal_Function|batch repeal function]] to repeal the range of provisions that come after the cross-heading, make sure that you select all but one of the provisions that fall under the cross-heading (if you select all the provisions under the cross-heading, the cross-heading box is automatically selected and you should avoid this happening for the reason described in the Warning above).
 +
<br>
 +
<br>
 +
[[File:Batch_repeal_cross_heading_2.png|750px]]
 +
<br>
 +
<br>
 +
Once you have carried out the batch repeal on this range of provisions, you should then amend the contents of the remaining provision manually, by checking out the cross-heading (which will also include the range of provisions) from the High Level Table of Contents and copying a dotted line from one of the newly repealed provisions and pasting it into the remaining provision (adjusting the tagging within the <code>ukl:P1para</code> of the remaining provision as appropriate and also inserting the F-note reference), for example:
 +
<br>
 +
<br>
 +
[[File:Batch_repeal_cross_heading_6.png|750px]]
 +
<br>
 +
<br>
 +
<div id="tna-websiteview"></div>
 +
You should end up with the repealed cross-heading and provisions looking like this when you preview the parent level (i.e. the cross-heading) on the website:
 +
<br>
 +
<br>
 +
https://www.legislation.gov.uk/ukpga/2005/5/part/6/chapter/9/crossheading/interest-and-royalty-payments
 +
<br>
 +
<br>
 +
[[File:Batch_repeal_cross_heading_5.png|750px]]
 +
<br>
 +
<br>
 +
Example at child provision level: https://www.legislation.gov.uk/ukpga/2005/5/section/757 (note that the section number and heading are still present).
 +
<br>
 +
<br>
 +
 
 +
<strong>Note:</strong> Where a range of provisions is being repealed, it is not our practice to repeal any cross-headings <strong>unless</strong> there is an explicit instruction from the drafter to do so.
 +
 
 +
==EDITORIAL PROCESSES==
 +
 
 +
===Auto Repeal function===
 +
 
 +
{|class="wikitable" style="border-left:solid 2px red;border-right:solid 2px red;border-top:solid 2px red;border-bottom:solid 2px red; background-color:#e6f2ff;
 +
|-
 +
|Before you carry out an auto repeal, make sure you have read the sections [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Before_you_carry_out_a_higher_level_repeal | Before you carry out a higher level repeal]] and [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Whole_repeals_-_Wholly_in_force | Editorial Approach: Whole repeals - Wholly in force]].
 +
|}
 +
 
 +
The instructions in this section should only be followed if the repeal in your current <strong>PiT</strong> is:
 +
 
 +
* for the whole Chapter, Part, Schedule or item of legislation;
 +
* for the whole extent;
 +
* wholly in force; and
 +
* there are no substantive savings that would mean that text should be retained.
 +
 
 +
1. On the High Level <strong>Update Details</strong> page, for:
 +
 
 +
* A <strong>whole item of legislation</strong>: click on the <strong>Auto Repeal</strong> button at the top of the <strong>ToC</strong> on this page.
 +
* A <strong>Part, Chapter or Schedule</strong>: scroll down the <strong>ToC</strong> to find the Part, Chapter, Schedule or relevant Heading level to be repealed and select the Auto Repeal button next to the heading of that Part, Chapter or Schedule.
 +
 
 +
<strong>Note:</strong> If there is no Auto Repeal button displayed next to the provision you need to repeal, you can use the  [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Batch_Repeal_Function | Batch Repeal Function]] to carry out the repeal.
 +
 
 +
2. In the pop-up box ‘Are you sure you want to apply auto repeals’ click OK; the system will automatically carry out the repeal and refresh the <strong>Update Details</strong> page (if the Update Details page doesn’t automatically refresh, it can be refreshed by pressing F5).
 +
 
 +
3. Once the auto repeal has been carried out, you will need to check and, if necessary,  [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Errors_in_the_automatically_generated_annotation | amend the automatically generated annotation]].
 +
 
 +
4. Once you have checked the automatically generated annotation, select the <strong>Preview Legislation</strong> button and double check:
 +
 
 +
*You’re satisfied that the amendment has formatted correctly and that the annotation is correctly positioned;
 +
*The annotation reference and the text of the annotation are correct (check annotation details such as type of effect, punctuation, date, savings (where applicable), commencement order (where applicable)).See more detail on annotations in [[Editorial_Update/Annotation_Conventions|Annotation Conventions]];
 +
*The right PiT has been created at the whole item of legislation level and also any parent and child levels;
 +
*You can move between the PiTs on the timeline correctly.
 +
 
 +
For examples of what the amendment and annotation should look like, see [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Location_of_F-note_reference.2C_annotation_and_dotty_lines| Location of F-note reference, annotation and dotty lines]]. Also check the other  [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Things_to_look_out_for|Things to look out for]].
 +
 
 +
5. Once you are satisfied that the amendment is correct, check that the amendment edit status is set to Edit Complete. You can also add any notes for the Review Editor by clicking on the note icon to the right of the edit status. You may need to add a note if there was anything unusual about the amendment that you need to draw to the attention of the Review Editor.
 +
 
 +
5. You can now navigate to the next part of your update task.
 +
 
 +
===Workaround where auto repeal function is not available===
 +
 
 +
If there is no [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Auto_Repeal_function|auto repeal]] button displayed by the high level provision that you need to wholly repeal (and the [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Batch_Repeal_Function|batch repeal function]] is also unavailable), you can use the following workaround to carry out the repeal:
 +
 
 +
1. Check out at parent level (the level being repealed) and insert the repeal F-note at heading level and make sure that heading level has these attributes:
 +
 
 +
Match = true
 +
Status = repealed
 +
Restrict start date = [PiT date that you’re working on]
 +
 
 +
(NB parent heading title should not be dotty lined)
 +
 
 +
2. Manually repeal all children with same task. In fact, after doing the first child you can copy and paste the whole <code>P1para</code> (including F-note and dotty lined text tag) for the remainder.
 +
 
 +
(NB This is the correct number of dots for block repeal: “. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .”)
 +
 
 +
You don’t need to repeal cross-headings.
 +
 
 +
3. Ensure all children (and also any cross-headings, which don’t need to be dotty lined) have the following attributes when you place cursor in <code>P1group</code> or <code>P1</code> (depending on whether you’re in main body or schedule):
 +
 
 +
Match = false
 +
Status = repealed
 +
Restrict start date = [PiT date that you’re working on]
 +
 
 +
4. Check in.
 +
 
 +
If this workaround does not work, we should raise a call with TSO to help.
 +
 
 +
See more on amending attributes [[Editorial_Update/XMetaL_and_XML_tagging#Attribute_Inspector|here]].
 +
 
 +
===Repeals where text is not removed===
 +
 
 +
====<u>Insertion of repeal annotation</u>====
 +
 
 +
If you need to insert an F-note at the top level for a high level repeal where text is being retained but you are not [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Retained_text_repeal_.28text_retained_with_square_brackets.29|performing a retained text repeal that will automatically insert an F-note]] (you can see examples of this type of repeal in [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#tna-Example1|Whole repeals - Not wholly in force]] and [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#“repealed (except for…)”|Partial repeals - Wholly in force]]), follow these instructions: 
 +
 
 +
1. This amendment will be carried out in XMetaL: you will have [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Selecting_the_relevant_provision_to_check_out|checked out the introductory or top level provision]] containing the relevant title tagging from the High Level <strong>Update Details</strong> page and have set up your [[Editorial_Update/Starting_Update_Tasks#Setting_up_your_XMetaL_workspace|XMetaL workspace]].
 +
 
 +
2. Your next action will depend on whether the repeal is for a whole item of primary or secondary legislation, or if it is for a whole Part, Schedule or chapter:
 +
 
 +
<strong>Whole item of primary legislation:</strong> In the amended provision, place the cursor immediately after the opening <code>ukl:LongTitle</code> tag at the top of the document.
 +
 
 +
<strong>Whole item of secondary legislation:</strong> In the amended provision, place the cursor immediately after the opening <code>ukl:EnactingText</code> tag in the Secondary Prelims at the top of the document.
 +
 
 +
<strong>Part, Chapter or Schedule:</strong> In the amended provision, place the cursor immediately after the <code>ukl:Number</code> at Part, Chapter or Schedule level (this is at the top of the document after the <code>ukl:Part</code>/<code>ukl:Chapter</code>/<code>ukl:Schedule</code> opening tag) but before the number of the Part, Chapter or Schedule.
 +
 
 +
3. Single click on the task to highlight it in the <strong>Resource Manager</strong> window.
 +
 
 +
4. On the toolbar at the top of the page click on <strong>Legislation - Non-Textual Amendments - Insert Commentary</strong>; this will
 +
 
 +
* insert a <code>ukl:CommentaryRef</code> tag and unique task number after the Part, Chapter or Schedule's opening <code>ukl:Number</code> tag, or for a whole item of legislation, in primary legislation after the opening <code>ukl:Longtitle</code> tag or in secondary legislation after the opening <code>ukl:EnactingText</code> tag;
 +
* insert the annotation for the task; and
 +
* generate a green tick next to the task in the <strong>Resource Manager</strong> window.
 +
 
 +
5. Now carry out your [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#tna-HLREditorialchecks|Editorial Checks]].
 +
 
 +
<strong>Note:</strong> You should scroll back up to the top of the Part, Chapter, Schedule or whole item of legislation to check the <code>ukl:CommentaryRef</code> tag has been correctly inserted.
 +
 
 +
====<u>Retained text repeal (text retained with square brackets)</u>====
 +
 
 +
=====Method to use in simple scenarios=====
 +
 
 +
To carry out a whole document, whole Part, whole Chapter, or whole Schedule retained text repeal, you need to [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Selecting_the_relevant_provision_to_check_out|check the relevant high level provision out in XMetaL]] and carry out a <strong>retained text repeal of words</strong> in the title of the whole document, or in the heading of the Schedule, Part or Chapter.
 +
 
 +
Use the "Retained text repeal" option where you are retaining text because your repeal is only partially commenced.
 +
 
 +
Use the "Limited extent repeal" option where you are retaining text because your repeal is only a limited extent/TA repeal
 +
 
 +
Then move the closing <code>/repeal</code> tag to the end of the last text tag of the last child provision in the Part, Chapter, Schedule or whole document (just before the last closing <code>/ukl:Text</code> tag of the final provision (<strong>do not</strong> include the text of the Explanatory Note in secondary legislation).
 +
 
 +
As well as displaying a repeal F-note at the high level provision level, this will also result in a derived repeal annotation appearing in each child provision which appears between the opening and closing square bracket when it is viewed separately.
 +
 
 +
See [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Substantive_savings|Examples 1-3 in the Substantive savings]] section to see what this type of repeal looks like.
 +
 
 +
Please <strong>do not</strong> try to change the type of repeal to a retained text repeal by altering any RetainText attributes in XMetaL, as this will cause problems in the data. Once you have completed the amendment, carry out your [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#tna-HLREditorialchecks|Editorial Checks]] as usual.
 +
 
 +
Note that the timeline resolver should be used to add the PiT of the retained text repeal to the individual provisions within your document/Part/Chapter/Schedule. For an example of this see [[Coronavirus_Legislation#Temporary_whole_document_retained_text_repeal|Coronavirus Legislation - Temporary whole document retained text repeal]].
 +
 
 +
Note that this method does not work so well in more complex scenarios, i.e. for a limited extent high level repeal where there are existing limited extent amendments within that high level, either in composite text or concurrent versions, or where large ranges of provisions have been inserted for a limited extent. The [[Editorial_Update/Limited_Extent_Amendments#Is_your_amendment_a_limited_extent_repeal_of_a_higher_level_provision_.28e.g._a_heading_and_range_of_provisions.2C_or_a_Chapter.2C_Part_or_Schedule_or_whole_document.29.3F|Limited Extent page goes into this in more detail]].
 +
 
 +
===Selecting the relevant provision to check out in XMetaL===
 +
 
 +
If you need to make any amendments to a repeal annotation, carry out a retained text repeal or insert a repeal annotation you will need to check the relevant provision out in XMetaL from the <strong>Higher Level Update Details ToC</strong>:
 +
 
 +
[[File:High_Level_Repeals_18.png|900px]]
 +
 
 +
<strong>Whole Item of Legislation:</strong> To edit an auto repeal annotation or insert a repeal annotation at top level, check out the Introductory Text. To carry out a retained text repeal you will need to check out the whole item of legislation, if this is feasible.
 +
 
 +
<strong>Schedule, Part, Chapter:</strong> To edit an auto repeal annotation, insert a repeal annotation or carry out a retained text repeal, check out the whole Schedule, Part or Chapter.
 +
 
 +
===Repealing a range of provisions===
 +
 
 +
You can use the <strong>Batch Repeal</strong> function to repeal ranges of provisions from the High Level <strong>Update Details</strong> page (fully repeal or repeal with retained text). You can also repeal each provision individually using the same method you would use to [[Editorial_Update/Textual_Amendments/Repeals/Provision_Level_Repeals#Carrying_out_the_repeal_of_a_provision_or_sub-provision_in_XMetaL|repeal an individual provision]] - if you choose to do this you should use the same task for each repeal within the range of provisions you are repealing, and the repeals will be carried out from the High Level <strong>Update Details</strong> page.
 +
 
 +
<strong>Note:</strong> Where a range of provisions is being repealed, it is not our practice to repeal any cross-headings <strong>unless</strong> there is an explicit instruction from the drafter to do so. The batch repeal function cannot be used to repeal cross-headings, this needs to be done by checking out the cross-heading from the High Level Update Details page and carrying out a repeal of words of the text in the cross-heading, see [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Cross-headings|Cross-headings]].
 +
 
 +
====Batch Repeal Function====
 +
 
 +
<div id="tna-HLRWarning"></div>
 +
{|class="wikitable" style="border-left:solid 2px red;border-right:solid 2px red;border-top:solid 2px red;border-bottom:solid 2px red; background-color:#e6f2ff;
 +
|-
 +
|<strong>WARNINGS:</strong>
 +
 
 +
 
 +
1. Do NOT use the batch repeal function for large ranges of provisions as the batch repeal function may not work properly if the range is too big. In this situation, it is better to carry out the batch repeals in smaller chunks (or if you have several different ranges of provisions to repeal, make sure you do them separately).
 +
 
 +
 
 +
2.The batch repeal function does not currently work correctly at cross-heading level, therefore do NOT select any cross-headings as part of a batch-repeal. (If you were to include a cross-heading in a batch repeal, this would result in a single dotty line after the cross-heading, which is incorrect because the repealed provisions should also be visible). See more on this in [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Cross-headings|Cross-headings]].
 +
 
 +
 
 +
3. The batch repeal function doesn't always insert F-notes into every provision within the range that has been repealed. Make sure that you check carefully that the F-note reference for the repeal is present in each provision you have repealed, and if necessary add in any that have been missed out (you can copy and paste the F-note reference).
 +
|}
 +
 
 +
 
 +
The batch repeal tab will be displayed when this function is available to use, for example:
 +
 
 +
<!--WRONG PLACE Higher level repeals may also come into force in stages that need to be applied incrementally across various PiTs.
 +
If you are not sure about any aspect of your higher level repeal, for example whether the text should be retained or not, or whether the retained text should be retained with brackets, or where the F-note should go, consult a <strong>Review Editor</strong>.-->
 +
 
 +
 
 +
[[File:High_Level_Repeals_14.png|900px]]
 +
 
 +
 
 +
Scroll down through the <strong>ToC</strong> to find the provisions that you need to repeal:
 +
 
 +
 
 +
[[File:High_Level_Repeals_15.png|900px]]
 +
 
 +
 
 +
Clicking on the red circle containing the exclamation mark will show you the amendment details (note that this may be missing the commencement details and won't necessarily be the same as the annotation that is generated when you carry out the batch repeal):
 +
 
 +
 
 +
[[File:High_Level_Repeals_16.png]]
 +
 
 +
 
 +
Select the provisions you wish to repeal using the check boxes and scroll back up to click the appropriate <strong>Full Repeal</strong> or <strong>Retained Text Repeal</strong> box to perform the repeal.
 +
 
 +
=====Higher level provisions=====
 +
 
 +
Note that if you select a parent provision such as a Chapter, all the child provisions will also be selected automatically and included in the repeal:
 +
[[File:Batch_repeal_6.png|900px]]
 +
 
 +
 
 +
=====Cross-headings=====
 +
 
 +
The batch repeal function does not currently work correctly at cross-heading level, therefore do not select any cross-headings as part of a batch-repeal. (If you were to include a cross-heading in a batch repeal, this would result in a single dotty line after the cross-heading, which is incorrect because the repealed provisions should also be visible). See more on this in [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Cross-headings|Cross-headings]].
 +
 
 +
 
 +
=====Checking batch repeals=====
 +
 
 +
Once the batch repeal is complete, you will be returned to the high level update details page:
 +
 
 +
 
 +
[[File:Batch_repeal_5.png|900px]]
 +
 
 +
 
 +
Use the <strong>Preview Legislation</strong> button to check you’re satisfied that the amendment has formatted correctly, and carry out the usual [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#tna-HLREditorialchecks|Editorial Checks]].
 +
 
 +
<strong>Look out for missing F-notes</strong>: sometimes the batch repeal function doesn't insert F-notes into every provision within the range that has been repealed. Once the batch repeal is complete, make sure that the F-note reference for the repeal is present in each provision you have repealed and if necessary add in any that have been missed (you can copy and paste the F-note reference in XMetaL):
 +
 
 +
 
 +
[[File:Batch_repeal_range.png|900px]]
 +
 
 +
 
 +
If you carry out a batch repeal involving a higher level provision and you find that the child provisions have not been repealed correctly, it is possible to manually edit the attributes so that the child provisions display correctly as repealed. Ask a Review Editor if you are not sure how to do this.
 +
 
 +
<strong>Note:</strong> If you use the batch repeal function to repeal ranges of provisions in a higher level repeal, you may also need to [[Editorial_Update/Textual_Amendments/Repeals/Higher_Level_Repeals#Insertion_of_repeal_annotation|insert an F-note at top level]] after you have carried out your batch repeal. 
 +
 
 +
<div id="tna-HLREditorialchecks"></div>
 +
 
 +
===Editorial Checks===
 +
 
 +
====Checking the amendment in XMetaL====
 +
 
 +
Once the amendment has been made, the cursor will be situated at the point the automatic annotation was inserted in the <strong>amended provision</strong> window.
 +
 
 +
1. Check the annotation has been generated and that it is accurate and complete. Carry out any edits if necessary.
 +
* Type of Effect is correct;
 +
* Punctuation is correct (e.g. no unnecessary spaces);
 +
* Date cited is that of the <strong>PiT</strong> you are editing and where applicable the correct <strong>In Force Date Qualification</strong> has been added after the date (check effects spreadsheet for any qualifications). If your amendment is not ‘wholly in force’ and has a different type of <strong>In Force Date Qualification</strong> (for example ‘for specified purposes’), this will be noted in the annotation and you will need to check the annotation to make sure that this has been rendered correctly: for further details on what the annotation should look like see [[Editorial_Update/Annotation_Conventions#Annotations_and_In_Force_Date_Qualifications|Annotations and In Force Date Qualifications]];
 +
* If a limited extent amendment, the extent is referenced;
 +
* Affected provision is correct;
 +
* Affecting provision is correct;
 +
* Savings are referenced (where applicable);
 +
* Commencement order is referenced (where applicable).
 +
 
 +
See more detail on annotations in [[Editorial_Update/Annotation_Conventions|Annotation Conventions]].
 +
 
 +
2. Scroll back up to the provision where the amendment was made and check any tagging and text are correct.
 +
3. On the toolbar at the top of the page click <strong>Legislation - Check In</strong>.
 +
4. In the pop-up <strong>Document is checked in successfully</strong> click <strong>OK</strong>.
 +
 
 +
====Checking the amendment on the Editorial Site====
 +
 
 +
1. Go back to the <strong>Update Details</strong> page and refresh the page by pressing CTRL and F5.
 +
 
 +
2. Select the <strong>Newly Edited Version</strong> to see a preview of the updated provision. Check that your amendment and annotation are formatted as you would expect.
 +
 
 +
3. To check the timeline and see how the provision would look in the context of the whole item of legislation, select the <strong>Preview Legislation</strong> button and check:
 +
* You’re satisfied that the amendment has formatted correctly and that the annotation is correctly positioned;
 +
* The annotation reference and the text of the annotation are correct (check annotation details such as type of effect, punctuation, date, savings (where applicable), commencement order (where applicable)).See more detail on annotations in [[Editorial_Update/Annotation_Conventions|Annotation Conventions]];
 +
* The right <strong>PiT</strong> has been created at the whole item of legislation level and also any parent and child levels;
 +
* You can move between the <strong>PiTs</strong> on the timeline correctly. If you need to use the timeline resolver, only use it at provision level not whole document, main body or Schedules levels, as using it at these higher levels can remove the repealed status in the attributes which can make the preview look incorrect.
 +
 
 +
4. Once you are satisfied that the amendment is correct, check that the amendment edit status is set to <strong>Edit Complete</strong>. You can also add any notes for the <strong>Review Editor</strong> by clicking on the note icon to the right of the edit status. You may need to add a note if there was anything unusual about the amendment that you need to draw to the attention of the <strong>Review Editor</strong>.
 +
 
 +
5. You can now [[Editorial_Update/Starting_Update_Tasks#Navigating_the_Update_Task|navigate]] to the next part of your update task.
 +
 
 +
==SCENARIOS==
 +
 
 +
===Dealing with a document that has been wholly repealed with savings and the saved version subsequently gets amended===
 +
 
 +
If a document has been repealed with savings that were not considered to be so substantial that the text should be retained (i.e. the text has been dotty lined), and  there is a subsequent amendment to the saved version of that document, we can include the amendment details of that subsequent amendment in the original annotation for the repeal. See this example on the REUL page:
 +
 
 +
[[Editorial_Update/Retained_EU_Legislation_Update#Whole_document_previously_wholly_repealed_.28with_savings.29_-_subsequent_amendment_of_.E2.80.9Cas_saved.E2.80.9D_version|Whole document previously wholly repealed (with savings) - subsequent amendment of “as saved” version]].
 +
 
 +
==RELATED PAGES==
 +
*[[Editorial_Update/Textual_Amendments/Repeals/Provision_Level_Repeals|Provision Level Repeals]]
 +
*[[Editorial_Update/Annotation_Conventions|Annotation Conventions]]
 +
*[[Editorial_Update/XMetaL_and_XML_tagging|XMetaL and XML Tagging]]
 +
*[[Editorial_Update/Manual_Amendments|Manual Amendments]]
 +
 
 +
 
 +
Approach, errors and troubleshooting:
 +
*[[Editorial_Update/Approach_to_Update,_Specific_Update_Issues_and_Update_Troubleshooting#APPROACH_TO_UPDATE_-_SOME_BASIC_RULES_AND_EXCEPTIONS|Approach to Update - Some Basic Rules and Exceptions]]
 +
*[[Editorial_Update/Approach_to_Update,_Specific_Update_Issues_and_Update_Troubleshooting#SPECIFIC_UPDATE_ISSUES|Specific Update Issues]]
 +
*[[Editorial_Update/Approach_to_Update,_Specific_Update_Issues_and_Update_Troubleshooting#UPDATE_TROUBLESHOOTING|Update Troubleshooting]]

Latest revision as of 11:20, 3 October 2025

OVERVIEW

Repeals at higher level can include groups of provisions, Parts, Chapters, Schedules or the whole item of legislation. For a whole extent, wholly in force higher level repeal where there are no substantive savings, the text can be completely removed and replaced with a dotty line. This type of repeal may be carried out by the Auto Repeal function on the Editorial Site. It is not necessary to check the amended provision out in XMetaL, unless you need to edit the auto annotation after the Auto Repeal has been carried out. If you need to repeal a range of provisions, you can use the Batch Repeal function.

For higher level repeals where the text should remain intact (e.g. where the repeal is for a limited extent, specified purposes or there are substantive savings), it is possible to carry out a retained text repeal in the Editorial System where brackets will be included around the retained text an annotation will be inserted at top level, or the repeal may be carried out in XMetaL by inserting the repeal annotation in a suitable location and leaving the text untouched (i.e. no square brackets around retained text). The choice of approach will depend on the type of repeal and is explained further in the Editorial Approach section below.

Higher level repeals may also come into force in stages that need to be applied incrementally across various PiTs.

If you are not sure about any aspect of your higher level repeal, for example whether the text should be retained or not, or whether the retained text should be retained with brackets, or where the F-note should go, consult a Review Editor.

Before you carry out a higher level repeal

Before carrying out a higher level repeal, make sure that you have researched the effects spreadsheet to check the type of effect, the commencement status, the extent and whether there are any savings, so that you are clear about whether text needs to be retained or not, and if text does need to be retained whether it needs to be surrounded by square brackets or not.

Use the Decision-making Process for Higher Level Repeals and the Editorial Approach sections to help you to decide on the correct approach to take before you go to the relevant part of the Editorial Processes section, which will explain how to carry out the repeal in the Editorial System.

Note: Be careful to check that the TOES details are correct e.g. if the repeal has been recorded as for specified purposes in TOES that the repeal really is for specified purposes only and not just for a range of provisions. If any of the details are incorrect, TOES may need to be corrected (speak to a Review Editor).

Decision-making process for Higher Level Repeals

1. Does the repeal apply to all provisions or only some? Is the auto repeal or batch repeal functionality therefore the best way to achieve the desired result?

However, before leaping in to use either auto repeal or batch repeal, consider the following…

2. Is the repeal of any or all of those provisions qualified in some way? Does it only apply for specified purposes, or in relation to a limited extent or territorial application, or are there substantive (as opposed to common form) savings that might make us think twice before dotty-lining the text and instead push us towards retaining text?

3. If the repeal itself is not qualified, then has it been brought wholly into force or is its commencement qualified? Is it only in force for specified purposes, or in relation to a limited extent or territorial application, or only in relation to some of its provisions and not others? Does the commencement order contain substantive savings which make us think twice before sweeping the text away?

4. Has anything already been repealed and, if so, what’s the best way to repeal the remainder? For example, if one or two provisions have been wholly repealed in a Part and then the Part is repealed (with no qualification), then we would just do a whole Part repeal and not repeal the remaining provisions individually. (After all, users can always see what the situation was before the last repeal in the previous versions). But if the Part repeal had been qualified as “in so far as not already repealed” then that forces us to work out what the remaining provisions are and then batch repeal them.

5. What happens next? Is there anything in TOES coming along in a future PiT (further amendments to our repealed provisions) which might make us think that we need to approach the repeal more cautiously and perhaps recognise that the savings we may have dismissed as common form are more substantive than we gave them credit for? Perhaps it may just be easier for the user to make sense of what’s going on if, rather than removing the text, we decide to retain the text for now in order to apply the future amendments to the saved repealed provisions?

EDITORIAL APPROACH

Whole repeals that are wholly in force

Where the repeal of the entire Part, Chapter, Schedule or whole item of legislation is wholly in force, covers the whole extent and there are no savings to be considered (see Caveat), you can use the Auto Repeal function. The amendments are automatically generated by the Editorial System when the Auto Repeal button has been selected from the High Level Update Details page.

Things to look out for

Errors in the automatically generated annotation

When you auto repeal a whole item of legislation, you will need to check that the correct type of legislation is referenced as the affected provision in the annotation (i.e. for secondary legislation, ‘Instrument’ should be amended as appropriate to ‘Order’, ‘Rules’ or ‘Regulations’ (See Citing Provisions in Secondary Legislation).

Note: for an Act of Adjournal, Act of Sederunt or Archbishops’ Instrument, the word ‘Instrument’ is correct and does not need to be changed.

WARNING: Look out for a bug in the auto repeal function whereby the annotation that is generated when Regulations are auto repealed says “Regulation revoked” rather than “Regulations revoked”. Look out for this and correct as necessary (NB also double check for this potential issue when revoking Rules).

Also check that the commencing provision of the amending legislation is present in the annotation and add it in if it is missing.

You can edit the annotation using the Edit button to the right of the annotation in Preview to edit it without having to check the provision out again in XMetaL. Click Update when you have finished making your changes to the text of the annotation (this will also generate any hyperlinks if necessary). You only need to check the provision out to edit the annotation where a hyperlink doesn't work because two same level sub-provisions are being cited (e.g. reg. 1(2)(3)), or if the wrong provision has been highlighted as being the operative provision. See more on fixing broken hyperlinks here.

Location of F-note reference, annotation and dotty lines

When you preview the completed amendment, you should make sure that the text of the repealed Part/Chapter/Schedule or whole item of legislation has been replaced by a dotty line. On opening the Parent Level from the ToC, directly below the heading there will be a single dotty line and following that will be the annotation giving authority for your repeal. On the Timeline of Changes you will see a new version has been created as at the date of the PiT of the repeal:

Whole repeal of a whole item of legislation


https://www.legislation.gov.uk/nisr/2015/205/2016-04-01

High Level Repeals 2.png

Note also that the word ‘(revoked)’ has been added to the end of the legislation title in the locations that have been highlighted. The word ‘revoked’ should only be present in these locations where a full repeal has been carried out, not for a retained text repeal. The top title is contained within the dc:title element, which is part of the metadata and we are unable to edit this directly, however if we make amendment to the legislation title, this should also be carried through into this top title. If an item of legislation is inadvertently fully repealed when text should have been retained, and the repeal needs to be corrected, we need to make sure that the word ‘(revoked)’ is removed from the legislation title and the top title.

Whole repeal of a Schedule

https://www.legislation.gov.uk/uksi/2010/490/schedule/1/2017-11-30

High Level Repeals 3.png

An example of the format of one of the revoked Child Provisions within the Schedule is:

https://www.legislation.gov.uk/uksi/2010/490/schedule/1/paragraph/1/2017-11-30

The provisions have a single dotty line appearing immediately after the provision number. There isn’t an F-note reference, but the annotation still appears below. On the Timeline of Changes there is a start date as at the date of the PiT of the repeal.


See an example of a whole repeal of a Chapter here:

https://www.legislation.gov.uk/uksi/2019/657/part/3/chapter/2/2020-12-31

Child provision within the repealed Chapter: https://www.legislation.gov.uk/uksi/2019/657/regulation/54/2020-12-31

Partially dotty lined Explanatory Notes when using the auto repeal function to revoke secondary legislation
There is currently a bug in the auto repeal facility which means that sometimes the Explanatory Note (EN) is left intact and still appears at the end of the revoked SI and sometimes the EN gets dotty lined and no longer appears at the end of the revoked SI. This is described in more detail under Specific Update Issues.

Caveat: what happens where there are savings

If your repeal is wholly in force and whole extent (so that all the text will be omitted upon repeal) but you think the savings are so substantial that text should be retained, consult a Review Editor about how to proceed.

Where there are substantive (as opposed to common form) savings, we may need to pause before going ahead and removing and dotty-lining the text and take some time to consider whether text should be retained.

If the legislation is repealed but continued for specified purposes and at the same time there are large insertions as so continued, it is probably useful to website users to retain text so that it can still be referred to easily (see examples below).

Also, even where savings appear to be common form we should consider whether there anything in TOES coming along at a future PiT (further amendments to our repealed provisions) that might require the text to be retained so that we can apply future amendments to the saved repealed provisions. For smaller amendments in saved repealed documents it’s probably sufficient just to mention them as appended commentary to the main repealed annotation. Consult a Review Editor if you are not sure.

See also the Scenarios section below, for an example of how we dealt with a document that was repealed with savings where text wasn't retained but the saved version was subsequently amended.

See, for example, the repeal of 1967 c. 86, ss. 30-38:

This repeal is subject to substantive savings in 2003 asp 2, Sch. 2 para. 7, which leaves those provisions in effect for a whole class of specified rights, which justified the text being retained:

“Notwithstanding the repeal of section 30 to 38, those sections continue to have effect—
(a) to the extent that the rights and facilities afforded to the public under those sections are not secured by section 1 above;
(b) in relation to land in respect of which access rights are, under section 6 above, not exercisable; and
(c) in relation to rights of way.”


Contrast this with the repeal of 1967 c. 86, Pt. 2:

This repeal is subject to 2003 asp 2, Sch. 2 para. 6, but these savings are more common form and transitional and therefore do not justify retaining the text:

“The coming into force of the repeal of Part II does not—
(a) prevent compensation thereafter being claimed or becoming payable under section 21 of the Act (compensation for depreciation or disturbance as a result of access order to be assessed only after five years' operation of order); or
(b) otherwise affect the operation thereafter of sections 21 to 23 and 70 of that Act in relation to claims for or payment of compensation.”

Note that transitional arrangements smooth the change in the law for certain persons or purposes and, it doesn’t really matter how long that transitional period is, the transitional arrangements will eventually come to an end and the new law will prevail. A substantive saving would result in these amendments not applying to certain persons or things etc at all and the old law continuing indefinitely in relation to those persons or things etc.


Substantive savings

If there are substantive savings that mean that text should not be removed, you should carry out a retained text repeal, for example:

Example 1: https://www.legislation.gov.uk/ukpga/2002/21/part/1
High Level Repeals 4.png
Example 2: https://www.legislation.gov.uk/ukpga/1972/68/introduction/2020-01-31 (whole Act retained text repeal that is subject to temporary savings):
High Level Repeals 5.png
Example 3: https://www.legislation.gov.uk/uksi/2013/1119 (retained text whole Order, note position of closing square bracket for the retained text repeal when the whole document is opened - at the end of Sch. 9 and before the Explanatory Note):
High Level Repeals 6.png
Common form savings

Where there is a repeal with a common form saving, you should remove the text. If further amendments come along later, we can apply these as appended commentary to the repeal annotation for later amendments to saved provisions.

Example 1: http://www.legislation.gov.uk/ssi/2007/577/introduction
High Level Repeals 7.png
Example 2: https://www.legislation.gov.uk/nisr/2020/55
High Level Repeals 8.png

Whole repeals that are not wholly in force

Scenarios where a whole repeal is brought into force incrementally over time

A repeal may not be wholly in force straight away but instead may be brought into force incrementally over time. It may be brought into force incrementally in one of three ways, or in a combination of all three:

Case 1. It may be brought into force for some, but not all, of its purposes.

Case 2. It may be brought into force for a part, but not all, of its extent or territorial application.

Case 3. It may be brought into force for some, but not all, of the provisions it affects.

As the repeal is brought further into force our aim should be to ensure that the F-note telling the story of its coming into force is accurate and that relevant child provisions are dealt with appropriately at each stage.

Approach in each case the first time the repeal is partially brought into force

Case 1 - Specified purposes: If the repeal is commenced only for specified purposes, leave the text intact and insert an F-note at top level. The F-note will only be visible at the top level and not in individual child provisions.

But, where the repeal has been commenced for specified purposes in relation only to specified individual provisions, then (in addition to the top level F-note) we should perform retained text repeals of those individual child provisions as well and these should share the same F-note as the top level.

Case 2 - Partial extent (or territorial application): If the repeal is commenced only for a part of its extent (or territorial application), carry out a retained text repeal of words in the heading and cut and paste the closing bracket to the end of the item of legislation or Chapter/Part/Schedule, so that the whole text of the item of legislation or Chapter/Part/Schedule is retained with square brackets around it. The F-note reference will be situated at the beginning of the heading and a derived annotation will be viewable in individual child provisions.

(Please see the Warning below re high level retained text repeals).

However, where the repeal has been commenced for a limited extent/TA only in relation to specified individual provisions, then those specified provisions should be retained text repealed and an F-note should be inserted at the top level.

You will also need to consider more complex scenarios where there are existing limited amendments in the child provisions and tailor your approach appropriately.

Case 3 - Specified provisions: If the repeal is commenced only for specified provisions, an F-note for the repeal should be inserted at top level and each specified provision should also be repealed in the usual way resulting in a dotty line (either individually or using the batch repeal functionality). The individually repealed provisions should share the same F-note as the top level.

Subsequent approach as repeal comes further into force

Thereafter, as the repeal comes further into force, the top level F-note should be checked (and corrected if necessary) and action taken at individual child provision level as appropriate.

When the repeal is finally brought wholly into force it may be appropriate at that stage to dotty line the whole text. If the auto repeal button or batch repeal page is not available at that stage, then you can use the workaround described below. If this workaround doesn't work, a story should be raised with TSO to help out.

Once the auto-repeal has been carried out you may need to remove the brackets of previous retained text repeals performed at both heading and child levels, as these won’t be removed automatically by the auto-repeal process.

At the final Point in Time, when the repeal is wholly in force, the higher level provision should look as though it has been wholly repealed: there should be no opening or closing brackets left and the text should have been removed and dotty-lined.

WARNING: When a higher level retained text repeal is brought into force in so far as not already in force, do not change the attributes for the retained text repeal from =true to =false as this will wipe out structural xml tagging as well as text and make the document incoherent. You need instead to carry out an auto-repeal or batch repeal to dotty line the text and check that the F-note accurately reflects the story of the repeal from start to finish.

This guidance outlines the most common way to approach these types of repeals. There may be variations that mean that a more tailored approach may be necessary. If you are not sure of the approach to use, consult a Review Editor.

Example 1: Incremental repeal of 1965 c. 64, which is repealed for specified provisions and extents beginning on 1/10/2006:


https://www.legislation.gov.uk/ukpga/1965/64/2014-12-15

High Level Repeals 9.png


Note: The F-note reference is at the beginning of the enacting text. The text of all provisions that are not affected by the repeal is untouched.


To look more closely at what happens to one of the affected provisions, see s.8 (which is repealed on1/10/2006 for E. by Commencement Order S.I. 2006/2504). The text of the affected provision is retained with square brackets around the retained text:


https://www.legislation.gov.uk/ukpga/1965/64/section/8/2006-10-01


Then on 1/10/2008, s. 8 is also repealed for W. by Commencement Order S.I. 2007/2386, bringing the repeal fully into force for the whole extent. The text of the affected provision is removed and dotty-lined:


https://www.legislation.gov.uk/ukpga/1965/64/section/8/2008-10-01

Example 2: Incremental repeal of S.I. 2020/353, beginning on 11.7.2020 (Regulations revoked for the revocation of reg. 5 for all purposes and regs. 4(4)-(6), 7A, 10-14 for specified purposes):


http://www.legislation.gov.uk/wsi/2020/353/introduction/2020-07-11


To look more closely at what happens to one of the affected provisions see reg. 4. Regs. 4(4)-(6), 7A are retained with square brackets and the top level annotation is carried through to the provision:


https://www.legislation.gov.uk/wsi/2020/353/regulation/4/2020-07-11


At the next PiT (13/7/2020), the Regulations are fully revoked:


https://www.legislation.gov.uk/wsi/2020/353/introduction/2020-07-13 https://www.legislation.gov.uk/wsi/2020/353/regulation/4/2020-07-13


Note: The top level F-note reference is now located at the end of the title and the text of all provisions has been revoked and replaced with a dotty line. The annotation text has been amended to include the date of the whole revocation and the words ‘in so far as not already in force’.

Example 3: 1965 c. 4, Sch. 3 was omitted for specified purposes ("except to the extent it applies to either or both of the Medical Research Council or the Science and Technology Facilities Council") on 31.10.2018, as brought into force by SI 2018/1054, reg. 2(d)(ii). When the effect was applied, the in force date qualification was changed from "specified purposes" to the following, to make it clearer to the end user:


Sch. 3 omitted (31.10.2018 except to the extent it applies to either or both of the Medical Research Council or the Science and Technology Facilities Council) by virtue of Higher Education and Research Act 2017 (c. 29), s. 124(5), Sch. 12 para. 4(5); S.I. 2018/1054, reg. 2(d)(ii) 


https://www.legislation.gov.uk/ukpga/1965/4/schedule/3

Partial repeals that are wholly in force

Ceases to have effect

Approach: Carry out retained text repeal with square brackets (if you can), F-note at top level.

Example: https://www.legislation.gov.uk/ssi/2016/346/2020-04-07
High Level Repeals 10.png

Note: all ‘ceases to have effect’ repeals need to be carried out with retained text in square brackets, whether temporary or not. Also note wording ‘by virtue of’ in annotation.

“Repealed for specified purposes” or “repealed in part”

This is where the drafter has specified a higher level provision (e.g. Act or Part) or range of provisions as repealed or revoked but then qualified this in some way, as explained in more detail on the Record Effects page: Qualifications of the type of effect – “(except for [specified provisions])” or “in part”/“for specified purposes” (not where the repeal is only in force for specified purposes, which is dealt with in the Whole repeals that are not wholly in force section above).

Approach: Carry out retained text repeal with square brackets (if you can), F-note at top level

Example 1: Regulations ‘revoked in part’


https://www.legislation.gov.uk/uksi/2005/18/2007-10-19


Note: In this example, ‘revoked in part’ was changed to ‘revoked (except in their application to the profession of company auditor)’, to make it clearer to the end user.

High Level Repeals 12.png
Example 2: Regulations ‘revoked in part’ https://www.legislation.gov.uk/uksi/2005/1971/introduction
Example 3: Schedule ‘revoked in part’ where the relevant part of the Schedule was fully revoked

See the affecting provision SI 2012/3118, Sch. 3, which revokes SI 2010/2214, reg. 54(1) and Sch. 5 "insofar as they relate to the Energy Performance of Buildings (Certificates and Inspections) (England and Wales) Regulations 2007":

https://www.legislation.gov.uk/uksi/2012/3118/schedule/3/made

The part of Sch. 5 relating to the Energy Performance of Buildings (Certificates and Inspections) (England and Wales) Regulations 2007 was fully revoked:

https://www.legislation.gov.uk/uksi/2010/2214/schedule/5/2013-01-09

Note: sometimes ‘revoked in part’ (or ‘repealed in part’) may have been recorded as the type of effect when certain provisions only have been revoked/repealed and it would be more appropriate to use the type of effect ‘revoked (except for…)’ (or ‘repealed (except for…)’) (see below). If you think the type of effect may need to be amended consult a Review Editor.

“repealed (except for…)”

Approach: Repeal the provisions that are fully repealed and leave the text intact for excepted provisions (with square brackets where appropriate i.e. where text is left intact for specified purposes or extent, otherwise leave excepted provisions untouched), insert the F-note for the repeal at top level.

Example 1: https://www.legislation.gov.uk/nisr/2013/71/2015-04-01
High Level Repeals 13.png


In this example, the excepted provision (reg. 28) is excepted for specified purposes only, so the text has been retained with square brackets around it https://www.legislation.gov.uk/nisr/2013/71/regulation/28/2015-04-01

Example 2: https://www.legislation.gov.uk/nisr/2013/207/2015-07-01


In this example, the text of reg. 9(2) has been retained (no brackets required as the text is fully retained) https://www.legislation.gov.uk/nisr/2013/207/regulation/9/2015-07-01

Example 3: https://www.legislation.gov.uk/uksi/2002/501/2010-04-01

Limited extent or territorial application

Approach: Carry out retained text repeal with square brackets (if you can), F-note at top level, using the limited extent repeal option in XMetaL:

https://www.legislation.gov.uk/uksi/2020/91/introduction/2024-01-01

https://www.legislation.gov.uk/uksi/1992/548/schedule/1/part/IV/2003-04-01

If it is impractical to carry out a retained text repeal in this manner (for example if the checked out fragment is too large), then you will have to just insert an F-note repeal annotation instead, making sure that the annotation contains an indication of its limited extent/TA.

You will also need to consider more complex scenarios where there are existing limited amendments in the child provisions and tailor your approach appropriately.

More examples of limited extent repeals can be found in the limited extent amendments pages.

Partial repeals that are not wholly in force

  • partial repeal commenced for specified purposes
  • partial repeal commenced for limited extent/territorial application
  • partial repeal commenced for specified provisions

Where the commencement of a partial repeal is incremental, the annotation for the repeal should be updated as the repeal is commenced further. You will need to check the auto annotation to make sure it reflects the story so far, and dotty line or add retain text brackets as appropriate.


Incremental repeals

The term “incremental repeal” is used to describe a repeal that takes place in stages, it may be a whole repeal that is commenced incrementally over time, or a partial repeal that is wholly in force or also commenced over time, as follows:

Whole repeals - not wholly in force

A whole repeal may not be wholly in force straight away, but instead may be brought into force incrementally over time. It may be brought into force incrementally in one of three ways, or in a combination of all three:

  • it may be brought into force for some, but not all, of its purposes.
  • it may be brought into force for a part, but not all, of its extent or territorial application.
  • it may be brought into force for some, but not all, of the provisions it affects.

As the repeal is brought further into force our aim should be to ensure that the F-note telling the story of its coming into force is accurate and that relevant child provisions are dealt with appropriately at each stage.

See further detail:

Scenarios where a repeal is brought into force incrementally over time

Subsequent approach as repeal comes further into force

Partial repeals - wholly in force

A repeal may be wholly in force but only only be partial, i.e. repealed for a limited extent, for specified purposes, repealed in part (or "except for" certain provisions), or “ceases to have effect”, the repeal of that high level may subsequently be made for further jurisdictions, purposes or provisions, which may eventually lead to the whole repeal of that high level; this is another form of incremental repeal.

The Limited Extent page explains how to update an existing limited extent amendment when an identical amendment is applied for another jurisdiction, which includes advice on what to do when the amendment now fully extends to all jurisdictions. The principles are similar for other types of partial repeal, whereby the details for the subsequent repeal(s) will be merged into one annotation and any relevant child provisions dealt with as appropriate.

Partial repeals - not wholly in force

Partial repeals may also be brought into force incrementally over time. Where the commencement of a partial repeal is incremental, the annotation for the repeal will be updated as the repeal is commenced further. Editors should check the auto annotation to make sure it reflects the story so far, and dotty line or add retain text brackets as appropriate.


What happens when an incremental repeal leads to the whole revocation of a document

If a whole document has been revoked incrementally, and the latest stage in that incremental revocation means that the whole document is revoked, editors need to make sure that the title of the document is amended to include “(revoked)” at the end of it, which should then automatically be reflected in the dc:title at the top of the document:


High Level Repeals 2.png


Cross-headings

If your update task involves the repeal of a cross-heading itself, this will be carried out from the High Level Update Details page. Check out the cross-heading from the High Level Table of Contents and carry out a repeal of words of the cross-heading text. For example, to repeal the cross-heading "Interest and royalty payments" you would select the "Check out for edit" button next to this cross-heading in the Table of Contents:

Batch repeal cross heading 7.png

Next, you need to carry out a repeal of words on the text within the cross-heading ukl:title tags in XMetaL:

Batch repeal cross heading 8.png

The repealed cross-heading should like like this when you preview it on the website: Cross-heading repeal 6.png

Repealing a range of provisions underneath a cross-heading

If your update task involves repealing a cross-heading and the provision (or range of provisions) that comes after it, once you have carried out the repeal of words in the cross-heading ukl:title tags, you can repeal the provision (or range of provisions) individually using the usual method for repealing a provision (highlighting the same task in the Task Manager each time). You can also use the batch repeal function to repeal the range of provisions, but please read the Warning and guidance that follows this first:

WARNING:The batch repeal function does not currently work correctly at cross-heading level, therefore do not select any cross-headings as part of a batch-repeal. (If you did include the cross-heading in the batch repeal, this would result in a single dotty line after the cross-heading, which is incorrect because the repealed provisions should also be visible, see example below)

If you do want to use the batch repeal function to repeal the range of provisions that come after the cross-heading, make sure that you select all but one of the provisions that fall under the cross-heading (if you select all the provisions under the cross-heading, the cross-heading box is automatically selected and you should avoid this happening for the reason described in the Warning above).

Batch repeal cross heading 2.png

Once you have carried out the batch repeal on this range of provisions, you should then amend the contents of the remaining provision manually, by checking out the cross-heading (which will also include the range of provisions) from the High Level Table of Contents and copying a dotted line from one of the newly repealed provisions and pasting it into the remaining provision (adjusting the tagging within the ukl:P1para of the remaining provision as appropriate and also inserting the F-note reference), for example:

Batch repeal cross heading 6.png

You should end up with the repealed cross-heading and provisions looking like this when you preview the parent level (i.e. the cross-heading) on the website:

https://www.legislation.gov.uk/ukpga/2005/5/part/6/chapter/9/crossheading/interest-and-royalty-payments

Batch repeal cross heading 5.png

Example at child provision level: https://www.legislation.gov.uk/ukpga/2005/5/section/757 (note that the section number and heading are still present).

Note: Where a range of provisions is being repealed, it is not our practice to repeal any cross-headings unless there is an explicit instruction from the drafter to do so.

EDITORIAL PROCESSES

Auto Repeal function

Before you carry out an auto repeal, make sure you have read the sections Before you carry out a higher level repeal and Editorial Approach: Whole repeals - Wholly in force.

The instructions in this section should only be followed if the repeal in your current PiT is:

  • for the whole Chapter, Part, Schedule or item of legislation;
  • for the whole extent;
  • wholly in force; and
  • there are no substantive savings that would mean that text should be retained.

1. On the High Level Update Details page, for:

  • A whole item of legislation: click on the Auto Repeal button at the top of the ToC on this page.
  • A Part, Chapter or Schedule: scroll down the ToC to find the Part, Chapter, Schedule or relevant Heading level to be repealed and select the Auto Repeal button next to the heading of that Part, Chapter or Schedule.

Note: If there is no Auto Repeal button displayed next to the provision you need to repeal, you can use the Batch Repeal Function to carry out the repeal.

2. In the pop-up box ‘Are you sure you want to apply auto repeals’ click OK; the system will automatically carry out the repeal and refresh the Update Details page (if the Update Details page doesn’t automatically refresh, it can be refreshed by pressing F5).

3. Once the auto repeal has been carried out, you will need to check and, if necessary, amend the automatically generated annotation.

4. Once you have checked the automatically generated annotation, select the Preview Legislation button and double check:

  • You’re satisfied that the amendment has formatted correctly and that the annotation is correctly positioned;
  • The annotation reference and the text of the annotation are correct (check annotation details such as type of effect, punctuation, date, savings (where applicable), commencement order (where applicable)).See more detail on annotations in Annotation Conventions;
  • The right PiT has been created at the whole item of legislation level and also any parent and child levels;
  • You can move between the PiTs on the timeline correctly.

For examples of what the amendment and annotation should look like, see Location of F-note reference, annotation and dotty lines. Also check the other Things to look out for.

5. Once you are satisfied that the amendment is correct, check that the amendment edit status is set to Edit Complete. You can also add any notes for the Review Editor by clicking on the note icon to the right of the edit status. You may need to add a note if there was anything unusual about the amendment that you need to draw to the attention of the Review Editor.

5. You can now navigate to the next part of your update task.

Workaround where auto repeal function is not available

If there is no auto repeal button displayed by the high level provision that you need to wholly repeal (and the batch repeal function is also unavailable), you can use the following workaround to carry out the repeal:

1. Check out at parent level (the level being repealed) and insert the repeal F-note at heading level and make sure that heading level has these attributes:

Match = true
Status = repealed
Restrict start date = [PiT date that you’re working on]

(NB parent heading title should not be dotty lined)

2. Manually repeal all children with same task. In fact, after doing the first child you can copy and paste the whole P1para (including F-note and dotty lined text tag) for the remainder.

(NB This is the correct number of dots for block repeal: “. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .”)

You don’t need to repeal cross-headings.

3. Ensure all children (and also any cross-headings, which don’t need to be dotty lined) have the following attributes when you place cursor in P1group or P1 (depending on whether you’re in main body or schedule):

Match = false
Status = repealed
Restrict start date = [PiT date that you’re working on]

4. Check in.

If this workaround does not work, we should raise a call with TSO to help.

See more on amending attributes here.

Repeals where text is not removed

Insertion of repeal annotation

If you need to insert an F-note at the top level for a high level repeal where text is being retained but you are not performing a retained text repeal that will automatically insert an F-note (you can see examples of this type of repeal in Whole repeals - Not wholly in force and Partial repeals - Wholly in force), follow these instructions:

1. This amendment will be carried out in XMetaL: you will have checked out the introductory or top level provision containing the relevant title tagging from the High Level Update Details page and have set up your XMetaL workspace.

2. Your next action will depend on whether the repeal is for a whole item of primary or secondary legislation, or if it is for a whole Part, Schedule or chapter:

Whole item of primary legislation: In the amended provision, place the cursor immediately after the opening ukl:LongTitle tag at the top of the document.

Whole item of secondary legislation: In the amended provision, place the cursor immediately after the opening ukl:EnactingText tag in the Secondary Prelims at the top of the document.

Part, Chapter or Schedule: In the amended provision, place the cursor immediately after the ukl:Number at Part, Chapter or Schedule level (this is at the top of the document after the ukl:Part/ukl:Chapter/ukl:Schedule opening tag) but before the number of the Part, Chapter or Schedule.

3. Single click on the task to highlight it in the Resource Manager window.

4. On the toolbar at the top of the page click on Legislation - Non-Textual Amendments - Insert Commentary; this will

  • insert a ukl:CommentaryRef tag and unique task number after the Part, Chapter or Schedule's opening ukl:Number tag, or for a whole item of legislation, in primary legislation after the opening ukl:Longtitle tag or in secondary legislation after the opening ukl:EnactingText tag;
  • insert the annotation for the task; and
  • generate a green tick next to the task in the Resource Manager window.

5. Now carry out your Editorial Checks.

Note: You should scroll back up to the top of the Part, Chapter, Schedule or whole item of legislation to check the ukl:CommentaryRef tag has been correctly inserted.

Retained text repeal (text retained with square brackets)

Method to use in simple scenarios

To carry out a whole document, whole Part, whole Chapter, or whole Schedule retained text repeal, you need to check the relevant high level provision out in XMetaL and carry out a retained text repeal of words in the title of the whole document, or in the heading of the Schedule, Part or Chapter.

Use the "Retained text repeal" option where you are retaining text because your repeal is only partially commenced.

Use the "Limited extent repeal" option where you are retaining text because your repeal is only a limited extent/TA repeal

Then move the closing /repeal tag to the end of the last text tag of the last child provision in the Part, Chapter, Schedule or whole document (just before the last closing /ukl:Text tag of the final provision (do not include the text of the Explanatory Note in secondary legislation).

As well as displaying a repeal F-note at the high level provision level, this will also result in a derived repeal annotation appearing in each child provision which appears between the opening and closing square bracket when it is viewed separately.

See Examples 1-3 in the Substantive savings section to see what this type of repeal looks like.

Please do not try to change the type of repeal to a retained text repeal by altering any RetainText attributes in XMetaL, as this will cause problems in the data. Once you have completed the amendment, carry out your Editorial Checks as usual.

Note that the timeline resolver should be used to add the PiT of the retained text repeal to the individual provisions within your document/Part/Chapter/Schedule. For an example of this see Coronavirus Legislation - Temporary whole document retained text repeal.

Note that this method does not work so well in more complex scenarios, i.e. for a limited extent high level repeal where there are existing limited extent amendments within that high level, either in composite text or concurrent versions, or where large ranges of provisions have been inserted for a limited extent. The Limited Extent page goes into this in more detail.

Selecting the relevant provision to check out in XMetaL

If you need to make any amendments to a repeal annotation, carry out a retained text repeal or insert a repeal annotation you will need to check the relevant provision out in XMetaL from the Higher Level Update Details ToC:

High Level Repeals 18.png

Whole Item of Legislation: To edit an auto repeal annotation or insert a repeal annotation at top level, check out the Introductory Text. To carry out a retained text repeal you will need to check out the whole item of legislation, if this is feasible.

Schedule, Part, Chapter: To edit an auto repeal annotation, insert a repeal annotation or carry out a retained text repeal, check out the whole Schedule, Part or Chapter.

Repealing a range of provisions

You can use the Batch Repeal function to repeal ranges of provisions from the High Level Update Details page (fully repeal or repeal with retained text). You can also repeal each provision individually using the same method you would use to repeal an individual provision - if you choose to do this you should use the same task for each repeal within the range of provisions you are repealing, and the repeals will be carried out from the High Level Update Details page.

Note: Where a range of provisions is being repealed, it is not our practice to repeal any cross-headings unless there is an explicit instruction from the drafter to do so. The batch repeal function cannot be used to repeal cross-headings, this needs to be done by checking out the cross-heading from the High Level Update Details page and carrying out a repeal of words of the text in the cross-heading, see Cross-headings.

Batch Repeal Function

WARNINGS:


1. Do NOT use the batch repeal function for large ranges of provisions as the batch repeal function may not work properly if the range is too big. In this situation, it is better to carry out the batch repeals in smaller chunks (or if you have several different ranges of provisions to repeal, make sure you do them separately).


2.The batch repeal function does not currently work correctly at cross-heading level, therefore do NOT select any cross-headings as part of a batch-repeal. (If you were to include a cross-heading in a batch repeal, this would result in a single dotty line after the cross-heading, which is incorrect because the repealed provisions should also be visible). See more on this in Cross-headings.


3. The batch repeal function doesn't always insert F-notes into every provision within the range that has been repealed. Make sure that you check carefully that the F-note reference for the repeal is present in each provision you have repealed, and if necessary add in any that have been missed out (you can copy and paste the F-note reference).


The batch repeal tab will be displayed when this function is available to use, for example:


High Level Repeals 14.png


Scroll down through the ToC to find the provisions that you need to repeal:


High Level Repeals 15.png


Clicking on the red circle containing the exclamation mark will show you the amendment details (note that this may be missing the commencement details and won't necessarily be the same as the annotation that is generated when you carry out the batch repeal):


High Level Repeals 16.png


Select the provisions you wish to repeal using the check boxes and scroll back up to click the appropriate Full Repeal or Retained Text Repeal box to perform the repeal.

Higher level provisions

Note that if you select a parent provision such as a Chapter, all the child provisions will also be selected automatically and included in the repeal: Batch repeal 6.png


Cross-headings

The batch repeal function does not currently work correctly at cross-heading level, therefore do not select any cross-headings as part of a batch-repeal. (If you were to include a cross-heading in a batch repeal, this would result in a single dotty line after the cross-heading, which is incorrect because the repealed provisions should also be visible). See more on this in Cross-headings.


Checking batch repeals

Once the batch repeal is complete, you will be returned to the high level update details page:


Batch repeal 5.png


Use the Preview Legislation button to check you’re satisfied that the amendment has formatted correctly, and carry out the usual Editorial Checks.

Look out for missing F-notes: sometimes the batch repeal function doesn't insert F-notes into every provision within the range that has been repealed. Once the batch repeal is complete, make sure that the F-note reference for the repeal is present in each provision you have repealed and if necessary add in any that have been missed (you can copy and paste the F-note reference in XMetaL):


Batch repeal range.png


If you carry out a batch repeal involving a higher level provision and you find that the child provisions have not been repealed correctly, it is possible to manually edit the attributes so that the child provisions display correctly as repealed. Ask a Review Editor if you are not sure how to do this.

Note: If you use the batch repeal function to repeal ranges of provisions in a higher level repeal, you may also need to insert an F-note at top level after you have carried out your batch repeal.

Editorial Checks

Checking the amendment in XMetaL

Once the amendment has been made, the cursor will be situated at the point the automatic annotation was inserted in the amended provision window.

1. Check the annotation has been generated and that it is accurate and complete. Carry out any edits if necessary.

  • Type of Effect is correct;
  • Punctuation is correct (e.g. no unnecessary spaces);
  • Date cited is that of the PiT you are editing and where applicable the correct In Force Date Qualification has been added after the date (check effects spreadsheet for any qualifications). If your amendment is not ‘wholly in force’ and has a different type of In Force Date Qualification (for example ‘for specified purposes’), this will be noted in the annotation and you will need to check the annotation to make sure that this has been rendered correctly: for further details on what the annotation should look like see Annotations and In Force Date Qualifications;
  • If a limited extent amendment, the extent is referenced;
  • Affected provision is correct;
  • Affecting provision is correct;
  • Savings are referenced (where applicable);
  • Commencement order is referenced (where applicable).

See more detail on annotations in Annotation Conventions.

2. Scroll back up to the provision where the amendment was made and check any tagging and text are correct. 3. On the toolbar at the top of the page click Legislation - Check In. 4. In the pop-up Document is checked in successfully click OK.

Checking the amendment on the Editorial Site

1. Go back to the Update Details page and refresh the page by pressing CTRL and F5.

2. Select the Newly Edited Version to see a preview of the updated provision. Check that your amendment and annotation are formatted as you would expect.

3. To check the timeline and see how the provision would look in the context of the whole item of legislation, select the Preview Legislation button and check:

  • You’re satisfied that the amendment has formatted correctly and that the annotation is correctly positioned;
  • The annotation reference and the text of the annotation are correct (check annotation details such as type of effect, punctuation, date, savings (where applicable), commencement order (where applicable)).See more detail on annotations in Annotation Conventions;
  • The right PiT has been created at the whole item of legislation level and also any parent and child levels;
  • You can move between the PiTs on the timeline correctly. If you need to use the timeline resolver, only use it at provision level not whole document, main body or Schedules levels, as using it at these higher levels can remove the repealed status in the attributes which can make the preview look incorrect.

4. Once you are satisfied that the amendment is correct, check that the amendment edit status is set to Edit Complete. You can also add any notes for the Review Editor by clicking on the note icon to the right of the edit status. You may need to add a note if there was anything unusual about the amendment that you need to draw to the attention of the Review Editor.

5. You can now navigate to the next part of your update task.

SCENARIOS

Dealing with a document that has been wholly repealed with savings and the saved version subsequently gets amended

If a document has been repealed with savings that were not considered to be so substantial that the text should be retained (i.e. the text has been dotty lined), and there is a subsequent amendment to the saved version of that document, we can include the amendment details of that subsequent amendment in the original annotation for the repeal. See this example on the REUL page:

Whole document previously wholly repealed (with savings) - subsequent amendment of “as saved” version.

RELATED PAGES


Approach, errors and troubleshooting: