memcpy

PROGRESO.md

@@ -2,8 +2,10 @@
 
 ## Estado actual
 
-- **Fase 2** — Buffer dinámico. (Fase 1 cerrada en Fedora; falta probar en Windows.)
-- Paso actual: 2.2, escpos_buffer_append_byte con realloc y duplicado de capacidad.
+- **Fase 2**: buffer dinámico. La Fase 1 está cerrada en Fedora, pero falta
+  probarla en Windows.
+- Paso actual: 2.3b, `escpos_buffer_append` (varios bytes: puntero `const` +
+  cantidad + `memcpy`). El 2.3a ya está hecho: `buffer_reserve`, `static`, `t` en `nm`.
 - Entorno activo: Fedora 42 nativo (gcc 15.2, clang 20, make 4.4, gdb 17,
   valgrind 3.26).
 
@@ -13,27 +15,73 @@
   la usa. Compila y enlaza a mano en Windows y en Fedora.
 - `samples/hello_world.bin`: ESC @, texto, LF, ESC d 5, GS V 0.
 - Emulador ESC/POS en Go (`emulator/`) para probar sin gastar papel.
+- Makefile con regla patrón, `clean` y `.PHONY`. Compila desde un clon limpio y
+  sin avisos con gcc y con clang.
+- 2.1: `escpos_buffer_new` / `escpos_buffer_free` con tipo opaco. Valgrind
+  limpio, y fuga provocada a propósito para leer el informe.
+- 2.2: `escpos_buffer_append_byte` con `realloc`: 64 bytes al principio, luego
+  el doble. Comprobado con 100 bytes (crece de 64 a 128). Valgrind limpio.
+  Sin el `free`, Valgrind da 24 `definitely` + 128 `indirectly`.
+- 2.3a: crecimiento extraído a `static int buffer_reserve(buffer, min_cap)`:
+  arranca en 64 o en `cap` y dobla hasta que cabe; un único `realloc`.
 
 ## Conceptos de C aprendidos
 
 - Etapas de compilación, unidades de traducción, cabeceras, *include guards*,
   `static` para encapsular, `nm` y errores del enlazador.
-- Cadenas terminadas en `'\0'`, `const char *`.
-- Memoria virtual de un proceso, modo usuario y modo núcleo.
-- Make: reglas, dependencias por fechas, variables, regla patrón con $@ $< $^, .PHONY.
-- Pila y montón, malloc/free, NULL, propiedad de punteros, tipo opaco, typedef, `->`, uint8_t/size_t, Valgrind.
+- Cadenas terminadas en `'\0'`, `const char *`, `'A'` frente a `"A"`.
+- Memoria virtual de un proceso, modo usuario y modo núcleo. `VmSize` frente a
+  `VmRSS`, *overcommit* y OOM killer.
+- Make: reglas, dependencias por fechas, variables, regla patrón con
+  `$@ $< $^`, `.PHONY`.
+- Pila y montón, `malloc`/`free`/`realloc`, `NULL`, propiedad de punteros,
+  tipo opaco, `typedef`, `->`, `uint8_t`/`size_t`, qué tipo usar.
+- Depuración: *segfault* (139), `free(): invalid pointer` (134), gdb básico,
+  y leer errores e informes de fugas en Valgrind.
+
+## Forma de trabajar
+
+- Desde el 2026-10-02: sin *vibecoding*. Enunciado y pruebas, predicción antes
+  de compilar, y pistas por niveles solo si las pide. Ante un error, primero su
+  diagnóstico.
 
 ## Decisiones de diseño
 
 - Prefijo `escpos_` para toda la API pública.
-- `escpos_buffer` es un tipo opaco: declarado en `escpos.h`, definido en `src/buffer.c`. Campos `uint8_t *data`, `size_t len`, `size_t cap`.
-- Estilo: nombres en `snake_case` y llave de apertura en línea aparte (estilo Allman) en funciones, structs y bloques. Aplicarlo a todo el proyecto, también a `escpos.c`.
-- Lo generado va en `build/`, que se crea en las recetas con `mkdir -p` y no se versiona.
+- `escpos_buffer` es un tipo opaco: declarado en `escpos.h` y definido en
+  `src/buffer.c`. Campos `uint8_t *data`, `size_t len` y `size_t cap`.
+- Crecimiento del buffer: 64 bytes al principio y luego el doble.
+- Por ahora, las funciones que pueden fallar devuelven `int`: `0` si va bien y
+  `-1` si no hay memoria. Pendiente de cambiar a códigos de error propios.
+- Estilo: nombres en `snake_case` y llave de apertura en línea aparte (estilo
+  Allman) en funciones, structs y bloques.
+- Lo generado va en `build/`, que se crea en las recetas con `mkdir -p` y no se
+  versiona.
 
 ## Pendiente / puntos débiles
 
-- `.gitignore` creado. Siguen versionados `emulator/escpos-emu.exe` y `goruntime/goruntime.exe`.
-- Ficheros sin salto de línea final: corregido; editor configurado.
-- Make: costó entender que va hacia atrás desde el objetivo, y que una regla patrón es una plantilla. Repasar con la sección de docs/06-make.md.
-- Punteros: le cuesta saber cuándo hace falta `*` y cuándo no (también le pasaba en Go). Reforzar con ejemplos de su propio código.
+- Fase 1: probar el Makefile en Windows (MSYS2), con el sufijo `.exe`.
+- `.gitignore` creado. Siguen versionados `emulator/escpos-emu.exe` y
+  `goruntime/goruntime.exe`.
+- Make: le costó entender que va hacia atrás desde el objetivo y que una regla
+  patrón es una plantilla. Repasar con `docs/06-make.md`.
+- Punteros: le cuesta saber cuándo hace falta `*` y cuándo no, y distinguir la
+  dirección del bloque (`data`) de una casilla (`data[i]`). Le funciona la
+  analogía de papel y casa. Reforzar con ejemplos de su propio código.
+- Tipos: usó `uint8_t` para un código de retorno. Repasar la tabla "Qué tipo
+  usar" de `docs/08-structs.md`.
+- Valorar añadir `-Wconversion` a `CFLAGS`: detecta conversiones con pérdida
+  que gcc no avisa por defecto.
+- Bucles: en `buffer_reserve` calculaba cada vuelta a partir de un valor que no
+  cambiaba (`buffer->cap`) o que empezaba en 0, y eso daba bucles infinitos.
+  Lo resolvió siguiendo los valores vuelta a vuelta. Seguir pidiéndole trazas
+  a mano.
 - Impresoras físicas: sin registrar marca y modelo.
+- Confunde puntero colgante ("se pierde") con fuga. Tampoco tenía claro por qué
+  el slice viejo es seguro en Go tras `append` (el GC no libera el array viejo,
+  no es por la copia). Repasar con la tabla de docs/07-dynamic-memory.md.
+
+## Otros
+
+- `goescpos/`: equivalente en Go idiomático (`bytes.Buffer`) de lo hecho hasta
+  ahora, para comparar.