IDE Window: Compiler Options/es: what changed

Revision 1 to 2. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		# Ventana de Opciones del Compilador
2	2
3	3		## Rutas
4	4
5	5		- Las rutas relativas se completan con la ruta del proyecto o paquete, el directorio donde están los archivos .lpi/.lpk).
6	6		- Estas rutas se añaden a las rutas de búsqueda.
7	7		- El IDE mantiene un conjunto de rutas de búsqueda para cada directorio. Esto significa que un paquete puede tener diferentes rutas de búsqueda sobre el proyecto activo.
8	8		- Si un paquete hace uso de otro paquete, heredará sus rutas de búsqueda. Se puede ver las rutas de búsqueda heredadas en la pestaña Heredado.
9	9		- Usando el sistema de paquetes Lazarus, apenas necesitarás establecer rutas de búsqueda manualmente.
10	10		- El compilador Free Pascal tiene un archivo de configuración propio (/etc/fpc.cfg, predeterminado) que define un conjunto de rutas de búsqueda de los archivos .ppu de FPC. Por ejemplo, para hallar las unidades de FPC de la RTL o del FCL como 'classes' o 'sysutils'. No ponga rutas de búsqueda de archivos de código fuente (.pas .inc) aquí.
11	11		- Las rutas de búsqueda están separadas por punto y coma ;.
12	12		- Los espacios iniciales o finales son ignorados y eliminados automáticamente por el IDE. El IDE normaliza las rutas y añade el separador de ruta (windows: /, otros: \\). Las rutas son automáticamente convertidas al sistema operativo actual cuando se abre un archivo .lpi o .lpk.
13	13		- Se puede usar macros. Por ejemplo, \$NameOnly(\$(ProjFile))-\$(TargetCPU). Ver [[IDE Macros in paths and filenames/es\|Macros del IDE en rutas y nombres de archivo]].
14	14		- Si no quiere usar rutas de búsqueda heredadas de un paquete hay que cambiar las opciones de compilación de ese paquete.
15	15		- Cada directorio en la ruta de búsqueda de la unidad del proyecto obtiene todas las rutas de búsqueda del proyecto.
16	16		- Cada directorio en la ruta de búsqueda de la unidad del paquete obtiene todas las rutas de búsqueda del paquete.
17	17		- Otros directorios obtienen las rutas de búsqueda del proyecto. Si la ruta de búsqueda del proyecto contiene '.' el directorio verá también el directorio del proyecto.
18	18		- Utilizar "uses unitname in 'filename'" no afecta a las rutas de búsqueda.
19	19
20	20		### Otros archivos de unidad (-Fu)
21	21
22	22		Esta es la ruta de búsqueda de las unidades de pascal (.ppu, .pp, .pas, .p), del proyecto o paquete. Ver el título de la ventana para saber cual. Esta ruta se le da al compilador Free Pascal, que la añade a su ruta de unidades.
23	23
24	24		- La adición y eliminación de unidades en el proyecto o paquete automáticamente le pedirá que ajuste la ruta de unidades.
25	25		- Esta ruta de búsqueda contiene los directorios de tu proyecto (o el paquete) que contienen los archivos .pas, .pp o .p.
26	26		- Atención: No añada directorios de los paquetes Lazarus utilizados en esta ruta. De lo contrario, FPC volverá a generar los archivos .ppu del paquete y los pondrá en el directorio del proyecto. Terminando con múltiples versiones de los .ppu y obteniendo errores impredecibles ''No se puede encontrar la unidad'. Por ejemplo: No añada ningún directorio de fuentes de FPC o de la LCL a esta ruta de búsqueda.
27	27		- Si deseas compartir algunas unidades entre tus proyectos, crea un paquete para ellas. Es muy fácil.
28	28
29	29		### Incluir Archivos (-Fi)
30	30
31	31		Esta es la ruta de búsqueda de los archivos de inclusión (archivos .inc, .lrs, por ejemplo).
32	32
33		-	~~`Esta ruta se pasa al compilador Free Pascal, que la añade a sus rutas de inclusión, y se utilizan por directivas como {$I filename.inc} o {$INCLUDE filename.inc}`~~
	33	+	```text
	34	+	Esta ruta se pasa al compilador Free Pascal, que la añade a sus rutas de inclusión, y se utilizan por directivas como {$I filename.inc} o {$INCLUDE filename.inc}
	35	+	```
34	36
35	37		### Otras fuentes
36	38
37	39		Esta es la ruta de búsqueda de unidades de fuentes pascal, que sólo se utilizan por el IDE y no por el compilador. Normalmente, esto se deja en blanco. Sólo es útil cuando genera los archivos .ppu sin Lazarus.
38	40
39	41		Ejemplo:
40	42
41	43		Tiene un directorio con los fuentes y un directorio con el archivo .ppu correspondiente. Agrega el directorio del .ppu. a la ruta de 'Otros archivos de unidad' y el directorio de .pas a la ruta Otras fuentes. De esta manera el compilador utilizará los archivos .ppu Y no tratará de reconstruir constantemente. Y el IDE encuentra las fuentes y funcionará la opción Buscar Declaración.
42	44
43	45		### Librerías
44	46
45	47		Esta es la ruta de búsqueda de librerías (archivos .dll, .so o .a).
46	48
47	49		### Directorio de salida de la unidad (-FU)
48	50
49	51		Este es el directorio donde el compilador pondrá todos los resultados (opción -FU del compilador), como los archivos .ppu, .o, .rst. Si se utiliza la directiva \$R para los archivos lfm, copia tambien aquí estos ficheros.
50	52
51	53		Un ejemplo de uso popular, es un directorio de salida llamado ''units', y luego un subdirectorio adicional para la CPU y el Sistema Operativo de destino. Por ejemplo:
52	54
53		-	~~` units/$(TargetCPU)-$(TargetOS)`~~
	55	+	```text
	56	+	units/$(TargetCPU)-$(TargetOS)
	57	+	```
54	58
55	59		Notas:
56	60
57	61		- Si el directorio de salida está vacío, Lazarus no pasa la opción -FU al compilador. El compilador entonces hace uso de la opción -FE. Ver [[IDE Window: Project Options\|Project target file]]
58	62		- Los paquetes normalmente heredan su directorio de salida a otros paquetes de a través de las opciones de "uso". No es necesario agregar rutas de paquete manualmente a su proyecto
59	63
60	64		### Adiciones a la ruta del depurador
61	65
62	66		Estos directorios se agregan a la ruta de búsqueda del depurador del IDE, cuando se buscan fuentes (unidades y archivos de cabecera).
63	67
64	68		### Tipo de Widget LCL
65	69
66	70		Este es el tipo de artilugio gráfico utilizado. Normalmente se utiliza el predeterminado. Si quieres probar otro, o estas realizando compilación cruzada, establece aquí otro conjunto de artilugios gráficos.
67	71
68	72		- Los artilugios predeterminados de un paquete son los del proyecto actual.
69	73		- Los artilugios predeterminados del proyecto actual depende del sistema operativo actual. Por ejemplo: win32 para windows 2000.
70	74		- No se debe establecer el conjunto de artilugios para un paquete, porque entonces el proyecto no puede sobrescribirlos. Sólo se ponen, si el paquete es parte de un conjunto de paquetes - uno para cada conjunto de artilugios.
71	75
72	76		## Procesando
73	77
74	78		Ver [Documentación de Free Pascal en línea](http://www.freepascal.org/docs.html)
75	79
76	80		### Modo de sintaxis (-M)
77	81
78	82		Elige el modo predeterminado. Si una unidad no contiene una directiva {\$mode unmodo}, se utiliza este como valor predeterminado.
79	83
80	84		Ver [Documentación de Free Pascal en línea](http://www.freepascal.org/docs.html)
81	85
82	86		### Syntax Options
83	87
84	88		- C Style Operators (*=, +=, /= and -=)
85	89		- Include Assertion Code
86	90		- Allow LABEL and GOTO
87	91		- C++ Styled INLINE
88	92		- C Style Macros (global)
89	93		- Constructor name must be init (destructor must be done)
90	94		- Static Keyword in Objects
91	95		- Use Ansi Strings
92	96
93	97		### Assembler style
94	98
95	99		- -R\<x\> assembler reading style:
96	100		- -Rdefault use default assembler
97	101		- -Ratt read AT&T style assembler
98	102		- -Rintel read Intel style assembler
99	103
100	104		## Code
101	105
102	106		Ver [Documentación de Free Pascal en línea](http://www.freepascal.org/docs.html)
103	107
104	108		## Linking
105	109
106	110		Ver [Documentación de Free Pascal en línea](http://www.freepascal.org/docs.html)
107	111
108	112		## Verbosity (Messages)
109	113
110	114		See [Free Pascal - Online documentation](http://www.freepascal.org/docs.html). Note that adding a lot of verbosity slows down the parsing of the compiler output much, even if most of the messages will be hidden in the messages view.
111	115
112	116		The page has been renamed to Verbosity, starting from 0.9.27 version.
113	117
114	118		## Messages
115	119
116	120		(Introduced in Lazarus 0.9.27 version) The page allows to control what compiler output Notes, Hints and Warnings are shown. The feature requires FP compiler to support -m switch (version 2.2.2 or higher).
117	121
118	122		It's also possible to specify message Language file (file should be Utf-8 encoded), to see compiler messages translated, without need to modify fpc.cfg file.
119	123
120	124		Samples of the messages translation file can be found at \${LazarusDir}/fpc/\${FPCTARGET}/msg, i.e. C:\Lazarus\fpc\2.2.3\msg
121	125
122	126		## Other
123	127
124	128		Ver [Documentación de Free Pascal en línea](http://www.freepascal.org/docs.html)
125	129
126	130		## Heredados
127	131
128	132		Esta página muestra todas las opciones de compilación heredadas desde los paquetes. Los paquetes heredean opciones a través de sus [[IDE Window: Package Options\|opciones]] de utilización ('usage').
129	133
130	134		El primer nodo muestra todas las opciones heredadas, que son las suma de todas las de los paquetes utilizados.
131	135
132	136		Los nodos subsiguientes muestran las opciones heredadas de cada uno de los paquetes utilizados.
133	137
134	138		Podemos ver y editar el conjunto de paquetes utilizados por el proyecto en el inspector de proyecto. Podemos ver y editar el conjunto de paquetes utilizados por un paquete en el editor de paquetes.
135	139
136	140		Para información general sobre paquetes ver [[Lazarus Packages/es\|Paquetes Lazarus]].
137	141
138	142		## Compilación
139	143
140	144		### Crear Makefile
141	145
142	146		Active esto si el IDE debiera crear archivo Makefile y Makefile.fpc antes de cada construcción. Esto es sólo soportado para paquetes, no para proyectos.
143	147
144	148		### Ejecutar antes
145	149
146	150		Configure aquí un comando a ejecutar antes de correr el compilador.
147	151
148	152		Llamados:
149	153
150	154		- Compile - ejecuta cuando se compila normalmente (F9).
151	155		- Build - ejecuta cuando se reconstruye todo. Esto podría por ejemplo un script para limpieza.
152	156		- Run - ejecuta cuando se compila rápido. Cuando se corre un proyecto, el IDE revisa si se necesita reconstruir. Si no se requiere reconstruir, el IDE omite el paso de compilar. Configure esta opción para que siempre se ejecute el comando, incluso si el paso de compilar se omite.
153	157
154	158		El IDE puede revisar sintáxis y filtrar la salida del comando y parar en los errores. Revise las opciones para los mensajes que el IDE deba estar pendiente.
155	159
156	160		### Compilador
157	161
158	162		Esta es la ruta del compilador que se usa por el proyecto o paquete. Por defecto es el macro \$(CompPath), el cual se reemplaza con el archivo de compilador en las opciones generales.
159	163
160	164		### Ejecutar después
161	165
162	166		Ponga aquí un comando a ejecutar después de correr el compilador. Ver arriba 'Ejecutar Antes' para detalles.
163	167
164	168		## Use these settings as default for new projects
165	169
166	170		Check this checkbox and click Ok. The settings will be saved to ~/.lazarus/compileroptions.xml (or whatever you have as primary config path). When you create a new project this file will be loaded to initialize the compiler options. This feature exists since 0.9.29.
167	171
168	172		## Botones
169	173
170	174		### Probar
171	175
172	176		Esto ejecutará diversas pruebas y detecta errores comunes de configuración. Para fpc 2.2.0 se advierte acerca de algunas unidades duplicadas. Las advertencias son correctas, pero se pueden ignorar, si no se utilizan esas unidades.
173	177
174	178		### Mostrar Opciones
175	179
176	180		Abre un diálogo y se muestran los parámetros de línea de comandos actuales.
177	181
178	182		### Cargar/Guardar
179	183
180	184		Abre un diálogo para guardar y / o cargar las opciones actuales del compilador de / a un archivo xmle.
181	185
182	186		### Aceptar
183	187
184	188		Este aplicará los cambios y saldrá del diálogo.
185	189
186	190		### Cancelar
187	191
188	192		Este cancelará los cambios y saldrá del diálogo.
189	193
190	194		---
191	195		From the Free Pascal wiki, page "IDE Window: Compiler Options/es", as it stood on 2023-02-22 after a change by Edgardager, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history