chore(i18n): finish translating code comments and scripts to English

Completes the English-only standardization for code, comments, scripts
and CI templates (UI/CLI-facing strings stay bilingual pt-BR/en,
untouched). Covers the remaining crates/, apps/gui/ui/ and
apps/gui/src-tauri/ comments, .gitea/ workflow and template comments,
.githooks/ hooks, and the scripts/ source comments for the files
already renamed in a prior commit (check.sh, generate-logo.py,
install-hooks.sh).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VAyr8d7HuAdUGB6aA5xmDD

crates/guara-core/src/vdisk/mod.rs

@@ -1,10 +1,10 @@
-//! Imagens de disco virtual e contêineres: QCOW2, VMDK, VHD, VHDX e DMG (UDIF).
+//! Virtual disk images and containers: QCOW2, VMDK, VHD, VHDX, and DMG (UDIF).
+//!
+//! Each format is opened read-only as a logical block device and plugs transparently into
+//! the standard pipeline (partitions, filesystems, encryption) via [`Source`]. Differencing
+//! disks (VHD/VHDX parent locators, QCOW2 backing files, VMDK parent chains) resolve reads
+//! up the backing chain to the base image.
 //!
-//! Cada formato é aberto como o disco que contém, somente para leitura, e entra na cadeia
-//! normal (partições, sistemas de arquivos, cifras) por meio de [`Source`]. Discos
-//! diferenciais (VHD e VHDX com pai, QCOW2 com arquivo de apoio, VMDK com pai) seguem a
-//! cadeia até o disco base. A identidade do pai (UUID, CID, data) não é conferida: se o pai foi
-//! alterado depois do filho, os dados lidos refletem o pai atual.
 
 mod dmg;
 mod qcow2;
@@ -36,21 +36,21 @@ pub(crate) fn le64(b: &[u8], o: usize) -> u64 {
     u64::from_le_bytes(b[o..o + 8].try_into().unwrap())
 }
 
-/// Leitura dentro de um único bloco do formato; devolve quantos bytes entregou (pode ser
-/// menos que `buf.len()`, nunca zero antes do fim do disco).
+/// Reads within a single format block/cluster; returns the number of bytes filled (may be
+/// less than `buf.len()`, but never `0` before the logical end of disk).
 pub(crate) trait Backend: Send + Sync {
     fn size(&self) -> u64;
     fn read_chunk(&self, voff: u64, buf: &mut [u8]) -> io::Result<usize>;
 }
 
-/// Disco virtual aberto de uma imagem de contêiner.
+/// Opened virtual disk backed by a container image.
 pub struct VDisk {
     inner: Box<dyn Backend>,
     format: &'static str,
 }
 
 impl VDisk {
-    /// Nome do formato (`QCOW2`, `VMDK`, `VHD`, `VHDX`, `DMG`).
+    /// Format label (`"QCOW2"`, `"VMDK"`, `"VHD"`, `"VHDX"`, `"DMG"`).
     pub fn format(&self) -> &'static str {
         self.format
     }
@@ -88,12 +88,12 @@ pub(crate) fn io_err(e: io::Error, what: &str) -> Error {
     Error::msg(format!("{what}: {e}"))
 }
 
-/// Cadeias de arquivos pai (VHD/VHDX diferenciais) não passam deste limite, o que também
-/// corta ciclos.
+/// Maximum parent/backing chain depth (prevents infinite loops on cyclic parent references).
+///
 const MAX_DEPTH: u32 = 16;
 
-/// Formato de contêiner reconhecido pelos primeiros bytes (e, para VHD fixo e DMG, pelo
-/// fim do arquivo). `None` quando é um disco bruto.
+/// Identifies a virtual disk container format from its leading bytes (and trailing footer
+/// for fixed VHD and DMG). Returns `None` for raw disk images.
 pub fn detect(file: &FileSource, head: &[u8]) -> Option<&'static str> {
     if head.starts_with(b"QFI\xfb") {
         return Some("QCOW2");
@@ -113,7 +113,7 @@ pub fn detect(file: &FileSource, head: &[u8]) -> Option<&'static str> {
     None
 }
 
