**********************************************************************
*                                                                    *
*                        DokumentVerschicken:                        *
*                                                                    *
* MS Word 6.0/7.0-Makro zum Versand von Dokumenten mit Pegasus Mail  *
*                                                                    *
* Von Thomas Riehm, Uni Mnchen, Ref. III A 2                        *
* (Thomas.Riehm@Verwaltung.Uni-Muenchen.DE)                          *
*                                                                    *
* Basierend auf "LaunchWinPMail" von Daniel A. Tauber                *
* (dtauber@sybex.com), mit Modifikationen von Gordon Keith           *
* (gordonkeith@acslink.net.au), Steven A. Davis (sda19@net-link.net) *
* und Kai Schirmer (kai.schirmer@rz.hu-berlin.de)                    *
*                                                                    *
**********************************************************************


Inhalt:

0. Anforderungen
1. Installation
1a.Deinstallation
2. Bedienung
3. Bekannte Bugs/Einschrnkungen
4. Kopieren
5. Gewhrleistung
6. "Registrierung"


0. Anforderungen
================

Das Makro wurde getestet mit
- Pegasus Mail fr Windows, 2.43, 2.52 und 2.53 (jeweils englisch und
  deutsch, 16 und 32 Bit)
- Word 6.0 und 7.0 (deutsch)
- WfW 3.11, Win95, WinNT 4.0

Windows NT 3.51 sollte eigentlich auch funktionieren. Frhere 
Word-Versionen scheiden leider aus.


1. Installation
===============

Die mitgelieferte Datei "install.doc" enthlt neben dem Makro 
"DokumentVerschicken" ein "AutoOpen"-Makro, das das eigentliche Makro 
automatisch installieren (=in Normal.dot kopieren), ein Symbol, einen 
Menbefehl und einen HotKey (Shift+Strg+V) hinzufgen sollte, wenn sie 
geffnet wird.

Das Installationsmakro fragt aber vor jedem einzelnen Schritt und jeder
Vernderung der Normal.dot nach, so da die Installation auch selektiv 
erfolgen kann (z.B. zwar Makro und Symbol, aber weder Menbefehl noch
Hotkey)

Da dies auch eine bevorzugte Funktionsweise von Makroviren ist, habe ich 
volles Verstndnis dafr, da man mir nicht vertraut und daher das 
AutoOpen-Makro nicht auf sein Word loslassen will (zumal ich nicht fr sein 
Funktionieren unter allen Umstnden garantieren kann; ich habe es mit Word 
6.0 und 7.0 getestet). Der Code von "AutoOpen", "Installation" und 
"Deinstallation" ist aber einigermaen kommentiert und im brigen auch
verstndlich.

Also zustzlich die Installation von Hand:
1.  Word starten
--- Fr das Makro ---
2.  Menbefehl "Extras/Makro"
3.  Button "Organisieren"
4.  Die linke Version von "Normal.dot" schlieen
5.  Links mit "Datei ffnen" install.doc laden
6.  Makro "DokumentVerschicken" auswhlen
7.  Button "Kopieren>>"
8.  Button "Schlieen"
--- Fr das Symbol ---
9.  Menbefehl "Ansicht/Symbolleisten"
10. Button "Anpassen"
11. Kategorie "Makros" auswhlen
12. Makro "Dokument verschicken" in die Symbolleiste ziehen
13. Lieblings-Symbol auswhlen
14. Button "Schlieen"
--- Fr den Menbefehl ---
15. Menbefehl "Extras/Anpassen"
16. Register "Mens"
17. Kategorie "Makros"
18. "DokumentVerschicken" auswhlen und an die Lieblingsstelle
    in der Menleiste ziehen; empfohlen: Datei/Senden.
19. Schaltflche "Hinzufgen" und "Schlieen"
--- Fr den Hotkey ---
20. Menbefehl "Extras/Anpassen"
21. Register "Tastatur"
22. Kategorie "Makros"
23. "DokumentVerschicken" auswhlen und den Lieblings-Hotkey eintragen
24. "Hinzufgen" und "Schlieen".
--- Pfad zu Pegasus Mail ---
25. Menbefehl "Extras/Makro"
26. "DokumentVerschicken" auswhlen
27. Button "Bearbeiten"
28. In Zeile 14 den Pfad zu Pegasus Mail eintragen. Bei Blanks im Pfad
    (Win95, NT) unbedingt mit chr$(34) Anfhrungszeichen setzen. Beispiele:
    WinPMailPath$ = "c:\pmail\winpmail.exe"
    WinPMailPath$ = "c:\pmail\winpm-32.exe -i tom -z 16384"
    WinPMailPath$ = Chr$(34) + "c:\programme\Pegasus Mail\winpm-32.exe" +
            Chr$(34) + " -i tom -z 16384"

29. Makro schlieen und nderungen speichern


1a. Deinstallation
==================

Wie die Installation ist auch die Deinstallation automatisiert. Dazu mu
nur das gleiche Dokument "Install.doc" wieder geffnet werden. Es erkennt,
da "DokumentVerschicken" bereits installiert war und bietet die Mglichkeit
einer Neuinstallation (z.B. fr Menbefehl oder Hotkey) sowie der 
Deinstallation. Dabei kann ich ein Funktionieren der Deinstallation nur 
garantieren, wenn das Makro mit der automatischen Installation installiert
wurde.

Auch hier wird vor jeder Vernderung der Normal.dot nachgefragt.

Bei Deinstallation von Hand sind einfach die obigen Schritte zu Installation
rckgngig zu machen.

