summaryrefslogtreecommitdiff
path: root/support/gtex-letter/manual
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /support/gtex-letter/manual
Initial commit
Diffstat (limited to 'support/gtex-letter/manual')
-rw-r--r--support/gtex-letter/manual/html/advanced-features.html162
-rw-r--r--support/gtex-letter/manual/html/advanced-guis.html94
-rw-r--r--support/gtex-letter/manual/html/copyright.html95
-rw-r--r--support/gtex-letter/manual/html/gui.html158
-rw-r--r--support/gtex-letter/manual/html/ideen30
-rw-r--r--support/gtex-letter/manual/html/images/address.jpegbin0 -> 29677 bytes
-rw-r--r--support/gtex-letter/manual/html/images/advanced-opening.jpegbin0 -> 10246 bytes
-rw-r--r--support/gtex-letter/manual/html/images/contents.jpegbin0 -> 37577 bytes
-rw-r--r--support/gtex-letter/manual/html/images/filename.jpegbin0 -> 35008 bytes
-rw-r--r--support/gtex-letter/manual/html/images/makeup.jpegbin0 -> 28900 bytes
-rw-r--r--support/gtex-letter/manual/html/images/opening.jpegbin0 -> 30693 bytes
-rw-r--r--support/gtex-letter/manual/html/images/sample-letter.jpegbin0 -> 20355 bytes
-rw-r--r--support/gtex-letter/manual/html/index.html200
-rw-r--r--support/gtex-letter/manual/html/rc-files.html610
-rw-r--r--support/gtex-letter/manual/html/template.html77
-rw-r--r--support/gtex-letter/manual/html/users-manual-ideas27
16 files changed, 1453 insertions, 0 deletions
diff --git a/support/gtex-letter/manual/html/advanced-features.html b/support/gtex-letter/manual/html/advanced-features.html
new file mode 100644
index 0000000000..01b7d86a65
--- /dev/null
+++ b/support/gtex-letter/manual/html/advanced-features.html
@@ -0,0 +1,162 @@
+<HTML><HEAD><TITLE>Gtex-Letter User Manual</TITLE>
+
+<LINK REL="HOME" TITLE="Gtex-Letter User Manual" HREF="index.html">
+<LINK REL="PREVIOUS" TITLE="" HREF="rc-files.html">
+<LINK REL="NEXT" TITLE="" HREF="">
+
+</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="rc-files.html">Prev</A></TD>
+
+ <TD WIDTH="80%" ALIGN="center" VALIGN="bottom"></TD>
+ <TD WIDTH="10%" ALIGN="right" VALIGN="bottom"><A HREF=""></A></TD>
+
+</TR></TABLE>
+
+<HR ALIGN="LEFT" WIDTH="100%"></DIV><DIV CLASS="CHAPTER"><H1><A NAME="advanced-featrues">The Advanced Features</A></H1>
+
+<DIV CLASS="TOC"><DL>
+
+<DT><B>Table of Contents</B></DT>
+<DT><A HREF="advanced-features.html#sex-adoption">Automatic Adoption to the Sex of the Addressee</A></DT>
+<DT><A HREF="advanced-features.html#filenames">Paths and Filenames</A></DT>
+<DT><A HREF="advanced-features.html#noninteractive">The Non-Interactive Mode</A></DT>
+
+</DL></DIV>
+
+<P>&nbsp;</P>
+
+<DIV CLASS="SECT1"><H1 CLASS="SECT1"><A NAME="sex-adoption">Automatic Adoption to the Sex of the Addressee</A></H1>
+
+<P>
+ One of the prime features of gtex-letter is its configurable adoption
+ to the sex of the addressee of you letter. This is helpful in most
+ languages. For example in German, where the ending of adjectives depends
+ on the person's sex the adjective is connected to.</P>
+
+<P>
+ Therefore you write <i class="EMPHASIS">"Sehr geehrte Frau Schneider"</i> and <i class="EMPHASIS">"Sehr geehrter Herr Schulze"</i>. Accordingly it is <i class="EMPHASIS">"Estimada Sra. Gonzalez"</i> and <i class="EMPHASIS">"Estimado Sr. Ortega"</i> in Spanish. Of course, you do not want to make this adoption yourself; especially not in serial letters.</P>
+
+<P>
+ Gtex-letter will take care of it automatically, if you configure it in a proper way and if you use the addressbook for the selection of an addressee. Use one of the language-specific <A HREF="rc-files.html#various-files">rc-files</A> for a start. However, you can easily enhance the setting.</P>
+
+<P>
+ There is a kind of pattern matching included in the programm. Such a clause looks like this:</P>
+
+<P><i class="EMPHASIS">"Sehr geehrte[__name_prefix__='Herr':'r'] __name_prefix__ __lastname__,"</i></P>
+
+<P>
+ The part in braces is optional. It reads: If the prefix is equal to 'Herr', add an 'r'. Therefore, if the person is a female ('Frau'), nothing is added. This depends on the entries in your addressbook. It adopts only if you select one of the addressbook entries. If you enter an address directly into the <A HREF="gui.html#address-page">addressfield</A>, you have to take care of the sec yourself.</P>
+
+<p>
+ Also more complex clauses are possible. This is the default Spanish one:</P>
+
+<P><i class="EMPHASIS">"Estimad[__name_prefix__='Sr.':'o'][__name_prefix__='D.':'o'][__name_prefix__='Sra.':'a']<br>[__name_prefix__='Sta.':'a'][__name_prefix__='Dña.':'a'] __name_prefix__ __lastname__,"</i></P>
+
+<P>
+ It takes care of the multiple forms of common prefixes.</P>
+
+
+</DIV>
+
+<P>&nbsp;</P>
+
+<DIV CLASS="SECT1"><H1 CLASS="SECT1"><A NAME="filenames">Paths and Filenames</A></H1>
+
+
+<p>
+ In the standard setup, gtex-letter will use your home directory as the stanard
+ save your letter. Using the
+ <a href="rc-files.html#filename_guess_path">filename-guess-path-option</a>,
+ you set a different default path. (XXX: So far this only works for filename
+ guessing. It is planned to update that behavior to manually choosen filenames
+ too.)</P>
+
+<p>
+ Most of the time it is annoying to choose a filename by yourself. With gtex-letter,
+ you can let the application choose one. If you think it does not fit, you
+ can set a different one. Gtex-letter will just guess a filename, therefore
+ this feature is called filename-guessing. It depends on the
+ <a href="rc-files.html#filename_guess_path">filename-guess-path-option</a> and
+ the <a href="rc-files.html#filename_guess_format">filename-guess-format-option</a>.
+ With the latter you can define the way gtex-letter guesses the filename.
+ Let me present a few useful formats to you:</P>
+
+<p><i class="EMPHASIS">__subject__-__date__.tex</i></p>
+
+<p>
+ This one will set filename equal to the subject and the date, connected by
+ a hyphen. The suffix of the files should always be tex. Please remember,
+ that empty spaces, colons and slashes will all be converted to underscores.</p>
+
+
+<p><i class="EMPHASIS">__id____date__.tex</i></p>
+
+<p>
+ Using this clause, you command gtex-letter to make a filename out of the addressbook-id and the date.</p>
+
+
+<p><i class="EMPHASIS">[__id__-][__subject__-]__date__.tex</i></p>
+
+<p>
+ This format uses optional clauses. If you did not choose an address from the
+ addressbook, the id and the hyphen will be omitted. The id would be omitted anyways
+ of course, but using the braces, you make clear to set the hyphen just in
+ case an id is set. The same holds for the subject. If it is empty, no subject and
+ no hyphen will be used.</p>
+
+</DIV>
+
+<P>&nbsp;</P>
+
+<DIV CLASS="SECT1"><H1 CLASS="SECT1"><A NAME="noninteractive">The Non-Interactive Mode</A></H1>
+
+<p>
+ Gtex-letter comes with a non-interactive mode, that can be called from the
+ console. Use the <i class="EMPHASIS">-n/--nogui-option</i> to call it. Of course
+ you have submit enough information to produce a successful letter. We will let
+ it up to you to find out what fancy things you can do with this feature.
+ Just a hint about its power:</p>
+
+
+<p><i class="EMPHASIS">gtex-letter --address ted_baker --opening 'Dear Mr. Baker' --closing 'Yours sincerely' --file ~/letters/we_have_moved --nogui --noshow --print</i></p>
+
+<p>
+ This will create a letter for Ted Baker, with supplied opening and closing.
+ The text of the letter will be taken from the file 'we_have_moved'. The letter
+ will be assembles non-interactively and will be sent to the printer directly,
+ without showing it first.</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="rc-files.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=""></A></TD>
+</TR>
+
+<TR>
+<TD WIDTH="33%" ALIGN="left" VALIGN="top">The Configuration Files</TD>
+<TD WIDTH="34%" ALIGN="center" VALIGN="top">&nbsp;</TD>
+<TD WIDTH="33%" ALIGN="right" VALIGN="top"></TD>
+</TR>
+
+</TABLE>
+</DIV>
+</BODY>
+</HTML>
diff --git a/support/gtex-letter/manual/html/advanced-guis.html b/support/gtex-letter/manual/html/advanced-guis.html
new file mode 100644
index 0000000000..dd9509152f
--- /dev/null
+++ b/support/gtex-letter/manual/html/advanced-guis.html
@@ -0,0 +1,94 @@
+<HTML><HEAD><TITLE>Gtex-Letter User Manual</TITLE>
+
+<LINK REL="HOME" TITLE="Gtex-Letter User Manual" HREF="index.html">
+<LINK REL="PREVIOUS" TITLE="" HREF="gui.html">
+<LINK REL="NEXT" TITLE="" HREF="rc-files.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="gui.html">Prev</A></TD>
+
+ <TD WIDTH="80%" ALIGN="center" VALIGN="bottom"></TD>
+ <TD WIDTH="10%" ALIGN="right" VALIGN="bottom"><A HREF="rc-files.html">Next</A></TD>
+
+</TR></TABLE>
+
+<HR ALIGN="LEFT" WIDTH="100%"></DIV><DIV CLASS="CHAPTER"><H1><A NAME="advanced-guis">The Advanced User Levels</A></H1>
+
+<DIV CLASS="TOC"><DL>
+
+<DT><B>Table of Contents</B></DT>
+<DT><A HREF="advanced-guis.html#intermediate">The Intermediate Userlevel</A></DT>
+<DT><A HREF="advanced-guis.html#expert">The Expert Userlevel</A></DT>
+
+</DL></DIV>
+
+<P>&nbsp;</P>
+
+<DIV CLASS="SECT1"><H1 CLASS="SECT1"><A NAME="intermediate">The Intermediate Userlevel</A></H1>
+
+<P>
+ Gtex-Letter comes with three userlevels. Out of box, it starts with the <A HREF="gui.html">novice</A> guilevel (Graphical User Interface Level). The novice is very strict in bringing only little information on the screen. This means more pages are necessary to make up a letter. Once you get used to how it works (a few runs should do). You can upgrade to the intermediate guilevel. You can give it a try by using the option 'guilevel' at <A HREF="XXX.html">startup</A>:</P>
+
+<P>
+ <i class="EMPHASIS">gtex-letter --guilevel intermediate</i></P>
+
+<p>
+ The difference is not that big. There are just more fields on one page. You will certainly get used to it. A subtle difference consists for the standard openings and closings. In the novice userlevel you select them via a drop down list. In the intermediate and <A HREF=advanced-guis.html#expert>expert</A> level a list of buttons is presented to you:
+
+
+<DIV CLASS="FIGURE">
+<P><B>Figure 7. Standard Openings with Buttons</B></P>
+<P><IMG SRC="images/advanced-opening.jpeg"></P>
+</DIV>
+
+<p>
+ Simply click the buttons and the text is copied to the textfield next to them.</P>
+
+</DIV>
+
+<P>&nbsp;</P>
+
+<DIV CLASS="SECT1"><H1 CLASS="SECT1"><A NAME="expert">The Expert Userlevel</A></H1>
+
+<P>
+ The expert user level presents you the whole letter generation process on one big page. Call this gui (Graphical User Interface) with:</P>
+
+<P>
+ <i class="EMPHASIS">gtex-letter --guilevel expert</i></P>
+
+<P>
+ Fill in the fields you know from the less advanced guilevels and click on the 'next'-button to get to the <A HREF=gui.html#makeup>makeup-page</A>.</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="gui.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="rc-files.html">Next</A></TD>
+</TR>
+
+<TR>
+<TD WIDTH="33%" ALIGN="left" VALIGN="top">Using Gtex-Letter</TD>
+<TD WIDTH="34%" ALIGN="center" VALIGN="top">&nbsp;</TD>
+<TD WIDTH="33%" ALIGN="right" VALIGN="top">The Configuration Files</TD>
+</TR>
+
+</TABLE>
+</DIV>
+</BODY>
+</HTML>
diff --git a/support/gtex-letter/manual/html/copyright.html b/support/gtex-letter/manual/html/copyright.html
new file mode 100644
index 0000000000..35eb16e757
--- /dev/null
+++ b/support/gtex-letter/manual/html/copyright.html
@@ -0,0 +1,95 @@
+<HTML
+><HEAD
+>
+<LINK REL="PREVIOUS" TITLE="Introduction" HREF="index.html">
+
+<LINK REL="HOME" TITLE="Gtex-Letter User Manual" HREF="index.html">
+
+<LINK REL="NEXT" TITLE="Using Gtex-Letter (The User Interface)" HREF="gui.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
+></TABLE
+><HR
+ALIGN="LEFT"
+WIDTH="100%"></DIV
+><DIV
+CLASS="LEGALNOTICE"
+><P
+></P
+>
+</DIV>
+<DIV CLASS="SECT1"><H1 CLASS="SECT1">Copyright</H1>
+
+
+<P
+>This documentation is free software; you can redistribute
+ it and/or modify it under the terms of the GNU General Public
+ License as published by the Free Software Foundation; either
+ version 2 of the License, or (at your option) any later
+ version.</P
+><P
+>This program is distributed in the hope that it will be
+ useful, but WITHOUT ANY WARRANTY; without even the implied
+ warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+ See the GNU General Public License for more details.</P
+><P
+>You should have received a copy of the GNU General Public
+ License along with this program; if not, write to the Free
+ Software Foundation, Inc., 59 Temple Place, Suite 330, Boston,
+ MA 02111-1307 USA</P
+><P
+>For more details see the file COPYING in the source
+ distribution of GNOME.</P
+><P
+></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"
+>&nbsp;</TD
+><TD
+WIDTH="34%"
+ALIGN="center"
+VALIGN="top"
+><A
+HREF="index.html"
+>Home</A
+></TD
+><TD
+WIDTH="33%"
+ALIGN="right"
+VALIGN="top"
+>&nbsp;</TD
+></TR
+></TABLE
+></DIV
+></BODY
+></HTML
+>
diff --git a/support/gtex-letter/manual/html/gui.html b/support/gtex-letter/manual/html/gui.html
new file mode 100644
index 0000000000..01fde718e4
--- /dev/null
+++ b/support/gtex-letter/manual/html/gui.html
@@ -0,0 +1,158 @@
+<HTML><HEAD><TITLE>Gtex-Letter User Manual</TITLE>
+
+<LINK REL="HOME" TITLE="Gtex-Letter User Manual" HREF="index.html">
+<LINK REL="PREVIOUS" TITLE="" HREF="copyright.html">
+<LINK REL="NEXT" TITLE="" HREF="advanced-guis.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="copyright.html">Prev</A></TD>
+
+ <TD WIDTH="80%" ALIGN="center" VALIGN="bottom"></TD>
+ <TD WIDTH="10%" ALIGN="right" VALIGN="bottom"><A HREF="advanced-guis.html">Next</A></TD>
+
+</TR></TABLE>
+
+<HR ALIGN="LEFT" WIDTH="100%"></DIV><DIV CLASS="CHAPTER"><H1><A NAME="gui">Using Gtex-Letter (The User Interface)</A></H1>
+
+<DIV CLASS="TOC"><DL>
+
+<DT><B>Table of Contents</B></DT>
+<DT><A HREF="gui.html#address-page">The Address Page</A></DT>
+<DT><A HREF="gui.html#opening-page">The Opening Page</A></DT>
+<DT><A HREF="gui.html#contents-page">The Contents Page</A></DT>
+<DT><A HREF="gui.html#filename-page">The Filename Page</A></DT>
+<DT><A HREF="gui.html#makeup-page">The Makeup Page</A></DT>
+
+</DL></DIV>
+
+<DIV CLASS="SECT1"><H1 CLASS="SECT1"><A NAME="address-page">The Address Page</A></H1>
+
+<P>
+ When you first start gtex-letter, the programms opens with a welcome screen. Clicking the 'Next'-button, you get to the address-page:</P>
+
+<DIV CLASS="FIGURE">
+<P><B>Figure 2. The address page</B></P>
+<P><IMG SRC="images/address.jpeg"></P>
+</DIV>
+
+<P>
+ You can enter the address in the textfield on the left. Divide multiple addresses with an empty line to make a serial letter. (There is <A HREF="XXX.html">more info</A> available on that). You can browse your gnome-card addressbook by clicking on the button 'Browse Addresses'. </P>
+
+<P>
+ The addressbook-dialog will only show the people that have either a postal address or a phone number. Email-only contacts will be hidden. Doubleclick to select an address and close the dialog. Otherwise click the 'okay'-button. Multiple addresses can be selected to make a serial letter. You can click on the head of every column to sort the list.</P>
+
+<DIV CLASS="SECT1"><H1 CLASS="SECT1"><A NAME="opening-page">The Opening Page</A></H1>
+
+<P>
+ By clicking the 'Next'-Button on the <A HREF="gui.html#address-page">address page</A> you access the opening page:</P>
+
+<DIV CLASS="FIGURE">
+<P><B>Figure 3. The opening page</B></P>
+<P><IMG SRC="images/opening.jpeg"></P>
+</DIV>
+
+<P>
+ Here, you can set a subject for the letter. Notice, that this subject is optional. Then, a list of values provides you with standard-openings. If you have choosen an address from the address browser on the previous page, the standard-openings are adopted to the address choosen. However, this does not apply to serial letters, where a special format of the opening is displayed. (There is <A HREF="XXX.html">more info</A> on this). You do not need to choose one of the standard openings. You can enter one by yourself. Please note, that entering an address by hand will not update the opening-buttons. Only selecting one from the addressbook will.
+
+
+
+
+<DIV CLASS="SECT1"><H1 CLASS="SECT1"><A NAME="contents-page">The Contents Page</A></H1>
+
+<DIV CLASS="FIGURE">
+<P><B>Figure 4. The contents page</B></P>
+<P><IMG SRC="images/contents.jpeg"></P>
+</DIV>
+
+<P>
+ Enter your letter in the top textfield.</P>
+
+<P>
+ You can import an already written text by clicking the 'Import Textfile'-Button. If you want to save your contents for further use, click the 'Save Contents'. (Note that Gtex-letter saves your letter in the LaTeX-format. For future import of the text, it is easier to save it here.)</P>
+
+<P>
+ Choose an appropriate closing for your letter in the 'closing'-textfield. You do not have to choose one from the list. It is possible to enter your own closing.</P>
+
+
+
+
+
+
+
+<DIV CLASS="SECT1"><H1 CLASS="SECT1"><A NAME="filename-page">The Filename Page</A></H1>
+
+<DIV CLASS="FIGURE">
+<P><B>Figure 5. The filename page</B></P>
+<P><IMG SRC="images/filename.jpeg"></P>
+</DIV>
+
+<P>
+ On this page you can choose a header for your letter and set a filename.</P>
+
+<P>
+ There is a list of predefined headers available. You can look for another header using the 'search'-button, that opens a file browser.
+ </P>
+
+<P>
+ Gtex-letter will try and guess an appropriate filename for your letter. You can stick with that one or enter a different one. Click on the 'search'-button to open a file browser.</P>
+
+
+
+
+
+<DIV CLASS="SECT1"><H1 CLASS="SECT1"><A NAME="makeup-page">The Makeup Page</A></H1>
+
+<DIV CLASS="FIGURE">
+<P><B>Figure 6. The Makeup page</B></P>
+<P><IMG SRC="images/makeup.jpeg"></P>
+</DIV>
+
+<P>
+ This page lets you preview, print and export your letter.</P>
+
+<P>
+ Click 'show letter' to get a preview. If you like the preview, you can print it by clicking on the printer icon. If you want to print it later, save it as a postscript. You can export the letter in the widely used Acrobat Format by clicking on 'save as pdf'.</P>
+
+<P>
+ At this point, gtex-letter has already saved your letter. The letter is saved in the the LaTeX-format. If you are used to LaTeX, you can edit the raw file using the button called 'continue with editor'.</P>
+
+<P>
+ The next and final screen of the programm is just a goodbye screen.
+
+
+</DIV>
+
+
+</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="copyright.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-guis.html">Next</A></TD>
+</TR>
+
+<TR>
+<TD WIDTH="33%" ALIGN="left" VALIGN="top">Copyright</TD>
+<TD WIDTH="34%" ALIGN="center" VALIGN="top">&nbsp;</TD>
+<TD WIDTH="33%" ALIGN="right" VALIGN="top">Advanced User-Levels</TD>
+</TR>
+
+</TABLE>
+</DIV>
+</BODY>
+</HTML>
diff --git a/support/gtex-letter/manual/html/ideen b/support/gtex-letter/manual/html/ideen
new file mode 100644
index 0000000000..078fce0b41
--- /dev/null
+++ b/support/gtex-letter/manual/html/ideen
@@ -0,0 +1,30 @@
+About
+
+Introduction
+Features
+Dependencies
+
+Quick-Start
+ the address frame
+
+The guis:
+ novice
+ intermediate
+ expert
+
+the rc-files
+the rc-options
+advanced features
+ sex-adoption
+ default directory
+ filename-guesses/path
+ different addressformats
+ different letterformats
+ letter headers
+
+office automation
+ noninteractive mode
+
+
+
+
diff --git a/support/gtex-letter/manual/html/images/address.jpeg b/support/gtex-letter/manual/html/images/address.jpeg
new file mode 100644
index 0000000000..fd8b348723
--- /dev/null
+++ b/support/gtex-letter/manual/html/images/address.jpeg
Binary files differ
diff --git a/support/gtex-letter/manual/html/images/advanced-opening.jpeg b/support/gtex-letter/manual/html/images/advanced-opening.jpeg
new file mode 100644
index 0000000000..bc6ce63541
--- /dev/null
+++ b/support/gtex-letter/manual/html/images/advanced-opening.jpeg
Binary files differ
diff --git a/support/gtex-letter/manual/html/images/contents.jpeg b/support/gtex-letter/manual/html/images/contents.jpeg
new file mode 100644
index 0000000000..79ec93c27c
--- /dev/null
+++ b/support/gtex-letter/manual/html/images/contents.jpeg
Binary files differ
diff --git a/support/gtex-letter/manual/html/images/filename.jpeg b/support/gtex-letter/manual/html/images/filename.jpeg
new file mode 100644
index 0000000000..af7e621cb6
--- /dev/null
+++ b/support/gtex-letter/manual/html/images/filename.jpeg
Binary files differ
diff --git a/support/gtex-letter/manual/html/images/makeup.jpeg b/support/gtex-letter/manual/html/images/makeup.jpeg
new file mode 100644
index 0000000000..9cedc19916
--- /dev/null
+++ b/support/gtex-letter/manual/html/images/makeup.jpeg
Binary files differ
diff --git a/support/gtex-letter/manual/html/images/opening.jpeg b/support/gtex-letter/manual/html/images/opening.jpeg
new file mode 100644
index 0000000000..e2c4480a61
--- /dev/null
+++ b/support/gtex-letter/manual/html/images/opening.jpeg
Binary files differ
diff --git a/support/gtex-letter/manual/html/images/sample-letter.jpeg b/support/gtex-letter/manual/html/images/sample-letter.jpeg
new file mode 100644
index 0000000000..371363ada4
--- /dev/null
+++ b/support/gtex-letter/manual/html/images/sample-letter.jpeg
Binary files differ
diff --git a/support/gtex-letter/manual/html/index.html b/support/gtex-letter/manual/html/index.html
new file mode 100644
index 0000000000..c3c55c623b
--- /dev/null
+++ b/support/gtex-letter/manual/html/index.html
@@ -0,0 +1,200 @@
+<HTML><HEAD><TITLE>Gtex-Letter User Manual</TITLE>
+
+<LINK REL="HOME" TITLE="Gtex-Letter User Manual" HREF="index.html">
+<LINK REL="PREVIOUS" TITLE="Introduction" HREF="index.html">
+<LINK REL="NEXT" TITLE="Copyright" HREF="copyright.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="index.html">Prev</A></TD>
+
+ <TD WIDTH="80%" ALIGN="center" VALIGN="bottom"></TD>
+ <TD WIDTH="10%" ALIGN="right" VALIGN="bottom"><A HREF="copyright.html">Next</A></TD>
+
+</TR></TABLE>
+
+<HR ALIGN="LEFT" WIDTH="100%"></DIV><DIV CLASS="CHAPTER"><H1><A NAME="Introduction">Introduction</A></H1>
+
+<DIV CLASS="TOC"><DL>
+
+<DT><B>Table of Contents</B></DT>
+<DT><A HREF="introduction.html#introduction">Introduction</A></DT>
+<DT><A HREF="introduction.html#dependencies">Dependencies</A></DT>
+
+<DT><A HREF="copyright.html">Copyright</A></DT>
+
+<DT><A HREF="gui.html">Using Gtex-Letter (The User Interface)</A></DT></DL></DD>
+<DD><DL><DT><A HREF="gui.html#address-page">The Address Page</A></DT></DL></DD>
+<DD><DL><DT><A HREF="gui.html#opening-page">The Opening Page</A></DT></DL></DD>
+<DD><DL><DT><A HREF="gui.html#contents-page">The Contents Page</A></DT></DL></DD>
+<DD><DL><DT><A HREF="gui.html#filename-page">The Filename Page</A></DT></DL></DD>
+<DD><DL><DT><A HREF="gui.html#makeup-page">The Makeup Page</A></DT></DL></DD>
+
+<DT><A HREF="advanced-guis.html">The Advanced User-Levels</A></DT>
+<DD><DL><DT><A HREF="advanced-guis.html#intermediate">The Intermediate Userlevel</A></DT></DL></DD>
+<DD><DL><DT><A HREF="advanced-guis.html#expert">The Expert Userlevel</A></DT></DL></DD>
+
+
+<DT><A HREF="rc-files.html">The Configuration File(s)</A></DT>
+
+<DD><DL><DT><A HREF="rc-files.html#various-files">The Different Files</A></DT></DL></DD>
+
+<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>
+
+<DT><A HREF="advanced-features.html">Advanced Features</A></DT>
+<DD><DL><DT><A HREF="advanced-features.html#sex-adoption">Automatic Adoption to the Sex of the Addressee</A></DT></DL></DD>
+<DD><DL><DT><A HREF="advanced-features.html#filenames">Paths and Filenames</A></DT></DL></DD>
+<DD><DL><DT><A HREF="advanced-features.html#noninteractive">The Non-Interactive Mode</A></DT></DL></DD>
+
+
+</DL></DIV>
+
+<DIV CLASS="SECT1"><H1 CLASS="SECT1"><A NAME="introduction">Introduction</A></H1>
+
+<P>
+ Gtex-Letter is a programm that helps you writing letters. It features include:
+
+The application can swallow text you pipe into it, being it the address or the text of the letter.
+
+
+
+
+</p><p></p>
+<p><ul>
+
+ <li><p>
+ Configuration of <i class="EMPHASIS">standard openings</i> and default closings.
+ </p></li>
+
+ <li><p>
+ Multiple predefined <i class="EMPHASIS">letter headers</i> can be accessed from within the application.
+ </p></li>
+
+ <li><p>
+ Support for <i class="EMPHASIS">serial letters</i> are.
+ </p></li>
+
+ <li><p>
+ Different user levels according to your skills.
+ </p></li>
+
+ <li><p>
+ Gtex-Letter connects to the <i class="EMPHASIS">gnome-address-book</i> from the gnome-pim package.
+ </p></li>
+
+ <li><p>
+ The openings can be configured to adopt to the sex of the addressee automatically. (This is very useful for most non-English languages).
+ </p></li>
+
+ <li><p>
+ The <i class="EMPHASIS">non-interactive mode</i> allows you produce standard-letters in an extremely efficient way.
+ </p></li>
+
+ <li><p>
+ The application can swallow text you <i class="EMPHASIS">pipe</i> into it, being it the address or the text of the letter.
+ </p></li>
+
+</ul>
+
+<DIV CLASS="FIGURE">
+<P><B>Figure 1. Beginning of a sample letter</B></P>
+<P><IMG SRC="images/sample-letter.jpeg"></P>
+</DIV>
+
+</DIV>
+
+<DIV CLASS="SECT1"><H1 CLASS="SECT1"><A NAME="dependencies">Dependencies</A></H1>
+
+
+<P>
+ Gtex-Letter depends on the following packages:
+</p><p></p>
+<p><ul>
+ <li><p>
+ <i class="EMPHASIS">Gnome</i>. Version 1.2 and above.
+ </p></li>
+
+ <li><p>
+ <i class="EMPHASIS">Python</i>. Version 1.5.2 and above.
+ </p></li>
+
+ <li><p>
+ <i class="EMPHASIS">LaTeX</i>. Any standard Distribution.
+ </p></li>
+
+ <li><p>
+ <i class="EMPHASIS">Python-Gnome</i>. Version 1.0.53 and above.
+ </p></li>
+
+ <li><p>
+ <i class="EMPHASIS">ImageMagick</i>. Any Version should do. ImageMagick is installed on most standard Linux systems except Debian ones. This dependency is due to gtk/gdk (that comes with Gnome).
+ </p></li>
+
+
+</ul>
+
+
+</DIV>
+
+
+</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="index.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="copyright.html">Next</A></TD>
+</TR>
+
+<TR>
+<TD WIDTH="33%" ALIGN="left" VALIGN="top">Index</TD>
+<TD WIDTH="34%" ALIGN="center" VALIGN="top">&nbsp;</TD>
+<TD WIDTH="33%" ALIGN="right" VALIGN="top">Copyright</TD>
+</TR>
+
+</TABLE>
+</DIV>
+</BODY>
+</HTML>
diff --git a/support/gtex-letter/manual/html/rc-files.html b/support/gtex-letter/manual/html/rc-files.html
new file mode 100644
index 0000000000..f6d24aff09
--- /dev/null
+++ b/support/gtex-letter/manual/html/rc-files.html
@@ -0,0 +1,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>
diff --git a/support/gtex-letter/manual/html/template.html b/support/gtex-letter/manual/html/template.html
new file mode 100644
index 0000000000..94e3180acc
--- /dev/null
+++ b/support/gtex-letter/manual/html/template.html
@@ -0,0 +1,77 @@
+<HTML><HEAD><TITLE>Gtex-Letter User Manual</TITLE>
+
+<LINK REL="HOME" TITLE="Gtex-Letter User Manual" HREF="gtex-letter.html">
+<LINK REL="PREVIOUS" TITLE="" HREF=".html">
+<LINK REL="NEXT" TITLE="" HREF=".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=".html">Prev</A></TD>
+
+ <TD WIDTH="80%" ALIGN="center" VALIGN="bottom"></TD>
+ <TD WIDTH="10%" ALIGN="right" VALIGN="bottom"><A HREF=".html">Next</A></TD>
+
+</TR></TABLE>
+
+<HR ALIGN="LEFT" WIDTH="100%"></DIV><DIV CLASS="CHAPTER"><H1><A NAME="GCAL">The GNOME Calendar</A></H1>
+
+<DIV CLASS="TOC"><DL>
+
+<DT><B>Table of Contents</B></DT>
+<DT><A HREF=".html#AEN69">Introduction</A></DT>
+<DT><A HREF=".html">Setting</A></DT>
+<DT><A HREF=".html">Using</A></DT>
+<DT><A HREF=".html">Making</A></DT>
+
+</DL></DIV>
+
+<DIV CLASS="SECT1"><H1 CLASS="SECT1"><A NAME="AEN69">Introduction</A></H1>
+
+<P>
+
+ The GNOME Calendar is a simple calendar applications which can be quite
+ useful in your daily work. The Calendar, like much of GNOME, is in its
+ </P>
+
+<P>
+ The Calendar is broken up into four main tabs: Day, Week, Month,
+ the tabs.
+ </P>
+
+<DIV CLASS="FIGURE">
+<P><B>Figure 3-1. The GNOME Calendar</B></P>
+<P><IMG SRC="images/calday.gif"></P>
+</DIV>
+
+</DIV></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="tech.html.html">Prev</A></TD>
+<TD WIDTH="34%" ALIGN="center" VALIGN="top"><A HREF="gnomecal.html">Home</A></TD>
+<TD WIDTH="33%" ALIGN="right" VALIGN="top"><A HREF="calsetup.html">Next</A></TD>
+</TR>
+
+<TR>
+<TD WIDTH="33%" ALIGN="left" VALIGN="top">Technical information about the GNOME calendar</TD>
+<TD WIDTH="34%" ALIGN="center" VALIGN="top">&nbsp;</TD>
+<TD WIDTH="33%" ALIGN="right" VALIGN="top">Setting Up the GNOME Calendar</TD>
+</TR>
+
+</TABLE>
+</DIV>
+</BODY>
+</HTML>
diff --git a/support/gtex-letter/manual/html/users-manual-ideas b/support/gtex-letter/manual/html/users-manual-ideas
new file mode 100644
index 0000000000..2539794460
--- /dev/null
+++ b/support/gtex-letter/manual/html/users-manual-ideas
@@ -0,0 +1,27 @@
+Ideas wat should go into a users-manual of gtex-letter.
+
+What is it all about. Scoop of the application
+ (personal to business)
+
+Dependencies
+
+Simple letter. More complex ones.
+Serial letters
+
+letter headers, multiple letter headers
+
+The different screens, frames.
+
+User interfaces
+
+The rc-file. Configuration
+
+Complex configuration:
+ address styles, openings depending on clauses, filename-guesses
+
+LaTeX for non-TeXies
+ .tex, .dvi, pdf, ps etc.
+
+Office automation, useful setups
+
+Internationalization. Different TeX-Styles, different Letter-headers