summaryrefslogtreecommitdiff
path: root/support/gtex-letter/manual/html/rc-files.html
blob: f6d24aff09c60eea88b2aaef874ea3ff312f8bb1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
<HTML><HEAD><TITLE>Gtex-Letter User Manual</TITLE>

<LINK REL="HOME" TITLE="Gtex-Letter User Manual" HREF="index.html">
<LINK REL="PREVIOUS" TITLE="" HREF="advanced-guis.html">
<LINK REL="NEXT" TITLE="" HREF="advanced-features.html">

</HEAD><BODY>

<DIV CLASS="NAVHEADER">

<TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0">

<TR> <TH COLSPAN="3" ALIGN="center">Gtex-Letter User Manual</TH></TR>

<TR><TD WIDTH="10%" ALIGN="left" VALIGN="bottom"><A HREF="advanced-guis.html">Prev</A></TD>

	<TD WIDTH="80%" ALIGN="center" VALIGN="bottom"></TD>
	<TD WIDTH="10%" ALIGN="right" VALIGN="bottom"><A HREF="advanced-features.html">Next</A></TD>

</TR></TABLE>

<HR ALIGN="LEFT" WIDTH="100%"></DIV><DIV CLASS="CHAPTER"><H1><A NAME="rc-files">The Configuration File(s)</A></H1>

<DIV CLASS="TOC"><DL>

<DT><B>Table of Contents</B></DT>
<DT><A HREF="rc-files.html#various-files">The Different Files</A></DT>
<DT><A HREF="rc-files.html#options">The Options</A></DT>

<DD><DL><DT><A HREF="rc-files.html#addressbook">Addressbook</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#mydvips">Mydvips</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#mydvipdf">Mydvipdf</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#mylatex">Mylatex</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#myeditor">Myeditor</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#myprintcommand">Myprintcommand</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#myxdvi">Myxdvi</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#dateformat">Dateformat</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#advertise">Advertise</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#quite_latex">Quite_latex</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#filename_guess_format">Filename_guess_format</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#filename_guess_path">Filename_guess_path</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#mycountry">Mycountry</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#guilevel">Guilevel</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#opening_defaults">Opening_defaults</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#closing_defaults">Closing_defaults</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#addressbook_columns">Addressbook_columns</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#addressbook_column_widths">Addressbook_column_widths</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#header_defaults">Header_defaults</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#lettertype">Lettertype</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#addressformat">Addressformat</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#texcommands">Texcommands</A></DT></DL></DD>

<DT><A HREF="rc-files.html#variable">The gtex-letter variables</A></DT>
<DD><DL><DT><A HREF="rc-files.html#address-variables">Address-variables</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#letter-based-variables">Letter-based variables</A></DT></DL></DD>
<DD><DL><DT><A HREF="rc-files.html#other-variables">Other variables</A></DT></DL></DD>

</DL></DIV>

<P>&nbsp;</P>

<DIV CLASS="SECT1"><H1 CLASS="SECT1"><A NAME="various-files">The Different Files</A></H1>

<P>   
    Gtex-Letter looks for a configuration file called <i class="EMPHASIS">.gtex-letterrc</i> when started. This file may reside in the current directory, in your home directory or in the place, where the application is installed. This is also the order of places where gtex-letter will look for the file.</P>

<P>   
    The gtex-letter package comes with a set of different config files containing different variants configuration variants. Mainly these files cover different languages. So if the your language of choice is Spanish, then you should run gtex-letter with the Spanish config files called <i class="EMPHASIS">.gtex-letterrc.spanish</i>. This can be done accomplished with this call:</P>
    
<P><i class="EMPHASIS">gtex-letter --rcfile .gtex-letterrc.spanish</i></P>

<P>
    The make the Spanish config file the standard one for the time being, copy it to your home directory under the name <i class="EMPHASIS">.gtex-letterrc</i>. Gtex-Letter will look for that file when started. You can do it with your filemanager or using the following call:
    </P>

<P><i class="EMPHASIS">cp /opt/gnome/bin/gtex-letter-prg/.gtex-letterrc.spanish ~</i></P>

<P>   
    (This will work only if you used the standard directory for the install. If you changed it, then you have to change the path in the above command too, of course.) 
    </P>
    

</DIV>

<P>&nbsp;</P>

<DIV CLASS="SECT1"><H1 CLASS="SECT1"><A NAME="options">The Options</A></H1>

<P>
    But now for the internals of the config file. This section will describe the different options, one by one.
    </P>
    
</DIV>

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="addressbook">Addressbook</A></H2>