2. Bedienung
============

Das Makro wird schlicht durch Klick auf das zugeordnete Symbol in der 
Symbolleiste gestartet. Dann erscheint eine Dialogbox, in der der Empfnger 
und der Betreff der zu verschickenden Mail eingetragen werden.

Das Makro hat zwei Versandmodi: Anlage (bzw. Beilage) und Text. Im ersten 
Fall wird das Dokument als Attachment (oder Enclosure) an die Mail 
angehngt, im  zweiten Fall der Dokumenttext (oder ein Teil davon, wenn er 
markiert war), als Textinhalt in die Mail bernommen.

In beiden Fllen kann ausgewhlt werden, ob die Mail vor dem Versand 
editiert werden soll oder nicht.

Zustzlich kann fr pawortgeschtzte Versionen von PMail (Novell- oder
POP3-Pawort) das Pawort eingegeben werden, damit PMail gestartet werden 
kann. In dieses Feld kann bei MultiUser-Installationen auch der Username
eingetragen werden. Was leider nicht geht, ist die Kombination von Username
und Passwort.

Durch Klick auf "Senden" wird PMail gestartet, eine neue Nachricht erstellt 
und mit den entsprechenden Angaben ausgefllt.

Im Anlagen-Modus mu die Datei zuerst gespeichert werden.


3. Bekannte Einschrnkungen/Bugs
================================

1. Wenn Addons (z.B. EVE) geladen sind und Pegasus bereits luft, kommt es 
manchmal zu Problemen, wenn das Addon den Fokus hat und das Kommando fr 
New Mail (Ctrl+N) nicht zu PMail durchdringt. Umgehung: Als NewMailCommand$ 
statt "^n" den entsprechenden Menbefehl eintragen, also "%fn" (englische 
Versionvon WinPmail) oder "%dn" (deutsche Version).

2. WinPmail 2.42/2.43 reagiert nicht auf Ctrl+N, wenn kein einziges Fenster 
geffnet ist. Drum geht auch das Makro schief. Umgehung: Entweder dafr 
sorgen, da beim Start von PMail immer ein Fenster geffnet ist (z.B. 
Ordnerverwaltung), oder NewMailCommand$ wie in Nr. 2 ndern.

3. 16Bit-Versionen von Pegasus Mail akzeptieren keine langen Dateinamen fr 
Anlagen. Sollte also auf NT/Win95 die 16Bit-Version von PMail zum Einsatz 
kommen, wird eine Fehlermeldung angezeigt, wenn Dateien mit langen Dateinamen 
als Anlage versendet werden. Der Versand als Text klappt problemlos. Kann jemand 
in WordBasic lange Dateinamen in "kurze" verwandeln?

4. Wurde PMail erst vom Makro gestartet (d.h. es lief noch nicht vorher) und
mute ein Pawort eingegeben werden, erscheint die rgerliche Dialogbox "Bitte
Eingabe des Paworts besttigen". Die ist nur da, weil PMail zu langsam ist und
die direkt nach dem Pawort geschickten Tastaturbefehle fr die neue Mail nicht
verkraftet (die landen dann in WinWord). Da eine Warteschleife auch den Start von 
PMail verzgert, hilft das leider auch nicht weiter, so da die MsgBox mein 
einziger Ausweg war. Wenn jemand eine bessere Idee hat: You're welcome!


4. Kopieren
===========

Dieses Makro darf in alle Welt frei kopiert und verbreitet werden, solange 
diese Datei und das Dokument install.doc immer zusammen bleiben und nicht 
verndert werden. Der Autor freut sich ber jede Rckmeldung (Lobeshymnen 
und Bug-Reports ;-).


5. Gewhrleistung
=================

Fr die mitgelieferten Makros wird KEINE GEWHR bernommen. Es wird 
ausdrcklich darauf hingewiesen, da die nderungen an Normal.dot und der 
brigen WinWord-Installation auf die GEFAHR DES JEWEILIGEN ANWENDERS 
vorgenommen werden.


6. "Registrierung"
==================

Ich fhre eine Verteilerliste mit den Mail-Adressen von Word_Peg-Benutzern.
Diese Verteilerliste wird *ausschlielich* dafr verwendet, Bugs und das
Erscheinen neuer Releases/Bugfixes mitzuteilen. Ich rechne derzeit mit ein bis 
zwei Mails pro Woche, wenn die Beta-Phase abgeschlossen ist, maximal eine pro 
Monat (ich habe auch anderes zu tun, als stndig neue Versionen zu basteln :-).
Ich werde die Daten unter keinen Umstnden weitergeben, weder gegen Geld noch 
gegen sonst etwas. Sie bleiben ausschlielich auf meinem lokalen PC!

In diese Liste kann sich jede/r, der/die will, eintragen, indem er eine Mail
an mich (Thomas.Riehm@Verwaltung.Uni-Muenchen.DE) mit dem Subject "ADD WORD_PEG"
schickt (ohne Anfhrungszeichen!). Um von der Liste wieder 'runterzukommen,
gengt eine Mail an die gleiche Adresse mit Subject "REMOVE WORD_PEG".

Die Benutzung und Weitergabe der Software ist vllig unabhngig von dieser
"Registrierung"; es handelt sich bei Word_Peg um *Freeware*, d.h. "registrierte"
Benutzer erhalten auch keine besseren Versionen o.., sondern nur eine Info, 
da es eine neue Version gibt.


Mnchen, 3.3.1997

Thomas Riehm
(Thomas.Riehm@Verwaltung.Uni-Muenchen.DE)
