English version draft

Assisted-by: Claude:claude-4.6-sonnet

Vivado Basics/08. Code processing errors.md

@@ -1,27 +1,27 @@
-# Руководство по работе с ошибками обработки кода
+# Guide to Handling Code Processing Errors
 
-Некоторые ошибки (например ошибки синтаксиса или иерархии) могут привести к тому, что САПР не сможет построить схему или запустить симуляцию.
+Some errors (such as syntax errors or hierarchy errors) may prevent the EDA tool from building the schematic or launching simulation.
 
-Без должного опыта, при подобных ошибках можно растеряться, т.к. всплывающие окна, сообщающие об этих ошибках малоинформативны (см. _рис. 1-2_).
+Without sufficient experience, these errors can be confusing, as the pop-up windows reporting them are not very informative (see _fig. 1–2_).
 
-Предположим, мы забыли поставить точку с запятой в конце одного из присваиваний, и попробовали запустить моделирование.
+Suppose we forgot to place a semicolon at the end of one of the assignments, and then tried to launch simulation.
 
-В результате, всплывающие окна, представленные на _рис. 1-2_.
+As a result, the pop-up windows shown in _fig. 1–2_ will appear.
 
 ![../.pic/Vivado%20Basics/08.%20Code%20processing%20errors/fig_01.png](../.pic/Vivado%20Basics/08.%20Code%20processing%20errors/fig_01.png)
 
-_Рисунок 1. Первое всплывающее окно при попытке запустить моделирование проекта с синтаксической ошибкой._
+_Figure 1. First pop-up window when attempting to launch simulation with a syntax error in the project._
 
 ![../.pic/Vivado%20Basics/08.%20Code%20processing%20errors/fig_02.png](../.pic/Vivado%20Basics/08.%20Code%20processing%20errors/fig_02.png)
 
-_Рисунок 2. Второе всплывающее окно при попытке запустить моделирование проекта с синтаксической ошибкой._
+_Figure 2. Second pop-up window when attempting to launch simulation with a syntax error in the project._
 
-Во втором окне есть кнопка `Open Messages View`. Нажмём её. Будет активировано окно сообщений, представленное на _рис. 3_.
+The second window contains an `Open Messages View` button. Click it. The messages window shown in _fig. 3_ will be activated.
 
 ![../.pic/Vivado%20Basics/08.%20Code%20processing%20errors/fig_03.png](../.pic/Vivado%20Basics/08.%20Code%20processing%20errors/fig_03.png)
 
-_Рисунок 3. Окно сообщений после неудачной попытки запуска симуляции._
+_Figure 3. Messages window after a failed attempt to launch simulation._
 
-Сообщения из раздела `Vivado commands` на _рис. 2_ дают мало информации. Однако здесь же есть критические предупреждения о синтаксической ошибке с возможностью перейти к строчке в файле, вызвавшей это предупреждение. Разумеется, не всегда САПР может сообщить доступным языком в чем именно ошибка, в данном случае, он просто обнаружил что ключевое слово `end` встретилось не там, где оно должно было бы быть (оно встретилось до завершения оператора присваивания, который должен был быть завершен символом `;`). В этом случае, вам необходимо самим разобраться в чем именно заключается ошибка (для этого вы можете кликнуть по гиперссылке в критическом предупреждении — откроется редактор с местом ошибки).
+The messages in the `Vivado commands` section in _fig. 2_ provide little information. However, there are also critical warnings about the syntax error, with a link to the line in the file that triggered the warning. Of course, the EDA tool cannot always clearly explain what the error is — in this case, it simply detected that the keyword `end` appeared in an unexpected location (it was encountered before the assignment operator was terminated with a `;`). In this situation, you need to figure out the exact nature of the error yourself (you can click the hyperlink in the critical warning to open the editor at the location of the error).
 
-Помните, что большая часть сообщений в данном окне сохраняется даже если ошибка будет исправлена, поэтому рекомендуется очищать окно сообщений, в случае если появились ошибки и уже сложно понять какие из них старые, а какие из них новые. Сделать это можно, нажав на иконку корзины в окне сообщений. При этом удалятся не все ошибки, а только те, которые были вызваны процессами, запущенными пользователем. К примеру, если очистить окно сообщений, не исправив указанную ошибку, пропадут только ошибки из раздела `Vivado commands`. Дело в том, что критические предупреждения появились не после того, как мы попытались запустить моделирования, а после того, как Vivado автоматически запустил инструменты анализа кода. Делает он это автоматически каждый раз, когда сохраняется файл. Эти ошибки пропадут только когда повторный анализ покажет, что они были исправлены.
+Keep in mind that most messages in this window persist even after the error is fixed, so it is recommended to clear the messages window when errors appear and it becomes difficult to distinguish old messages from new ones. This can be done by clicking the trash can icon in the messages window. Note that not all errors will be cleared — only those triggered by processes launched by the user. For example, if you clear the messages window without fixing the error, only the messages from the `Vivado commands` section will disappear. This is because the critical warnings appeared not when we attempted to launch simulation, but when Vivado automatically ran its code analysis tools. Vivado does this automatically every time a file is saved. These warnings will only disappear once a subsequent analysis confirms they have been resolved.