wiki:リリースの方法 をフィードバック
@@ -423,23 +423,83 @@ | ||
423 | 423 | To release Tera Term installation package is shown in the following step: |
424 | 424 | </p> |
425 | 425 | |
426 | +<h3>From start release until create RC</h3> | |
427 | + | |
426 | 428 | <ol> |
427 | - <li>Increment the version while RC release process.<br /> | |
428 | - The binary is released for test in this timing. Prevent that old and new binary have same version number. | |
429 | + <li>Confirm ticket and branches. | |
429 | 430 | <ul> |
431 | + <li>Confirm in project team. | |
432 | + <ul> | |
433 | + <li>Organize / decide whether to include bug fix / feature in this release or defer.</li> | |
434 | + </ul> | |
435 | + </li> | |
436 | + <li>Merge branches | |
437 | + <ul> | |
438 | + <li>Verify trunk / 4-stable and working branches.</li> | |
439 | + </ul> | |
440 | + </li> | |
441 | + <li>Close tickets. | |
442 | + <ul> | |
443 | +<!-- | |
444 | + <li>すでに修正済み、処理済みのものはクローズする<br /> | |
445 | + リリース時には、対象のマイルストーンのチケットはすべてクローズされている状態になる</li> | |
446 | + <li>次のリリースへ回すものはマイルストーンを変更する<br /> | |
447 | + 次のリリース用マイルストーンを作成する</li> | |
448 | +--> | |
449 | + </ul> | |
450 | + </li> | |
451 | +<!-- | |
452 | + <li>この時点で新たに出てくるチケットの対応を検討する</li> | |
453 | +--> | |
454 | + </ul> | |
455 | + </li> | |
456 | + <li>Confirm tools, libraries, import sources. | |
457 | + <ul> | |
458 | + <li>Visual Studio (<a href="https://visualstudio.microsoft.com">https://visualstudio.microsoft.com</a>)</li> | |
459 | + <li>Inno Setup (<a href="https://jrsoftware.org/isdl.php">https://jrsoftware.org/isdl.php</a>)</li> | |
460 | + <li>Oniguruma (<a href="https://github.com/kkos/oniguruma">https://github.com/kkos/oniguruma</a>)</li> | |
461 | + <li>OpenSSL (<a href="https://www.openssl.org">https://www.openssl.org</a>)</li> | |
462 | + <li>zlib (<a href="https://www.zlib.net">http://www.zlib.net</a>)</li> | |
463 | + <li>PuTTY (<a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/">http://www.chiark.greenend.org.uk/~sgtatham/putty/</a>)</li> | |
464 | + <li>SFMT (<a href="http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/SFMT/index-jp.html">http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/SFMT/index-jp.html</a>)</li> | |
465 | + <li>The reference C implementation of Argon2 (<a href="https://github.com/P-H-C/phc-winner-argon2">https://github.com/P-H-C/phc-winner-argon2</a>)</li> | |
466 | + </ul> | |
467 | +<!-- | |
468 | + <p>リリースに使うバージョンはこの時点でおおむね決定する。</p> | |
469 | +--> | |
470 | + </li> | |
471 | +<!-- | |
472 | + <!--li>今回のリリースに入れたいものが落ち着く</li> | |
473 | +--> | |
474 | +</ol> | |
475 | + | |
476 | +<h3>From create RC until release</h3> | |
477 | + | |
478 | +<ol> | |
479 | + <li>Confirm documents. | |
480 | + <ul> | |
481 | +<!-- | |
482 | + <li>ダイアログ上の設定項目・UIのない特別オプション・コマンドラインパラメータ・新規マクロコマンドなど、対応するドキュメントに漏れがないか確認する。</li> | |
483 | + <li>変更履歴を確認し、書き忘れがあれば追記する。</li> | |
484 | + <li>変更履歴の順番を変更する。だいたいの指針としては、ターミナルエミュレーション関係・アプリケーションとしての変更・マクロの順。</li> | |
485 | + <li>ドキュメント差分が翻訳されていることを確認し、翻訳忘れがあれば翻訳する。</li> | |
486 | +--> | |
487 | + </ul> | |
488 | + </li> | |
489 | + <li>Increment the version while RC release process. | |
490 | + <p>The binary is released for test in this timing. Prevent that old and new binary have same version number.</p> | |
491 | + <ul> | |
430 | 492 | <li>teraterm\common\tt-version.h</li> |
431 | 493 | <li>ttssh2\ttxssh\ttxssh-version.h</li> |
432 | - <li>ttpmenu\ttpmenu.rc // only modifying</li> | |
494 | + <li>Onttpmenu\ttpmenu.rc // only modifying</li> | |
433 | 495 | <li>TTProxy\TTProxy.rc // only modifying</li> |
434 | 496 | <li>TTXKanjiMenu\ttxkanjimenu.rc // only modifying</li> |
435 | - <li>installer\teraterm.iss | |
436 | - <ul> | |
437 | - <li>version up AppVer and add "RC"</li> | |
438 | - <li>comment out snapshot</li> | |
439 | - <li>change called batch files</li> | |
440 | - </ul> | |
441 | - </li> | |
442 | 497 | </ul> |
498 | + <p> | |
499 | + By way of exception, CygTerm+ always upgrades not regarding Tera Term release process when the patch is committed.<br /> | |
500 | + The release date is the day committed by a developer. <!--そのため、修正・バージョンのインクリメント・変更履歴を同時にコミットする。--><br /> | |
501 | + Because user can get gcc compiler for free. | |
502 | + </p> | |
443 | 503 | </li> |
444 | 504 | <li>Increment the year of last publication of copyright notice if it is first release in this year. |
445 | 505 | <ul> |
@@ -466,101 +526,197 @@ | ||
466 | 526 | <li>doc\ja\html\macro\index.html</li> |
467 | 527 | </ul> |
468 | 528 | </li> |
469 | - <li>Check latest libraries and tools. | |
529 | + <li>Replace 64bit Cygwin binary | |
530 | + <p> | |
531 | +<!-- | |
532 | + 前回のリリースから CygTerm+ に変更がある場合は、64bit Cygwinでビルドした cygterm\cygterm+-x86_64\cygterm.exe をコミットする。<br /> | |
533 | + ソース修正をコミットするときに、同時にバイナリがコミットされていれば、リリース時にこの工程を行う必要はない。 | |
534 | +--> | |
535 | + </p> | |
536 | + </li> | |
537 | + <li>Create installer. | |
470 | 538 | <ul> |
471 | - <li>Visual Studio<br /> | |
472 | - http://www.microsoft.com/japan/msdn/vstudio/downloads/default.aspx</li> | |
473 | - <li>Inno Setup<br /> | |
474 | - http://www.jrsoftware.org/isdl.php</li> | |
475 | - <li>Oniguruma<br /> | |
476 | - http://www.microsoft.com/japan/msdn/vstudio/downloads/default.aspx</li> | |
477 | - <li>OpenSSL<br /> | |
478 | - http://www.openssl.org/</li> | |
479 | - <li>zlib<br /> | |
480 | - http://www.zlib.net/</li> | |
481 | - <li>PuTTY<br /> | |
482 | - http://www.chiark.greenend.org.uk/~sgtatham/putty/</li> | |
483 | - <li>SFMT<br /> | |
484 | - http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/SFMT/index.html</li> | |
485 | - <li>CygTerm<br /> | |
486 | - https://googledrive.com/host/0B1s-dM6d6yC4fmhEZ3c0VTNFWEFtV3daUlRGQmFHVnBmVHRybUNnUVliNWktNDRlZ2NnZTQ/index-e.html</li> | |
539 | + <li>Version up AppVer and add "RC" in teraterm.iss. | |
540 | + <pre> | |
541 | +- #define AppVer "4.105" | |
542 | ++ #define AppVer "4.106-RC1" | |
543 | + </pre> | |
544 | + </li> | |
545 | + <li>Comment out snapshot in teraterm.iss. | |
546 | + <pre> | |
547 | +- #define snapshot GetDateTimeString('yyyymmdd_hhnnss', '', ''); | |
548 | ++ ;#define snapshot GetDateTimeString('yyyymmdd_hhnnss', '', ''); | |
549 | + </pre> | |
550 | + </li> | |
551 | + <li>Change calling batch file to enable rebuild and create archive. | |
552 | + <pre> | |
553 | + [InnoIDE_PreCompile] | |
554 | + Name: makechm.bat | |
555 | +- Name: build.bat | |
556 | +- ;Name: build.bat; Parameters: rebuild | |
557 | ++ ;Name: build.bat | |
558 | ++ Name: build.bat; Parameters: rebuild | |
559 | + | |
560 | + [InnoIDE_PostCompile] | |
561 | +- ;Name: makearchive.bat; Parameters: release | |
562 | ++ Name: makearchive.bat; Parameters: release | |
563 | + | |
564 | + [PreCompile] | |
565 | + Name: makechm.bat | |
566 | +- Name: build.bat | |
567 | +- ;Name: build.bat; Parameters: rebuild | |
568 | ++ ;Name: build.bat | |
569 | ++ Name: build.bat; Parameters: rebuild | |
570 | + | |
571 | + [PostCompile] | |
572 | +- ;Name: makearchive.bat; Parameters: release | |
573 | ++ Name: makearchive.bat; Parameters: release | |
574 | + | |
575 | + [_ISToolPreCompile] | |
576 | + Name: makechm.bat | |
577 | +- Name: build.bat | |
578 | +- ;Name: build.bat; Parameters: rebuild | |
579 | ++ ;Name: build.bat | |
580 | ++ Name: build.bat; Parameters: rebuild | |
581 | + | |
582 | + [_ISToolPostCompile] | |
583 | +- ;Name: makearchive.bat; Parameters: release | |
584 | ++ Name: makearchive.bat; Parameters: release | |
585 | + </pre> | |
586 | + </li> | |
587 | + <li id="RC_commit">Commit this state.</li> | |
588 | + <li>Open teraterm\installer\teraterm.iss with ISTool, and create installer by "Project"-"Compile Setup."</li> | |
589 | + <li>Compress portable version with zip.</li> | |
487 | 590 | </ul> |
488 | 591 | </li> |
489 | - <li>Check the document files.</li> | |
490 | - <li>Increase the software version and modify date. | |
592 | + <li>Test run installer, run and connect in all supported OS.</li> | |
593 | + <li>Add to OSDN Release | |
491 | 594 | <ul> |
492 | - <li>teraterm.iss<br /> | |
493 | - remove "RC" from AppVer</li> | |
494 | - <li>html/about/hisotry.html</li> | |
595 | + <li>Add new release (e.g. "4.106 RC") to "Tera Term RC" Package.</li> | |
596 | + <li>Add installer and portable zip file to new release.</li> | |
495 | 597 | </ul> |
496 | - Note: Don't update the version number until the release, because the installer does not overwrite file when versions are same.<br /> | |
497 | - 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. | |
498 | 598 | </li> |
499 | - <li>When CygTerm+ is changed from previous version, please build the software with 64bit Cygwin and replace cygterm\cygterm+-x86_64\cygterm.exe.</li> | |
500 | - <li>Evaluate executable program file. | |
599 | + <li>Announce RC release. | |
501 | 600 | <ul> |
502 | - <li>Make installer package<br /> | |
503 | - Open "teraterm\installer\teraterm.iss" with ISTool and call [Project]-[Compile Setup] with InnoSetup.</li> | |
504 | - <li>Test Tera Term installation and evaluate it.</li> | |
601 | + <li><a href="https://lists.osdn.me/mailman/listinfo/ttssh2-users">ttssh2-users</a> mailing list</li> | |
602 | + <li>Twitter (<a href="https://twitter.com/Tera_Term">https://twitter.com/Tera_Term</a>)</li> | |
505 | 603 | </ul> |
506 | 604 | </li> |
507 | - <li>Create SVN tag.<br /> | |
508 | - The naming rule is `teraterm-version'(ex. teraterm-4_106).<br /> | |
509 | -<pre> | |
510 | -svn copy -m "Release 4.106" svn+ssh://svn.osdn.net/svnroot/ttssh2/branches/4-stable svn+ssh://svn.osdn.net/svnroot/ttssh2/tags/teraterm-4_106 | |
511 | -</pre> | |
605 | + <li>Get feedbacks. | |
606 | + <p>If changed source code, redo "Confirm documents" and "Test run and connect in all supported OS."</p> | |
512 | 607 | </li> |
513 | - <li>Re-checkout from svn tag.</li> | |
514 | - <li>Make installer package | |
515 | - <ul> | |
516 | - <li>Edit "teraterm\installer\teraterm.iss" | |
517 | -<pre> | |
518 | -#define AppVer "4.???" | |
519 | -;#define snapshot GetDateTimeString('yyyymmdd_hhnnss', '', ''); | |
608 | +</ol> | |
520 | 609 | |
521 | -[InnoIDE_PreCompile] | |
522 | -Name: makechm.bat | |
523 | -;Name: build.bat | |
524 | -Name: build.bat; Parameters: rebuild | |
610 | +<h3>Release</h3> | |
525 | 611 | |
526 | -[InnoIDE_PostCompile] | |
527 | -Name: makearchive.bat; Parameters: release | |
528 | 612 | |
529 | -[PreCompile] | |
530 | -Name: makechm.bat | |
531 | -;Name: build.bat | |
532 | -Name: build.bat; Parameters: rebuild | |
533 | - | |
534 | -[PostCompile] | |
535 | -Name: makearchive.bat; Parameters: release | |
536 | - | |
537 | -[_ISToolPreCompile] | |
538 | -Name: makechm.bat | |
539 | -;Name: build.bat | |
540 | -Name: build.bat; Parameters: rebuild | |
541 | - | |
542 | -[_ISToolPostCompile] | |
543 | -Name: makearchive.bat; Parameters: release | |
544 | -</pre> | |
613 | +<ol> | |
614 | + <li>Confirm documents. (same as above)</li> | |
615 | + <li>Modify release date. | |
616 | + <ul> | |
617 | + <li>html/about/hisotry.html</li> | |
618 | + </ul> | |
619 | + </li> | |
620 | + <li>Create installer. | |
621 | + <ul> | |
622 | + <li>Change AppVer in teraterm.iss. | |
623 | + <pre> | |
624 | +- #define AppVer "4.106-RC1" | |
625 | ++ #define AppVer "4.106" | |
626 | + </pre> | |
545 | 627 | </li> |
546 | - <li>Open "teraterm\installer\teraterm.iss" with ISTool and call [Project]-[Compile Setup] with InnoSetup.</li> | |
628 | + <li>Open teraterm\installer\teraterm.iss with ISTool, and create installer by "Project"-"Compile Setup."</li> | |
547 | 629 | </ul> |
548 | 630 | </li> |
631 | + <li>Commit this state.</li> | |
632 | + <li>Create SVN tag.<br /> | |
633 | + The naming rule is `teraterm-version' (e.g. teraterm-4_106). | |
634 | + <pre> | |
635 | +svn copy -m "Release 4.106" \ | |
636 | + svn+ssh://svn.osdn.net/svnroot/ttssh2/branches/4-stable \ | |
637 | + svn+ssh://svn.osdn.net/svnroot/ttssh2/tags/teraterm-4_106 | |
638 | + </pre> | |
639 | + </li> | |
640 | + <li>Re-checkout from svn tag.<br /> | |
641 | + <p>All source code is same as development branch. Only SVN revision is different.</p> | |
642 | + </li> | |
643 | + <li>Create installer. | |
644 | + <ul> | |
645 | + <li>Open teraterm\installer\teraterm.iss with ISTool, and create installer by "Project"-"Compile Setup."</li> | |
646 | + <li>Compress portable version with zip.</li> | |
647 | + </ul> | |
648 | + </li> | |
549 | 649 | <li>Update OSDN project site. |
550 | 650 | <ul> |
551 | - <li>Add new release.</li> | |
651 | + <li>add new release (e.g. "4.106") to "Tera Term" Package.</li> | |
652 | + <li>Add installer and portable zip file to new release.</li> | |
653 | +<!-- | |
654 | + <li>ドキュメントの変更履歴から、リリースの「変更履歴」に(Wikiフォーマットで)転記する(日本語・英語とも)</li> | |
655 | +--> | |
552 | 656 | <li>Submit news.</li> |
553 | 657 | </ul> |
554 | 658 | </li> |
555 | - <li>Announce release to mailing list(in Japan).</li> | |
556 | - <li>Update OSDN project home page.</li> | |
557 | - <li>Delete snapshots.</li> | |
558 | - <li>Announce release to Twitter.<br /> | |
559 | - https://twitter.com/Tera_Term<br /> | |
560 | - Post release announcement and pin.</li> | |
659 | + <li>Update OSDN project home page (<a href="https://ttssh2.osdn.jp">https://ttssh2.osdn.jp</a>). | |
660 | + <p><a href="https://osdn.net/projects/ttssh2/wiki/%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%83%9A%E3%83%BC%E3%82%B8%E3%81%AE%E6%9B%B4%E6%96%B0%E6%89%8B%E9%A0%86">How to update project home page (in Japanese).</a></p> | |
561 | 661 | </li> |
562 | - <li>Update Chocolatey</li> | |
662 | + <li>Announce release. | |
663 | + <ul> | |
664 | + <li><a href="https://lists.osdn.me/mailman/listinfo/ttssh2-users">ttssh2-users</a> mailing list</li> | |
665 | + <li>Twitter (<a href="https://twitter.com/Tera_Term">https://twitter.com/Tera_Term</a>) | |
666 | + <ul> | |
667 | + <li>Pin announce tweet.</li> | |
668 | + </ul> | |
669 | + </li> | |
670 | + </ul> | |
671 | + </li> | |
672 | + <li id="revert_teraterm_iss">Revert teraterm.iss in development branch. | |
673 | + <pre> | |
674 | +- ;#define snapshot GetDateTimeString('yyyymmdd_hhnnss', '', ''); | |
675 | ++ #define snapshot GetDateTimeString('yyyymmdd_hhnnss', '', ''); | |
676 | + | |
677 | + [InnoIDE_PreCompile] | |
678 | + Name: makechm.bat | |
679 | +- ;Name: build.bat | |
680 | +- Name: build.bat; Parameters: rebuild | |
681 | ++ Name: build.bat | |
682 | ++ ;Name: build.bat; Parameters: rebuild | |
683 | + | |
684 | + [InnoIDE_PostCompile] | |
685 | +- Name: makearchive.bat; Parameters: release | |
686 | ++ ;Name: makearchive.bat; Parameters: release | |
687 | + | |
688 | + [PreCompile] | |
689 | + Name: makechm.bat | |
690 | +- ;Name: build.bat | |
691 | +- Name: build.bat; Parameters: rebuild | |
692 | ++ Name: build.bat | |
693 | ++ ;Name: build.bat; Parameters: rebuild | |
694 | + | |
695 | + [PostCompile] | |
696 | +- Name: makearchive.bat; Parameters: release | |
697 | ++ ;Name: makearchive.bat; Parameters: release | |
698 | + | |
699 | + [_ISToolPreCompile] | |
700 | + Name: makechm.bat | |
701 | +- ;Name: build.bat | |
702 | +- Name: build.bat; Parameters: rebuild | |
703 | ++ Name: build.bat | |
704 | ++ ;Name: build.bat; Parameters: rebuild | |
705 | + | |
706 | + [_ISToolPostCompile] | |
707 | +- Name: makearchive.bat; Parameters: release | |
708 | ++ ;Name: makearchive.bat; Parameters: release | |
709 | + </pre> | |
710 | + </li> | |
711 | + <li>Update Chocolatey.</li> | |
563 | 712 | </ol> |
564 | 713 | |
714 | +<h3>About code freeze.</h3> | |
715 | + | |
716 | +<p> | |
717 | +After code freeze, only critical bug fix is able to committed.<br /> | |
718 | +Code freeze start with <a href="#RC_commit">RC commit in development branch</a>, and end with <a href="#revert_teraterm_iss">revert teraterm.iss commit in development branch</a>. | |
719 | +</p> | |
720 | + | |
565 | 721 | </body> |
566 | 722 | </html> |
@@ -27,7 +27,7 @@ | ||
27 | 27 | <li><a href="#build-cygterm">CygTermのビルド方法</a></li> |
28 | 28 | <li><a href="#build-ttxsamples">TTXSamplesのビルド方法</a></li> |
29 | 29 | <li><a href="#build-htmlhelp">ヘルプファイルのビルド方法</a></li> |
30 | - <li><a href="#release">リリースの方法</a></li> | |
30 | + <li><a href="#release">リリースの手順</a></li> | |
31 | 31 | </ol> |
32 | 32 | |
33 | 33 | <hr> |
@@ -435,32 +435,82 @@ | ||
435 | 435 | </ol> |
436 | 436 | |
437 | 437 | |
438 | -<h2 id="release">リリースの方法</h2> | |
438 | +<h2 id="release">リリースの手順</h2> | |
439 | 439 | |
440 | 440 | <p> |
441 | -リリースの方法について以下に示します。 | |
441 | +TeraTerm Project でのリリース手順について以下に示します。 | |
442 | 442 | </p> |
443 | 443 | |
444 | +<h3>リリース作業の開始からRC作成まで</h3> | |
445 | + | |
444 | 446 | <ol> |
445 | - <li>RC 作成時にバージョンを一つインクリメントする。<br /> | |
446 | - 一般にテストを呼びかけ、旧バージョンとの同時実行が考えられるため、このタイミングとする(cf. TT_FILEMAPNAME 定義)。 | |
447 | + <li>チケット、ブランチなどを確認する | |
447 | 448 | <ul> |
448 | - <li>teraterm\common\tt-version.h</li> | |
449 | - <li>ttssh2\ttxssh\ttxssh-version.h</li> | |
450 | - <li>ttpmenu\ttpmenu.rc // only modifying</li> | |
451 | - <li>TTProxy\TTProxy.rc // only modifying</li> | |
452 | - <li>TTXKanjiMenu\ttxkanjimenu.rc // only modifying</li> | |
453 | - <li>installer\teraterm.iss | |
449 | + <li>プロジェクトチーム内で確認する | |
454 | 450 | <ul> |
455 | - <li>AppVer を上げ、"RC" を追加</li> | |
456 | - <li>snapshot を コメントアウト</li> | |
457 | - <li>バッチファイルの呼び出しを修正</li> | |
451 | + <li>今回のリリースに入れるもの・次回以降に延期するものを整理・決定する</li> | |
458 | 452 | </ul> |
459 | 453 | </li> |
454 | + <li>ブランチをマージする | |
455 | + <ul> | |
456 | + <li>trunk と 4-stable 間、作業中のブランチなど</li> | |
457 | + </ul> | |
458 | + </li> | |
459 | + <li>チケットをクローズする | |
460 | + <ul> | |
461 | + <li>すでに修正済み、処理済みのものはクローズする<br /> | |
462 | + リリース時には、対象のマイルストーンのチケットはすべてクローズされている状態になる</li> | |
463 | + <li>次のリリースへ回すものはマイルストーンを変更する<br /> | |
464 | + 次のリリース用マイルストーンを作成する</li> | |
465 | + </ul> | |
466 | + </li> | |
467 | + <li>この時点で新たに出てくるチケットの対応を検討する</li> | |
460 | 468 | </ul> |
461 | 469 | </li> |
462 | - <li>この年における最初のリリースの場合は、著作権表示の「最後の発行の年」をインクリメントする。 | |
470 | + <li>ツール、ライブラリ、インポート元の最新版をチェックする | |
463 | 471 | <ul> |
472 | + <li>Visual Studio (<a href="https://visualstudio.microsoft.com">https://visualstudio.microsoft.com</a>)</li> | |
473 | + <li>Inno Setup (<a href="https://jrsoftware.org/isdl.php">https://jrsoftware.org/isdl.php</a>)</li> | |
474 | + <li>Oniguruma (<a href="https://github.com/kkos/oniguruma">https://github.com/kkos/oniguruma</a>)</li> | |
475 | + <li>OpenSSL (<a href="https://www.openssl.org">https://www.openssl.org</a>)</li> | |
476 | + <li>zlib (<a href="https://www.zlib.net">http://www.zlib.net</a>)</li> | |
477 | + <li>PuTTY (<a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/">http://www.chiark.greenend.org.uk/~sgtatham/putty/</a>)</li> | |
478 | + <li>SFMT (<a href="http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/SFMT/index-jp.html">http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/SFMT/index-jp.html</a>)</li> | |
479 | + <li>The reference C implementation of Argon2 (<a href="https://github.com/P-H-C/phc-winner-argon2">https://github.com/P-H-C/phc-winner-argon2</a>)</li> | |
480 | + </ul> | |
481 | + <p>リリースに使うバージョンはこの時点でおおむね決定する。</p> | |
482 | + </li> | |
483 | + <li>今回のリリースに入れたいものが落ち着く</li> | |
484 | +</ol> | |
485 | + | |
486 | +<h3>RC作成からリリースまで</h3> | |
487 | + | |
488 | +<ol> | |
489 | + <li>ドキュメントを確認する | |
490 | + <ul> | |
491 | + <li>ダイアログ上の設定項目・UIのない特別オプション・コマンドラインパラメータ・新規マクロコマンドなど、対応するドキュメントに漏れがないか確認する。</li> | |
492 | + <li>変更履歴を確認し、書き忘れがあれば追記する。</li> | |
493 | + <li>変更履歴の順番を変更する。だいたいの指針としては、ターミナルエミュレーション関係・アプリケーションとしての変更・マクロの順。</li> | |
494 | + <li>ドキュメント差分が翻訳されていることを確認し、翻訳忘れがあれば翻訳する。</li> | |
495 | + </ul> | |
496 | + </li> | |
497 | + <li>バージョンを一つインクリメントする | |
498 | + <p>一般にテストを呼びかけ、旧バージョンとの同時実行が考えられるため、このタイミングとする(例: TT_FILEMAPNAME 定義 など)。</p> | |
499 | + <ul> | |
500 | + <li>teraterm\common\tt-version.h</li> | |
501 | + <li>ttssh2\ttxssh\ttxssh-version.h</li> | |
502 | + <li>Onttpmenu\ttpmenu.rc // 変更時のみ</li> | |
503 | + <li>TTProxy\TTProxy.rc // 変更時のみ</li> | |
504 | + <li>TTXKanjiMenu\ttxkanjimenu.rc // 変更時のみ</li> | |
505 | + </ul> | |
506 | + <p> | |
507 | + CygTerm+ は例外で、リリースとは関係なくバージョンが上がる。<br /> | |
508 | + 修正がコミットされると即リリース扱いになり、リリース日はその日付となる。そのため、修正・バージョンのインクリメント・変更履歴を同時にコミットする。<br /> | |
509 | + これはコンパイラの入手が容易なため。 | |
510 | + </p> | |
511 | + </li> | |
512 | + <li>この年における最初のリリースの場合は、著作権表示の「最後の発行の年」をインクリメントする | |
513 | + <ul> | |
464 | 514 | <li>teraterm\keycode\keycode-version.rc // VERSIONINFO</li> |
465 | 515 | <li>teraterm\teraterm\tt-version.rc // VERSIONINFO</li> |
466 | 516 | <li>teraterm\ttpcmn\ttpcmn-version.rc // VERSIONINFO</li> |
@@ -484,111 +534,192 @@ | ||
484 | 534 | <li>doc\ja\html\macro\index.html</li> |
485 | 535 | </ul> |
486 | 536 | </li> |
487 | - <li>依存ライブラリ、ツール、インポート元の最新版をチェックする。 | |
537 | + <li>64bit Cygwin バイナリを差し替える | |
538 | + <p> | |
539 | + 前回のリリースから CygTerm+ に変更がある場合は、64bit Cygwinでビルドした cygterm\cygterm+-x86_64\cygterm.exe をコミットする。<br /> | |
540 | + ソース修正をコミットするときに、同時にバイナリがコミットされていれば、リリース時にこの工程を行う必要はない。 | |
541 | + </p> | |
542 | + </li> | |
543 | + <li>インストーラを作成する | |
488 | 544 | <ul> |
489 | - <li>Visual Studio<br /> | |
490 | - http://www.microsoft.com/japan/msdn/vstudio/downloads/default.aspx</li> | |
491 | - <li>Inno Setup<br /> | |
492 | - http://www.jrsoftware.org/isdl.php</li> | |
493 | - <li>Oniguruma<br /> | |
494 | - http://www.microsoft.com/japan/msdn/vstudio/downloads/default.aspx</li> | |
495 | - <li>OpenSSL<br /> | |
496 | - http://www.openssl.org/</li> | |
497 | - <li>zlib<br /> | |
498 | - http://www.zlib.net/</li> | |
499 | - <li>PuTTY<br /> | |
500 | - http://www.chiark.greenend.org.uk/~sgtatham/putty/</li> | |
501 | - <li>SFMT<br /> | |
502 | - http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/SFMT/index.html</li> | |
503 | - <li>CygTerm<br /> | |
504 | - https://googledrive.com/host/0B1s-dM6d6yC4fmhEZ3c0VTNFWEFtV3daUlRGQmFHVnBmVHRybUNnUVliNWktNDRlZ2NnZTQ/index-e.html</li> | |
545 | + <li>teraterm.iss の AppVer を「次のバージョン-RC」とする | |
546 | + <pre> | |
547 | +- #define AppVer "4.105" | |
548 | ++ #define AppVer "4.106-RC1" | |
549 | + </pre> | |
550 | + </li> | |
551 | + <li>teraterm.iss の snapshot をコメントアウトする | |
552 | + <pre> | |
553 | +- #define snapshot GetDateTimeString('yyyymmdd_hhnnss', '', ''); | |
554 | ++ ;#define snapshot GetDateTimeString('yyyymmdd_hhnnss', '', ''); | |
555 | + </pre> | |
556 | + </li> | |
557 | + <li>teraterm.iss から起動するバッチを、リリース用に「リビルド有効」「アーカイブ作成有効」にする | |
558 | + <pre> | |
559 | + [InnoIDE_PreCompile] | |
560 | + Name: makechm.bat | |
561 | +- Name: build.bat | |
562 | +- ;Name: build.bat; Parameters: rebuild | |
563 | ++ ;Name: build.bat | |
564 | ++ Name: build.bat; Parameters: rebuild | |
565 | + | |
566 | + [InnoIDE_PostCompile] | |
567 | +- ;Name: makearchive.bat; Parameters: release | |
568 | ++ Name: makearchive.bat; Parameters: release | |
569 | + | |
570 | + [PreCompile] | |
571 | + Name: makechm.bat | |
572 | +- Name: build.bat | |
573 | +- ;Name: build.bat; Parameters: rebuild | |
574 | ++ ;Name: build.bat | |
575 | ++ Name: build.bat; Parameters: rebuild | |
576 | + | |
577 | + [PostCompile] | |
578 | +- ;Name: makearchive.bat; Parameters: release | |
579 | ++ Name: makearchive.bat; Parameters: release | |
580 | + | |
581 | + [_ISToolPreCompile] | |
582 | + Name: makechm.bat | |
583 | +- Name: build.bat | |
584 | +- ;Name: build.bat; Parameters: rebuild | |
585 | ++ ;Name: build.bat | |
586 | ++ Name: build.bat; Parameters: rebuild | |
587 | + | |
588 | + [_ISToolPostCompile] | |
589 | +- ;Name: makearchive.bat; Parameters: release | |
590 | ++ Name: makearchive.bat; Parameters: release | |
591 | + </pre> | |
592 | + </li> | |
593 | + <li id="RC_commit">この状態でコミットする</li> | |
594 | + <li>ISTool で teraterm\installer\teraterm.iss を開き、"Project"-"Compile Setup" でインストーラを作成する</li> | |
595 | + <li>作成されたポータブル版を zip で圧縮する</li> | |
505 | 596 | </ul> |
506 | 597 | </li> |
507 | - <li>ドキュメントを確認する。 | |
598 | + <li>サポートされている全 OS でインストーラの実行、起動、接続をチェックする</li> | |
599 | + <li>OSDN のリリース物件に追加する | |
508 | 600 | <ul> |
509 | - <li>ダイアログ上の設定項目・UIのない特別オプション・コマンドラインパラメータ・新規マクロコマンドなど、対応するドキュメントに漏れがないか確認する。</li> | |
510 | - <li>変更履歴の書き忘れを確認する。<br /> | |
511 | - おおむね変更した順に追記される変更履歴の順番を変更する。だいたいの指針としては、ターミナルエミュレーション関係・アプリケーションとしての変更・マクロの順。</li> | |
512 | - <li>ドキュメント差分が翻訳されていることを確認する。</li> | |
601 | + <li>「Tera Term RC」パッケージに新しいリリース(例: "4.106 RC")を追加する</li> | |
602 | + <li>新しいリリースに、インストーラ・ポータブル版の zip ファイルを追加する</li> | |
513 | 603 | </ul> |
514 | 604 | </li> |
515 | - <li>バージョンを上げ、日付を変更する。 | |
605 | + <li>RCの作成をアナウンスする | |
516 | 606 | <ul> |
517 | - <li>teraterm.iss<br /> | |
518 | - AppVer から RC を削除</li> | |
607 | + <li><a href="https://lists.osdn.me/mailman/listinfo/ttssh2-users">ttssh2-users</a> メーリングリスト</li> | |
608 | + <li>Twitter (<a href="https://twitter.com/Tera_Term">https://twitter.com/Tera_Term</a>)</li> | |
609 | + </ul> | |
610 | + </li> | |
611 | + <li>フィードバックを受け入れる | |
612 | + <p>修正が入ったら再度「ドキュメントを確認する」「サポートされている全 OS で起動・接続チェックする」</p> | |
613 | + </li> | |
614 | +</ol> | |
615 | + | |
616 | +<h3>リリース作業</h3> | |
617 | + | |
618 | +<ol> | |
619 | + <li>ドキュメントを確認する (詳細は同上)</li> | |
620 | + <li>リリース日を変更する | |
621 | + <ul> | |
519 | 622 | <li>html/about/hisotry.html</li> |
520 | 623 | </ul> |
521 | - CygTerm+ は例外で、リリースとは関係なくバージョンが上がる。<br /> | |
522 | - パッチがコミットされると即リリース扱いになり、リリース日はその日付となる。<br /> | |
523 | - これは、バージョンの末尾が patchlevel であり、コンパイラの入手が容易なため。 | |
524 | 624 | </li> |
525 | - <li>前回のリリースからCygTerm+に変更がある場合は、64bit Cygwinでビルドして cygterm\cygterm+-x86_64\cygterm.exe の差し替えを行う。</li> | |
526 | - <li>動作確認をする | |
625 | + <li>インストーラを作成する | |
527 | 626 | <ul> |
528 | - <li>インストーラを作成する。<br /> | |
529 | - ISTool で teraterm\installer\teraterm.iss を開き、[Project]-[Compile Setup]で作成される。</li> | |
530 | - <li>インストールおよび実行をテストする。</li> | |
627 | + <li>teraterm.iss の AppVer を変更する | |
628 | + <pre> | |
629 | +- #define AppVer "4.106-RC1" | |
630 | ++ #define AppVer "4.106" | |
631 | + </pre> | |
632 | + </li> | |
633 | + <li>ISTool で teraterm\installer\teraterm.iss を開き、"Project"-"Compile Setup" で作成する</li> | |
531 | 634 | </ul> |
532 | 635 | </li> |
533 | - <li>SVN のタグを作成する。<br /> | |
534 | - タグ名は「teraterm-バージョン」。たとえば、v4.106ならば"teraterm-4_106"。<br /> | |
535 | - <pre> | |
536 | -svn copy -m "Release 4.106" svn+ssh://svn.osdn.net/svnroot/ttssh2/branches/4-stable svn+ssh://svn.osdn.net/svnroot/ttssh2/tags/teraterm-4_106 | |
537 | - </pre> | |
636 | + <li>この状態でコミットする</li> | |
637 | + <li>SVN のタグを作成する<br /> | |
638 | + タグ名は「teraterm-バージョン」。(例: v4.106ならば"teraterm-4_106") | |
639 | + <pre> | |
640 | +svn copy -m "Release 4.106" \ | |
641 | + svn+ssh://svn.osdn.net/svnroot/ttssh2/branches/4-stable \ | |
642 | + svn+ssh://svn.osdn.net/svnroot/ttssh2/tags/teraterm-4_106 | |
643 | + </pre> | |
538 | 644 | </li> |
539 | - <li>リリース用のタグでチェックアウトし直す。</li> | |
540 | - <li>インストーラを作成する。 | |
645 | + <li>リリース用のタグでチェックアウトし直す<br /> | |
646 | + <p>SVN のリビジョン以外のすべてが、開発ブランチと同じ状態になる</p> | |
647 | + </li> | |
648 | + <li>インストーラを作成する | |
541 | 649 | <ul> |
542 | - <li>teraterm\installer\teraterm.iss を編集する | |
543 | -<pre> | |
544 | -#define AppVer "4.???" | |
545 | -;#define snapshot GetDateTimeString('yyyymmdd_hhnnss', '', ''); | |
546 | - | |
547 | -[InnoIDE_PreCompile] | |
548 | -Name: makechm.bat | |
549 | -;Name: build.bat | |
550 | -Name: build.bat; Parameters: rebuild | |
551 | - | |
552 | -[InnoIDE_PostCompile] | |
553 | -Name: makearchive.bat; Parameters: release | |
554 | - | |
555 | -[PreCompile] | |
556 | -Name: makechm.bat | |
557 | -;Name: build.bat | |
558 | -Name: build.bat; Parameters: rebuild | |
559 | - | |
560 | -[PostCompile] | |
561 | -Name: makearchive.bat; Parameters: release | |
562 | - | |
563 | -[_ISToolPreCompile] | |
564 | -Name: makechm.bat | |
565 | -;Name: build.bat | |
566 | -Name: build.bat; Parameters: rebuild | |
567 | - | |
568 | -[_ISToolPostCompile] | |
569 | -Name: makearchive.bat; Parameters: release | |
570 | -</pre> | |
571 | - </li> | |
572 | - <li>ISTool で teraterm\installer\teraterm.iss を開き、[Project]-[Compile Setup]で作成される</li> | |
650 | + <li>ISTool で teraterm\installer\teraterm.iss を開き、"Project"-"Compile Setup" で作成する</li> | |
651 | + <li>作成されたポータブル版を zip で圧縮する</li> | |
573 | 652 | </ul> |
574 | 653 | </li> |
575 | - <li>OSDN を更新する。 | |
654 | + <li>OSDN を更新する | |
576 | 655 | <ul> |
577 | - <li>[ダウンロード]-[管理]-[新規作成]<br /> | |
578 | - 変更履歴を入力してリリースを作成する。</li> | |
579 | - <li>[ニュース一覧]-[新規登録]<br /> | |
580 | - ニュース記事を作成する。</li> | |
656 | + <li>「Tera Term」パッケージに新しいリリース(例: "4.106")を追加する</li> | |
657 | + <li>新しいリリースに、インストーラ・ポータブル版の zip ファイルを追加する</li> | |
658 | + <li>ドキュメントの変更履歴から、リリースの「変更履歴」に(Wikiフォーマットで)転記する(日本語・英語とも)</li> | |
659 | + <li>ニュース記事を作成する</li> | |
581 | 660 | </ul> |
582 | 661 | </li> |
583 | - <li>メーリングリストにアナウンスする。</li> | |
584 | - <li>プロジェクトページを更新する。</li> | |
585 | - <li>スナップショットを削除する。</li> | |
586 | - <li>Twitter に告知する。<br /> | |
587 | - https://twitter.com/Tera_Term<br /> | |
588 | - リリース告知をツイートして固定する。</li> | |
662 | + <li>プロジェクトページ (<a href="https://ttssh2.osdn.jp">https://ttssh2.osdn.jp</a>) を更新する | |
663 | + <p>更新のしかたは <a href="https://osdn.net/projects/ttssh2/wiki/%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%83%9A%E3%83%BC%E3%82%B8%E3%81%AE%E6%9B%B4%E6%96%B0%E6%89%8B%E9%A0%86">プロジェクトページの更新手順</a> を参照</p> | |
589 | 664 | </li> |
590 | - <li>Chocolatey の登録を更新</li> | |
665 | + <li>リリースをアナウンスする | |
666 | + <ul> | |
667 | + <li><a href="https://lists.osdn.me/mailman/listinfo/ttssh2-users">ttssh2-users</a> メーリングリスト</li> | |
668 | + <li>Twitter (<a href="https://twitter.com/Tera_Term">https://twitter.com/Tera_Term</a>) | |
669 | + <ul> | |
670 | + <li>リリースアナウンスのツイートを固定ツイートにする</li> | |
671 | + </ul> | |
672 | + </li> | |
673 | + </ul> | |
674 | + </li> | |
675 | + <li id="revert_teraterm_iss">開発ブランチの teraterm.iss を戻し、コミットする | |
676 | + <pre> | |
677 | +- ;#define snapshot GetDateTimeString('yyyymmdd_hhnnss', '', ''); | |
678 | ++ #define snapshot GetDateTimeString('yyyymmdd_hhnnss', '', ''); | |
679 | + | |
680 | + [InnoIDE_PreCompile] | |
681 | + Name: makechm.bat | |
682 | +- ;Name: build.bat | |
683 | +- Name: build.bat; Parameters: rebuild | |
684 | ++ Name: build.bat | |
685 | ++ ;Name: build.bat; Parameters: rebuild | |
686 | + | |
687 | + [InnoIDE_PostCompile] | |
688 | +- Name: makearchive.bat; Parameters: release | |
689 | ++ ;Name: makearchive.bat; Parameters: release | |
690 | + | |
691 | + [PreCompile] | |
692 | + Name: makechm.bat | |
693 | +- ;Name: build.bat | |
694 | +- Name: build.bat; Parameters: rebuild | |
695 | ++ Name: build.bat | |
696 | ++ ;Name: build.bat; Parameters: rebuild | |
697 | + | |
698 | + [PostCompile] | |
699 | +- Name: makearchive.bat; Parameters: release | |
700 | ++ ;Name: makearchive.bat; Parameters: release | |
701 | + | |
702 | + [_ISToolPreCompile] | |
703 | + Name: makechm.bat | |
704 | +- ;Name: build.bat | |
705 | +- Name: build.bat; Parameters: rebuild | |
706 | ++ Name: build.bat | |
707 | ++ ;Name: build.bat; Parameters: rebuild | |
708 | + | |
709 | + [_ISToolPostCompile] | |
710 | +- Name: makearchive.bat; Parameters: release | |
711 | ++ ;Name: makearchive.bat; Parameters: release | |
712 | + </pre> | |
713 | + </li> | |
714 | + <li>Chocolatey の登録を更新する</li> | |
591 | 715 | </ol> |
592 | 716 | |
717 | +<h3>コードフリーズについて</h3> | |
718 | + | |
719 | +<p> | |
720 | +コードフリース中は、原則的には致命的なバグの修正のみ可能となります。<br /> | |
721 | +コードフリーズは、RC作成(<a href="#RC_commit">開発ブランチ で teraterm.iss に RC を付けるコミット</a>)</a>からリリース(<a href="#revert_teraterm_iss">開発ブランチの teraterm.iss を戻すコミット</a>)までとします。 | |
722 | +</p> | |
723 | + | |
593 | 724 | </body> |
594 | 725 | </html> |