1 |
* Development Environment |
2 |
- OS |
3 |
Windows XP Professional |
4 |
- Compiler |
5 |
Visual Studio 2005 SP1 Standard Edition (or higher edition) |
6 |
Note: the executable program which was compiled by Visual Studio 2008 does not work on Windows NT 4.0, 95, 98 and Me. |
7 |
- Installer |
8 |
Inno Setup 5.3.5 ANSI (http://www.jrsoftware.org/isinfo.php) |
9 |
Inno Setup Preprocessor 5.3.5 (from ispack-5.3.4) |
10 |
ISTool 5.3.0 (from ispack-5.3.5) |
11 |
Japanese-5-5.1.11.isl (http://www.jrsoftware.org/files/istrans/) |
12 |
- others |
13 |
Cygwin 1.5.x (1.7.x doesn't support Windows 9x) |
14 |
ActivePerl 5.8 later version |
15 |
converts character-code and return-code of documents for building OpenSSL. |
16 |
|
17 |
|
18 |
* Libraries |
19 |
- oniguruma 5.9.1 (http://www.geocities.jp/kosako3/oniguruma/) |
20 |
- openssl 0.9.8k (http://www.openssl.org/) |
21 |
- zlib 1.2.3 (http://www.zlib.net/) |
22 |
- PuTTY 0.60 (http://www.chiark.greenend.org.uk/~sgtatham/putty/) |
23 |
|
24 |
|
25 |
* Notice for SVN commiter |
26 |
- SVN repository for commiter is followings: |
27 |
svn+ssh://svn.sourceforge.jp/svnroot/ttssh2/trunk |
28 |
|
29 |
- Should not edit checkout file in copying directory. |
30 |
The other modification code may be deleted in SVN server when you commit checkout file. Also, fix it carefully when the conflicting occurs. |
31 |
|
32 |
- Should not have opened checkout file. |
33 |
SVN commit procedure may be failure while checkout file will have been opened. |
34 |
|
35 |
|
36 |
* Naming rule to add menu ID |
37 |
|
38 |
The first digit is 5. |
39 |
|
40 |
The second digit is: |
41 |
Tera Term VT window 0 |
42 |
Tera Term TEK window 1 |
43 |
TTSSH 2 |
44 |
TTProxy 3 |
45 |
TTXKanjiMenu 4 |
46 |
|
47 |
The third digit is: |
48 |
[File] menu 1 |
49 |
[Edit] menu 2 |
50 |
[Setup] menu 3 |
51 |
[Control] menu 4 |
52 |
[Window] menu 8 |
53 |
[Help] menu 9 |
54 |
|
55 |
|
56 |
Example: adding a TTSSH menu under File menu |
57 |
|
58 |
#define ID_SSHSCPMENU 52110 |
59 |
|
60 |
|
61 |
* What to do when new macro command is added? |
62 |
|
63 |
- Coding |
64 |
-- get a new number of command internal ID. |
65 |
... teraterm/ttmacro/ttmparse.h |
66 |
-- add a if statement to below function. |
67 |
... CheckReservedWord@teraterm/ttmacro/ttmparse.c |
68 |
-- add a caller doing the macro command. |
69 |
... ExecCmnd@teraterm/ttmacro/ttl.c |
70 |
-- make a function code for the macro command. |
71 |
|
72 |
- Help topic |
73 |
-- make the command help file. |
74 |
... doc/LANG/html/macro/command/hogefunc.html |
75 |
-- add the file to help topic. |
76 |
... doc/LANG/teraterm.hhc |
77 |
-- get a new number of context ID in help page. |
78 |
The value is internal ID + 92000. |
79 |
... teraterm/common/helpid.h |
80 |
-- make the alias between context ID and calling file. |
81 |
... doc/LANG/teraterm.hhp |
82 |
|
83 |
|
84 |
* How to build Libraries |
85 |
1. PuTTY (used by TTSSH) |
86 |
(1) Extract putty source into libs/putty directory. |
87 |
|
88 |
2. Oniguruma (used by Tera Term Macro) |
89 |
(1) Extract oniguruma source into libs/oniguruma directory. |
90 |
(2) Launch 'Visual Studio 2005 Command Prompt' batch file from start menu. |
91 |
(3) Move 'libs' directory on the command prompt. And run buildoniguruma.bat. |
92 |
|
93 |
3. OpenSSL (used by TTSSH and TTProxy) |
94 |
(1) Extract openssl source into libs/openssl directory. |
95 |
(2) Launch 'Visual Studio 2005 Command Prompt' batch file from start menu. |
96 |
(3) Move 'libs' directory on the command prompt. And run buildopenssl.bat. |
97 |
|
98 |
4. Zlib (used by TTSSH) |
99 |
(1) Extract zlib source into libs/zlib directory. |
100 |
(2) Launch 'Visual Studio 2005 Command Prompt' batch file from start menu. |
101 |
(3) Move 'libs' directory on the command prompt. And run buildzlib.bat. |
102 |
|
103 |
|
104 |
* How to build Tera Term |
105 |
To build Tera Term source code is shown in the following step: |
106 |
And you should use Visual Studio 2005 Standard Edition later version to build Tera Term because Tera Term program links MFC library (Visual Studio 2005 Express Edition can't be used). |
107 |
|
108 |
1. Checkout Tera Term source code from SourceForge(http://sourceforge.jp/projects/ttssh2/). |
109 |
2. Open teraterm\visualc\ttermpro.sln with Visual Studio. |
110 |
The linefeed code of .sln file must be "CR+LF". |
111 |
3. Build Tera Term solution. |
112 |
4. Tera Term execution program will be generated in teraterm\visualc\bin directory if the building is successful. |
113 |
|
114 |
|
115 |
* How to build TeraTerm Menu |
116 |
1. Checkout TeraTerm Menu source code from SourceForge(http://sourceforge.jp/projects/ttssh2/). |
117 |
2. Open ttpmenu\ttpmenu.sln with Visual Studio. |
118 |
3. Build ttpmenu solution. |
119 |
4. ttpmenu.exe will be generated in Release directory if the building is successful. |
120 |
|
121 |
|
122 |
* How to build TTXKanjiMenu |
123 |
1. Checkout TTXKanjiMenu source code from SourceForge(http://sourceforge.jp/projects/ttssh2/). |
124 |
2. Open TTXKanjiMenu\ttxkanjimenu.sln with Visual Studio. |
125 |
3. Build ttpmenu solution. |
126 |
4. ttxkanjimenu.dll will be generated in TTXKanjiMenu directory if the building is successful. |
127 |
|
128 |
|
129 |
* How to build TTProxy |
130 |
To build TTProxy source code is shown in the following step: |
131 |
And you need Visual Studio 2005(VC++8.0) to build. |
132 |
|
133 |
1. Checkout TTProxy source code from SourceForge(http://sourceforge.jp/projects/ttssh2/). |
134 |
2. Open TTProxy\TTProxy.sln with Visual Studio. |
135 |
3. Build TTProxy solution. |
136 |
4. TTProxy DLL module will be generated in TTProxy directory if the building is successful. |
137 |
|
138 |
|
139 |
* How to build TTSSH |
140 |
To build TTSSH source code is shown in the following step: |
141 |
And you need Visual Studio 2005(VC++8.0) and ActivePerl to build. |
142 |
|
143 |
* VS2005 Express Edition is able to build TTSSH. TTSSH links to ttpcmn.lib and it must be created beforehand. VS2005 Express Edition cannot build Tera Term, but it can create ttpcmn.lib |
144 |
|
145 |
* On VS2008 Express Edition, following error occurs: |
146 |
.\ttxssh.rc(10) : fatal error RC1015: cannot open include file 'afxres.h'. |
147 |
|
148 |
To avoid this error, edit ttxssh.rc file. Delete the line of "afxres.h", and add 2 lines. |
149 |
|
150 |
- #include "afxres.h" |
151 |
+ #include <windows.h> |
152 |
+ #define IDC_STATIC -1 |
153 |
|
154 |
1. Checkout TTSSH source code from SourceForge(http://sourceforge.jp/projects/ttssh2/). |
155 |
2. Open ttssh2\ttssh.sln with Visual Studio. |
156 |
3. Build TTSSH solution. |
157 |
4. TTSSH DLL will be generated in ttssh2\ttxssh directory if the building is successful. |
158 |
|
159 |
|
160 |
* How to build CygTerm |
161 |
To build CygTerm source code is shown in the following step: |
162 |
|
163 |
1. Install Cygwin(http://www.cygwin.com/) to your PC. |
164 |
Note: 1.7.x doesn't support Windows 9x. Use version 1.5.x. |
165 |
1.5.x doesn't seem support Windows 7. But a binary that is compiled by 1.5.x can execute in 1.7.x environment. |
166 |
2. Launch Cygwin shell and go to cygterm directory. |
167 |
# cd cygterm |
168 |
3. Compile Cygterm. |
169 |
# make |
170 |
|
171 |
|
172 |
* How to build TTXSamples |
173 |
To build TTXSamples source code is shown in the following step: |
174 |
And you need Visual Studio 2005(VC++8.0) to build. |
175 |
VS2005 Express Edition is able to build TTXSamples. |
176 |
|
177 |
1. Checkout TTXSamples source code from SourceForge(http://sourceforge.jp/projects/ttssh2/). |
178 |
2. Open TTXSamples\TTXSamples.sln with Visual Studio. |
179 |
3. Build TTXSamples solution. |
180 |
4. TTXSamples DLL module will be generated in TTXSamples directory if the building is successful. |
181 |
|
182 |
|
183 |
* How to build HTML help file |
184 |
To build HTML help file is shown in the following step: |
185 |
|
186 |
1. Intall HTML Help Workshop from below site: |
187 |
http://msdn.microsoft.com/library/default.asp?url=/library/en-us/htmlhelp/html/hwMicrosoftHTMLHelpDownloads.asp |
188 |
|
189 |
2. Copy document files with batch file on command prompt. |
190 |
> cd teraterm\insatller |
191 |
> convtext.bat |
192 |
|
193 |
3. Select Open of File menu and open doc\en\teraterm.hhp file or doc\jp\teratermj.hhp. |
194 |
|
195 |
4. Select Compile of File menu and HTML help file will be created. |
196 |
|
197 |
|
198 |
* How to release Tera Term installation package |
199 |
To release Tera Term installation package is shown in the following step: |
200 |
|
201 |
1. Check latest libraries and tools. |
202 |
Visual Studio |
203 |
http://www.microsoft.com/japan/msdn/vstudio/downloads/default.aspx |
204 |
Inno Setup |
205 |
http://www.jrsoftware.org/isdl.php |
206 |
http://www.jrsoftware.org/files/istrans/ |
207 |
Oniguruma |
208 |
http://www.geocities.jp/kosako3/oniguruma/ |
209 |
OpenSSL |
210 |
http://www.openssl.org/ |
211 |
zlib |
212 |
http://www.zlib.net/ |
213 |
PuTTY |
214 |
http://www.chiark.greenend.org.uk/~sgtatham/putty/ |
215 |
CygTerm |
216 |
http://www.dd.iij4u.or.jp/~nsym/cygwin/cygterm/ |
217 |
LogMeTT |
218 |
http://www.logmett.com/forum/viewforum.php?f=5 |
219 |
|
220 |
2. Increase the software version and modify date. |
221 |
Increment the version of VS_VERSION_INFO while release process. |
222 |
- ttermpro.rc |
223 |
- ttxssh.rc |
224 |
- ttmacro.rc // only modifying |
225 |
- ttpmenu.rc // only modifying |
226 |
- TTProxy.rc // only modifying |
227 |
- ttxkanjimenu.rc // only modifying |
228 |
- teraterm.iss |
229 |
- html/about/hisotry.html |
230 |
|
231 |
Note: Don't update the version number until the release, because the installer does not overwrite file when versions are same. |
232 |
|
233 |
Note: By way of exception, CygTerm+ always upgrades not regarding Tera Term release process when the patch is committed. The release date is the day committed by a developer. The suffix of CygTerm+ version is patchlevel, and then a user can get gcc compiler for free. |
234 |
|
235 |
3. Create SVN tag. |
236 |
The naming rule is `teraterm-version'(ex. teraterm-4_62). |
237 |
|
238 |
4. Re-checkout from svn tag. |
239 |
|
240 |
5. Evaluate executable program file. |
241 |
- Rebuild Tera Term program |
242 |
- Make installer package |
243 |
Open "teraterm\installer\teraterm.iss" with ISTool and call [Project]-[Compile Setup] with InnoSetup. |
244 |
- Test Tera Term installation and evaluate it. |
245 |
|
246 |
6. Update SourceForge.jp project site. |
247 |
|
248 |
7. Update SourceForge.jp project home page. |
249 |
|
250 |
8. Announce release to mailing list(in Japan). |
251 |
|
252 |
9. Announce release to forum(in Canada). |
253 |
(1) Announcements http://logmett.com/forum/viewforum.php?f=5 |
254 |
Create new topic in `Announcements' entry. |
255 |
Change the type of previous Announcement from Announcement to Normal. |
256 |
Delete third previous Announcement. |
257 |
|
258 |
(2) Tera Term Changelog http://logmett.com/forum/viewtopic.php?f=5&t=3 |
259 |
Added current modification. |
260 |
|
261 |
(3) TTSSH Changelog http://logmett.com/forum/viewtopic.php?f=5&t=29 |
262 |
Added current modification. |
263 |
|
264 |
9. Delete spanshots. |