updates

docs/cheatsheet.md

@@ -0,0 +1,71 @@
+# Chuleta de comandos
+
+Comandos que hemos usado, agrupados por tarea. Los flags del proyecto son
+`-std=c17 -Wall -Wextra -Wpedantic -g`.
+
+## Compilar paso a paso
+
+| Comando | Qué hace |
+|---|---|
+| `gcc -E -Iinclude src/escpos.c -o build/escpos.i` | Solo preprocesa. Genera el `.i`: C con los `.h` pegados. |
+| `gcc -S ...` | Para después de compilar. Genera el `.s` (ensamblador). |
+| `gcc <flags> -Iinclude -c src/escpos.c -o build/escpos.o` | Compila hasta el `.o` (fichero objeto), sin enlazar. |
+| `gcc <flags> -c build/escpos.i -o build/escpos.o` | Compila partiendo de un `.i`. No hace falta `-I`. |
+| `gcc <flags> -Iinclude -save-temps -c src/escpos.c` | Cadena completa, conservando `.i`, `.s` y `.o`. |
+| `gcc build/hello.o build/escpos.o -o build/hello` | Enlaza los `.o` en un ejecutable. |
+| `./build/hello` | Ejecuta un programa de la carpeta actual. |
+
+Si juntas dos flags de parada (`-E -S`), gana la que para antes.
+
+## Inspeccionar ficheros
+
+| Comando | Qué hace |
+|---|---|
+| `nm build/hello.o` | Lista símbolos: `T` definido y visible, `t` definido y `static`, `U` usado pero definido en otro sitio. |
+| `wc -l fichero` | Cuenta líneas (por ejemplo, para comparar `.c` y `.i`). |
+| `ls -l build/` | Muestra la fecha de modificación: sirve para ver qué `.o` está obsoleto. |
+| `file fichero` | Dice qué es: ELF (Linux), COFF o PE (Windows)... |
+| `strings fichero.o` | Muestra las cadenas legibles que hay dentro de un binario. |
+| `objdump -d fichero.o` | Desensambla el código máquina. |
+| `objdump --dwarf=info fichero.o` | Muestra la información de depuración que añade `-g`. |
+| `xxd fichero.bin` | Volcado hexadecimal (para revisar los bytes ESC/POS). |
+| `tail -c 5 fichero \| xxd` | Muestra los últimos bytes: sirve para ver si el fichero acaba en `0a` (`\n`). |
+| `echo $?` | Código de salida del último comando: `0` es éxito. |
+
+## Solo en Windows (MSYS2)
+
+| Comando | Qué hace |
+|---|---|
+| `objdump -p hello.exe \| grep "DLL Name"` | Lista las DLL de las que depende el ejecutable. |
+| `strip hello.exe` | Quita símbolos e información de depuración. |
+| `gcc -static ...` | Enlaza estáticamente todas las librerías posibles. |
+
+## Make
+
+| Comando | Qué hace |
+|---|---|
+| `make` | Construye el primer objetivo del `Makefile`. |
+| `make build/escpos.o` | Construye un objetivo concreto. |
+| `make CC=clang` | Sobrescribe una variable del Makefile para esta ejecución. No recompila lo que ya está al día. |
+| `make clean` | Borra lo generado (si el Makefile tiene esa regla y está en `.PHONY`). |
+| `touch fichero` | Actualiza la fecha del fichero sin cambiar su contenido. Make lo verá como modificado. |
+| `cat -A Makefile` | Muestra los caracteres invisibles: `^I` es un tabulador y `$` es el fin de línea. |
+
+## Errores típicos y qué significan
+
+| Mensaje | Quién lo da | Causa |
+|---|---|---|
+| `fichero.c:línea:col: error:` | Compilador | Error en el código fuente. |
+| `undefined reference to 'x'` | Enlazador (`ld`, `collect2`) | Un `U` sin ninguna `T`: falta pasar un `.o` o una librería. |
+| `multiple definition of 'x'` | Enlazador | Dos `T` con el mismo nombre. A menudo, un cuerpo de función en un `.h`. |
+| `missing separator` | Make | La receta empieza por espacios en vez de tabulador. |
+| `'x' is up to date` | Make | No es un error: el objetivo es más nuevo que todos sus prerrequisitos. Si `x` es una acción (`clean`), falta en `.PHONY`. |
+| `no newline at end of file` | Clang | El fichero no termina en `\n`. |
+
+## Go equivalente
+
+| Go | C |
+|---|---|
+| `go build -x` | Ver los comandos que se ejecutan por dentro. |
+| `go build -work` | Conservar los intermedios (como `-save-temps`). |
+| `go build -ldflags="-s -w"` | Quitar símbolos (como `strip`). |