<P>   
	This is the location of your gnome-card-addressbook. 
	You can define multiple addressbooks. Seperate them 
	with a semicolon (;). The default is: </P>

<P><i class="EMPHASIS">addressbook='~/.gnome/GnomeCard.gcrd'</i></P>


<P>&nbsp;</P>


<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="mydvips">Mydvips</A></H2>

<P>
	The programm call to produce the ps-file out of the dvi-file.
	Ps means postscript and dvi device independent. If you do not
	know what this is all about, leave it the way it is. These
	are LaTeX specific programms gtex-letter depends upon.</P>

<P><i class="EMPHASIS">mydvips='dvips __short_filename__'</i></P>

<P>
	__short_filename__ describes the filename without the suffix.
	The other possible variable is __filename__, meaning the
	normal filename. (Actually all the 
	<A HREF="rc-files.html#variables">gtex-letter-variables</A>
	are supported, but most do not make sense.)</P>

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="mydvipdf">Mydvipdf</A></H2>

<P>
	The programm call to produce the 
	pdf-file from the dvi-file. Pdf is the popular Adobe Acrobat
	format and dvi means device independent. If you do not
	know what this is all about, leave it the way it is. 
	Default is:</P>

<P><i class="EMPHASIS">mydvipdf='dvipdf __short_filename__'</i></P>

<P>
        __short_filename__ describes the filename without the suffix. 
	The other possible variable is __filename__, meaning the
	normal filename. (Actually all the 
	<A HREF="rc-files.html#variables">gtex-letter-variables</A>
	are supported, but most do not make sense.)</P>

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="mylatex">Mylatex</A></H2>

<P>
	The LaTeX call to produce the dvi-file. Dvi stands for device
	independent. You do not need to know, how gtex-letter makes use
	of this stuff. It is best to leave it the way it is.
	
<P><i class="EMPHASIS">Default is 'latex __short_filename__'</i></P>

<P>
        __short_filename__ describes the filename without the suffix. 
	The other possible variable is __filename__, meaning the
	normal filename. (Actually all the 
	<A HREF="rc-files.html#variables">gtex-letter-variables</A>
	are supported, but most do not make sense.)</P>
	

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="myeditor">Myeditor</A></H2>

<P>
	The command to bring up the editor, that lets you proceed with
	your letter manually.</P>

<P><i class="EMPHASIS">myeditor='xterm -e vi __filename__'</i></P>

<P>
        This call opens a shell and vi therein with the current file.
	__filename__ means the filename choosen by you or the programm.
	(Actually all the 
	<A HREF="rc-files.html#variables">gtex-letter-variables</A>
	are supported, but most do not make sense.) If you are not
	used to vi, a classical Unix editor, you should replace it
	with you favorite editor. If your editor has a graphical
	version, you do not have to call it via an xterm. I use:</P>
	
<P><i class="EMPHASIS">myeditor='gvim __filename__'</i></P>
	
<P>
	Gvim (for Gtx-Vim) is vi on steroids. The best editor ever, hehe!</P>
	

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="myprintcommand">Myprintcommand</A></H2>

<P>
	The command used to print the file.
	
<P><i class="EMPHASIS">myprintcommand=''lpr __short_filename__.ps'</i></P>	

<P>
	__short_filename describes the filename without 
	the suffix. The other possible variable is 
	__filename__, meaning the normal filename. (Actually all the 
	<A HREF="rc-files.html#variables">gtex-letter-variables</A>
	are supported, but most do not make sense.) If you change
	anything in this call, make sure the right file is being
	printed (usually the postscript one).</P>

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="myxdvi">Myxdvi</A></H2>

<P>
	The command to call the dvi-viewer. Dvi means device independent.
	This is the preview version. Default is:</P>
	
<P><i class="EMPHASIS">myxdvi='xdvi __short_filename__'</i></P>

<P>
	__short_filename describes the filename without the suffix. 
	The other possible variable is __filename__, 
	meaning the normal filename. (Actually all the 
	<A HREF="rc-files.html#variables">gtex-letter-variables</A>
	are supported, but most do not make sense.)</P>

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="dateformat">Dateformat</A></H2>

<P>
	You can use this option to include a specially
	formatted date in the filename. Please refer to
	<A HREF="rc-files.html#filename_guess_format">filename_guess_format</A>
	for further information on this issue.</P>
	
<P><b>IMPORTANT NOTE</b>: This is _not_ the date 
	format that is displayed on the letter.</P>

