{"type":"doc","content":[{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Remove Statement Summary","type":"text"}]},{"type":"paragraph","content":[{"text":"Remove","type":"text","marks":[{"type":"strong"}]},{"text":" is a terminal, refactoring statement that occurs only with a ","type":"text"},{"text":"Refactor","type":"text","marks":[{"type":"strong"}]},{"text":" statement. It prevents a component from being authored. For components other than subprograms, removing them involves simply not declaring them in the target code. For subprograms, they can either not be declared or they can be stubbed out --.i.e., declared but no procedural code authored. The problem with not declaring components is that their references in the procedural code must be dealt with as well. The bulk of the attributes associated with this statement deal with the issue of replacing references to the undeclared components. In some cases, the comments associated with (i.e. preceding) the removed declaration are also removed.","type":"text"}]},{"type":"paragraph","content":[{"text":"The attributes of the ","type":"text"},{"text":"Remove","type":"text","marks":[{"type":"strong"}]},{"text":" statement are as follows:","type":"text"}]},{"type":"table","attrs":{"layout":"default","localId":"40d0abc1-fc49-472f-a228-ea4fdd015936"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[149.0]},"content":[{"type":"paragraph","content":[{"text":"Attribute ","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1009.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[149.0]},"content":[{"type":"paragraph","content":[{"text":"Identifier","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1009.0]},"content":[{"type":"paragraph","content":[{"text":"This required identifier attributes specifies the component to be removed. If the containing ","type":"text"},{"text":"Refactor","type":"text","marks":[{"type":"strong"}]},{"text":" statement had a ","type":"text"},{"text":"FileFilter","type":"text","marks":[{"type":"strong"}]},{"text":" specified then this identifier should be specified relative to it; else, it should be specified relative to the root of the symbol table.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[149.0]},"content":[{"type":"paragraph","content":[{"text":"MigPattern","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1009.0]},"content":[{"type":"paragraph","content":[{"text":"This optional string attribute contains a pattern string that will be used as a substitute for a reference to the component. Any arguments that reference might require have to be accounted for in the pattern string. See the ","type":"text"},{"text":"Patterns","type":"text","marks":[{"type":"strong"}]},{"text":" page for details.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[149.0]},"content":[{"type":"paragraph","content":[{"text":"MigStatus","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1009.0]},"content":[{"type":"paragraph","content":[{"text":"This optional attribute is one of the entries -- ","type":"text"},{"text":"Notimplemented","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"Delete","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"Stubout","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"Conditional","type":"text","marks":[{"type":"strong"}]},{"text":", or a code event string.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[149.0]},"content":[{"type":"paragraph","content":[{"text":"KeepComments","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1009.0]},"content":[{"type":"paragraph","content":[{"text":"This optional boolean attribute indicates if comments preceding the declaration of the remove symbol should be retained or not. The default is to remove comments along with the declaration of the symbol. This attribute only applie when MigStatus=delete.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The script errors associated with the ","type":"text"},{"text":"Remove","type":"text","marks":[{"type":"strong"}]},{"text":" statement are as follows:","type":"text"}]},{"type":"paragraph"},{"type":"table","attrs":{"layout":"default","localId":"cbac7e0f-08a2-410c-9ea4-ebc27f4d5b3d"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Error ","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"1098","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"The identifier [%1d] could not be found.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"The ","type":"text"},{"text":"migStatus","type":"text","marks":[{"type":"strong"}]},{"text":" entries are used to control how remove declared components from the translation without causing build problems caused by references to those components. To demonstrate how these change the translations consider the demonstration code ","type":"text"},{"text":"fmstocks\\vb6\\FMStocks_DB\\FMStocks_DB.vbp","type":"text","marks":[{"type":"strong"}]},{"text":" from which a subprogram ","type":"text"},{"text":"DBHelper.collectParams","type":"text","marks":[{"type":"strong"}]},{"text":" and a declare ","type":"text"},{"text":"Helpers.RegisterEventSource","type":"text","marks":[{"type":"strong"}]},{"text":" will be removed with various migStatus settings. In the source, these are, showing a typical reference and the declaration","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"visualbasic"},"content":[{"text":"collectParams cmd, params\n ...\nPrivate Sub collectParams(ByRef cmd As ADODB.Command, ByVal argparams As Variant)\n Dim params As Variant, v As Variant\n Dim i As Integer, l As Integer, u As Integer\n ...\nEnd Sub\n\nhEventLog = RegisterEventSource(\"\", sEventTitle)\n ...\nDeclare Function RegisterEventSource Lib \"advapi32.dll\" Alias _\n \"RegisterEventSourceA\" (ByVal lpUNCServerName As String, _\n ByVal lpSourceName As String) As Long\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that the subprogram has a body that needs to be dealt with in the removal as well; while the declare does not. Looking at the default translations for these","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"csharp"},"content":[{"text":"collectParams(ref cmd,params_migname);\n ...\nprivate void collectParams(ref ADODB.Command cmd,object argparams)\n{\n object[][] params_migname = null;\n object v = null;\n ...\n}\n\nhEventLog = RegisterEventSource(\"\",sEventTitle);\n ...\n[DllImport(\"advapi32.dll\",EntryPoint=\"RegisterEventSourceA\")]\npublic static extern int RegisterEventSource(string lpUNCServerName,string lpSourceName);\n","type":"text"}]},{"type":"paragraph"},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Using Remove with no migStatus","type":"text"}]},{"type":"paragraph","content":[{"text":"Using the remove without any migStatus specification removes the indicated component from the translation without effecting any of the references to that component. Using this ","type":"text"},{"text":"Remove","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"causes the entire declaration for these components to be removed from the translation, but leaves statements like","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"c++"},"content":[{"text":"collectParams(ref cmd,params_migname);\n ...\nhEventLog = RegisterEventSource(\"\",sEventTitle);\n","type":"text"}]},{"type":"paragraph","content":[{"text":"in the translation, which means that it will not build. ","type":"text"},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Using Remove with Delete migStatus","type":"text"}]},{"type":"paragraph","content":[{"text":"Using the remove with the delete migStatus removes both the declarations for the components and also the references. Using this ","type":"text"},{"text":"Remove","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"completely removes the named components from the translation. ","type":"text"},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Using Remove with NotImplemented migStatus","type":"text"}]},{"type":"paragraph","content":[{"text":"Using the remove with the NotImplemented migstatus removes the declaration but comments out the references rather that removing them completely. Using this ","type":"text"},{"text":"Remove","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"removes the declarations as before but authors the references as can be see here","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"c++"},"content":[{"text":"// collectParams\n// collectParams(ref cmd,params_migname);\n ...\n// RegisterEventSource\n// hEventLog = Convert.ToString(RegisterEventSource(\"\",sEventTitle));\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Notice that each reference line is preceded by a comment documenting which component is causing the commenting out. ","type":"text"},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Using Remove with StubOut migStatus","type":"text"}]},{"type":"paragraph","content":[{"text":"As an alternative to removing the declaration, a stubbed version of that declaration can be authored instead. This has the advantage that this approach does not require that any references to the components be changed. Using this ","type":"text"},{"text":"Remove","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"the only difference between the original translation and the migrated one is","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"c++"},"content":[{"text":" public void collectParams(ref ADODB.Command cmd,object argparams)\n {\n }\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Notice that the Declared component does not change at all since it has no body to be stubbed. The ","type":"text"},{"text":"Remove","type":"text","marks":[{"type":"strong"}]},{"text":" statement accepts the specification, but it has no effect. ","type":"text"},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Using Remove with Conditional migStatus","type":"text"}]},{"type":"paragraph","content":[{"text":"From time to time we come across a subroutine that we plan to reauthor during the migration phase of the project. Frequently the subroutine is not translating well, perhaps because it depends on a lot of win32 APIS and the most productive approach is a reauthor. However, we want to defer the reauthoring task. Also Reauthoring almost always begins with the latest good translation of the code. Being able to get a current translation but also defer finishing it and changing it to a reauthor are somewhat at odds. Using the ","type":"text"},{"text":"Conditional","type":"text","marks":[{"type":"strong"}]},{"text":" migstatus is a way to get a current translation of a routine, but have the .NET compiler treat the resulting routine as a stub. Using this ","type":"text"},{"text":"Remove","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"causes the following simple change in the translation","type":"text"}]},{"type":"paragraph"},{"type":"codeBlock","attrs":{"language":"none"},"content":[{"text":"*** Refactored start of connectParams\n {\n // UPGRADE_INFO: conditional stub FMStocks_DB.DBHelper.collectParams\n #if mig_conditional_stub\n object[][] params_migname = null;\n*** Original start of connectParams\n {\n object[][] params_migname = null;\n\n\n*** Refactored end of connectParams\n #endif\n }\n*** Original start of connectParams\n }\n","type":"text"}]},{"type":"paragraph","content":[{"text":"The actual text associated with the start and end entries are in the ","type":"text"},{"text":"AuthorText.StartConditional","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"AuthorText.EndConditional","type":"text","marks":[{"type":"strong"}]},{"text":" methods in the language file, where they may be overridden on replaced. As in the ","type":"text"},{"text":"StubOut","type":"text","marks":[{"type":"strong"}]},{"text":", notice that the Declared component does not change at all since it has no body. The ","type":"text"},{"text":"Remove","type":"text","marks":[{"type":"strong"}]},{"text":" statement accepts the specification, but it has no effect.","type":"text"}]}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"panel","parameters":{"macroParams":{"bgColor":{"value":"CCFFFF"},"title":{"value":"Table of Contents"}},"macroMetadata":{"macroId":{"value":"6c1bfeb2-e0ef-4ed1-8769-e02725492651"},"schemaVersion":{"value":"1"},"title":"Panel"}},"localId":"c7e251fa-d362-46dd-bc27-0b2231abd43b"},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"2d62359c-6fc2-40e9-a787-35cfe20aff45"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"f33d67c0-a123-4d85-ae7f-61740441179d"}}]}]}]}],"version":1}

Browser not supported