-/// Abre `path` como disco virtual, ou `Ok(None)` se não for um contêiner conhecido.
+/// Opens `path` as a virtual disk, or returns `Ok(None)` if it is not a recognized container.
 pub fn open(path: &Path) -> Result<Option<VDisk>> {
     open_depth(path, 0)
 }
@@ -139,8 +139,8 @@ pub(crate) fn open_depth(path: &Path, depth: u32) -> Result<Option<VDisk>> {
     Ok(Some(VDisk { inner, format }))
 }
 
-/// Abre o disco pai (VHD/VHDX diferencial, QCOW2 com apoio, VMDK com pai). Com `raw`, o
-/// arquivo é tratado como disco bruto sem tentar reconhecer o formato.
+/// Opens a parent/backing image at `depth`. When `raw` is `true`, treats the backing file
+/// directly as a raw image without probing for a container header.
 pub(crate) fn open_parent(
     candidates: &[std::path::PathBuf],
     depth: u32,
@@ -170,7 +170,7 @@ pub(crate) fn open_parent(
     )))
 }
 
-/// Lê de um arquivo por posição e exige todos os bytes.
+/// Positional read helper that fills all of `buf` or returns `UnexpectedEof`.
 pub(crate) fn read_exact(f: &FileSource, off: u64, buf: &mut [u8]) -> io::Result<()> {
     crate::source::read_exact_at(f, off, buf)
 }
@@ -181,7 +181,7 @@ pub(crate) fn read_vec(f: &FileSource, off: u64, len: usize) -> io::Result<Vec<u
     Ok(v)
 }
 
-/// Tabelas em memória têm teto: um cabeçalho adulterado não pode pedir gigabytes.
+/// Upper bound on in-memory allocation tables so a corrupted header cannot trigger multi-GB allocations.
 pub(crate) fn check_table(entries: u64, entry_size: u64, what: &str) -> io::Result<usize> {
     const MAX: u64 = 512 * 1024 * 1024;
     if entries.saturating_mul(entry_size) > MAX {
@@ -190,7 +190,7 @@ pub(crate) fn check_table(entries: u64, entry_size: u64, what: &str) -> io::Resu
     Ok(entries as usize)
 }
 
-/// UTF-16 (big ou little endian) até o primeiro nulo.
+/// Decodes UTF-16 (BE or LE) up to the first NUL code unit.
 pub(crate) fn utf16(b: &[u8], big: bool) -> String {
     let units: Vec<u16> = b
         .chunks_exact(2)
@@ -200,8 +200,8 @@ pub(crate) fn utf16(b: &[u8], big: bool) -> String {
     String::from_utf16_lossy(&units)
 }
 
-/// Caminhos onde procurar o disco pai: o caminho gravado (relativo ao arquivo filho, com `\`
-/// virando `/`) e, como alternativa, só o nome do arquivo na mesma pasta.
+/// Candidate paths for locating a parent/backing disk: relative to the child image's directory
+/// (normalizing `\` to `/`), falling back to the basename in the same directory.
 pub(crate) fn candidate_paths(dir: &Path, names: &[String]) -> Vec<std::path::PathBuf> {
     let mut out: Vec<std::path::PathBuf> = vec![];
     for n in names {
@@ -228,7 +228,7 @@ pub(crate) fn candidate_paths(dir: &Path, names: &[String]) -> Vec<std::path::Pa
     out
 }
 
-/// Lê do disco pai (ou zeros, sem pai); o que o pai não cobre também é zero.
+/// Reads from the parent disk (or fills zeros if there is no parent or `off` is past parent EOF).
 pub(crate) fn read_parent(
     parent: &Option<Box<dyn Source>>,
     voff: u64,