<P>
	The date can be entered via the ANSI C date
	description format. Default is:</P>

<P><i class="EMPHASIS">filename_guess_format=%x</i></P>

<P>
	for the standard and English rc-files. For the other
	ones, the default is:</P>

<P><i class="EMPHASIS">filename_guess_format=%d.%m.%y</i></P>

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="advertise">Advertise</A></H2>

<P>
	This stands for an advertise-string in the
	generated LaTeX-file. If you do not care about LaTeX
	and just want to have your letter, then this is of no
	importance to you. Put it to 'false' or 'no'
	to suppress the advertise-string.
	Default is:</P>

<P><i class="EMPHASIS">advertise=yes</i></P>

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="quite_latex">Quite_latex</A></H2>

<P>
	Set this option to 1 or yes to suppress all 
	LaTeX output. It will also suppress the output of
	xdvi, dvips and dvipdf. If you do not know what this
	is all about, just leave it untouched. Default is:</P>

<P><i class="EMPHASIS">quite_latex=no</i></P>


<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="filename_guess_format">Filename_guess_format</A></H2>

<P>
	Gtex-letter will choose a filename for your letter
	based upon your selections, the  and this option. This
	is called filename guessing.
	Optional values and separators
	are possible (please refer to section 
	<A HREF="rc-files.html#addressformat">addressformat</A> 
	for explanation).</P>

<P>
	If there is empty space in the format or in the
	parameters you supply (subjects of letters tend to
	have empty space), these spaces will be converted to
	'_'. The same applies to ':' and '/'.</P>

<P>
	Please make sure that the end of the format is 
	'.tex'.  The possible variables are explained in the
	<A HREF="rc-files.html#variables">gtex-letter-variables</A>-section.</A>

<P><i class="EMPHASIS">filename_guess_format=__id__[-__subject__].tex</i></P>

<P>
	This means a guessed filename with the id of the addressee and
	if a subject for the letter is choosen, a hyphen and the subject.
	The sufix is .tex.</P>


<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="filename_guess_path">Filename_guess_path</A></H2>

<P>
	Gtex-letter will choose a filename for your letter
	based upon your selections, the 
	<A HREF="rc-files.html#filename_guess_format">filename guess format</A>
	and this path, which is prepended to the guessed filename. Default is:</P>

<P><i class="EMPHASIS">filename_guess_path=~/</i></P>

<P>
	This means your home directory.</P>

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="mycountry">Mycountry</A></H2>

<P>
	If you define mycountry, gtex-letter will
	hide the country in the address if it is equal to mycountry.
	This might not be true if you have changed the
	<A HREF="rc-files.html#addressformat"></A>addressformat.</P>


<P><i class="EMPHASIS">mycountry=D</i></P>

<P>
	Gtex-letter checks the country-field in the addresses of your
	addressbook. So if you abbrevated the countrys there, you have
	to abbrevate the mycountry-option too.</P>

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="guilevel">Guilevel</A></H2>

<P>
	This is the level of complexity of the graphical
	user interface (gui). Default value is:</P>
	
<P><i class="EMPHASIS">guilevel=novice</i></P>

<P> 
	Guilevel '<A HREF="gui.html#gui">novice</A>',
	means simple screens, that are easy to 
	understand. After a few runs you might consider
	moving to '<A HREF="advanced-guis.html#intermediate">intermediate</A>'.
	This is a bit more straight forward. You can give it a try with the
	command-line option "--guilevel 'intermediate'".
	At last, there is the guilevel '<A HREF="advanced-guis.html#expert">expert</A>'
	that brings you everything in one big page.</P>
<P>
	Various aliases exist for the three guilevels. The following
	values are possible: novice, beginner, normal, intermediate, 
	advanced, expert, 0, 1 and 2.

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="opening_defaults">Opening_defaults</A></H2>

<P>
	The different default values for the
	combox or buttons for the opening. Please enter 
	the openings seperated by ';'. 
	But do not forget to set quotation marks in front and behind every opening.</P>

<P>
	It is possible to further enhance the buttons with 
	the name of the address chosen. This can be reached 
	via inclusion of a term like __lastname__. The possible
	terms are explained in the
	<A HREF="rc-files.html#variables">gtex-letter-variables</A>-section.</A>
	Most variables make little sense however.</P>

<P>
	Furthermore, the is a kind of 'if-then'-pattern matching
	possible. This applies to people writing
	in languages, where the opening depends on the
	sex of the addressee. This is explained in the section of
	<A HREF="advanced-features.html#sex-adoption">adoption to the sex</A>
	of an addressee. The default in the standard-file is:</P>


