Difference between revisions of "Editorial Update/Textual Amendments/Substitutions/Provision Level Substitutions"
Line 538: | Line 538: | ||
<br> | <br> | ||
− | Whilst still in XMetaL, you need to check that the amendment has been carried out correctly and that the annotation is accurate and complete by | + | 1. <span style = "color:red;"><strong>Whilst still in XMetaL, you need to check that the amendment has been carried out correctly and that the annotation is accurate and complete by carrying out all the checks detailed in the</span> [[Editorial_Update/Update_Editor_Checklist#After_you_have_carried_out_the_amendment_in_the_XML|Update Editor Checklist]]</strong>. |
<br> | <br> | ||
<br> | <br> | ||
Line 570: | Line 570: | ||
<br> | <br> | ||
− | + | ||
+ | |||
<u>Example of a substitution of words: substitution of "Welsh Ministers" for "Secretary of State"</u> | <u>Example of a substitution of words: substitution of "Welsh Ministers" for "Secretary of State"</u> | ||
Line 580: | Line 581: | ||
See on the published site [http://www.legislation.gov.uk/ukpga/1988/41/schedule/8/paragraph/10 1988 c. 41 sch. 8 para. 10] | See on the published site [http://www.legislation.gov.uk/ukpga/1988/41/schedule/8/paragraph/10 1988 c. 41 sch. 8 para. 10] | ||
− | + | --> | |
+ | <br> | ||
<br> | <br> | ||
− | + | 2. Remember to move the opening square bracket if you substituted a provision or a sub-provision | |
If you substituted a <strong>whole provision</strong>, the opening bracket for the substitution will automatically be positioned within the <code>ukl:Pnumber</code> tag before the first sub-provision number inside the <code>ukl:P1para</code> tagging. You need to adjust the position of the opening bracket to include the provision number by moving (by clicking on the tag and dragging it) the opening <code>ukl:Substitution</code> tag to just before the provision number within the <code>ukl:Pnumber</code> of the provision. If your substitution also included the provision heading, you need to adjust the position of the opening bracket to include that, e.g. | If you substituted a <strong>whole provision</strong>, the opening bracket for the substitution will automatically be positioned within the <code>ukl:Pnumber</code> tag before the first sub-provision number inside the <code>ukl:P1para</code> tagging. You need to adjust the position of the opening bracket to include the provision number by moving (by clicking on the tag and dragging it) the opening <code>ukl:Substitution</code> tag to just before the provision number within the <code>ukl:Pnumber</code> of the provision. If your substitution also included the provision heading, you need to adjust the position of the opening bracket to include that, e.g. | ||
Line 600: | Line 602: | ||
<br> | <br> | ||
<br> | <br> | ||
− | Remember to <strong>check that the extent of your substituted provision</strong> is correct. If the RestrictExtent attribute is blank, the provision will inherit the extent of the parent into which it has been substituted so you need to check that this is correct. See more on the [[Editorial_Update/XMetaL_and_XML_tagging#RestrictExtent_Attribute|RestrictExtent Attribute]]. | + | 3. Remember to <strong>check that the extent of your substituted provision</strong> is correct. If the RestrictExtent attribute is blank, the provision will inherit the extent of the parent into which it has been substituted so you need to check that this is correct. See more on the [[Editorial_Update/XMetaL_and_XML_tagging#RestrictExtent_Attribute|RestrictExtent Attribute]].</li> |
<!--*If your substitution includes any <strong>power-conferring provisions</strong> (marked in TOEs Comments for Editor as "Contains power"), you will need to set the ConfersPower attribute to "true" for those provisions. See more on the [[Editorial_Update/XMetaL_and_XML_tagging#ConfersPower_Attribute|ConfersPowerAttribute]]. | <!--*If your substitution includes any <strong>power-conferring provisions</strong> (marked in TOEs Comments for Editor as "Contains power"), you will need to set the ConfersPower attribute to "true" for those provisions. See more on the [[Editorial_Update/XMetaL_and_XML_tagging#ConfersPower_Attribute|ConfersPowerAttribute]]. | ||
*Look out for and remove any Non Breaking Space Characters that may have been added to the amended provision by your substitution. See more on [[Editorial_Update/Approach_to_Update_-_Some_Basic_Rules_and_Exceptions#Non_Breaking_Space_Characters|Non Breaking Space Characters]]. | *Look out for and remove any Non Breaking Space Characters that may have been added to the amended provision by your substitution. See more on [[Editorial_Update/Approach_to_Update_-_Some_Basic_Rules_and_Exceptions#Non_Breaking_Space_Characters|Non Breaking Space Characters]]. | ||
Line 608: | Line 610: | ||
<br> | <br> | ||
<br> | <br> | ||
− | Once you are satisfied that the amendment is correct and complete, select <strong>Legislation - Check In</strong> on the menu bar at the top of the page: | + | 4. Once you are satisfied that the amendment is correct and complete, select <strong>Legislation - Check In</strong> on the menu bar at the top of the page: |
<br> | <br> | ||
<br> | <br> | ||
Line 616: | Line 618: | ||
</li> | </li> | ||
<br> | <br> | ||
− | Click <strong>OK</strong> in the pop-up [[File:Document_is_checked_in_successfully.png|link=]] | + | 5. Click <strong>OK</strong> in the pop-up [[File:Document_is_checked_in_successfully.png|link=]] |
<br> | <br> | ||
<br> | <br> | ||
− | Close the <strong>amending provision</strong> window and go back to the Editorial Site to check the amendment in [[Editorial_Update/Textual_Amendments/Substitutions/Provision_Level_Substitutions#Preview_the_amendment_from_the_Update_Details_page|Step Four]] (leaving XMetaL open if you have more update to do after this amendment). | + | 6. Close the <strong>amending provision</strong> window and go back to the Editorial Site to check the amendment in [[Editorial_Update/Textual_Amendments/Substitutions/Provision_Level_Substitutions#Preview_the_amendment_from_the_Update_Details_page|Step Four]] (leaving XMetaL open if you have more update to do after this amendment). |
|} | |} | ||
Revision as of 10:58, 29 February 2024
OVERVIEW
Substitution of words
Whole extent - wholly in force
https://www.legislation.gov.uk/uksi/2020/1045/regulation/3/2021-03-29
How to carry out a substitution of words |
Whole extent - partially in force
See retained text substitution of words in 2014 c. 12, Sch. 8 para 3(2).
Note: The first set of words in brackets is the retained text and the second set of words is the substituted text (for specified purposes).
How to carry out a substitution of words |
Limited extent - wholly in force
https://www.legislation.gov.uk/ukpga/2009/23/section/85/2015-03-12
Note: The first set of words is the original text that has been retained and the second set of words is the substituted text for E.W. only.
How to carry out a substitution of words |
Substitution of a provision or sub-provision
Whole extent - wholly in force
https://www.legislation.gov.uk/ukpga/2009/1/section/8
How to carry out the substitution of a provision or sub-provision |
Whole extent - partially in force
https://www.legislation.gov.uk/uksi/2010/2214/regulation/23/2013-01-09
How to carry out the substitution of a provision or sub-provision |
Limited extent - wholly in force
Limited extent substitution of a sub-provision
S. 33(3) substituted (E.W.) (9.2.2009) by Local Transport Act 2008 (c. 26), s. 134(4), Sch. 4 para. 59(2); S.I. 2009/107, art. 2(1), Sch. 1 Pt. 1
Note: For limited extent whole provision substitutions, it may not be possible to carry out a limited extent amendment without creating concurrent versions. Speak to a Review Editor for advice in this situation.
How to carry out the substitution of a provision or sub-provision |
IN MORE DETAIL
Important considerations
Before you commit yourself to carrying out your amendment, make sure that you have considered all the factors that will influence how you carry it out.
The effects spreadsheet that you download at the start of the update task contains all the information that was recorded for the effect you are applying. You should check the TOES data for your amendment before you start. In particular, check the Comments for Editor to see if there is anything unusual about the effect that you need to be aware of, or if the amendment text contains power. Also look at the commencement details of the affecting document and look at the affecting provision itself.
Questions to consider:
Is the effect wholly in force or partially in force? Is it whole or limited extent? Has your affecting provision itself been amended by an amendment to earlier affecting provision effect? Is there an appended commentary for the effect? Is your effect a knock-on effect? Does your inserted text contain power? Are there any savings or transitional provisions?
The answers to these questions will inform how you carry out the amendment, whether you need to amend any of the attributes of the provision you are amending, also what the annotation that the Editorial System generates will look like and whether there are any amendments you might need to make to this annotation.
Use the Update Editor Checklist to make sure that you have researched everything you need to before you carry out your amendment and refer back to it throughout the task, particularly when you check the amendment in XMetaL and preview your amendment.
The following pages also give useful guidance that will help if you are not sure how carry out your amendment:
Limited extent amendments
The Editorial System flags possible limited extent amendments with the following message:
The extent of the affected and affecting provision is highlighted in red. You can also view the extent/TA in the effects spreadsheet that can be downloaded from the Starting Update Page.
To decide whether or not you need to make your amendment as a limited extent amendment, follow the decision-making process described in the Decision tree for deciding what is a limited extent amendment on the Limited Extent Amendments page, where you may also need to consider creating a concurrent version of the provision.
If, after making all the considerations outlined above, you decide that the amendment is indeed a limited extent amendment, when you get to Step Two, follow the method outlined in Step Two – limited extent (the other steps remain the same).
Partially in force amendments
Amendments are not always brought wholly into force at once, frequently they are brought into force gradually over two or more points in time (PiTs). This is described in more detail in the section on Partially in force amendments on the Applying partially in force amendments which are then brought further into force over time page.
If an amendment has been brought into force for specified purposes only, the commencement “for specified purposes” will get added after the in force date when the annotation is generated.
See the examples in the Overview: Insertion of words - whole extent - partially in force and Insertion of a sub-provision - whole extent - partially in force.
To read more about how partially in force amendments get brought further into force over time, see What happens when an amendment comes further, or fully into force?.
Qualifications to the type of effect
Note that an amendment can be wholly in force but made for specified purposes only, in which case the existing text will also need to be retained when you carry out the substitution, and the qualification “for specified purposes” will appear after the type of effect in the annotation when the substitution is carried out. For example:
Words in reg. 11(3) substituted for specified purposes (31.12.2020) by The Direct Payments to Farmers and Rural Affairs (Miscellaneous Amendments etc.) (Wales) (EU Exit) Regulations 2020 (S.I. 2020/1556), regs. 1(2)(a), 12(5)
Update process
In these instructions, the update process has been broken down into four steps, Steps 1-3 are carried out in XMetaL and Step 4 on the Editorial site after check-in. Steps 1 and 2 are explained separately for insertions of words and sub-provisions (and Step 2 is further subdivided into whole extent (wholly in force or partially in force) and limited extent). The checks made in Steps 3 and 4 are the same, whichever route you take to get there.
Carrying out and checking the amendment in XMetaL:
Step One - preparing to carry out the amendment in XMetaL
Step Two - selecting the correct XMetaL Legislation menu option to carry out the amendment
Step Three - checking the amendment in XMetaL
Checking the amendment in the Editorial System:
Step Four - preview the amendment from the Update Details page
Things to remember
The Specific Update Issues guidance includes some general Editorial Update reminders to be aware of before you carry out your amendment. Also included is information on how amendments are presented. Note, in particular, the details of tagging that may need to be removed from amendment text, to prevent formatting errors.
See also the advice on how to approach more unusual types of amendment, and Approach to Update - Some Basic Rules and Exceptions.
Carrying out a substitution of words in XMetaL
The amendment of the data is carried out in XMetaL and the instructions that follow assume that you have checked out the relevant provision that is to be amended, that you have set up your XMetaL workspace, and that you are now ready to carry out the amendment. For guidance on the steps required to reach this point, see Starting Update Tasks.
Notes:
- When you are substituting words, any commentary reference included in the existing text you highlight will be removed automatically when the text is substituted, and if this commentary reference relates to a single annotation then that annotation will also be removed automatically on check-in.
- Occasionally there may be multiple substitutions of the same words throughout a provision. As long as the same task in the Resource Manager window is highlighted on each occasion, it is possible to carry out the same substitution of words and generate the same commentary reference (linking to the same annotation) each time, without any unnecessary new footnote references or annotations also being created.
Step One
|
Whole substitution
Step Two - whole extent and wholly in force substitution of words
On the menu bar at the top of the page select Legislation - Textual Amendments - Substitution. This will:
Words in sch. 1 substituted (28.11.2018) by The Budget (Scotland) Act 2018 Amendment Regulations 2018 (S.S.I. 2018/363), regs. 1(1), 3(2)(d)(i)
Your next task will be to check the amendment in XMetaL (Step Three), followed by the final task of previewing the amendment from the Update Details page (Step Four). |
Limited extent substitution
Step Two - limited extent substitution of words
On the menu bar at the top of the page select Legislation - Textual Amendments - Limited Extent Substitution. In the pop-up XMetaL Author Essential, check the Extent entered is correct and click OK. This will:
Words in Sch. 1 para. 6 substituted (E.W.) (1.1.2017) by The Environmental Permitting (England and Wales) Regulations 2016 (S.I. 2016/1154), reg. 1(1), Sch. 29 Pt. 1 para. 20(b) (with regs. 1(3), 77-79, Sch. 4)
Your next task will be to check the amendment in XMetaL (Step Three), followed by the final task of previewing the amendment from the Update Details page (Step Four). |
See the Overview for an example of a limited extent substitution of words. Further reading on limited extent amendments can be found here.
WARNING: There is a bug in the limited extent amendment code that means that limited extent amendments to headings results in false E-notes being created - look out for this and remove any false E-notes. |
Retained text substitution
If your amendment is not ‘wholly in force’ and has a different type of In Force Date Qualification, e.g. ‘for specified purposes’, or the effect itself is qualified in some way e.g. ‘substituted for specified purposes’, you may need to carry out a retained text substitution to make sure that the existing word or words are retained alongside the newly substituted word or words.
For further guidance on retaining text for partially in force amendments see partially in force amendments. Check with a Review Editor if the amendment is not straightforward and you are not sure whether to retain text or not.
Step Two - retained text substitution of words
On the menu bar at the top of the page click Legislation - Textual Amendments - Substitution Retain Text. This will:
Words in Sch. 7 para. 5(7) substituted (31.1.2017 for specified purposes) by Policing and Crime Act 2017 (c. 3), s. 183(1)(5)(e), Sch. 2 para. 122(3)
Your next task will be to check the amendment in XMetaL (Step Three), followed by the final task of previewing the amendment from the Update Details page (Step Four). |
See the Overview for an example of a substitution of words for specified purposes.
See Applying partially in force amendments which are then brought further into force over time for more details about substitutions that are brought further into force over time where text may need to be retained.
Carrying out the substitution of a provision or sub-provision in XMetaL
If your substitution involves unequal substitution of whole provisions, you should follow the instructions in Higher Level Substitutions, as you will need to have checked out the parent level of the provision.
The amendment of the data is carried out in XMetaL and the instructions that follow assume that you have checked out the relevant provision that is to be amended, that you have set up your XMetaL workspace, and that you are now ready to carry out the amendment. For guidance on the steps required to reach this point, see Starting Update Tasks.
Step One
|
Whole substitution
Step Two - whole extent and wholly in force substitution of a sub-provision
On the menu bar at the top of the page select Legislation - Textual Amendments - Substitution. This will:
S. 5(3) substituted (1.3.2004) by Health and Education Act 2003 (c. 90), s. 130, Sch. 18 para. 8
Your next task will be to check the amendment in XMetaL (Step Three), followed by the final task of previewing the amendment from the Update Details page (Step Four). |
Limited extent substitution
For limited extent whole provision substitutions, it may not be possible to carry out a limited extent amendment without creating concurrent versions. You should follow the guidance on the Limited Extent amendments page on deciding whether to create a concurrent version.
If you do need to carry out a limited extent substitution of a whole provision and you are not creating a concurrent version, it is possible to do a limited extent substitution of <ukl:P1para>
tags and display both versions within the same provision, see an example here:
https://www.legislation.gov.uk/ukpga/1985/50/section/1/2023-02-06
WARNING: You should not try to substitute at <ukl:P1> or <ukl:P1group> tagging levels because this is the level that contains the identifiers and other attributes. You should also not attempt to create multiple versions of a whole provision, by inserting the substituted version as a new provision, as this will cause update errors.
|
For a limited extent substitution of a sub-provision that doesn't require the creation of a concurrent version, you can carry out a limited extent substitution having selected the relevant <ukl:P2>
or <ukl:P3>
tagging (as described in Step One above, although note this is slightly different to the
description in Step One where <ukl:P#para>
tags are selected for whole extent and wholly in force substitutions of sub-provisions. Note that if you were to carry out a limited extent sub-provision substitution on the <ukl:P#para>
tags, you would also need to create the <ukl:P#>
tagging for the substituted version after carrying out the substitution).
Once you have selected the relevant <ukl:P2>
or <ukl:P3>
tagging and copied it, proceed as follows:
Step Two - limited extent substitution of a sub-provision
On the menu bar at the top of the page select Legislation - Textual Amendments - Limited Extent Substitution. In the pop-up 'XMetaL Author Essential', check the Extent entered is correct and click OK, e.g.:
Reg. 33(1) substituted (E.W.S.) (9.2.2009) by Local Transport Act 2008 (c. 26), s. 134(4), Sch. 4 para. 59(2); S.I. 2009/107, art. 2(1), Sch. 1 Pt. 1
Your next task will be to check the amendment in XMetaL (Step Three), followed by the final task of previewing the amendment from the Update Details page (Step Four). |
See the Overview for an example of a limited extent substitution of a sub-provision and further reading on limited extent amendments can be found here.
Retained text substitution
If your amendment is not ‘wholly in force’ and has a different type of In Force Date Qualification, e.g. ‘for specified purposes’, or the effect itself is qualified in some way, e.g. ‘substituted for specified purposes’ you may need to consider carrying out a retained text substitution so that the existing provision/sub-provision is retained alongside the newly substituted provision/sub-provision; however this is not always straightforward and may not always be possible, so check with a Review Editor if you are not sure. For further guidance on retaining text for partially in force amendments see Applying partially in force amendments which are then brought further into force over time - Partially in force amendments.
See an example of a retained text whole provision substitution here: https://www.legislation.gov.uk/uksi/2010/2214/regulation/23/2013-01-09.
For a retained text substitution of a sub-provision, you can carry out a limited extent substitution having selected the relevant <ukl:P2> or <ukl:P3> tagging (as described in Step One above, although note this is slightly different to the description in Step One where <ukl:P#para> tags are selected for whole extent and wholly in force substitutions of sub-provisions. Note that if you were to carry out a limited extent sub-provision substitution on the <ukl:P#para> tags, you would also need to create the <ukl:P#> tagging for the substituted version after carrying out the substitution).
Step Two - retained text substitution of a sub-provision
On the menu bar at the top of the page click Legislation - Textual Amendments - Substitution Retain Text. The Editorial System will automatically retain the existing
Sch. 8 para. 33(1) substituted (31.1.2017 for specified purposes) by Policing and Crime Act 2017 (c. 3), ss. 163(3), 183(1)(5)(e)
Your next task will be to check the amendment in XMetaL (Step Three), followed by the final task of previewing the amendment from the Update Details page (Step Four). |
Check the amendment in XMetaL
Step Three
If you substituted a whole provision, the opening bracket for the substitution will automatically be positioned within the Original location of
4. Once you are satisfied that the amendment is correct and complete, select Legislation - Check In on the menu bar at the top of the page: ![]() 5. Click OK in the pop-up ![]() 6. Close the amending provision window and go back to the Editorial Site to check the amendment in Step Four (leaving XMetaL open if you have more update to do after this amendment). |
Preview the amendment from the Update Details page
Step Four
|
SCENARIOS
See also Specific Update Issues.
Unequal substitution of sub-provisions
If your substitution involves unequal substitution of whole provisions, you should follow the instructions on the Higher Level Substitutions page, as you will need to have checked out the parent level of the provision.
More for less
More for less sub-provision substitutions occur when the substitution results in more sub-provisions than there were previously, such as new sub-provisions (a)-(c) in place of the existing (a) sub-provision.
To carry out this type of amendment, substitute the existing sub-provision in the amended provision with the new version from the amending provision. Then, copy and paste the new subs-provisions from the amending provision after the newly substituted sub-provision in the amended provision. Finally, in the amended sub-provision select the closing </ukl:Substitution>
tag which sits before the closing <ukl:text>
tag and cut and paste (or drag) it so it sits just before the closing </ukl:text>
tag of the last new sub-provision.
Less for more
Less for more sub-provision substitutions occur when the substitution results in fewer sub-provisions than there were previously, such as a new sub-provision (a) substituted in place of the amended provision’s existing (a)-(c) sub-provisions.
To carry out this type of amendment, substitute in the new sub-provision which has the same number/letter as the existing sub-provision. Then, for the sub-provision(s) which are to be substituted out, delete the sub-provision <ukl:P2>
, <ukl:P3>
or <ukl:P4>
tagging (which will completely remove the sub-provision(s)).
Note: This method differs from the whole provision level 'less for more' substitution method, which repeals the provisions to be substituted out, leaving the provision number and a dotted line.
Example of a less for more substitution of a sub-provision
Amendment: 2004 c. 33, Sch. 2 para. 15(1)(c) substituted for Sch. 2 para. 15(1)(b)(c) by 2013 c. 2, Sch. 11 para. 168(2)(b)
Instructions: Carry out substitution of para. 15(1)(c) and then delete the <P3>
tagging for para. 15(1)(b) so that sub-paragraph (b) is completely removed.
Result: See 2004 c. 33, Sch. 2 para. 15(1)
Sub-provisions substituted for words
Amendment: 2008 c. 17, s. 178(3)(a)(b) substituted for words by 2011 c. 20, Sch. 19 para. 54
Instructions: In XMetaL, using the Element List, two sets of empty ukl:P3
tagging, i.e.
ukl:P3
ukl:Pnumber
/ukl:Pnumber
ukl:P3para
ukl:Text
/ukl:Text
/ukl:P3para
/ukl:P3
were inserted within the existing ukl:P2
tagging of s. 178(3) and the text for these sub-provisions was copied from the amending provision into the empty ukl:Text
tagging for sub-paragraphs (a) and (b). To generate the square brackets and the annotation for this amendment, the words "to the HCA." were substituted with the em dash from the amending provision using the relevant substitution task in the Resource Manager. The closing square bracket was then moved to the end of the text in sub-paragraph (b).
Result: See 2008 c. 17, s. 178
RELATED PAGES
- Applying partially in force amendments which are then brought further into force over time
- Higher Level Substitutions
- Limited extent amendments
- Lists
- Images
- Manual Amendments
- Tables
- XMetaL and XML tagging
Approach, errors and troubleshooting: