← Back to branch summary

~ubuntu-branches/ubuntu/jaunty/aspectc++/jaunty

« back to all changes in this revision

Viewing changes to Ag++/doc/Ag++Manual/Ag++Manual.lyx

  • Committer: Bazaar Package Importer
  • Author(s): Reinhard Tartler
  • Date: 2008-07-07 14:41:02 UTC
  • mfrom: (1.1.3 upstream) (6.1.1 lenny)
  • Revision ID: james.westby@ubuntu.com-20080707144102-lzml7t07f3sl00r5
Tags: 1.0pre4~svn.20080711-1
http://bugs.debian.org/480316
* new upstream snapshot.
* include all upstream documentation. Clarifying emails regarding
  licensing has been included into debian/copyright.
* reformat description following recomendations of
  http://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Description
  (Closes: #480316)

Show diffs side-by-side

added added

removed removed

Lines of Context:
Ag++/doc/Ag++Manual/Ag++Manual.lyx
 
1
#LyX 1.4.4 created this file. For more info see http://www.lyx.org/
 
2
\lyxformat 245
 
3
\begin_document
 
4
\begin_header
 
5
\textclass article
 
6
\begin_preamble
 
7
\usepackage{a4}
 
8
%--------------------------------------------------------------------
 
9
% PDF related
 
10
%--------------------------------------------------------------------
 
11
\newif\ifpdf 
 
12
\ifx\pdfoutput\undefined 
 
13
  \pdffalse                     % we are not running PDFLaTeX 
 
14
\else 
 
15
  \pdfoutput=1                % we are running PDFLaTeX 
 
16
  \pdftrue 
 
17
\fi
 
18
 
 
19
%--------------------------------------------------------------------
 
20
% setup hyperref
 
21
%--------------------------------------------------------------------
 
22
\ifpdf
 
23
  \usepackage{color}
 
24
  \pagecolor{white}
 
25
  \usepackage{hyperref}  
 
26
  \hypersetup{% 
 
27
    %
 
28
    %% general document information
 
29
    pdftitle          = {AG++ Manual}, 
 
30
    pdfsubject     = {Dokumentation}, 
 
31
    pdfkeywords  = {AOP, AspectC++, ac++, pure-systems,g++}, 
 
32
    pdfauthor      = {Georg Blaschke}, 
 
33
    pdfcreator     = {\LaTeX\ with package \flqq hyperref\frqq},
 
34
    pdfproducer  = {pdfTeX-0.\the\pdftexversion\pdftexrevision},
 
35
    %
 
36
    %% document style
 
37
    colorlinks=true,                  % colored link
 
38
    urlcolor=blue,                    % blue URL links
 
39
    bookmarks=true,                % generate bookmarks
 
40
    bookmarksnumbered=true,  % generate section numbers
 
41
    pdfpagemode=None           % don't open bookmarks
 
42
  } 
 
43
  
 
44
  %% set document creation date to 
 
45
  \pdfinfo {/CreationDate (D:20061303000000)}
 
46
\fi
 
47
 
 
48
%--------------------------------------------------------------------
 
49
% create hyperrefs depending on the use of pdflatex
 
50
%--------------------------------------------------------------------
 
51
\newcommand\depref[2]{%
 
52
  \ifpdf
 
53
    \href{#1}{#2}
 
54
  \else  
 
55
    {#2}
 
56
  \fi
 
57
}
 
58
 
 
59
%--------------------------------------------------------------------
 
60
% setup pure-systems style
 
61
%--------------------------------------------------------------------
 
62
\usepackage{floatflt}
 
63
\usepackage{../styles/acc}
 
64
\version{0.7} 
 
65
\doctype{Documentation:}
 
66
\credit{}
 
67
\otherlogo{
 
68
  \resizebox{4cm}{!}{\includegraphics{../images/ac++logo}}}
 
69
\sloppy
 
70
\remark{}
 
71
 
 
72
 
 
73
% less than one half space between lines
 
74
\setstretch{1.15}
 
75
\end_preamble
 
76
\language english
 
77
\inputencoding auto
 
78
\fontscheme pslatex
 
79
\graphics default
 
80
\paperfontsize 12
 
81
\spacing onehalf
 
82
\papersize default
 
83
\use_geometry false
 
84
\use_amsmath 1
 
85
\cite_engine basic
 
86
\use_bibtopic false
 
87
\paperorientation portrait
 
88
\secnumdepth 3
 
89
\tocdepth 3
 
90
\paragraph_separation indent
 
91
\defskip medskip
 
92
\quotes_language english
 
93
\papercolumns 1
 
94
\papersides 2
 
95
\paperpagestyle default
 
96
\tracking_changes false
 
97
\output_changes true
 
98
\end_header
 
99
 
 
100
\begin_body
 
101
 
 
102
\begin_layout Title
 
103
 
 
104
\emph on
 
105
Ag++  Manual:
 
106
\end_layout
 
107
 
 
108
\begin_layout Author
 
109
 
 
110
\size largest
 
111
Georg Blaschke
 
112
\end_layout
 
113
 
 
114
\begin_layout Standard
 
115
\begin_inset LatexCommand \tableofcontents{}
 
116
 
 
117
\end_inset
 
118
 
 
119
 
 
120
\begin_inset ERT
 
121
status collapsed
 
122
 
 
123
\begin_layout Standard
 
124
 
 
125
 
 
126
\backslash
 
127
clearpage
 
128
\end_layout
 
129
 
 
130
\end_inset
 
131
 
 
132
 
 
133
\end_layout
 
134
 
 
135
\begin_layout Section
 
136
 
 
137
\family sans
 
138
\begin_inset LatexCommand \label{sec:Introduction}
 
139
 
 
140
\end_inset
 
141
 
 
142
 
 
143
\family default
 
144
Introduction
 
145
\end_layout
 
146
 
 
147
\begin_layout Standard
 
148
The 
 
149
\family typewriter
 
150
ag++
 
151
\family default
 
152
 program provides a more intuitive frontend to the AspectC++ weaver (
 
153
\family typewriter
 
154
ac++
 
155
\family default
 
156
) in a GNU environment.
 
157
 The only preliminaries are a working installation of GNU C++ compiler,
 
158
 which also can run within a cygwin environment.
 
159
 It basically wraps the functionality of the aspect weaver and the c++ compiler
 
160
 into one single program.
 
161
 
 
162
\end_layout
 
163
 
 
164
\begin_layout Section
 
165
 
 
166
\family sans
 
167
\begin_inset LatexCommand \label{sec:Invocation}
 
168
 
 
169
\end_inset
 
170
 
 
171
 
 
172
\family default
 
173
Invocation
 
174
\end_layout
 
175
 
 
176
\begin_layout Standard
 
177
The usage of 
 
178
\family typewriter
 
179
ag++ 
 
180
\family default
 
181
is mainly influenced by the usage of the GNU g++ compiler and the synopsis
 
182
 is like:
 
183
\end_layout
 
184
 
 
185
\begin_layout Standard
 
186
 
 
187
\family typewriter
 
188
ag++ [options] [files...]
 
189
\family default
 
190
.
 
191
\newline
 
192
Let's say, you want to 
 
193
\series bold
 
194
compile
 
195
\series default
 
196
 a single file (here: 
 
197
\family typewriter
 
198
main.cc
 
199
\family default
 
200
) with 
 
201
\family typewriter
 
202
g++,
 
203
\family default
 
204
 you have to run
 
205
\end_layout
 
206
 
 
207
\begin_layout Standard
 
208
 
 
209
\family typewriter
 
210
g++ -c main.cc
 
211
\family default
 
212
 
 
213
\newline
 
214
in order to generate an object file.
 
215
\newline
 
216
To 
 
217
\series bold
 
218
weave
 
219
\series default
 
220
 and 
 
221
\series bold
 
222
compile
 
223
\series default
 
224
 a single file you simply invoke
 
225
\end_layout
 
226
 
 
227
\begin_layout Standard
 
228
 
 
229
\family typewriter
 
230
ag++ -c main.cc
 
231
\newline
 
232
 
 
233
\family default
 
234
the same way like you did before with 
 
235
\family typewriter
 
236
g++
 
237
\family default
 
238
.
 
239
\newline
 
240
 
 
241
\end_layout
 
242
 
 
243
\begin_layout Subsection
 
244
Concept
 
245
\end_layout
 
246
 
 
247
\begin_layout Standard
 
248
As 
 
249
\family typewriter
 
250
ag++ 
 
251
\family default
 
252
is just a wrapper, it first generates the puma configuration file, then
 
253
 calls 
 
254
\family typewriter
 
255
ac++
 
256
\family default
 
257
 and afterwards 
 
258
\family typewriter
 
259
g++
 
260
\family default
 
261
.
 
262
 The intermediate files generated by 
 
263
\family typewriter
 
264
ac++
 
265
\family default
 
266
 are stored in the directory which is extracted from the 
 
267
\family typewriter
 
268
-o
 
269
\family default
 
270
 option or in current directory.
 
271
 In some cases this may lead to a situation where the names of intermediate
 
272
 files interfere with each other.
 
273
\end_layout
 
274
 
 
275
\begin_layout Subsection
 
276
Options
 
277
\end_layout
 
278
 
 
279
\begin_layout Standard
 
280
All available options are summed up in the options table (see table 
 
281
\begin_inset LatexCommand \ref{tab:options}
 
282
 
 
283
\end_inset
 
284
 
 
285
).
 
286
 The column labeled with 
 
287
\emph on
 
288
AC++ 
 
289
\emph default
 
290
shows if the option is taken over from 
 
291
\family typewriter
 
292
ac++
 
293
\family default
 
294
 by 
 
295
\family typewriter
 
296
ag++
 
297
\family default
 
298
 ('X'), not supported by 
 
299
\family typewriter
 
300
ac++
 
301
\family default
 
302
 ('--') or modified by 
 
303
\family typewriter
 
304
ag++
 
305
\family default
 
306
 ('!').
 
307
 All options which are taken over, are not described in this document.
 
308
 Consult the AC++ Compiler Manual instead.
 
309
 Options which are not listed in the option table are accounted as 
 
310
\family typewriter
 
311
g++
 
312
\family default
 
313
 options.
 
314
 Some 
 
315
\family typewriter
 
316
g++ 
 
317
\family default
 
318
options can not be automatically handled correctly by the options parser
 
319
 of 
 
320
\family typewriter
 
321
ag++.
 
322
 
 
323
\family default
 
324
So all 
 
325
\family typewriter
 
326
g++ 
 
327
\family default
 
328
options starting with 
 
329
\family typewriter
 
330
-p, -a, -d and -r 
 
331
\family default
 
332
(e.g.
 
333
 
 
334
\family typewriter
 
335
-pipe, -ansi, -dletters ,-remap 
 
336
\family default
 
337
) have to be written between 
 
338
\family typewriter
 
339
--Xcompiler
 
340
\family default
 
341
 (see 
 
342
\begin_inset LatexCommand \ref{sub:--Xcompiler}
 
343
 
 
344
\end_inset
 
345
 
 
346
) and 
 
347
\family typewriter
 
348
--Xweaver 
 
349
\family default
 
350
(see 
 
351
\begin_inset LatexCommand \ref{sub:--Xweaver}
 
352
 
 
353
\end_inset
 
354
 
 
355
).
 
356
 If such options passed to 
 
357
\family typewriter
 
358
ag++ 
 
359
\family default
 
360
without using 
 
361
\family typewriter
 
362
--Xcompiler 
 
363
\family default
 
364
they will be interpreted a 
 
365
\family typewriter
 
366
ag++/ac++
 
367
\family default
 
368
 options ; e.g.
 
369
 
 
370
\family typewriter
 
371
-pipe 
 
372
\family default
 
373
will be interpreted as 
 
374
\family typewriter
 
375
-p 
 
376
\begin_inset Quotes eld
 
377
\end_inset
 
378
 
 
379
ipe
 
380
\family default
 
381
 
 
382
\begin_inset Quotes erd
 
383
\end_inset
 
384
 
 
385
 
 
386
\family typewriter
 
387
.
 
388
\end_layout
 
389
 
 
390
\begin_layout Standard
 
391
\begin_inset Float table
 
392
wide false
 
393
sideways false
 
394
status open
 
395
 
 
396
\begin_layout Standard
 
397
\align center
 
398
\begin_inset Tabular
 
399
<lyxtabular version="3" rows="29" columns="3">
 
400
<features>
 
401
<column alignment="center" valignment="top" leftline="true" width="0">
 
402
<column alignment="center" valignment="top" leftline="true" width="0">
 
403
<column alignment="block" valignment="top" leftline="true" rightline="true" width="8cm">
 
404
<row topline="true" bottomline="true">
 
405
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
406
\begin_inset Text
 
407
 
 
408
\begin_layout Standard
 
409
 
 
410
\series bold
 
411
Option
 
412
\end_layout
 
413
 
 
414
\end_inset
 
415
</cell>
 
416
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
417
\begin_inset Text
 
418
 
 
419
\begin_layout Standard
 
420
 
 
421
\series bold
 
422
AC++
 
423
\end_layout
 
424
 
 
425
\end_inset
 
426
</cell>
 
427
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
428
\begin_inset Text
 
429
 
 
430
\begin_layout Standard
 
431
 
 
432
\series bold
 
433
Description
 
434
\end_layout
 
435
 
 
436
\end_inset
 
437
</cell>
 
438
</row>
 
439
<row topline="true">
 
440
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
441
\begin_inset Text
 
442
 
 
443
\begin_layout Standard
 
444
 
 
445
\family typewriter
 
446
--gen_config
 
447
\end_layout
 
448
 
 
449
\end_inset
 
450
</cell>
 
451
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
452
\begin_inset Text
 
453
 
 
454
\begin_layout Standard
 
455
--
 
456
\end_layout
 
457
 
 
458
\end_inset
 
459
</cell>
 
460
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
461
\begin_inset Text
 
462
 
 
463
\begin_layout Standard
 
464
Only generate Puma configuration file
 
465
\end_layout
 
466
 
 
467
\end_inset
 
468
</cell>
 
469
</row>
 
470
<row topline="true">
 
471
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
472
\begin_inset Text
 
473
 
 
474
\begin_layout Standard
 
475
 
 
476
\family typewriter
 
477
--weave_only 
 
478
\end_layout
 
479
 
 
480
\end_inset
 
481
</cell>
 
482
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
483
\begin_inset Text
 
484
 
 
485
\begin_layout Standard
 
486
--
 
487
\end_layout
 
488
 
 
489
\end_inset
 
490
</cell>
 
491
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
492
\begin_inset Text
 
493
 
 
494
\begin_layout Standard
 
495
 
 
496
\family roman
 
497
\series medium
 
498
\shape up
 
499
\size normal
 
500
\emph off
 
501
\bar no
 
502
\noun off
 
503
\color none
 
504
Weave only
 
505
\end_layout
 
506
 
 
507
\end_inset
 
508
</cell>
 
509
</row>
 
510
<row topline="true">
 
511
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
512
\begin_inset Text
 
513
 
 
514
\begin_layout Standard
 
515
 
 
516
\family typewriter
 
517
-c 
 
518
\end_layout
 
519
 
 
520
\end_inset
 
521
</cell>
 
522
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
523
\begin_inset Text
 
524
 
 
525
\begin_layout Standard
 
526
!
 
527
\end_layout
 
528
 
 
529
\end_inset
 
530
</cell>
 
531
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
532
\begin_inset Text
 
533
 
 
534
\begin_layout Standard
 
535
 
 
536
\family roman
 
537
\series medium
 
538
\shape up
 
539
\size normal
 
540
\emph off
 
541
\bar no
 
542
\noun off
 
543
\color none
 
544
Compile only
 
545
\end_layout
 
546
 
 
547
\end_inset
 
548
</cell>
 
549
</row>
 
550
<row topline="true">
 
551
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
552
\begin_inset Text
 
553
 
 
554
\begin_layout Standard
 
555
 
 
556
\family typewriter
 
557
--keep_woven
 
558
\end_layout
 
559
 
 
560
\end_inset
 
561
</cell>
 
562
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
563
\begin_inset Text
 
564
 
 
565
\begin_layout Standard
 
566
--
 
567
\end_layout
 
568
 
 
569
\end_inset
 
570
</cell>
 
571
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
572
\begin_inset Text
 
573
 
 
574
\begin_layout Standard
 
575
 
 
576
\family roman
 
577
\series medium
 
578
\shape up
 
579
\size normal
 
580
\emph off
 
581
\bar no
 
582
\noun off
 
583
\color none
 
584
Keep woven source code files
 
585
\end_layout
 
586
 
 
587
\end_inset
 
588
</cell>
 
589
</row>
 
590
<row topline="true">
 
591
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
592
\begin_inset Text
 
593
 
 
594
\begin_layout Standard
 
595
 
 
596
\family typewriter
 
597
--c_compiler <arg> 
 
598
\end_layout
 
599
 
 
600
\end_inset
 
601
</cell>
 
602
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
603
\begin_inset Text
 
604
 
 
605
\begin_layout Standard
 
606
--
 
607
\end_layout
 
608
 
 
609
\end_inset
 
610
</cell>
 
611
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
612
\begin_inset Text
 
613
 
 
614
\begin_layout Standard
 
615
 
 
616
\family roman
 
617
\series medium
 
618
\shape up
 
619
\size normal
 
620
\emph off
 
621
\bar no
 
622
\noun off
 
623
\color none
 
624
Path to C++ compiler
 
625
\end_layout
 
626
 
 
627
\end_inset
 
628
</cell>
 
629
</row>
 
630
<row topline="true">
 
631
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
632
\begin_inset Text
 
633
 
 
634
\begin_layout Standard
 
635
 
 
636
\family typewriter
 
637
--ac_compiler <arg> 
 
638
\end_layout
 
639
 
 
640
\end_inset
 
641
</cell>
 
642
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
643
\begin_inset Text
 
644
 
 
645
\begin_layout Standard
 
646
--
 
647
\end_layout
 
648
 
 
649
\end_inset
 
650
</cell>
 
651
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
652
\begin_inset Text
 
653
 
 
654
\begin_layout Standard
 
655
 
 
656
\family roman
 
657
\series medium
 
658
\shape up
 
659
\size normal
 
660
\emph off
 
661
\bar no
 
662
\noun off
 
663
\color none
 
664
Path to AspectC++ compiler
 
665
\end_layout
 
666
 
 
667
\end_inset
 
668
</cell>
 
669
</row>
 
670
<row topline="true">
 
671
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
672
\begin_inset Text
 
673
 
 
674
\begin_layout Standard
 
675
 
 
676
\family typewriter
 
677
--config_command <arg>
 
678
\end_layout
 
679
 
 
680
\end_inset
 
681
</cell>
 
682
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
683
\begin_inset Text
 
684
 
 
685
\begin_layout Standard
 
686
--
 
687
\end_layout
 
688
 
 
689
\end_inset
 
690
</cell>
 
691
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
692
\begin_inset Text
 
693
 
 
694
\begin_layout Standard
 
695
Specify command which prints information about compiler
 
696
\end_layout
 
697
 
 
698
\end_inset
 
699
</cell>
 
700
</row>
 
701
<row topline="true">
 
702
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
703
\begin_inset Text
 
704
 
 
705
\begin_layout Standard
 
706
 
 
707
\family typewriter
 
708
--Xcompiler
 
709
\end_layout
 
710
 
 
711
\end_inset
 
712
</cell>
 
713
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
714
\begin_inset Text
 
715
 
 
716
\begin_layout Standard
 
717
--
 
718
\end_layout
 
719
 
 
720
\end_inset
 
721
</cell>
 
722
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
723
\begin_inset Text
 
724
 
 
725
\begin_layout Standard
 
726
In case of doupt account following options as 
 
727
\family typewriter
 
728
g++
 
729
\family default
 
730
 options.
 
731
\end_layout
 
732
 
 
733
\end_inset
 
734
</cell>
 
735
</row>
 
736
<row topline="true" bottomline="true">
 
737
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
738
\begin_inset Text
 
739
 
 
740
\begin_layout Standard
 
741
 
 
742
\family typewriter
 
743
--Xweaver
 
744
\end_layout
 
745
 
 
746
\end_inset
 
747
</cell>
 
748
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
749
\begin_inset Text
 
750
 
 
751
\begin_layout Standard
 
752
--
 
753
\end_layout
 
754
 
 
755
\end_inset
 
756
</cell>
 
757
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
758
\begin_inset Text
 
759
 
 
760
\begin_layout Standard
 
761
In case of doupt account following options as 
 
762
\family typewriter
 
763
ac++
 
764
\family default
 
765
 options.
 
766
\end_layout
 
767
 
 
768
\end_inset
 
769
</cell>
 
770
</row>
 
771
<row topline="true">
 
772
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
773
\begin_inset Text
 
774
 
 
775
\begin_layout Standard
 
776
 
 
777
\family typewriter
 
778
-p|--path\InsetSpace ~
 
779
<arg>
 
780
\end_layout
 
781
 
 
782
\end_inset
 
783
</cell>
 
784
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
785
\begin_inset Text
 
786
 
 
787
\begin_layout Standard
 
788
!
 
789
\end_layout
 
790
 
 
791
\end_inset
 
792
</cell>
 
793
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
794
\begin_inset Text
 
795
 
 
796
\begin_layout Standard
 
797
Defines a project directory
 
798
\end_layout
 
799
 
 
800
\end_inset
 
801
</cell>
 
802
</row>
 
803
<row topline="true">
 
804
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
805
\begin_inset Text
 
806
 
 
807
\begin_layout Standard
 
808
 
 
809
\family typewriter
 
810
-d|--dest <arg>
 
811
\end_layout
 
812
 
 
813
\end_inset
 
814
</cell>
 
815
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
816
\begin_inset Text
 
817
 
 
818
\begin_layout Standard
 
819
X
 
820
\end_layout
 
821
 
 
822
\end_inset
 
823
</cell>
 
824
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
825
\begin_inset Text
 
826
 
 
827
\begin_layout Standard
 
828
Specifies a target directory for saving
 
829
\end_layout
 
830
 
 
831
\end_inset
 
832
</cell>
 
833
</row>
 
834
<row topline="true">
 
835
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
836
\begin_inset Text
 
837
 
 
838
\begin_layout Standard
 
839
 
 
840
\family typewriter
 
841
-v|--verbose <arg>
 
842
\end_layout
 
843
 
 
844
\end_inset
 
845
</cell>
 
846
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
847
\begin_inset Text
 
848
 
 
849
\begin_layout Standard
 
850
!
 
851
\end_layout
 
852
 
 
853
\end_inset
 
854
</cell>
 
855
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
856
\begin_inset Text
 
857
 
 
858
\begin_layout Standard
 
859
Level of verbosity (
 
860
\family typewriter
 
861
0
 
862
\family default
 
863
-
 
864
\family typewriter
 
865
9
 
866
\family default
 
867
)
 
868
\end_layout
 
869
 
 
870
\end_inset
 
871
</cell>
 
872
</row>
 
873
<row topline="true">
 
874
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
875
\begin_inset Text
 
876
 
 
877
\begin_layout Standard
 
878
 
 
879
\family typewriter
 
880
-o|--output <arg>
 
881
\end_layout
 
882
 
 
883
\end_inset
 
884
</cell>
 
885
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
886
\begin_inset Text
 
887
 
 
888
\begin_layout Standard
 
889
X
 
890
\end_layout
 
891
 
 
892
\end_inset
 
893
</cell>
 
894
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
895
\begin_inset Text
 
896
 
 
897
\begin_layout Standard
 
898
Name of the output file
 
899
\end_layout
 
900
 
 
901
\end_inset
 
902
</cell>
 
903
</row>
 
904
<row topline="true">
 
905
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
906
\begin_inset Text
 
907
 
 
908
\begin_layout Standard
 
909
 
 
910
\family typewriter
 
911
--include_files
 
912
\end_layout
 
913
 
 
914
\end_inset
 
915
</cell>
 
916
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
917
\begin_inset Text
 
918
 
 
919
\begin_layout Standard
 
920
X
 
921
\end_layout
 
922
 
 
923
\end_inset
 
924
</cell>
 
925
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
926
\begin_inset Text
 
927
 
 
928
\begin_layout Standard
 
929
Generate manipulated header files (short version 
 
930
\family typewriter
 
931
-i
 
932
\family default
 
933
 is not supported)
 
934
\end_layout
 
935
 
 
936
\end_inset
 
937
</cell>
 
938
</row>
 
939
<row topline="true">
 
940
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
941
\begin_inset Text
 
942
 
 
943
\begin_layout Standard
 
944
 
 
945
\family typewriter
 
946
-a|--aspect_header <arg>
 
947
\end_layout
 
948
 
 
949
\end_inset
 
950
</cell>
 
951
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
952
\begin_inset Text
 
953
 
 
954
\begin_layout Standard
 
955
!
 
956
\end_layout
 
957
 
 
958
\end_inset
 
959
</cell>
 
960
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
961
\begin_inset Text
 
962
 
 
963
\begin_layout Standard
 
964
 
 
965
\family roman
 
966
\series medium
 
967
\shape up
 
968
\size normal
 
969
\emph off
 
970
\bar no
 
971
\noun off
 
972
\color none
 
973
Name of aspect header file or 
 
974
\family typewriter
 
975
\series default
 
976
\shape default
 
977
\size default
 
978
\emph default
 
979
\bar default
 
980
\noun default
 
981
\color inherit
 
982
0
 
983
\end_layout
 
984
 
 
985
\end_inset
 
986
</cell>
 
987
</row>
 
988
<row topline="true">
 
989
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
990
\begin_inset Text
 
991
 
 
992
\begin_layout Standard
 
993
 
 
994
\family typewriter
 
995
-r|--repository <arg>
 
996
\end_layout
 
997
 
 
998
\end_inset
 
999
</cell>
 
1000
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1001
\begin_inset Text
 
1002
 
 
1003
\begin_layout Standard
 
1004
X
 
1005
\end_layout
 
1006
 
 
1007
\end_inset
 
1008
</cell>
 
1009
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
1010
\begin_inset Text
 
1011
 
 
1012
\begin_layout Standard
 
1013
Name of the project repository
 
1014
\end_layout
 
1015
 
 
1016
\end_inset
 
1017
</cell>
 
1018
</row>
 
1019
<row topline="true">
 
1020
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1021
\begin_inset Text
 
1022
 
 
1023
\begin_layout Standard
 
1024
 
 
1025
\family typewriter
 
1026
--config <arg>
 
1027
\end_layout
 
1028
 
 
1029
\end_inset
 
1030
</cell>
 
1031
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1032
\begin_inset Text
 
1033
 
 
1034
\begin_layout Standard
 
1035
!
 
1036
\end_layout
 
1037
 
 
1038
\end_inset
 
1039
</cell>
 
1040
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
1041
\begin_inset Text
 
1042
 
 
1043
\begin_layout Standard
 
1044
Parser configuration file
 
1045
\end_layout
 
1046
 
 
1047
\end_inset
 
1048
</cell>
 
1049
</row>
 
1050
<row topline="true">
 
1051
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1052
\begin_inset Text
 
1053
 
 
1054
\begin_layout Standard
 
1055
 
 
1056
\family typewriter
 
1057
--no_line
 
1058
\end_layout
 
1059
 
 
1060
\end_inset
 
1061
</cell>
 
1062
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1063
\begin_inset Text
 
1064
 
 
1065
\begin_layout Standard
 
1066
X
 
1067
\end_layout
 
1068
 
 
1069
\end_inset
 
1070
</cell>
 
1071
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
1072
\begin_inset Text
 
1073
 
 
1074
\begin_layout Standard
 
1075
Disable generation of 
 
1076
\family typewriter
 
1077
#line
 
1078
\family default
 
1079
 directives
 
1080
\end_layout
 
1081
 
 
1082
\end_inset
 
1083
</cell>
 
1084
</row>
 
1085
<row topline="true">
 
1086
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1087
\begin_inset Text
 
1088
 
 
1089
\begin_layout Standard
 
1090
 
 
1091
\family typewriter
 
1092
-k|--keywords
 
1093
\end_layout
 
1094
 
 
1095
\end_inset
 
1096
</cell>
 
1097
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1098
\begin_inset Text
 
1099
 
 
1100
\begin_layout Standard
 
1101
X
 
1102
\end_layout
 
1103
 
 
1104
\end_inset
 
1105
</cell>
 
1106
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
1107
\begin_inset Text
 
1108
 
 
1109
\begin_layout Standard
 
1110
Allow AspectC++ keywords in normal project files
 
1111
\end_layout
 
1112
 
 
1113
\end_inset
 
1114
</cell>
 
1115
</row>
 
1116
<row topline="true" bottomline="true">
 
1117
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1118
\begin_inset Text
 
1119
 
 
1120
\begin_layout Standard
 
1121
 
 
1122
\family typewriter
 
1123
--real-instances
 
1124
\end_layout
 
1125
 
 
1126
\end_inset
 
1127
</cell>
 
1128
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1129
\begin_inset Text
 
1130
 
 
1131
\begin_layout Standard
 
1132
X
 
1133
\end_layout
 
1134
 
 
1135
\end_inset
 
1136
</cell>
 
1137
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
1138
\begin_inset Text
 
1139
 
 
1140
\begin_layout Standard
 
1141
Let 
 
1142
\family typewriter
 
1143
ac++
 
1144
\family default
 
1145
 perform a full template analysis
 
1146
\end_layout
 
1147
 
 
1148
\end_inset
 
1149
</cell>
 
1150
</row>
 
1151
<row topline="true">
 
1152
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1153
\begin_inset Text
 
1154
 
 
1155
\begin_layout Standard
 
1156
 
 
1157
\family typewriter
 
1158
--problem...
 
1159
\end_layout
 
1160
 
 
1161
\end_inset
 
1162
</cell>
 
1163
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1164
\begin_inset Text
 
1165
 
 
1166
\begin_layout Standard
 
1167
X
 
1168
\end_layout
 
1169
 
 
1170
\end_inset
 
1171
</cell>
 
1172
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
1173
\begin_inset Text
 
1174
 
 
1175
\begin_layout Standard
 
1176
Enable back-end compiler problem workaround 
 
1177
\end_layout
 
1178
 
 
1179
\end_inset
 
1180
</cell>
 
1181
</row>
 
1182
<row topline="true" bottomline="true">
 
1183
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1184
\begin_inset Text
 
1185
 
 
1186
\begin_layout Standard
 
1187
 
 
1188
\family typewriter
 
1189
--no_problem...
 
1190
\end_layout
 
1191
 
 
1192
\end_inset
 
1193
</cell>
 
1194
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1195
\begin_inset Text
 
1196
 
 
1197
\begin_layout Standard
 
1198
X
 
1199
\end_layout
 
1200
 
 
1201
\end_inset
 
1202
</cell>
 
1203
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
1204
\begin_inset Text
 
1205
 
 
1206
\begin_layout Standard
 
1207
Disable back-end compiler problem workaround
 
1208
\end_layout
 
1209
 
 
1210
\end_inset
 
1211
</cell>
 
1212
</row>
 
1213
<row topline="true">
 
1214
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1215
\begin_inset Text
 
1216
 
 
1217
\begin_layout Standard
 
1218
 
 
1219
\family typewriter
 
1220
--warn...
 
1221
\end_layout
 
1222
 
 
1223
\end_inset
 
1224
</cell>
 
1225
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1226
\begin_inset Text
 
1227
 
 
1228
\begin_layout Standard
 
1229
X
 
1230
\end_layout
 
1231
 
 
1232
\end_inset
 
1233
</cell>
 
1234
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
1235
\begin_inset Text
 
1236
 
 
1237
\begin_layout Standard
 
1238
Show a specific 
 
1239
\family typewriter
 
1240
ac++
 
1241
\family default
 
1242
 warning that is suppressed by default
 
1243
\end_layout
 
1244
 
 
1245
\end_inset
 
1246
</cell>
 
1247
</row>
 
1248
<row topline="true" bottomline="true">
 
1249
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1250
\begin_inset Text
 
1251
 
 
1252
\begin_layout Standard
 
1253
 
 
1254
\family typewriter
 
1255
--no_warn...
 
1256
\end_layout
 
1257
 
 
1258
\end_inset
 
1259
</cell>
 
1260
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1261
\begin_inset Text
 
1262
 
 
1263
\begin_layout Standard
 
1264
X
 
1265
\end_layout
 
1266
 
 
1267
\end_inset
 
1268
</cell>
 
1269
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
1270
\begin_inset Text
 
1271
 
 
1272
\begin_layout Standard
 
1273
Suppress a specific 
 
1274
\family typewriter
 
1275
ac++
 
1276
\family default
 
1277
 warning
 
1278
\end_layout
 
1279
 
 
1280
\end_inset
 
1281
</cell>
 
1282
</row>
 
1283
<row topline="true">
 
1284
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1285
\begin_inset Text
 
1286
 
 
1287
\begin_layout Standard
 
1288
 
 
1289
\family typewriter
 
1290
-I <arg>
 
1291
\end_layout
 
1292
 
 
1293
\end_inset
 
1294
</cell>
 
1295
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1296
\begin_inset Text
 
1297
 
 
1298
\begin_layout Standard
 
1299
X
 
1300
\end_layout
 
1301
 
 
1302
\end_inset
 
1303
</cell>
 
1304
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
1305
\begin_inset Text
 
1306
 
 
1307
\begin_layout Standard
 
1308
Include file search path
 
1309
\end_layout
 
1310
 
 
1311
\end_inset
 
1312
</cell>
 
1313
</row>
 
1314
<row topline="true">
 
1315
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1316
\begin_inset Text
 
1317
 
 
1318
\begin_layout Standard
 
1319
 
 
1320
\family typewriter
 
1321
-D <name>[=<value>]
 
1322
\end_layout
 
1323
 
 
1324
\end_inset
 
1325
</cell>
 
1326
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1327
\begin_inset Text
 
1328
 
 
1329
\begin_layout Standard
 
1330
X
 
1331
\end_layout
 
1332
 
 
1333
\end_inset
 
1334
</cell>
 
1335
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
1336
\begin_inset Text
 
1337
 
 
1338
\begin_layout Standard
 
1339
Macro definitions
 
1340
\end_layout
 
1341
 
 
1342
\end_inset
 
1343
</cell>
 
1344
</row>
 
1345
<row topline="true">
 
1346
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1347
\begin_inset Text
 
1348
 
 
1349
\begin_layout Standard
 
1350
 
 
1351
\family typewriter
 
1352
-U <name>
 
1353
\end_layout
 
1354
 
 
1355
\end_inset
 
1356
</cell>
 
1357
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1358
\begin_inset Text
 
1359
 
 
1360
\begin_layout Standard
 
1361
X
 
1362
\end_layout
 
1363
 
 
1364
\end_inset
 
1365
</cell>
 
1366
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
1367
\begin_inset Text
 
1368
 
 
1369
\begin_layout Standard
 
1370
Undefine a macro
 
1371
\end_layout
 
1372
 
 
1373
\end_inset
 
1374
</cell>
 
1375
</row>
 
1376
<row topline="true" bottomline="true">
 
1377
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1378
\begin_inset Text
 
1379
 
 
1380
\begin_layout Standard
 
1381
 
 
1382
\family typewriter
 
1383
--include <arg>
 
1384
\end_layout
 
1385
 
 
1386
\end_inset
 
1387
</cell>
 
1388
<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
 
1389
\begin_inset Text
 
1390
 
 
1391
\begin_layout Standard
 
1392
X
 
1393
\end_layout
 
1394
 
 
1395
\end_inset
 
1396
</cell>
 
1397
<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
 
1398
\begin_inset Text
 
1399
 
 
1400
\begin_layout Standard
 
1401
Forced include
 
1402
\end_layout
 
1403
 
 
1404
\end_inset
 
1405
</cell>
 
1406
</row>
 
1407
</lyxtabular>
 
1408
 
 
1409
\end_inset
 
1410
 
 
1411
 
 
1412
\end_layout
 
1413
 
 
1414
\begin_layout Caption
 
1415
\begin_inset LatexCommand \label{tab:options}
 
1416
 
 
1417
\end_inset
 
1418
 
 
1419
 
 
1420
\family typewriter
 
1421
ag++
 
1422
\family default
 
1423
 Compiler Option Summary
 
1424
\end_layout
 
1425
 
 
1426
\end_inset
 
1427
 
 
1428
 
 
1429
\end_layout
 
1430
 
 
1431
\begin_layout Subsubsection
 
1432
 
 
1433
\family typewriter
 
1434
--gen_config
 
1435
\end_layout
 
1436
 
 
1437
\begin_layout Standard
 
1438
Just create a parser configuration and quit afterwards.
 
1439
 The argument of the 
 
1440
\family typewriter
 
1441
-o 
 
1442
\family default
 
1443
option specifies the name of the file.
 
1444
 In any other case (no
 
1445
\family typewriter
 
1446
 --gen_config
 
1447
\family default
 
1448
 and/or no 
 
1449
\family typewriter
 
1450
-o
 
1451
\family default
 
1452
 option) a configuration file with the name 'puma.config' will be generated
 
1453
 in the directory where 
 
1454
\family typewriter
 
1455
ag++
 
1456
\family default
 
1457
 was invoked.
 
1458
 
 
1459
\end_layout
 
1460
 
 
1461
\begin_layout Subsubsection
 
1462
 
 
1463
\family typewriter
 
1464
--weave_only
 
1465
\end_layout
 
1466
 
 
1467
\begin_layout Standard
 
1468
Generate only woven source code files.
 
1469
 With 
 
1470
\family typewriter
 
1471
-o 
 
1472
\family default
 
1473
option and one file the generated output is named after the argument of
 
1474
 the 
 
1475
\family typewriter
 
1476
-o
 
1477
\family default
 
1478
 option.
 
1479
 
 
1480
\end_layout
 
1481
 
 
1482
\begin_layout Subsubsection
 
1483
 
 
1484
\family typewriter
 
1485
--path
 
1486
\end_layout
 
1487
 
 
1488
\begin_layout Standard
 
1489
This options differs only slightly from the 
 
1490
\family typewriter
 
1491
--path
 
1492
\family default
 
1493
 option of
 
1494
\family typewriter
 
1495
 ac++
 
1496
\family default
 
1497
.
 
1498
 In 
 
1499
\family typewriter
 
1500
ac++ 
 
1501
\family default
 
1502
it is mandatory to specify a project path, whereby 
 
1503
\family typewriter
 
1504
ag++
 
1505
\family default
 
1506
 the current working directory is used as project path by default.
 
1507
 Especially for larger projects it is NOT wise to rely on the default project
 
1508
 path, as weaving take a lot of time.
 
1509
 See the AspectC++ Compiler Manual for a more detailed description of this
 
1510
 option.
 
1511
\end_layout
 
1512
 
 
1513
\begin_layout Subsubsection
 
1514
 
 
1515
\family typewriter
 
1516
-c
 
1517
\end_layout
 
1518
 
 
1519
\begin_layout Standard
 
1520
Like the 
 
1521
\family typewriter
 
1522
-c
 
1523
\family default
 
1524
 option of 
 
1525
\family typewriter
 
1526
g++
 
1527
\family default
 
1528
, this options effects the creation of object files of one or more source
 
1529
 files.
 
1530
\end_layout
 
1531
 
 
1532
\begin_layout Subsubsection
 
1533
 
 
1534
\family typewriter
 
1535
-v|--verbose [<arg>]
 
1536
\end_layout
 
1537
 
 
1538
\begin_layout Standard
 
1539
Set the level of verbosity.
 
1540
 
 
1541
\end_layout
 
1542
 
 
1543
\begin_layout Subsubsection
 
1544
 
 
1545
\family typewriter
 
1546
--aspect-header <arg>
 
1547
\end_layout
 
1548
 
 
1549
\begin_layout Standard
 
1550
This option differs from meaning in 
 
1551
\family typewriter
 
1552
ac++
 
1553
\family default
 
1554
 only if dependencies are generated ( see 
 
1555
\begin_inset LatexCommand \ref{sub:Generating-dependency-information}
 
1556
 
 
1557
\end_inset
 
1558
 
 
1559
).
 
1560
\end_layout
 
1561
 
 
1562
\begin_layout Subsubsection
 
1563
 
 
1564
\family typewriter
 
1565
--keep_woven
 
1566
\end_layout
 
1567
 
 
1568
\begin_layout Standard
 
1569
Don't remove intermediate
 
1570
\emph on
 
1571
 
 
1572
\emph default
 
1573
woven files.
 
1574
\end_layout
 
1575
 
 
1576
\begin_layout Subsubsection
 
1577
 
 
1578
\family typewriter
 
1579
--c_compiler
 
1580
\end_layout
 
1581
 
 
1582
\begin_layout Standard
 
1583
Specify path to GNU C++ compiler\i \.{ }
 
1584
 The default is 
 
1585
\family typewriter
 
1586
g++.
 
1587
\end_layout
 
1588
 
 
1589
\begin_layout Subsubsection
 
1590
 
 
1591
\family typewriter
 
1592
--ac_compiler
 
1593
\end_layout
 
1594
 
 
1595
\begin_layout Standard
 
1596
Specify path to AspectC++ compiler\i \.{ }
 
1597
 By default ag++ assumes, that the ac++
 
1598
 executable is located in the same directory like itself.
 
1599
\end_layout
 
1600
 
 
1601
\begin_layout Subsubsection
 
1602
 
 
1603
\family typewriter
 
1604
--config_command
 
1605
\end_layout
 
1606
 
 
1607
\begin_layout Standard
 
1608
Specify the command which prints information about the compiler.
 
1609
 This information is necessary for generating the parser (puma) configuration
 
1610
 file.
 
1611
 The default value is 
 
1612
\begin_inset Quotes erd
 
1613
\end_inset
 
1614
 
 
1615
 
 
1616
\family typewriter
 
1617
<compiler> <compiler options> -E -dM -v -x c++ <an empty file>
 
1618
\begin_inset Quotes erd
 
1619
\end_inset
 
1620
 
 
1621
.
 
1622
\end_layout
 
1623
 
 
1624
\begin_layout Subsubsection
 
1625
 
 
1626
\family typewriter
 
1627
--config <arg>
 
1628
\end_layout
 
1629
 
 
1630
\begin_layout Standard
 
1631
Path to a puma configuration file.
 
1632
 If this option is available the configuration file will not be generated
 
1633
 automatically.
 
1634
\end_layout
 
1635
 
 
1636
\begin_layout Subsubsection
 
1637
 
 
1638
\family typewriter
 
1639
\begin_inset LatexCommand \label{sub:--Xcompiler}
 
1640
 
 
1641
\end_inset
 
1642
 
 
1643
--Xcompiler
 
1644
\end_layout
 
1645
 
 
1646
\begin_layout Standard
 
1647
 
 
1648
\family typewriter
 
1649
ac++ 
 
1650
\family default
 
1651
and 
 
1652
\family typewriter
 
1653
ag++ 
 
1654
\family default
 
1655
options that might interfere with 
 
1656
\family typewriter
 
1657
g++ 
 
1658
\family default
 
1659
options are not recognized after using 
 
1660
\family typewriter
 
1661
--Xcompiler 
 
1662
\family default
 
1663
in the argument list of an 
 
1664
\family typewriter
 
1665
ag++ 
 
1666
\family default
 
1667
invocation.
 
1668
 
 
1669
\end_layout
 
1670
 
 
1671
\begin_layout Subsubsection
 
1672
 
 
1673
\family typewriter
 
1674
\begin_inset LatexCommand \label{sub:--Xweaver}
 
1675
 
 
1676
\end_inset
 
1677
 
 
1678
--Xweaver
 
1679
\end_layout
 
1680
 
 
1681
\begin_layout Standard
 
1682
Enable the recognition of those 
 
1683
\family typewriter
 
1684
ac++ 
 
1685
\family default
 
1686
and 
 
1687
\family typewriter
 
1688
ag++ 
 
1689
\family default
 
1690
options which previously have been disabled by the usage of --
 
1691
\family typewriter
 
1692
Xcompiler.
 
1693
\end_layout
 
1694
 
 
1695
\begin_layout Subsection
 
1696
\begin_inset LatexCommand \label{sub:Generating-dependency-information}
 
1697
 
 
1698
\end_inset
 
1699
 
 
1700
Generating dependency information
 
1701
\end_layout
 
1702
 
 
1703
\begin_layout Standard
 
1704
To produce dependency files just pass the 
 
1705
\family typewriter
 
1706
-M 
 
1707
\family default
 
1708
or 
 
1709
\family typewriter
 
1710
-MM 
 
1711
\family default
 
1712
(consult the GNU C++ Compiler Manual) to 
 
1713
\family typewriter
 
1714
ag++
 
1715
\family default
 
1716
 .
 
1717
 Dependency files generated by 
 
1718
\family typewriter
 
1719
ag++ 
 
1720
\family default
 
1721
are slighty different from dependency files created by 
 
1722
\family typewriter
 
1723
g++
 
1724
\family default
 
1725
, as they contain dependencies to aspect header files.
 
1726
 If the 
 
1727
\family typewriter
 
1728
--aspect-header 
 
1729
\family default
 
1730
option is provided, only the header file specified as option argument is
 
1731
 considered when building the dependency file; otherwise the dependency
 
1732
 file will contain all aspect header files within the whole project path
 
1733
 .
 
1734
 
 
1735
\end_layout
 
1736
 
 
1737
\begin_layout Subsection
 
1738
Examples
 
1739
\end_layout
 
1740
 
 
1741
\begin_layout Itemize
 
1742
 
 
1743
\family typewriter
 
1744
ag++ --help
 
1745
\family default
 
1746
 
 
1747
\newline
 
1748
Displays all options with a short description.
 
1749
\end_layout
 
1750
 
 
1751
\begin_layout Itemize
 
1752
 
 
1753
\family typewriter
 
1754
ag++ -o test Test.cc main.cc
 
1755
\newline
 
1756
 
 
1757
\family default
 
1758
Weave, compile and link the source files 
 
1759
\family typewriter
 
1760
Test.cc
 
1761
\family default
 
1762
 and 
 
1763
\family typewriter
 
1764
main.cc
 
1765
\family default
 
1766
.
 
1767
 The created executable will be named '
 
1768
\family typewriter
 
1769
test
 
1770
\family default
 
1771
'.
 
1772
\end_layout
 
1773
 
 
1774
\begin_layout Itemize
 
1775
 
 
1776
\family typewriter
 
1777
ag++ --gen_config
 
1778
\newline
 
1779
 
 
1780
\family default
 
1781
Create a puma configuration file named 
 
1782
\family typewriter
 
1783
puma.config
 
1784
\family default
 
1785
 within the current working directory.
 
1786
 
 
1787
\end_layout
 
1788
 
 
1789
\begin_layout Itemize
 
1790
 
 
1791
\family typewriter
 
1792
ag++ --gen_config -o my.config
 
1793
\newline
 
1794
 
 
1795
\family default
 
1796
Create a puma configuration file named 
 
1797
\family typewriter
 
1798
my.config.
 
1799
\end_layout
 
1800
 
 
1801
\begin_layout Itemize
 
1802
 
 
1803
\family typewriter
 
1804
ag++ --path src --include_files --dest gen/includes
 
1805
\newline
 
1806
 
 
1807
\family default
 
1808
Generate modified include files out of all include files found below 
 
1809
\family typewriter
 
1810
src
 
1811
\family default
 
1812
 directory and store them under '
 
1813
\family typewriter
 
1814
gen/includes
 
1815
\family default
 
1816
'.
 
1817
\end_layout
 
1818
 
 
1819
\begin_layout Itemize
 
1820
 
 
1821
\family typewriter
 
1822
ag++ -M -MFmain.dep main.cc
 
1823
\newline
 
1824
 
 
1825
\family default
 
1826
Generate dependency file 
 
1827
\family typewriter
 
1828
main.dep 
 
1829
\family default
 
1830
from source file 
 
1831
\family typewriter
 
1832
main.cc
 
1833
\family default
 
1834
 .
 
1835
\end_layout
 
1836
 
 
1837
\begin_layout Itemize
 
1838
 
 
1839
\family typewriter
 
1840
ag++ -p ../aspects -p .
 
1841
 --Xcompiler
 
1842
\newline
 
1843
 
 
1844
\family default
 
1845
This string could be used to substitute 
 
1846
\family typewriter
 
1847
g++
 
1848
\family default
 
1849
 in a simple 
 
1850
\family typewriter
 
1851
make
 
1852
\family default
 
1853
 environment.
 
1854
\end_layout
 
1855
 
 
1856
\end_body
 
1857
\end_document