<P><i class="EMPHASIS">opening_defaults="Dear __name_prefix__ __lastname__,"; "Dear __firstname__,"; "To whom it may concern,"</i></P>

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="closing_defaults">Closing_defaults</A></H2>

<P>
	The different default buttons for the 
	closing. Please enter the openings seperated by a semicolon (;).
	But do not forget to set quotation marks around every closing.
	'If-then'-pattern matching is possible. They are explained
	in the section on <A HREF="rc-files.html#opening_defaults">opening_defaults</A>.
	Default is:</P>

<P><i class="EMPHASIS">closing_defaults="Yours sincerely,"; "Regards,"; "With the best regards,"; "With the very best regards,"</i></P>

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="addressbook_columns">Addressbook_columns</A></H2>

<P>
	The different columns of the gtex-letter 
	representation of your addressbook. You can choose from 
	the following columns: Name_Prefix, Firstname, Lastname, 
	Street, ZIP, City, Country, Telephone. 
	This list is the default value:</P>

<P><i class="EMPHASIS">addressbook_columns=Name_Prefix, Firstname, Lastname, Street, ZIP, City, Country, Telephone</i></P>

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="addressbook_column_widths">Addressbook_column_widths</A></H2>

<P>
	The widths of the columns, seperated 
	by comma. Please make sure, that 
	the number of columns and the number of column widths 
	match. The width is counted in pixels. Default is:</P>

<P><i class="EMPHASIS">addressbook_column_widths=50, 80, 100, 120, 50, 100, 20, 90</i></P>

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="header_defaults">Header_defaults</A></H2>

<P>
	You can enter a list of different LaTeX-header 
	filenames here. Please enter the header filenames 
	seperated by ';'. You may 
	choose to omit the '.tex' in the filename.</P>

<P>	
	<b>A WORD OF WARNING</b>: LaTeX letter classes are very specific.
	The letter-header defines some parameters that will be
	passed to LaTeX while processing your letter of the
	specified class. If you simply choose to use a
	different of the letter-headers that come with gtex-letter, 
	without adopting the rc-file. LaTeX will complain.
	However, it is secure to use the default headers that
	are defined in every rc-file.</P>

<P>
	If you are not used to LaTeX, you should start to copy
	one of the default headers and adopt it to your needs. It is
	quite tricky to write a header from scratch. Default is:</P>

<P><i class="EMPHASIS">header_defaults='letterheader.standard_latex'</i></P>


<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="lettertype">Lettertype</A></H2>

<P>
	The type of your LaTeX-letter. There are many different LaTeX letter
	classes available. Gtex-letter can be adopted to support them using
	this option and different <A HREF="rc-files.html#texcommands">LaTeX-commands</A>.
	The default is:</P>

<P><i class="EMPHASIS">lettertype='letter'</i></P>

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="addressformat">Addressformat</A></H2>

<P>
	This option(s) defines the format of the addresses in your
	letter. This option is a multiple liner. The lines are numbered
	starting from 0, the number seperated from the name of the option by a dot.
	Empty lines are possible.
	The possible keywords are explained in the
	<A HREF="rc-files.html#variables">gtex-letter-variables</A>-section.</A></P>

<P>
	Optional values are possible. They are set within [...].
	An example: Not every address person has a name_suffix.
	However, if there is a name_suffix, it is seperated
	from that name via a "," in the default setting. 
	If there is no name_suffix that
	"," should be omitted, of course. Therefor the name_suffix
	together with the "," is optional: [, __name_suffix__].
	Do not worry about optional terms without a separator.
	Like __post_office__ as an example. They will be omitted
	anyways. The optional clause is only interesting together
	with separators. The deault is:</P>

<P>
<i class="EMPHASIS">addressformat.0=__name_prefix__ </i><br>
<i class="EMPHASIS">addressformat.1=[__firstname__ ][__middlename__ ]__lastname__[, __name_suffix__]</i><br>
<i class="EMPHASIS">addressformat.2=__post_office__</i><br>
<i class="EMPHASIS">addressformat.3=__extended__</i><br>
<i class="EMPHASIS">addressformat.4=__street__</i><br>
<i class="EMPHASIS">addressformat.5=[__country__--][__zip__ ]__city__[, __region__]</i></P>

<P>&nbsp;</P>

<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="texcommands">Texcommands</A></H2>

