summaryrefslogtreecommitdiff
path: root/info/digests/tugboat/merge.sty
blob: b3f033869e65dfa964fa4f55a447926189ab4f31 (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
%% [merge.sty]
%%
%%	  MERGE -- A Form Letter Option to the LaTeX Letter Style
%%
%%				by
%%
%%			Graeme McKinstry
%%			Computing Services Centre
%%			University of Otago
%%			P O Box 56
%%			Dunedin, New Zealand
%%
%%		graeme%otago.ac.nz@relay.cs.net
%%
%% A version of these macros appeared in TUGboat 8 #1, April 1987.
%%
%% Merge is a substyle [option] under the Latex style 'Letter' which
%% merges a standard letter with a separate file containing addresses
%% and opening lines.  Merge will read {address}{opening} pairs from a
%% specified file and merge them with a form letter by producing a separate
%% letter environment (containing unique "\begin{letter}{address}" and
%% "\opening{opening}" commands) for each pair.  
%%
%% Detailed instructions for preparation of the form letter and the
%% separate address file appear below, after the macros.
%%
%%
%%	27 July 1988
%%	Special Thanks go to B. Beeton (BNB@SEED.AMS.COM) for
%%	-- supplying the raw TeX and documentation from the TUGBoat article;
%%	-- adding some documentation;
%%	-- and for placing this file in the <tex.tugboat> archives at score.
%%
%%	28 July 1988
%%	C. Roberson (csrobe@icase.[arpa|edu], csrobe@[wm]cs.wm.edu)
%%	-- some additional documentation (mostly cleanup for .sty file);
%%	-- changed ID message to a form more similar to LaTeX's;
%%	-- changed "Could not open file" to "Could not open address file"
%%	   so user would better understand for which filename TeX
%%	   was prompting with the string "\@mergefile=";
%%	-- tested merge.sty;  It works!  Thanks, Graeme!
%%	-- submitted file to /public/latex-style archives @ cs.rochester.edu.
%%
%%	6 September 1988
%%	G. McKinstry
%%	-- enhanced the macros to handle running headlines properly;
%%	-- fixed some other problems from the original version not addressed
%%	   fully by C. Roberson;
%%	-- submitted new file to the latex-style archives.
%%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%


% csr - changed next line to conform more to LaTeX greeting.
\typeout{Letter Sub-Style 'Merge'. Release 6 October 1986 by Graeme McKinstry}

%% The basic algorithm is:
%%      1. Open the address file.
%%      2. Read the addresses file getting the address and opening line.
%%      3. Process the contents of the MERGE environment and store it
%%         in a box (\@store). This is the standard part of the letter.
%%      4. Produce the start of the letter (your address (including date),
%%         their address, and the opening line).
%%      5. Make a copy of the standard letter (\@store) and unbox this copy.
%%      6. Repeat steps 2, 4, and 5 (not 3) until there are no more addresses.


\newbox\@store
\long\def\@contents{\global\setbox\@store=\vbox\bgroup}  % store the contents
\long\def\@endcontents{\egroup}                          % of the letter

\def\@sendaddress{test}
\def\@openingtext{test}
\newif\if@firsttime                          % For storing the standard letter
\@firsttimetrue                              %   the first time through.

\newread\@addrfile                           % allocate an input stream

\def\@openfile{\openin\@addrfile=\@mergefile % open the address file
\ifeof\@addrfile                             % i.e., didn't open successfully
  \loop
     \immediate\write16{Could not open address file \@mergefile}
     \closein\@addrfile                      % close the input stream
     \read16 to \@mergefile                  % get another file name
     \openin\@addrfile=\@mergefile           % open up input stream
     \ifeof\@addrfile
  \repeat                                    % repeat until successfully opened
\fi}

% The merge environment (used as the \begin{merge}. The argument (#1) is
% the name of the file containing the addresses (a default of .tex extension)
% This file is opened (\@openfile), read (\@readfile), and then the box
% containing the contents of the standard letter is started (\@contents).

\def\merge#1{\def\@mergefile{#1 }\@openfile
                 \@readfile
                 \@contents}

% Read address file getting the address and opening line. If this is the
% first through then there is no reason to call \endmerge as this will
% be called later on (when \end{merge} is used).

\def\@getopeningline{\global\read\@addrfile
                            to\@openingtext}  % get the opening line

\def\@readfile{\global\read\@addrfile to\@sendaddress   % get the address
              \ifeof\@addrfile
                 \let\next=\relax
              \else
                 \@getopeningline
                 \if@firsttime
                    \let\next=\relax
                 \else
                    \let\next=\endmerge
                 \fi
              \fi\next}

\newbox\@letterbox       % For copy of \@store (the box containing the standard
                         %   letter.
\def\endmerge{\if@firsttime\@endcontents\global\@firsttimefalse\fi %
                                        % end contents if it is the first time
     \bgroup\let\oldletter=\letter
     \def\letter##1\@relax{\oldletter{##1}}  % redefines letter
     \expandafter\letter\@sendaddress\@relax % need to expand \@sendaddress
     \opening{\@openingtext\vskip2\parskip}
     \setbox\@letterbox=\copy\@store  % copy the contents of the letter
     \unvbox\@letterbox
     \endletter\egroup
     \ifeof\@addrfile
        \message{End of file}
        \let\next=\relax
     \else
        \let\next=\@readfile          % loop round yet again
     \fi\next}

\endinput

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

%% A letter, say LETTER.TEX, would be set up as follows:

%% \documentstyle[merge]{letter}
%%
%% \address{...}		% your address
%% \signature{...}		% your signature
%%
%% \begin{document}
%% \begin{merge}{myaddresses}	% MYADDRESSES.TEX contains addresses+openings
%%
%% With regard to ....		% letter starts
%%
%% \closing{...}		% closing
%% \ps{...}			% \ps, \encl, \cc, etc.
%%
%% \end{merge}
%% \end{document}

%% The address file, MYADDRESSES.TEX, would contain:

%% {Computing Services Centre, \\	% first address
%%  University of Otago, \\
%%  Dunedin, \\
%%  New Zealand}
%% {Dear Graeme,}		% \opening for first address
%% {Charles S. Roberson\\	% next address
%%  Dept. of Computer Science\\
%%  College of William and Mary\\
%%  Williamsburg, VA  23185}
%% {Dear Chip,}			% next \opening
%% ....				% etc.

%% NOTES:
%%   Braces are matched, except that if the input is only one line then it
%%     is not necessary to contain it within braces.
%%   It is important to leave NO BLANK LINES at the end of the address file.
%%   Be sure to supply the "\\" for breaking the addresses. -csr

%% [merge.sty]