<P>
	These are the LaTeX-commands. More or less the template file
	for your letters. If you are not used to LaTeX, just leave it untouched.
	This option is a multiple liner. The lines are numbered
	starting from 0, the number seperated from the name of the option by a dot.
	Empty lines are possible.
	The possible keywords are explained in the
	<A HREF="rc-files.html#variables">gtex-letter-variables</A>-section. 
	Default is:</A></P>
	
<P>
<i class="EMPHASIS">texcommands.0=\documentclass[12pt]{__lettertype__}</i><br>
<i class="EMPHASIS">texcommands.1=\usepackage[T1]{fontenc}</i><br>
<i class="EMPHASIS">texcommands.2=\usepackage[latin1]{inputenc}</i><br>
<i class="EMPHASIS">texcommands.3=\name{Charles Mustermann}</i><br>
<i class="EMPHASIS">texcommands.4=\usepackage{graphicx}</i><br>
<i class="EMPHASIS">texcommands.5=\input{__letter_header__}</i><br>
<i class="EMPHASIS">texcommands.6=\begin{document}</i><br>
<i class="EMPHASIS">texcommands.7=\begin{letter}{__letter_address__}</i><br>
<i class="EMPHASIS">texcommands.8=\textbf{\Large\raggedleft __letter_subject__}</i><br>
<i class="EMPHASIS">texcommands.9=\opening{__letter_opening__}</i><br>
<i class="EMPHASIS">texcommands.10=__letter_contents__</i><br>
<i class="EMPHASIS">texcommands.11=</i><br>
<i class="EMPHASIS">texcommands.12=\closing{__letter_closing__}</i><br>
<i class="EMPHASIS">texcommands.13=\end{letter}</i><br>
<i class="EMPHASIS">texcommands.14=\end{document}</i></P>

<P>&nbsp;</P>




<DIV CLASS="SECT2"><H2 CLASS="SECT2"><A NAME="variables">Variables</A></H2>

<P>
	The following options can be used in the gtex-letter and its config-file.
	They are all embraced by two underscores. This makes the rc-file
	more readable.</P>

<P>	
	<A NAME="address-variables">The address-variables:</A></P>

<P>
The Id (Identification) of the choosen address: <i class="EMPHASIS">__id__</i><br>
The prefix of a name in an address: <i class="EMPHASIS">__name_prefix__</i><br>
The firstname of an address: <i class="EMPHASIS">__firstname__</i><br>
The middlename: <i class="EMPHASIS">__middlename__</i><br>
The lastname: <i class="EMPHASIS">__lastname__</i><br>
The suffix of a name in an address: <i class="EMPHASIS">__name_suffix__</i><br>
The extended part of an address: <i class="EMPHASIS">__extended__</i><br>
The post-office-part of an address: <i class="EMPHASIS">__post_office__</i><br>
The street: <i class="EMPHASIS">__street__</i><br>
The postal code (zip-code): <i class="EMPHASIS">__zip__</i><br>
The city: <i class="EMPHASIS">__city__</i><br>
The region: <i class="EMPHASIS">__region__</i><br>
The country: <i class="EMPHASIS">__country__</i></P>

<P>
	<A NAME="letter-based-variables">The letter-based variables:</A></P>

<P>
The subject of your letter: <i class="EMPHASIS">__subject__</i><br>
The opening choosen: <i class="EMPHASIS">__opening__</i><br>
The closing: <i class="EMPHASIS">__closing__</i><br>
The filename: <i class="EMPHASIS">__filename__</i><br>
The filename without the suffix: <i class="EMPHASIS">__short_filename__</i></P>

<P>
	<A NAME="other-variables">Other variables:</A></P>
<P>
Todays date: <i class="EMPHASIS">__date__</i></P>

</DIV>



<DIV CLASS="NAVFOOTER">

<HR ALIGN="LEFT" WIDTH="100%">

<TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0">

<TR>
<TD WIDTH="33%" ALIGN="left" VALIGN="top"><A HREF="advanced-guis.html">Prev</A></TD>
<TD WIDTH="34%" ALIGN="center" VALIGN="top"><A HREF="index.html">Home</A></TD>
<TD WIDTH="33%" ALIGN="right" VALIGN="top"><A HREF="advanced-features.html">Next</A></TD>
</TR>

<TR>
<TD WIDTH="33%" ALIGN="left" VALIGN="top">Advanced User-Levels</TD>
<TD WIDTH="34%" ALIGN="center" VALIGN="top">&nbsp;</TD>
<TD WIDTH="33%" ALIGN="right" VALIGN="top">Advanced Features</TD>
</TR>

</TABLE>
</DIV>
</BODY>
</HTML>