Perforce Swarm リリースノート

                                 バージョン 2018.1 Patch 3

はじめに
---------

    Helix Swarm （以降、「Swarm」と記述）は、Helix Core を使用した開発チー
    ムにおけるコラボレーションおよびコードレビューを実現し、品質の高いソ
    フトウェアを迅速にリリースするよう開発チームを支援します。

    本ドキュメントには、Helix Swarm リリース 2018.1 における変更点がすべ
    て記載されています。

    Perforce のリリース番号は YYYY.R/CCCCC (例: 2018.1/123456) という形式
    で表され、YYYY は年、R はその年の中のリリース番号、CCCCC はバグ修正レ
    ベルでの変更を示します。これらのリリースノートにおける各バグ修正は、
    変更番号で示されています。いずれのリリースも、（1）過去のリリースから
    のすべてのバグ修正と、（2）現在のリリースにおけるすべてのバグ修正を含
    みます。

    これらリリースノートの最新版は、以下の URL から入手することができま
    す。

    * http://www.perforce.com/perforce/doc.current/user/swarm_relnotes.txt

    フィードバックはすべて support@perforce.com にご連絡ください。

------------------------------------------------------------------------


本ドキュメントについて
-----------------------

    Swarm リリース 2018.1 ドキュメントは、製品版の「public/docs」フォル
    ダ配下に保存されており、Swarm にログイン後、ツールバーの「ヘルプ」メ
    ニューからアクセスすることができます。

    また、オンライン (下記 URL) からも同ドキュメントを閲覧することが可能
    です。

    * http://www.perforce.com/perforce/r18.1/manuals/swarm


サポート対象のクライアントブラウザ
-----------------------------------

    Swarm は、次に示すクライアント Web ブラウザの最新安定バージョンをサポー
    トします。

    * Apple Safari
    * Google Chrome
    * Microsoft Internet Explorer
    * Mozilla Firefox

    ベストの状態で Swarm を使用するためには、上記にリストアップしたブラ
    ウザの安定した最新バージョンを使用することを推奨します。

    これら以外の Web ブラウザ (前述の Web ブラウザの古いバージョンや開
    発 / ベータ版を含む) でも動作しますが、正式にはサポートされていませ
    ん。

    Swarm を利用するにあたり、Web ブラウザの avaScript および Cookie を
    必ず有効にしてください。


インストールおよびサポートされているプラットフォーム
-----------------------------------------------------

    詳細については、以下のインストールガイドを参照してください。

    https://www.perforce.com/perforce/r18.1/manuals/swarm/#Swarm/chapter.setup.html


古いバージョンからのアップグレード
-----------------------------------

    詳細については、以下のアップグレードガイドを参照してください。

    https://www.perforce.com/perforce/r18.1/manuals/swarm/#Swarm/setup.upgrade.html


ライセンス
----------

    詳細については、別途用意されている「license」ファイルを参照するか、
    弊社テクニカルサポート <ss_support@toyo.co.jp> までお問い合わせください。


既知の制限
-----------

    アクセス制御

      Perforce の古いバージョン (2013.1/659207 寄り前) では、「dm.keys.hide」
      の設定が存在しません。Swarm は Perforce 内のキーに膨大な量のメタデー
      タを格納します (例: コメント、アクティビティ、プロジェクト)。review
      アクセス権を持つ任意のユーザは、デフォルトでこれらのキーに対して、
      読み込み / 書き込み処理を行うことが可能です。
      
      十分な処理能力を有する新しいサーバを使用する場合、「p4 configure set
      dm.keys.hide=2」を実行して、読み込み / 書き込みキーへのアクセスに管
      理者権限を要求するよう設定してください。

    タスクストリームレビュー

      タスクストリーム内のコミット前のレビューは、まだサポートされていま
      せん。
    
    Swarm の OVA 環境における p4 login2 の実行エラー

      問題：MFA が有効な Helix サーパに対する Swarm OVA 環境で、p4 login2
      の実行がエラー終了します。        
      
      回避策：Swarm OVA を展開する前に、MFA が有効なスーパーユーザのアカ
      ウントで p4 login2 を実行する必要があります。

--------------------------------------------------------------------------
2017.3 へのアップグレード手順

   Swarm 2017.3 にアップグレードする際、追加で実行する手順かあります。Swarm
   のレビュー履歴を正しい順序で表示させるよう、Swarm インデックスを再構築
   してください。
   
   この手順は、Swarm を 2017.3 以降にアップグレードする際に一度だけ必要な
   手順です。その後のアップグレードではインデックスを再構築する必要はあり
   ません。新規インストールの場合も、インデックスの再構築は不要です。
   
   admin または super 権限を持ったユーザが次のページを開くことによってア
   ップグレードできます。
   http://SWARM_HOST/upgrade
   
   詳しくはアップグレードガイドを参照してください。
--------------------------------------------------------------------------
重要なお知らせ

    Swarm 2019.1 では、5.4 より古いバージョンの PHP のサポートを終了する
    予定です。これは、EOL（End-of-Life）に達したプラットフォームの使用を
    廃止するという Perforce社のコミットメントの一部です。
    
    つまり、Swarm 2019.1 をご利用になるには、ご自身で PHP 5.4 以上をイン
    ストールできるようにする必要があります

--------------------------------------------------------------------------
Bugs fixed in 2018.1 Patch 3
    #1742255 (Bug #97228)
        Fixing an issue where the project page becomes un-usable due to
        sub group no longer existing in Helix Core.

--------------------------------------------------------------------------
Bugs fixed in 2018.1 Patch 2

    #1699267 (Bug #96277)
        Diff is not shown after garbled characters.

    #1691958 (Bug #95287)
        Prevent unwanted mail notifications when role on a project cannot
        be determined.

    #1688445 (Bug #096053)
        If the Operating system does not have HTTP::Tiny installed for perl, 
        the Swarm trigger falls back to using Curl instead. The payload
        that was generated for the shelvedel, wasn't being attached to the
        curl request.

--------------------------------------------------------------------------
Bugs fixed in 2018.1 Patch 1

    #1659947 (Bug #95186)
        Fixing the Timestamp display time.
        Timestamp was displaying the wrong time and date on the review
        revision selectors.

    #1657813 (Bug #95127)
        Fixing the show more lines button at the bottom of a file.

        Instead of showing a few extra lines, it was mistakenly showing
        all of the lines to the end of the file.

    #1656932, #1657772 (Bug #95108)
        Fixing swarm-trigger.pl which was not handling extra parameters
        being passed to it. Also put some extra checks around the
        processing of the shelvedel event to ensure we do not empty a
        review by mistake.

    #1656897 (Bug #95056)
        Delayed comment notifications are always identified as comment 
        edits even if all comments are new.

        Fixed to only be identified as edits if there are any edited 
        comments.

    #1650837 (Bug #95016)
        Comments have lost their width restriction on rendering

--------------------------------------------------------------------------
2018.1の主な新機能
------------------

    #1635329, #1635613 (Bug #91807)
        コメントメールの遅延送信に関する改善

        デフォルトで遅延チェックボックスはなくなり、すべてのコメントは 30
        分（1800秒）遅れて送信されます。コメントの電子メールを遅延時間な
        しに送信したい場合は、新しい設定オプションを 0 に設定すれば、コメ
        ントが投稿されるとすぐに通知が送信されます。コメントが追加または
        編集されるたびに、遅延時間は 30分にリセットされます。最後のコメ
        ントが追加または編集されてから 30分が経過すると、Swarm はすべての
        遅延コメントを自動的に 1つのメールにまとめて送信します。
        
    #1623050 (Bug #89713)
        レビューリビジョンのスライダバーが 2つのドロップダウンに変更され、
        ユーザは比較したい 2つのリビジョンを選択できるようになりました。
        また、レビューのベースリビジョンを選択できるよう、オプションが追
        加されました。
        また、レビューの基準改訂版またはレビューの改訂版を選択できる追加
        オプションを導入しました。 レビューが解決する必要があるかどうかを
        ユーザーが確認できるようにヘッドが追加されました。
        
    #1620890 (Bug #94101)
        shelve-delete の場合に対処するトリガを更新し、CWD、CLIENTNAME、
        USERNAME、およびファイル引数のリストを、新しい引数としてトリガス
        クリプトに追加しました。

        ファイルの引数が、すべて同じルートの下に存在するように配置します。
        そのため、パスの任意の部分を確認のうえ削除したり、カレントディレ
        クトリを変更したりする必要があります。

        いくつかのファイル引数はディポ・パスになることがあり、ディポ・パ
        スとして Swarm に渡されます。このとき、ローカルのファイル名とディ
        ポのパスが混在している可能性があります。

        トリガに次の依存関係が追加されています。
        Ubuntu: libjson-perl
        CentOS: perl-JSON
        Windows: Strawberry Perl の一部として既に含まれています。
        Perl CPAN module: JSON

    #1619070 (Bug #94103)
        保留削除トリガのイベントリスナーによりイベントが処理され、可能な
        場合はレビューからファイルが削除されるようになりました。

    #1614852 (Bug #94102)
        保留削除の検出を有効にするための構成オプションが追加されました。
        デフォルトでは、トリガは空の配列によってオフの状態となります。特
        定のレビュー状態からファイルを削除できるようにするには、この配列
        に含めたい状態を追加します。有効なレビュー状態は、'needsReview'、
        'needsRevision'、'rejected'、'approved'です。'approved:commit' お
        よび 'approved' をリストに追加することはお勧めしません。なぜなら
        ば、保留中のチェンジリストを整理する際、レビュー対象のファイルを
        すべて削除することにより、誤ってレビューを更新することを避けるた
        めです。

    #1612156 (Bug #92266)
        Swarm が接続する P4D サーバーの、2 要素認証に対応するようになりま
        した。

    #1604122 (Bug #64898)
        スレッド化されたコメントを、4階層まで追加できるようになりました。
        階層の深さは、システムレベルで設定できます。

Minor new functionality in 2018.1

    #1640585 (Bug #93964)
        トリガスクリプトでサーババージョンをチェックする機能が追加されま
        した。 サーバのバージョンが古いか、もしくはパッチが適用されていな
        い場合、トリガの保留削除機能はサポートされません。 これを実現する
        ため、%serverVersion% 引数をトリガで解析し、メジャーバージョンと
        パッチレベルをチェックします。

        Perforce社では、サポートするバージョンに対するパッチレベルの配列
        を用意しています。2016.1 より古いバージョンは拒否され、2018.1 よ
        り新しいものは自動的に許容されます。 その間のバージョンについては、
        パッチレベル（チェンジリスト番号）によって許容されるか否かが決ま
        ります。

    #1639013 (Bug #91986)
        何日前という形式（Timeago形式）か、通常のタイムスタンプか、日付の
        表示形式を選択できるようになりました。

        この設定はユーザ設定ページで行い、デフォルトでは Timeago形式とな
        ります。管理者がタイムスタンプをデフォルトとしたい場合、config.php
        ファイルにおいて変更できます。

    #1638416 (Bug #94592)
        Windows では fork() が利用できないため、子プロセスを生成します。

        Windows には fork() がなく、fork() をシミュレートするために子プロ
        セスを生成する必要があります。そのため、文書化されていない新しい
        オプション（-z）が追加されました。-z が渡されると、コードは fork()
        の呼び出しをスキップします。-z は、スクリプトが Windows 上で実行
        され、fork() を起動しようとするときに追加され、fork() の代わりに
        Win32::Process::Create() を呼び出します。所定のオプション（および-z）
        が引数として渡されて Perl スクリプトが実行されます。

    #1638315 (Bug #94753)
        コメント/ファイルの既読/未読を示すポップアップテキストを分かり易
        くしました。

    #1637379 (Bug #94138)
        電子メールが送信された理由のアクションを、メールヘッダに追記しま
        す。これにより、電子メールの理由となったアクションに基づいて電子
        メールをフィルタリングし易くなります。

    #1636747 (Bug #94692)
        ユーザがコメントをすぐに送信できるよう、各コメントボックスに投稿
        と通知ボタンを追加しました。

    #1635642 (Bug #94885)
        すべてのコメントを既読にする機能が追加されました。

        レビューのトップバーに 2つの新しいボタンが追加され、そのレビュー
        内のすべてのコメントを既読または未読としてマークできるようになり
        ました。

    #1634173 (Bug #87696)
        ファイルの表示機能を改善し、より多くの内容を表示できるようになり
        ました。

        2つのボタンで、現在の差分の上または下の 10行を表示できるようにな
        りました。また、別のボタンで 2つの diff のすべての内容を表示でき
        ます。これによりユーザは、参照ファイルの量を調節することができま
        す。

    #1633429 (Bug #66560)
        コメントを既読としてマークする機能が追加されました。

        これは、ファイルを既読としてマークする機能と非常によく似ています。
        レビュー中のファイルを表示する際、コメントをグレーアウトして表示
        する量を調整します。

    #1631768 (Bug #94215)
        メンバー数に応じてプロジェクトのサイドバーの透明度を高めました。

        以前の Swarm ではホームページのサイドバーのメンバー数を減らしてい
        たため、大量のプロジェクトに参加しているとメンバー数をほとんど読
        み取ることができませんでした。

    #1631061 (Bug #94478)
        システムレベルの新しい構成可能変数を設け、「詳細を表示」ボタンで
        表示する行数を変更できるようにしました。

        変更の内容を理解できる行数として、デフォルトを 10 としています。

    #1630870 (Bug #72451)
        変更やレビューの説明に対してコメントできるようにました。

    #1626174 (Bug #84866)
        レビュー履歴ページに、アクティビティが発生したバージョンが表示さ
        れるようになりました。 これにより、レビューの各リビジョンで何が起
        こったのかが明確になります。

    #1623437 (Bug #94284)
        作業中チェンジリストが、プレまたはポストコミットレビューに追加さ
        れるようになりました。

    #1623067 (Bug #94329)
        グループ設定ページで、所有者とメンバーを並べ替えられるようになり
        ました。

    #1621863 (Bug #77332)
        P4V の作業中およびサブミット済みアイコンを用いて、レビューのタイ
        プがポストコミットかプレコミットかを明確に示すようになりました。

    #1620929, #1621914 (Bug #88951)
        プロジェクトの編集ページにおいて、メンバーなどをアルファベット順
        で表示するようになりました。

    #1617842 (Bug #94058)
        v9 をサポートするよう、すべての API コントローラをバージョンアッ
        プしました。

    #1617796 (Bug #68470)
        追加または置換として新しいチェンジリストを示すフロントエンドの機
        能が追加されました。

    #1617441 (Bug #93962)
        #review をサポートするのと同じ方法によって、チェンジリストのコメ
        ント内で追加および置換をサポートするようになりました。

        チェンジリスト内のファイルを既存のレビューに追加するには、コメン
        トに＃append-XXXX を追記します。 これにより、当該レビューにそのフ
        ァイルが追加されます。

        レビュー中のファイルを現在のファイルに置き換えるには、コメントに
        ＃replace-XXXXX を追記します。 これにより、当該レビュー内のすべて
        のファイルがチェンジリストのファイルに置き換えられます。

    #1615959 (Bug #93959)
        /api/v9/reviews/:id/changes エンドポイントに、新しいパラメータ 
        mode=[append|replace] が追加されました。

    #1613704, #1613740 (Bugs #61441, #94007, #94008)
        チェンジリストとレビューに対するプリファレンスのインタフェースが
        追加されました。

    #1613258 (Bug #67406)
        ダッシュボードページのデフォルトを、[自分のプロジェクト] としまし
        た。

        デフォルトのプロジェクト表示をまだ設定していない認証済みユーザに
        対して、デフォルトの表示を「すべてのプロジェクト」ではなく「マイ
        プロジェクト」としました。

    #1613254 (Bug #94007)
        ユーザに対して差分/レビュー設定を保存できるようにしました、

    #1610131 (Bug #93403)
        グループ/プロジェクトを保存したとき、その設定ページが表示されたま
        まとなりました。 これにより、ユーザーは意図した変更が保存されたこ
        とを確認できます。

    #1605657 (Bug #87242)
        未処理のタスクを持つレビューを、承認禁止とする設定が追加されまし
        た。デフォルトで以前の動作を維持するように設定することも可能です。

    #1604157, #1604159 (Bug #93423)
        JIRA を使用しているとき、Helix のジョブにリンクする機能が追加され
        ました。

        link_to_jobs をオンにし、P4DTG を有効にすることによって、JIRA の
        チケットを Helix のジョブにリンクできます。

    #1603058 (Bug #93314)
        従来の p4review2 と同様、レビュー仕様に "// depot / jobs" と記述
        しているユーザに対して、メールによる通知が行われるようになりまし
        た。

    #1602144 (Bug #92742)
        自分が所有するプロジェクトを「マイプロジェクト」として表示するよ
        うになりました。

    #1601014 (Bug #92626)
        ユーザ ID の上にカーソルを置くことによって、当該ユーザのフルネー
        ムが表示されるようになりました。

    #1600771 (Bug #93578)
        文字セットのサポートが強化されました。

Bugs fixed in 2018.1

    #1643364 (Bug #94581)
        p4 protects -m should not run for every comment

    #1642759 (Bug #94516)
        Eliminate unnecessary p4 search (1202) commands for project lists

    #1642187 (Bug #94803)
        Fixing an issue when the setting for 窶彭isplay_change_email窶? is
        disabled could result in an error about no email templates.

    #1639957, #1643301 (Bug #94674)
        Adding some loading status to the transition dialog to help user
        know that Swarm is still processing the work in the background.
        This helps prevent closing of the transition dialog when approve
        and commit happens and leaving swarm review in a "committing..."
        state.

    #1638383 (Bug #94508)
        Enhancing the email notifications for private projects.

        If the private project has unticked the send all members and
        moderators and email on review creation, then we ensure we do not
        include them.

    #1635695 (Bug #93926)
        Fixing an javascript error you could get when inputting text into
        reviews page search boxes.

    #1631631 (Bug #94502)
        Swarm was not sending emails out to reviewers of the review when
        the review was committed outside of Swarm.

    #1631630 (Bug #94170)
        Fixed an issue when you added a filename into a project branch
        mapping it could cause Swarm to not display the project.


    #1625385, #1626126 (Bug #94217)
        Fixed an issue were if you were to edit a group notification you
        would get an error about must have owner. This was fixed for older
        version of PHP that works differently.

    #1622116 (Bug #94327)
        The apple 竚? key was mistakenly being escaped and showing html
        encoding in the shortcut dialog

    #1621915, #1623987 (Bug #92244)
        Treat inline `code` the same as block ```code``` in linkify.

        Otherwise, comments with `<` or other HTML entities are escaped and
        become &lt; in the rendered text.

    #1619592 (Bug #90815)
        Trim _ and * from words in linkify code to handle markdown better.

        When encountering something like _word @user_ the linkify code
        would not recognize the @user and would produce unexpected results
        (link would be HTML escaped and it had the wrong reference). This
        change strips underscores and asterisks from the word to better
        recognize the @mention. The drawback is that users and groups
        cannot have trailing _ and * and still be referenced correctly.

    #1617772 (Bug #94140)
        Remove the 'Check all' from user preferences

    #1617736 (Bug #)
        Updating the compiled latest patched p4php against 2016.2 API

    #1617547 (Bug #93623)
        Special case _url config values and do not lowercase their values.

        The customer states that when the avatars URL values are retrieved
        from the config, they are lower cased. This is problematic. However,
        it seems that Swarm wants to lowercase values for easy comparison.
        As such, special case any config value whose path ends with _url.

    #1615266 (Bug #90604)
        Avoid URI limits in reviews request for users with many projects.

        The reviews page was sending every project identifier that the user
        was a part of on the URL, and exceeding the default Apache
        LimitRequestLine value. This change replaces that filter-value with
        a new "projects-for-user" along with a user ID, which the reviews
        controller then replaces with the actual project IDs. This avoids
        any drastic changes to the code.

    #1612538 (Bug #)
        Fixing the mistakenly logging users out when closing any modal
        dialog. Also noticed the success.png wasn't been found when in
        partial mode so resolved this.

    #1604561 (Bug #93687)
        Fix email notifications for opt_in users that have no role

    #1604163 (Bug #93753)
        Tooltip adjustments to show id and full name

    #1604100 (Bug #93491)
        Adjust the wrapping for id/description columns in dashboard.

    #1603741 (Bugs #93764, #93788)
        Improved the display of group names that are long. They now wrap to
        allow display of the other information on the page.

    #1602047 (Bug #90443)
        Do not show moderator role on the dashboard if the review cannot
        be approved yet.

    #1600772 (Bug #91741)
        When calling projects API with option fields readme should only
        return when listed

    #1600757 (Bug #93620)
        User name tooltip to be consistent

    #1596793 (Bug #90087)
        Improved the scrolling of review transition dialog, when you have
        lots of different job status.

    #1597534 (Bug #89230)
        Fixing Inline comments not breaking when lines are very long

--------------------------------------------------------------------------
Bugs fixed in 2017.4 Patch 2

    #1622027 (Bug #94142)
        Fixed the scenario when a user is added as a reviewer but is not a
        member or follower of the project, the user will not receive the
        commit email. The user will now receive an email.

    #1621905 (Bug #94371)
        Updated the P4PHP binary included with Swarm to fix an issue in
        the API. Users without a password were rejected because crypto
        exchange expects a token. Users without a password can now log in
        to Swarm.

    #1621582 (Bug #94228)
        Improved handling of comments with no revision number. Now when
		you click on a comment without a revision number the latest
		revision of the review is opened.

--------------------------------------------------------------------------
Bugs fixed in 2017.4 Patch 1

    #1607458, #1608076 (Bugs #93764, #93806, #93928)
        Improve long Group/Project name wrapping for Microsoft browsers.

    #1606326 (Bugs #93863, #93901, #93905)
        Fixes to the JavaScript to better support Microsoft browsers.
        - Unable to make a default reviewer a required reviewer via the
          branch drop-down setting dialog on Internet Explorer.
        - No drop-down dialog appears when '+Add Branch' button in project
          settings page is clicked on Internet Explorer.
        - 'Map' is undefined JavaScript error on Internet Explorer 10.

    #1605687 (Bug #93687)
        A non-member of a project does not receive email notifications
        when a review spec is setup and honor_p4_reviews is true

    #1605669, #1609142, #1610151 (Bug #93846)
        Projects with a member project can fail notifications

--------------------------------------------------------------------------
Major new functionality in 2017.4

    #1590566 (Bug #92193)
        ブランチおよびプロジェクトレベルでデフォルトのレビューアを設定で
        きるようになりました。

	#1587857 (Bug #92780)
        @@mention の指定により、レビュー参加者のリストに特定のグループを
        追加できるようになりました。 @@* の場合、グループメンバーのすべて
        の投票を必須とます。@@! の場合、一つを投票を必須とします。

Minor new functionality in 2017.4

    #1595196, #1595203 (Bugs #93504, #93506)
        指定されたチェンジリスト番号に対して、デフォルトレビューアのリス
        トを取得する API エンドポイントが追加されました。

    #1594153 (Bug #90292)
        Swarm において、より多くのエンコーディングタイプに対応するための
        構成可能変数が追加されました。

    #1593079 (Bug #93415)
        チェンジリストによって影響を受けるプロジェクトを取得するための、API
        エンドポイントが追加されました。

    #1592102 (Bug #92839)
        ユーザが基準を満たしている定足数グループ内にいる場合、レビュー担
        当者としてその役割をダッシュボードに表示するようになりました。

    #1592081 (Bug #92596)
        API において、モデレータグループをプロジェクトとして使用できない
        ようにしました。

    #1591817 (Bug #93350)
        レビュー作成者の変更ブロックに右マージンを持たせ、タスクと同じ値
        を使用することにより、スペースが、変更レビュー作成者を無効にする
        のと同じようにしました。

	#1591640 (Bug #93062)
        デフォルトレビューアを含むチェンジリスト用の API が作成されました。

    #1591638 (Bugs #92195, #92196)
        バージョン 8 のデフォルトレビューアを含めるための、プロジェクト 
        API リクエストが実装されました。

    #1590126 (Bug #92991)
        自身のページから、すべてのフォロワーを削除する機能か追加されまし
        た。admin または super 権限を持っていれば、別のユーザのページから
        すべてのフォロワーを削除することもできます。

    #1589583 (Bug #93325)
        プロジェクトの表示名が自動補完されるようになりました。

    #1588528 (Bugs #92402, #93239)
        「続きを表示」ボタンがファイルの最後に表示されなくなりました。代
        わりに、2種類の「さらに表示」ボタンが設置され、差分が切り捨てられ
        たときの操作性が改善されました。

    #1584512 (Bug #89741)
        承認とコミット時にテストを無効にするための構成可能変数が追加され
        ました。

Bugs fixed in 2017.4

    #1595827 (Bug #93554)
        Fixing performance issue with projects fetching readme and searching
        too deep down the depot tree structure.

    #1595336 (Bug #91034)
        Fixing the issue when swarm is running against a Windows P4D server
        the unzip can fail due to camel case protections.

    #1594753 (Bug #93508)
        Dashboard performance improvements. Modified a few of the dashboard
        queries to make them more efficient and improve loading speed.

    #1593203 (Bug #93389)
        Improved the Upgrade of swarm key data to not update the review
        last updated date when issuing the upgrade endpoint.

    #1592554 (Bug #92922)
        Prevent linkify parsing off the end of code blocks and ignoring
        subsequent @mentions

    #1592082, #1593106 (Bug #93412)
        Wrap items in the project sidebar rather than let them overflow the
        dashboard. Applied the existing .force-wrap class to the sidebar
        project attributes

    #1591346 (Bug #92570)
        Don't offer the current group in the members dropdown

    #1589558 (Bug #92781)
        Putting Display name onto Groups and projects.

    #1589542 (Bug #93327)
        Observations on Show more Context fixes

    #1587990 (Bug #93312)
        Fix to remove the $this->p4 from the closure and pass the
        connection in instead.

    #1587727 (Bug #93096)
        Fixing an issue where the change will return an event of mail with
        no template. This meant it was causing an ERR about no valid
        template.

    #1584513 (Bug #93059)
        Reduce the amount of calls to fetch the timezone of the connected
        P4D, now cache the timezone to help reduce performance impact.

--------------------------------------------------------------------------
Major new functionality in 2017.3

    #1576709 (Bugs #92887, #92890)
        グループにプロジェクトを展開し、グループがメーリングリストを使
        用していないときにグループをメンバーに展開します。

    #1574656 (Bug #92805)
        当該ユーザがレビューの参加グループのメンバーである場合、ユーザ
        のアバターがレビューページから削除されるようになりました。

    #1573690 (Bug #92461)
        プロジェクトサイドバーにおいて、グループのメンバーを個々に表示
        するのではなく、グループのアバターのみを表示するようになりまし
        た。

    #1573175, #1574693 (Bug #92650)
        api バージョンのドキュメントを v7 に更新し、anonymous に対して
        /api/version へのアクセスを許可するようになりました。

    #1570712 (Bug #92203)
        グループ通知の設定に関するインタフェースが実装されました。

    #1569595 (Bug #92681)
        グループを考慮に入れて、承認およびコミットを実行できるようにな
        りました。

    #1569358 (Bugs #92635, #92720)
        現在ログインしているユーザーがレビューの担当グループのメンバー
        である場合、メニュー項目は異なる方法で表示されるようになりまし
        た。

        メニュー項目は、「賛成投票」、「反対投票」、および「レビューに
        参加」となります。

        「レビューに参加」メニューが表示される理由は、投票を行うまでは
        実際のレビューアとしないためです。

        「レビューへ参加」メニューをクリックすることにより、メニュー項
        目は「賛成投票」「反対投票」「通知を無効」「レビューから離脱」
        となります。
        
        通知を無効にすると、当該レビューに関する通知を受け取らなくなり
        ます。ただし、グループのメーリングリストが定義されていれば、そ
        れに対する通知は受け取ります。
        
        レビューから離脱すると、投票がクリアされ、直接のレビュー参加者
        ではなくなります。しかしながら、依然としてグループを経由したレ
        ビューのメンバーです。

    #1569194 (Bug #92206)
        構成可能変数 group_notification_settings により、グループのメタ
        データを保存できるようになりました。

    #1569165 (Bug #92205)
        グループに対して機能するように、通知設定が変更されました。

    #1567846 (Bug #92190)
        @@mention と指定することによって、@mention リストにグループを指
        定できるようになりました。

    #1567844 (Bug #91173)
        レビューのコメント内で @@*mention または @@!mention でグループ
        を指定することによって、当該グループをレビュー参加者として追加
        できるようになりました。

        次のとおり、@@mention でグループを指定できるようになりました。
        @@mention：当該グループをレビュー担当者とする。
        @@*mention：グループメンバー全員の賛成投票が必要。
        @@!mention：グループメンバーの少なくとも 1名の賛成投票が必要。

    #1567037 (Bugs #92229, #92230)
        グループに所属していることによって個人が取るべきアクションが、
        ダッシュボードに表示されるよう改善されました。

    #1563741 (Bugs #92149, #92179)
        API リクエストからレビュー担当者としてグループを表示する機能が
        追加されました。各グループには、swarm-group-'GroupID という接頭
        辞が付きます。GroupID は Helix のグループ名です。

    #1563243 (Bug #92198)
        グループは、追加された個々のレビューアとともにレビューページで
        表示されるようになりました。 レビュー担当グループのメンバーは、
        すべての直接メンバーとサブグループメンバーを表示するメニューを
        利用できます。 また、ユーザは、レビューのグループロールを「任意」
        「全員の賛成必須」「一人の賛成必須」から選択できます。 グループ
        アバターは、そのグループのメンバーに基づいて正しい投票状態を表
        示します。

    #1561671, #1563195 (Bug #92201)
        レビュー担当として、グループをレビューに追加できるようになりま
        した。

    #1557483 (Bug #92493)
        グループに対して、ユーザと同じ方法でアバターを設定できるように
        なりました。

    #1553115 (Bugs #92207, #92247)
        グループ設定ページで、メールアドレスを変更する機能が追加されま
        した。

    #1552877 (Bug #92208)
        API を介して、グループのメールアドレスを追加する機能が追加され
        ました。

    #1548638 (Bug #72452)
        レビューページに関する新しい構成可能変数が用意され、デフォルト
        のレビュー表示順序を設定できるようになりました。 値に 'updated'
        または 'created' を設定することにより、更新された日付順または作
        成された日付順に、レビューの表示順序を設定できます。

    #1546810 (Bug #91718)
        レビュー検索の役割フィルタを変更することでユーザは、「作成者」
        「作成者ではない参加者」「参加者または作成者」であるかどうかに
        応じてレビューをフィルタリングできるようになりました。

Minor new functionality in 2017.3

    #1573194 (Bug #92809)
        編集レビューア形式のオーバーフローやスクロールを動的に管理する
        ようになりました。これにより、自動補完は消えず、多くのレビュー
        アがフォームボタンにおいてスクロールされるようになります。

    #1571516 (Bug #92586)
        ユーザ名やグループ名の前にメンションのための * または ！ を指定
        しても、オートコンプリートに対応するようになりました。

    #1569931 (Bugs #92511, #92594)
        以下のグローバル通知設定が追加されました。
        - review_opened_issue
        - review_required_vote
        - review_optional_vote

        これらは、グローバルレベルでのみ設定できます。

    #1566967 (Bug #92633)
        グループページからベルアイコンが削除されました。

    #1560222 (Bug #90023)
        各グループの上にタイトルを表示することで、ユーザーとグループが
        区別し易くなりました。

    #1557324 (Bugs #90018, #92491)
        ユーザーページを拡張し、サイドバーにユーザのメールアドレスが表
        示されるようになりました。

    #1553022 (Bugs #91719, #92429)
        以下のとおり、グローバルとユーザに対する通知が追加されました。

        - 自分はレビューのモデレータであり、かつレビュー内のファイルは
          更新されている
        - 自分はレビューの作成者であり、かつレビューはコミットされてい
          る
        - レビューの状態を変更した（デフォルトを false にする必要があり
          ます）
        - 自分はレビューの作成者であり、レビュー上のテストが完了した
          （テストは合格した、またはテストは失敗した）

    #1552908 (Bug #91999)
        レビューページの進捗バーが改善されました。

    #1551363, #1551811 (Bugs #92180, #92181)
        ブランチのフィールドにモデレータグループを含めるよう、API ドキ
        ュメントが更新されました。

    #1549768 (Bugs #92172, #92174)
        プロジェクトのモデレータブランチにおいて、グループがモデレータ
        として追加されるようになりました。

    #1543562 (Bug #70512)
        curl リクエストによって、削除されたプロジェクトを元に戻すことが
        可能になりました。

    #1543281 (Bugs #86639, #92285)
        メールをフィルタリングして utf-8 エンコーディングを設定できるよ
        うに、X-Swarm-Review-Id/Author ヘッダが追加されました。

Bugs fixed in 2017.3

    #1556959 (Bug #92529)
        Added some validation to ensure that project members where not
        being added to the notification list when a review was updated.

    #1553867 (Bug #92448)
        Added some handling around the reviews page fetching more records
        then it required to load the page.

    #1552791 (Bug #92432)
        Put some handlers in place to deal with unexpected character
        encoding that swarm did not handle. If Swarm does not understand
        the encoding will convert the character into ? to allow the show
        more button to continue to work

    #1550088 (Bug #92444)
        Fixed the review State Filters that was not working in IE11

    #1548609 (Bug #91969)
        Users interested in a project did not always get commit emails if
        opt_in_review_path is set

    #1542425 (Bug #92019)
        Fix to resolve the reviews not updating. The issue is due to
        workspaces having files in pending changelist when it should have
        been cleaned up.

--------------------------------------------------------------------------

Bugs fixed in 2017.2 Patch 2

    #1549954 (Bug #92444)
        Review state filters in the Reviews page on Swarm/2017.1
        and Swarm/2017.2 show a console error with MS IE11.

    #1550085 (Bug #92285)
        Re-instate MIME encoding of email headers removed
        after Swarm 2016.1.

--------------------------------------------------------------------------

Bugs fixed in 2017.2 Patch 1

    #1539964 (Bug #92340)
        Fixed an undeclared property which was failing when accessing 
		users fullname against no unicode enabled servers.

--------------------------------------------------------------------------

2017.2 の主な新機能
--------------------

    #1532256 (Bug #92061)
        差分表示に関する不具合を修正しました。

    #1529588, #1529647, #1533980 (Bugs #90654, #91642, #91650, #91769)
        大容量のファイルをレビューする際の操作性が向上しました。構成可
        能変数が 2 つ追加され、これを設定することで管理者はページの読み込
        みに要する時間を調整して改善することが可能です。

        参照時にファイルサイズをバイト単位で表示します。
        'files' array(
            'max_size'  => 1024 * 1024,
        ),

        ファイルがトランケートされる前に表示される差分の行数
        'diffs' => array(
            'max_diffs' => 1500,       // 手動で上書きしない
                                       // 差分の最大行数を指定
        ),


    #1524707 (Bug #91782)
        賛成票 / 反対票のフィルタリングに関するパフォーマンスが向上しまし
        た。リクエストでは、ログイン中のユーザが参加しているレビューのみ
        が取得されます。これにより、ポストフィルタで処理されるデータ量が
        制限されます。

    #1524597 (Bug #91756)
        表示されるファイル数を制限するための構成可能変数が新たに追加され
        ました。

        これらの変数は、オプションを無効化するファイル制限を指定すること
        で、レビューにおける 'Expand all' の使用を制御します。0 は常に有
        効であることを示します。
        'reviews' => array(
            'expand_all_file_limit' => 10,
        ),

    #1523805 (Bug #91798)
        Zend には、ページの読み込み時間を改善する cache クラスが標準で実
        装されています。この cache クラスを使うよう Swarm が構成されまし
        た。

    #1521677, #1524714, #1525522 (Bugs #91673, #91695, #91755, #91780, #91781,
    #91782, #91811)
        すべてのレビューを取得し、メモリを最大限に消費していた 
        FETCH_MAXIMUM がリセットされないようになりました。フィルタリング
        を実行した際にレビューがほとんど存在しないと、前のページを表示す
        るために、レビューページは大量の Ajax を呼び出します。

    #1520113, #1520876 (Bug #90952)
        レビュー用に「I have not voted (未投票)」フィルタが追加されました。
        これにより、ユーザは自分が参加しているレビューで、まだ投票してい
        ないものや、古い投票のレビュー一覧を確認することができます。

--------------------------------------------------------------------------

Minor new functionality in 2017.2

    #1523878, #1524740, #1524624, #1533964 (Bugs #91833,#91834, #91835,
    #92130, #92145)
        Re-branding of product updated.

    #1531205 (Bug #91930)
        The comments filter now includes the author as a participant when
        fetching reviews.

    #1529997 (Bug #89066)
        Allow longer time to download a file - configurable value default
        to 30 minutes same as archive

        'files' => array(
           'download_timeout' => 1800, // Time allowed before download of a
                                       // non archive file will error default
                                       // 30 minutes (must be in seconds)
        ),

    #1528515, #1528516 (Bugs #87586, #89689, #90701, #90702, #91286, #91953,
    #92053)
        Removing the need for curl/wget in the swarm trigger script. This
        should simplify configuration and installation, especially on
        Windows.

        VERIFY_SSL - Defaults to 1, if 0 then will not verify SSL
        certificates, allowing self-signed certs to be used on a web
        server.

        Also now outputs the error reason if there is a non-200 response
        from the server, and checks to ensure that no content has been
        returned even if there is a 200 response. Since the Swarm endpoints
        don't return any content from a trigger call, if we see content
        then possibly we're not configured to talk to the correct web
        server.

    #1528166 (Bug #91240)
        Introduced a review cleanup script as example of how to tidy up
        reviews that may have many pending changelists associated with them.
        This can be found in the API section of the documentation.

    #1520123 (Bug #90855)
        Moving the activity stream to its own page if a readme.md is
        present or not disabled.

    #1520087, #1521604 (Bug #91627)
        Added feature to check if group tab is disabled. If it is disabled
        we remove groups from the search box.

    #1519006 (Bug #91670)
        Ensuring that shelved changes in Swarm only show the @mention users
        based on the mentions mode that has been set.

    #1519005 (Bug #91598)
        Upgrading Jquery to 3.2.1

    #1517927 (Bugs #91395, #91432, #91433, #91434)
        Making sure the mention mode for pages like reviews/changes and
        jobs have taken effect.

--------------------------------------------------------------------------

Bugs fixed in 2017.2

    #1533627 (Bug #79136)
        Fixing bug with trigger SSL verification, and making sure a ping
        command outputs any errors to the console.

    #1532234 (Bug #91857)
        Fix to make the state buttons on the reviews page sticky.

    #1532216 (Bug #91962)
        Corrected the display of file history where in some edge case
        integrations were being left off or displayed incorrectly.

    #1531115 (Bug #91839)
        Email threading not working correctly for outlook users. Corrected
        the threadIndex and added additional debug output.

        Also added new configurable to allow the threadIndex to be turn off
        or on.

        'mail' => array(
            'index-conversations' => true,
        ),

        Some mail application and servers can deal with the indexing
        themselves.

    #1530952, #1531161 (Bug #91866)
        When using the delay email (batching) it wasn't taking the
        configuration option 'notify_self'. This meant that the Author wasn't
        being added to the recipients list.

    #1530881, #1530904 (Bug #92033)
        Upgraded Zend to 2.2.10 due to PHP 5.3.3 compatibility limits.

    #1530040, #1532193 (Bugs #92002, #92003, #92004)
        Fixes for cleanup API return values both with and without the
        reopen parameter.

    #1530007 (Bugs #91417, #91612, #92141, #92159)
        Comments mentions and project owners/members search should use user
        full name.

    #1529630 (Bug #89986)
        Improved the frequent calls to the groups command, which now uses a
        local cache to help speed the request up. This also helps lower the
        number of Perforce commands Swarm issues.

    #1529623 (Bug #91913)
        If a review author has been deleted we don't log this as an error when
        getting the review.

    #1529616 (Bug #91860)
        Fix review index storage when a review commit fails. If a review is
        approved:committed and it fails (perhaps due to resolution needed)
        the review state index remains at approved. This is because the
        indexes get updated before the commit runs. If the commit fails we
        should roll back to the previous state so the index value and the
        review agree.

    #1529602, #1529923 (Bug #91783)
        Fix the global search functionality that wasn't able to fetch data
        from the cache.

    #1526033 (Bug #91742)
        Fixed the mail module that would exit without warning if the Perforce
        user was deleted.

    #1523803 (Bug #91640)
        Fixed Unicode character issues searching full name.

    #1518979 (Bug #91549)
        Add some defensive code to cope with user clone errors.

--------------------------------------------------------------------------

Bugs fixed in 2017.1 Patch 2

    #1516348 (Bug #91548)
        Dashboard incorrectly showing user as Moderator.
        
    #1516683 (Bug #91510)
        URL to documentation from pending changelist dialog is not
        correct if Swarm is running on non-default URL root.
        
    #1517575 (Bug #91613, #91592)
        Comment boxes at the bottom of files are not visible, making it
        difficult to add comments in this situation.

--------------------------------------------------------------------------

Bugs fixed in 2017.1 Patch 1

    #1514634 (Bug #91503)
        Fix to documentation for the new notifications configuration.

--------------------------------------------------------------------------

2017.1の主な新機能
------------------

    #1507398 (Bugs #91013, #91014)
        E-mail 通知を設定する UI ページが追加されました。

    #1504132 (Bug #90741)
        設定が有効の場合、ユーザの作業中チェンジリストを自動的にクリアで
        きる機能が新たに追加されました。

    #1502499, #1503697, #1504157 (Bug #89906)
        グローバル通知を設定するためのサポートが追加されました。

    #1499167 (Bug #90426)
        プロジェクト用の Readme.md ファイルを表示するサポートが実装されま
        した。

    #1496945, #1508873 (Bug #86498, #90885)
        コメントにおける Markdown 記法がサポートされました。ページのフロー
        を分断しない構文に限りコメントで Markdown 記法を使うことが可能で
        す。

    #1493811, #1496152, #1496156 (Bug #90559, #90562, #90671, #90672)
        新しいレビュー用のフィルタが追加されました。これにより、レビュー
        へのコメントや投票に基づいて、レビューを一覧表示することができる
        ようになりました。

    #1488307 (Bug #89886)
        ホームページにアクション用のダッシュボードが追加されました。これ
        により、アクションが必要なレビューを確認できます。

    #1485432, #1485462, #1489449 (Bug #86758)
        P4PHP および Swarm における PHP7 がサポートされるようになりました。

    #1481965 (Bug #89025)
        レビューの作成者を変更するための機能が追加されました。

        この機能を有効にするには、以下の設定を true に変更してください。

        'allow_author_change' => false,

--------------------------------------------------------------------------

Minor new functionality in 2017.1

    #1510372 (Bug #91320)
        Added ability to disable and limit what markdown is rendered.

        Settings will be:
        
        'projects' => array(
           'readme_mode' => 'restricted' // Modes, "disabled", "restricted",
                                         // "unrestricted"
        );

        Disabled = means now markdown rendered at all. Restricted = Will
        render default markdown but not html elements Unrestricted = Will
        render everything it can in the file with no restrictions.

    #1508474 (Bug #90730)
        Remove old legacy trigger scripts.

    #1507806 (Bugs #90584, #90759)
        Configurable project sort order for 'All projects' on the home page

    #1507137 (Bug #90795)
        Changed the Reviews page a little to allow it to display a reviews
        with lots of reviwers on it. Also made it so the actionable buttons
        like Tasks, Author change and Reviewers buttons go onto a new line
        once a screen size is too small.

    #1503645, #1503754, #1503714 (Bug #91012)
        Implemented user notification settings storage

    #1499644 (Bug #90703)
        Adding the ability to cleanup the users pending changelist related
        to a review when committing the reviews.

    #1496624 (Bug #90637)
        Remove the fullname of users from the buttons when added to project
        so they don't look like the name is being truncated.

    #1496523 (Bug #90388)
        Changes to email headers.

        This change changes how email headers are constructed for reviews.
        Previously we were assigning random timestamps to emails coming out
        of reviews, this resulted in users not being able to filter the
        email notifications coming out of Swarm.

        Main principle is - all messages should have proper Message-ID and
        In-Reply-To headers - if this is a new review then the email should
        only have a Message-ID. All messages coming out of a review should
        have the header of In-Reply-To pointing to the message-ID of the
        first email in the chain (new review being requested). All comments
        to the review itself should be accumulated under one thread, all
        comments to a specific line in a file in a specific version should
        have their separate thread. All other messages - actions taken on
        the review - should have a distinguishable value ie.
        "action-voted_up" and a timestamp to avoid confusion between
        messages.

        The part after "@" sign should be configurable and default to
        'swarm'.

    #1492280, #1498080 (Bug #88949)
        Enhance Swarm RESTful API to allow retrieving a list of inactive
        reviews and archiving the inactive reviews in bulk.

    #1492207 (Bug #87136)
        Autosuggest dropdown with users for @mentions in comments.

        Added jquery plugin to enable user dropdown in comments on
        files/reviews/jobs with new configuration options: 'mentions' =>
        array( 	'mode' - either global(default)/projects/disabled
        	'usersBlacklist' - array of user id's that should not appear on
        the dropdown

        It uses a two-fold approach - if we have enabledAll - all comment
        boxes in all pages in Swarm - the data is fetched from js with an
        ajax call and then passed down to the plugin. If we have
        enabledInProjects only comment boxes in reviews that are part of a
        project will have a list of users that are either a participant on
        that review or a member of a project.

        By default the dropdown is disabled.

    #1490507 (Bug #90062)
        Review Participants API endpoint

        This endpoint will enable listing, adding, removing, and updating
        participants on reviews.

        It will also allow the API caller to define required participants
        and place votes.

    #1488227, #1489225 (Bug #89362)
        Review page project filtering enhancement to maintain consistency.
        Added an input field on the projects filter.

    #1486271, #1490338 (Bug #89614)
        Updated P4PHP to 2016.2 release which contains a fix for not
        requiring login -a.

	#1485328 (Bug #89885)
        Action Review API to support action Dashboard


    #1480084, #1487008 (Bug #72450)
        Add option to sync change/review descriptions.

        If "sync_descriptions" was enabled and we have updated a change
        description on a changelist all previous changelists would have
        their description changed.

    #1479671, #1486253 (Bug #87275)
         Only show groups tab for super users.

    #1479414, #1486693 (Bugs #74561, #80804)
        Modify the message behaviour on commit failure.

        Previously we were discarding all messages coming out of p4 and
        passing down the first line of the message.

        Modify the behaviour to pass the whole message except the last line
        for jQuery to render. If message will have more than two lines use
        the extender to hide the additional output. It will pass down
        anything coming out of Perforce - so it will also pass any
        user-defined messages - like messages coming out of triggers - to
        the frontend.

    #1478138 (Bug #85037)
        Override expander to allow any part of the table cell containing
        the shortened description to be clicked.

    #1477010 (Bug #63571)
        Implemented a global 'ignore whitespace' button that toggles
        ignore off/on. Initially whitespace is not ignored - when you click
        the global button all files that were not ignoring whitespace and
        changed to ignore whitespace Similarly when you toggle the global
        button off all files ignoring whitespace are switched to not ignore
        whitespace

--------------------------------------------------------------------------

Bugs fixed in 2017.1

    #1510345 (Bug #76755)
        Fixed abstract API controller when the implementing controllers
        simply return null instead of a json model.

    #1510048 (Bug #90177)
        Fixed an issue to allow users the ability to unlink jobs from a review.

    #1509403 (Bug #91047)
        Swarm PATCH API endpoints - cannot unset array based parameters

    #1508938 (Bug #91015)
        Differentiate mail instance name when in a multi server environment

    #1507768 (Bug #91100)
        Tweaked the cache reader to handle failures from fetching all
        users better and improved performance.

    #1506970 (Bug #90564)
        Increased the API version to V6 for all the new API endpoints.

    #1503190 (Bug #90941)
        Handle if dm.keys.hide is set and fetch review data as the user
        running Swarm and validate the normal permissions with the user
        requesting the zip.

    #1500863 (Bug #90690)
        The Swarm home page was giving a bad link for RSS feeds. Fixed the
        javascript that handled this.

    #1500020 (Bug #90785)
        Enhanced the archive API endpoint to allow Super user to change the
        transition of the review state using the Bulk review archive API
        endpoint.

    #1499188 (Bug #90783)
        Improved the date validation for inactive search as well as archive.

    #1497510 (Bugs #90717, #90733, #90735)
        It introduces a configuration option to restrict the number of
        action items on the dashboard (defaulting to 1000).


    #1496055 (Bugs #90560, #90586)
        Improved the review description formatting to break at new lines.

    #1494480, #1497544 (Bug #90307)
        If your P4 admin is mis-configured or its ticket has expired,
        will result in the user now getting a meaningful error message.

    #1493869 (Bug #89988)
        Bookmark reviews filter.

        As we cannot reliably do the same thing for all browsers a decision
        has been made to include a button on the reviews page to save the
        url - this button should have a tooltip informing users of an
        option of saving the current filters by using the browsers built-in
        function to create bookmarks.



    #1492312 (Bug #87180)
        Fixing temporary file creation while handling ktext files.

        Trigger script was creating a file and trying to run a p4 print
        against an open file - which would understandably fail. The message
        returned was not helpful to the customer at all.

        Changed it so instead of creating a file it creates a filename that
        later is used with the print command - should fix the problem and
        it should now be possible to recalculate digests for unexploded
        ktext files.

    #1492205 (Bug #90376)
        Fixing the issue where the project typeahead would auto close when
        clicking inside the input. This was due to the multiPicker checking
        if authenticated first then dropping out instead of preventing the
        closure of the input box first. This has only been introduced
        because no multipicker was accessible unless logged in.

    #1491907 (Bug #90380)
        If you have navigated to a private project and decided to logout,
        you will now be redirected to the home page instead of a 403 error.

    #1491863 (Bug #90217, #90218)
        Make the global whitespace buttons stick between pages.

    #1490000 (Bug #89983)
        Filter reviews by participant role only Filter reviews by
        participant role only On the 'Reviews' page selecting "I'm a
        participant" should not also return all the views I authored

    #1489999 (Bug #80507)
        We should attempt to line break long descriptions to prevent the
        whole description from appearing in bold.

    #1487039 (Bug #90243)
        This change prevents the user from adding a non-committed change to
        a review from the 'Add commit...', 'Already committed...' dialogs.

    #1484420 (Bug #89829)
        Defensive code for trigger script to ensure argument are defined.

    #1483093, #1490001 (Bug #89908)
        Perforce admin users should not see all projects Perforce super
        users should see all projects Perforce admin users should not see
        all projects; they should be subject to permissions when it comes
        to project filtering

    #1481962 (Bug #80366)
        Close our confirm popover when clicked outside.

        Before, the only way to close the popover was by clicking on the
        'Cancel' button inside it. This could be problematic when the DOM
        structure changes as it could cause the popover being visually
        detached from the element.

    #1481527, #1482019, #1483208 (Bug #89801)
        PHP 7.0-compatible .htaccess and build.xml files

    #1480955 (Bug #89891)
        Make sure if someone updates a review, they get properly credited
        for the work.

        Previously if user 'foo' created a review, all updates to that
        review would be credited to that user. This should make sure anyone
        who at any point updates the review with a new shelf, is credited
        for the work, instead of the review author.

    #1480702 (Bug #88630)
        Show a better error for invalid group name created via the API

    #1480070 (Bug #89622)
        Allow owners to delete a project without needing to be a member

    #1479660 (Bug #65237)
        Make branch id in sync with branch name

    #1474448 (Bug #89662)
        Fixed a bug where review version slider was always rendered in
        scrolling mode if review page was loaded with 'Files' tab not
        active.

--------------------------------------------------------------------------

2016.3の主な新機能
------------------

    #1467868, #1471434 (Bug #87694)
        レビューバージョンのスライダーに、横向きのスクロールバーが実装され
        ました。

        リビジョン数が非常に多いためにレビジョンノード間の距離が 30 ピク
        セルよりも小さくなる場合に、このスクロールバーが表示されます。

        また、画面に表示しきれないプロット上のリビジョンが存在することを
        視覚的に示すため、スクロールバーとともにその横に、左 / 右ボタンが
        表示されます。

    #1467839, #1471273 (Bug #87137)
        レビューに参加しながら、特定のレビューの通知を受信しないように設
        定できるようになりました。他のユーザがその通知に再度 @mentions を
        付与すると通知を受信しますが、これ以外の場合、あらゆるアクション
        に関する通知を受信しません。

    #1464475, #1467862 (Bug #76662, #89337)
        レビュー用に新しいタスクダイアログが追加されました。報告者やタス
        クのステータス (Open / Addressed / Verified) でフィルタリングする
        ことが可能です。

    #1462877, #1468505, #1469467 (Bug #89076, #89487)
        Swarm Comments APIの新機能:

        - コメントを一覧表示する際のフィルタを新たに追加:
            - ignoreArchived (boolean)
            - tasksOnly  (boolean)
            - taskStates (文字列の配列: comment, open, addressed, verified)
        - 出力は、レビュートピックを一覧表示する場合に、新しい 
          context[version] フィルタを使う特定のレビューバージョンに限定さ
          れます。

        これらの変更を有効にするため、API のバージョンが V5 にダンプされ
        ます。

    #1460511, #1461108, #1466651, #1467799, #1467866, #1468376, #1471350
    (Bugs #67282, #89145, #89146, #89209, #89242, #89384, #89492)
        レビュー内容をダウンロードして.zip ファイルとしてコミットするた
        めのボタンが追加されました。

    #1458591 (Bug #87390)
        現在のレビューバージョンに投稿されているコメントのみを表示するオ
        プションが追加されました。

    #1452353, #1453328, #1464507 (Bugs #86857, #88891)
        特定のユーザでレビューをフィルタリングする機能が追加されました。

--------------------------------------------------------------------------

Minor new functionality in 2016.3

    #1467904, #1471347 (Bug #89151)
        When a project is converted from Public to Private, followers are
        removed to prevent them from accessing the project and receiving
        project notifications. A warning to this effect is displayed when a
        project has existing followers and the 'Private' checkbox is checked.

    #1464600 (Bug #87260)
        Add a config option to control the default "ignore whitespace"
        setting for file diffs.

        $config['diffs']['ignore_whitespace_default'] can now be set to true
        or false to control this behaviour.

    #1464415 (Bug #79156)
        Add hyperlink for review on Commits page.

    #1462721 (Bug #78162)
        Configuration option ('mail' -> 'notify_self') allowing users to
        receive emails for their own comments.

    #1462538 (Bug #89067)
        Include a call to cleanFiles() in updateFromChange() - this should
        help Swarm keep better track of its managed workspaces.

    #1459119 (Bugs #70655, #88082)
        Update user profile pages to display more information about project
        membership.

    #1453538, #1467872, #1467881 (Bug #67131, #89340, #89371)
        Added the ability to display line endings (CR, LF, and CR+LF) along
        with other whitespace characters.

    #1462197, #1467459 (Bug #72504)
        Adding a 'My Projects' entry to the project filter drop-down based
        on customer request.

--------------------------------------------------------------------------

Bugs fixed in 2016.3

    #1471099 (Bug #89514)
        The "Edit Reviewers" dialog now requests a fresh list of reviewers
        from the server when it opens.

    #1470023 (Bug #89544)
        Eliminated some PHP notices and warnings when Swarm is processing
        review commits.

    #1467769, #1467783 (Bugs #77869, #79019, #85255)
        Improvements to Swarm's handling of case-insensitive P4D instances.

        - Fixed a problem where on a case insensitive server you can end up
          with duplicate reviewers.

        - Fixed a bug where a user could approve their own review
          on a case insensitive server.

    #1467529 (Bug #70431)
        Leave files expanded when switching between review versions.

    #1466334 (Bug #88952)
        Tweaked searching in reviews queue to include records with literal
        ID match in results.

    #1464587, #1465462, #1467647 (Bug #85143)
        Swarm now treats users and groups containing '/' with more care.

    #1464505 (Bug #71838)
        Project followers count shown in the tooltip on the home page is now
        more accurate.

    #1455427 (Bug #87983)
        CSS update to help make it easier to scroll certain files in
        diff views.

    #1455374 (Bugs #88652, #88724)
        Migrate threejs from r64 to the most recent version r81.

    #1452571 (Bug #87759)
        Updated Review listener to lock processing the review task via our
        advisory record lock.

        This should eliminate a race condition where 2 processes (2
        different workers) are trying to process the same review task,
        which can for example happen when a review is requested from P4V.

    #1452069 (Bugs #84131, #86502)
        Activity stream on the user's Profile page now works with usernames
        containing "\", such as "foo\bar".

    #1449548 (Bug #88141)
        Improve load time of Changes page.

--------------------------------------------------------------------------

2016.2の主な新機能
-------------------

    #1438253
        Swarm API V4の新機能:

        - プライベートプロジェクトのサポート
        - ファイル / 行レベルにおけるインラインコメントのサポート

    #1437756, #1438482, #1441898, #1444540, #1444540 (Bugs #87883, #88471,
    #88548)
        Swarm Comment API では、ファイルレベルおよび行レベルにおける、イ
        ンラインのコメントを変更やレビューに対して作成できるようになりま
        した。

        新しいパラメータ "context[rightLine]" ならびに "context[file]" 
        を指定することで、API クライアントで Swarm のレビューや変更に対す
        る行レベルのコメントを追加することが可能です。"context[file]" の
        みを設定すると、ファイルレベルのコメントを追加することができます。

        "context[version]" パラメータを用いることで、特定のレビューバージ
        ョンに、コメントを追加することも可能です (同パラメータを指定しな
        い場合には、デフォルトで最新のバージョンに追加されます)。コメント
        を diff ツールの左側に追加するには、"context[rightLine]" ではなく
        "context[leftLine]" を使ってください。

        Swarm は、"context[content]" の値そのものを作成しますが、オプショ
        ンで行レベルのコメントには、比較結果の 5 行を表示することができま
        す。これを Swarm UI で使用すると、コメントの追加後にコードが編集
        されているかどうかが検出され、"古い" コードがそのコメントのプレビュー
        として示されます。

    #1436048, #1437222, #1437569, #1437686, #1437750, #1437752, #1438054,
    #1438237, #1439324, #1440324, #1440706, #1444542 (Bugs #87098, #87729,
    #87730, #87930, #87994, #88029, #88132, #88360, #88402, #88418, #88523)
        Swarm に "プライベートプロジェクト" という概念が導入されました。
        これらのプロジェクトは、管理者、スーパーユーザ、プロジェクト所有
        者、プロジェクトメンバ、プロジェクトブランチモデレータのみが閲覧
        できます。

        プロテクションでプロジェクトメンバ以外にはファイルを非表示にする
        よう定義していない限り、基本的なファイルは P4D に表示されます。

        プライベートプロジェクトには、表示が制限されていることを表す
        "目を閉じた" 形のアイコンが表示されるので、通常のプロジェクトと
        視覚的に見分けることができます。

        Swarm は、ジョブの変更リストやコメント API などをはじめとした、さ
        まざまな場所で、プライベートプロジェクトに属するレビュー、変更、
        アクティビティ、コメントを非表示にします。

        レビュー、変更、アクティビティ、コメントがプライベートプロジェク
        トとパブリックプロジェクトの両方に関連付けられている場合には、あ
        たかもパブリックプロジェクトのみに所属しているかのように、表示さ
        れます。

        プロジェクトに関連付けられていないレビューは、パブリックと判断さ
        れます。

        変更が現在のユーザがアクセスできないレビューに関連付けられている
        場合や、そのユーザが作成されるレビューを閲覧できない際には、変更
        ページに、レビューのリクエスト / 表示ボタンは表示されません。

        プライベートプロジェクトでは、"フォロワー" を保持できません。この
        ため、パブリックプロジェクトをプライベートに設定すると、既存の使
        用されていないフォロワーは、非表示となり、パブリックに設定を戻す
        と、フォロワーは再表示されます。

        E-mail 通知は、プライベートプロジェクト用に変更されます。プライベー
        トプロジェクトへのリンクは、change-commit およびレビューの E-mail
        通知から削除されます。

        重要: API で真偽値を設定すると (例えば、プライベートプロジェクト
        向けの新しい "private" オプションなど)、フォームエンコード値には、
        "false" や "true" ではなく、"0" または "1" を指定しなければなりま
        せん。"false" という文字列は、ゼロ以外の値と判断され、暗黙的に 
        (紛らわしいことに) "true" に変換されます。

--------------------------------------------------------------------------

Minor new functionality in 2016.2

    #1440162 (Bug #87991)
        Group name validation now performs more thorough server-side
        validation.

    #1438479, 1439663, #1439742 (Bugs #88400, #88536)
        Extended sanity check in index.php to allow validation of Swarm
        configuration file.

        This should produce nicer errors if values for these options look
        invalid.

        At the moment, this handles 2 cases:
        - show error if config.php doesn't return array
        - show error if short_links are mis-configured
          (i.e. ensure that [environment][external_url] is set if
          [short_links][external_url] is set).

    #1438069 (Bug #87622)
        Added [short_links][external_url] option to allow specifying custom
        scheme and/or port for generating short links.

        This setting is only honoured if [environment][external_url] is
        also specified, otherwise Swarm might not be able to resolve the
        short links to correct URLs.

    #1439046 (Bug #88287)
        Change the placeholder of 'key=value' to 'property=value' in
        project edit page.

--------------------------------------------------------------------------

Bugs fixed in 2016.2

    #1446331 (Bug #88629)
        ThreeJS fixes for Base URL support when rendering 3D models.

    #1438201 (Bug #88438)
        Minor UI tweak on groups overview page to not show a tooltip with
        'You are not a member' on users count badge for anonymous users
        (they are always non-members).

    #1437684 (Bug #87644)
        Comments API: Fixing an internal server error when listing comments
        on an invalid topic.

    #1437356 (Bug #87210)
        Group descriptions are now properly shown in global search.

    #1437317 (Bug #87851)
        New warning popover on project save shown when we detect that
        the user might not be able to edit the project after save.

        Additionally, project form buttons are disabled when the popover is
        shown.

    #1434985 (Bug #88326)
        Fixed a bug where adding job(s) for changes may not have worked if
        Swarm is running under a Base URL configuration.

--------------------------------------------------------------------------

Major new functionality in 2016.1

    #1349976, #1354369, #1359795, #1363946, #1365396, #1369116, #1371461,
    #1372479, #1372656, #1372707, #1373228, #1374179, #1374273, #1375065,
    #1375073, #1375075, #1375228, #1375498, #1375504, #1375648, #1375649,
    #1375718, #1376051, #1376062, #1377591, #1378119, #1378785, #1378791,
    #1379330, #1383350, #1385018, #1385382 (Bugs #84966, #84967, #84968,
    #84969, #84971, #84974, #84975, #84976, #84977, #84978, #84979,
    #84981, #84982, #84983, #84984, #85311, #85602, #85914, #86004,
    #86059, #86121, #86131, #86232, #86263, #86274, #86372, #86449)
        Swarm でユーザグループを管理できるようになりました。

        グループの表示、リスト作成、検索、追加、編集、削除ができるように
        なりました。他のグループメンバによるレビューの作成や、変更のコミ
        ットが行われると E-mail が送信されるよう、グループごとに通知を有
        効にすることが可能です。

        グループを表示するとグループメンバによって実行されたアクティビティ
        や、グループメンバによって作成されたレビューを確認することができ
        ます。

        グループとリスト表示する場合、自分が所有するグループや所属するグ
        ループが最初に表示されます。通知が有効になっているグループが 2 番
        めに、そして最後に名前順でグループが表示されます。

    #1334616, #1334641, #1334707, #1334746, #1336388, #1336866, #1363026,
    #1365608, #1368601, #1380898 (Bugs #84462, #85188, #85402, #85411)
        コメントに「いいね」を設定できるようになりました。各コメントの下
        に、いいねの数とハート型のアイコンが表示されます。このアイコンを
        クリックすると、コメントに「いいね」することができます。

        コメントが「いいね」されると、Swarm はアクティビティを記録して、
        コメントの作成者に E-mail 通知を送信します。

    #1325760, #1330654, #1338383, #1349339, #1353543, #1353982, #1354643,
    #1356548, #1356781, #1359595, #1363405, #1374135, #1374751, #1374758,
    #1375435, #1375931, #1377876, #1378137, #1379283, #1383321, #1383679,
    #1385021, #1385190 (Bugs #76774, #84359, #84458, #84852, #85003,
    #85010, #85129, #85307, #85391, #85492, #85537, #85570, #85620,
    #86060, #86119, #86225, #86350)
        RESTful API のバージョン 2 が追加されました (例: /api/v2/)。

        バージョン 2 では、以下の機能が実装されました。
        アクティビティやグループのリスト表示、グループの取得 / 作成 / 更
        新 / 削除、プロジェクトの取得 / 作成 / 更新 / 削除、レビューの転
        送およびコミット

--------------------------------------------------------------------------

Minor new functionality in 2016.1 Service Pack 1 (since 2016.1.1/1400199)

    #1429617 (Bug #87938)
        Administrators may now set $config['environment']['external_url'].

        This setting allows generated URLs to point to a custom Swarm host,
        including a specific schema and port number, in case Swarm is being
        run in a complex environment.

        Example: 'external_url' => 'https://swarm.example.com:8443'

    #1416420 (Bug #87634)
        Increasing Swarm API version to "v3" because of new functionality.

    #1412045, #1417249, #1427139 (Bugs #79296, #86783, #87913, #88054)
        Comments API added which allows users to list, create, and
        edit comments through the Swarm API.

        This also enables flagging comments as tasks and archiving of
        comments.

        In addition to the comment "body", the parameter "topic" is
        required when creating a comment, and should look like this:

        - For changes:  changes/1234
        - For reviews:  reviews/1234
        - For jobs:     jobs/job001234

        Comment attachments, votes, likes, and file- and line-level comments
        are not supported in this initial version.

    #1417855 (Bug #86453)
        Show the group id below name on "Groups" listing page if they
        differ.

    #1417297, #1429100, #1427946, #1429616, #1430908, #1434985 (Bugs #85030,
    #87887, #88128, #87622, #88326)
        Make Swarm behave more consistently when using a BaseURL
        configuration.

        Under the 'environment' configuration key, a new 'base_url'
        key allows you to define which directory Swarm lives in. Some
        web server configuration changes are necessary to ensure that
        Swarm is actually reachable at the defined Base URL.

        Additionally, for calls to $.ajax() that do not need explicit
        baseURL logic, a new option has been added to the prefilter.
        You can specify 'skipBaseUrl: true' to avoid double-encoding
        of URLs.

    #1400125 (Bugs #86718, #86719)
        Added 'worker.loop' event fired periodically during the worker
        lifetime cycle (before the task event).

--------------------------------------------------------------------------

Minor new functionality in 2016.1

    #1382157 (Bug #84535)
        Improved performance for the Swarm blame button. Using a 20,000
        line test file, this change reduces the rendering time from
        ~60s to ~2s in Firefox and Chrome. Internet Explorer 10 improves
        from ~730s to ~8s.

    #1380885 (Bug #86341)
        Swarm now requires users to be logged in by default.
        To restore the previous behavior edit config.php and set
        array('security' => array('require_login' => false))

    #1379290 (Bug #84420)
        Added a "My Reviews" dropdown button to the Reviews page. This
        allows reviews to be filtered by those that you authored or those
        that you are participating in.

    #1374066 (Bug #86011)
        Added an option to disable Swarm's auto-registration of the
        P4.Swarm.URL property. The new option can be set in config.php:
        array('p4' => array('auto_register_url' => false))

    #1372999 (Bug #81339)
        The X-Frame-Options header is now configurable. This header
        controls when Swarm can be embedded in frames. To disable the
        header edit config.php and set:
        array('security' => array('x_frame_options' => false))

    #1368888, #1372690 (Bugs #85380, #85542, #86050)
        Improved performance with large numbers of users or groups.
        Testing with 10000 users and a comment thread with 100 comments,
        page load times were reduced from 7s to 250ms.

    #1361367 (Bug #86519)
        Updated language files for JA, KO and ZH.

    #1356521 (Bug #85314)
        Renamed config options for adding projects to be more consistent
        with other options. Existing settings are still honored.
        The 'security -> add_project_admin_only' option becomes
        'projects -> add_admin_only'. The 'security -> add_project_groups'
        becomes 'projects -> add_groups_only'.

    #1351847, #1352325, #1352326, #1356409 (Bug #81285)
        Updated the precompiled P4PHP binaries that come with Swarm to
        use P4API 2015.2/1340214.

    #1323467 (Bug #77725)
        To assist with troubleshooting email configuration problems Swarm
        now logs successful emails at the DEBUG log level.

    #1321796 (Bug #84384)
        Updated the project toolbar to look more modern.

--------------------------------------------------------------------------

Bugs fixed in 2016.1 Service Pack 1 (since 2016.1.1/1400199)

    #1433837 (Bug #88290)
        Project Add action now explicitly passes P4Admin to the blank
        project object.

        This fixes a rare situation where the browser could wait
        indefinitely when trying to load the Add Project form.

    #1427904 (Bug #87793)
        Search now works for SSL-enabled Perforce servers.

        The P4TRUST path in search.php is now set to the trust file
        under the data directory. This will work provided that Swarm
        has already auto-trusted the server and generated this file.

    #1427343 (Bug #77474)
        Fixed scaling issue when diffing images in specific versions of
        Firefox and IE.

    #1427066 (Bug #84960)
        Deleted projects are no longer shown in search results.

    #1425846 (Bug #88069)
        Fixed Projects API bug that accidentally erased member lists
        when editing a project and a list of members was not provided.

    #1418164, #1424799 (Bugs #87821, #87869)
        Fixed Groups API to ignore Swarm-managed project groups.

        Groups that begin with "swarm-project-" are managed by Swarm and
        should only be modified using the Projects API.

    #1417924 (Bugs #86836, #87590, #87591, #87617)
        Refreshing configure-swarm.sh to provide a better user experience.

        Also fixes the way configure-swarm.sh generates cronjobs so that
        they work better with Base URL configurations.

    #1417831 (Bug #84762)
        Removing oversized attachments is now possible. Previously there
        was a small problem with the way error state was detected that
        prevented clicking the "X" icon.

    #1416134 (Bug #85907)
        Searching by keywords fixed for values such as usernames that
        happened to contain a dot.

    #1414580 (Bug #85256)
        Improved validation of branches in project configuration. Swarm
        now produces a human-friendly error if the path contains null
        directories ('//depot/main//branch') or relative paths ('.' and
        '..').

    #1413309 (Bug #87640)
        Small fix for an anonymous function in the Emojify filter. Its
        syntax is now compatible with older versions of PHP.

    #1408661 (Bug #86458)
        Unknown fields passed to PATCH methods in the Swarm API are now
        silently ignored.

    #1400199 (Bug #86950)
        Older versions of the 'zip' command do not support the long flag
        '--symlinks', so Swarm now uses the shorter '-y' flag when
        archiving files for download.

--------------------------------------------------------------------------

Bugs fixed in 2016.1 Patch 1 (since 2016.1/1386839)

    #1399779 (Bug #87077)
        Fixed an XSS vulnerability where labels in search results were
        not being escaped correctly.

    #1398683, #1398909, #1399266, #1399692, #1400199 (Bugs #86663,
    #86950, #87024)
        Fixed multiple vulnerabilities involving symlinks. The system now
        refuses to preview, archive or delete the target of symlinks.
        Previously, symlinks could be abused to disclose data or remove
        files on the Swarm server that the user does not have permission
        to access.

        Note: The archive feature now requires the 'zip' command.
        Support for PHP's 'zip' extension has been removed. If the 'zip'
        command cannot be found, the archive button will not appear.

    #1394659 (Bug #86805)
        Fixed an XSS vulnerability where HTML in project descriptions was
        not being escaped correctly on the home page.

--------------------------------------------------------------------------

Bugs fixed in 2016.1

    #1380942, #1381570, #1384005 (Bug #85965)
        Fixed a bug that could produce two reviews for a single change
        under certain conditions. If a review was created using both the
        '#review' keyword and via the P4V integration, there was a race
        condition that could result in two reviews being created.

        Now Swarm temporarily locks each change before starting a new
        review. These locks are Swarm specific and only limit the creation
        of reviews.

    #1372509 (Bug #85872)
        Fixed a minor issue where double-clicking on project settings
        checkboxes could cause the checkbox to become out of sync with
        the form.

    #1365277 (Bug #84965)
        Fixed a bug where links to users in search results did not work
        for usernames that contained backslashes.

    #1359574 (Bugs #80107, #85454)
        Fixed a bug where ZIP downloads did not work on pending files.

    #1359011 (Bug #85423)
        Fixed a problem where URLs with no TLD were not linkified.
        Swarm no longer requires a TLD in the hostname to linkify a URL.

    #1355979 (Bug #81600)
        Reduced the severity of Basic Authentication failures to 'debug'.
        This should reduce noise in the log file.

    #1352055 (Bug #76075)
        Fixed an issue where the buttons on an archived comment could
        become hard to click if the window was too narrow.

    #1350832, #1351299 (Bug #85191)
        Fixed a bug where the user dropdown menu could be partially
        hidden behind the header on some pages.

    #1350733 (Bug #85176)
        Fixed a bug where the branch moderators tooltip on the project
        settings page did not correctly list moderators.

    #1349386 (Bug #84995)
        Fixed a 500 error that could occur when viewing a user's shelved
        changes if 'dm.keys.hide' was set and the current user was not an
        administrator.

    #1338808 (Bug #84906)
        Fixed a bug that caused the jobs search to throw an exception for
        queries that start with '^' (not).

    #1327917 (Bug #84622)
        Fixed a problem where the test status of a review was not updated
        if the tests were re-run without making any changes to the review.

    #1327209, #1327378 (Bug #84629)
        Fixed a problem that could occur with existing cache files when
        upgrading Swarm. We now verify that the schema in the cached
        objects matches the current schema.

    #1318968, #1330724 (Bug #84650)
        Fixed a bug where the common path was not being displayed for
        shelved changes.

--------------------------------------------------------------------------

2015.4の主な新機能
-------------------
    #1308891, #1308998, #1309707, #1310199 (Bug #63187)
        グループをプロジェクトメンバーとして追加できるようになりました。
        これらのグループ (またはそのサブグループ) に所属するメンバーはす
        べて、プロジェクトのメンバーになります。これらのグループに対する
        変更はすべて、自動的にプロジェクト内に反映されます。これは、ユー
        ザ管理を簡素化するよう設計されています。

    #1308890 (Bug #71597)
        レビューの任意のバージョンで比較を実行できるようになりました。
        以前までは、レビューの連続したバージョンを比較する際に制限があ
        りました。バージョンスライダを動かすことで、バージョン範囲を変
        更することが可能です。コネクタを動かすと、両方のバージョンマー
        カーがロックステップ内で移動します。

    #1307207, #1308095 (Bug #78222)
        RHEL/CentOS 7およびUbuntu 14.04.のパッケージが追加されました。

    #1265420, #1308568, #1309189 (Bug #66264)
        ユーザのプロファイルページに、保留中チェンジリストのタブが追加
        されました。これにより、保留中チェンジリストのレビューを依頼し
        たり、進行中の変更のレビューステータスを確認したりすることがで
        きます。

--------------------------------------------------------------------------

Minor new functionality in 2015.4

    #1309162, #1309659, #1309729 (Bug #77809)
        Introduced a button to show whitespace characters (space and  
        tab) in diff output. When enabled these characters 
        appear as muted dots and arrows respectively.

    #1255119 (Bug #84195)
        Added support for previewing the Keynote, Pages and Numbers
        document formats via the LibreOffice module.

--------------------------------------------------------------------------

Bugs fixed in 2015.4 Patch 1 (since 2015.4/1317923)

    #1326721 (Bug #84612)
        Fixed a regression where projects could not be added on Perforce
        Servers older than 2012.1.

    #1326575 (Bug #70714)
        Fixed a problem affecting edge/commit server deployments. If 
        Swarm was configured to talk directly to an edge server, reviews
        created by that instance of Swarm could not be updated. This is
        because the change was being bound to the edge server. Now, edge
        server instances forward review creation to the commit server 
        instance.

    #1322454 (Bug #84108)
        Fixed a bug where the user picker could list groups for fields
        that do not allow groups to be selected (e.g. Project Owners).

--------------------------------------------------------------------------

Bugs fixed in 2015.4

    #1316264 (Bug #84197)
        Fixed a bug in the Perl trigger where posting to Swarm could
        fail on Windows Perforce Servers. This would only occur when
        wget was installed but curl was not.

    #1307838 (Bug #83660)
        Fixed a bug where links in RSS feeds did not work in some feed
        readers. RSS feeds now use the fully qualified Swarm URL.

    #1306055 (Bug #83608)
        Fixed a bug introduced by the 'edit_branches_admin_only'
        option. When enabled, this feature unintentionally restricted
        editing of projects to administrators.

    #1265682 (Bug #83602)
        Fixed a bug in the Perl trigger script where the strict check
        erroneously prevented committing a review in some cases.
        Specifically: reviews with a single file marked for delete and
        reviews with moved files.

    #1265015 (Bug #83589)
        Fixed an issue where Swarm did not recognize the new utf8 file
        type as text and therefore failed to render diffs and previews.

    #1262908 (Bug #77369)
        Fixed a bug where +l files were silently dropped from reviews.
        Note this fix requires Perforce Server version 2014.2 or newer
        with the filetype.bypasslock server configurable enabled.

    #1261960 (Bug #83277)
        Fixed a performance problem that could occur if the .git-fusion
        depot contained changes with more than 10k files.

    #1255309 (Bug #84196)
        Adjusted the styling of text file previews so that the page
        does not shift around when syntax highlighting large files.

--------------------------------------------------------------------------

2015.3の主な新機能
-------------------

    #1241320 (Bug #66921)
        Perl トリガが拡張され、Windows 環境でも実行できるようになりまし
        た。サポート対象のあらゆるサーバプラットフォームで実行できる単一
        のトリガスクリプトが導入されました。

    #1239352 (Bug #70542)
        プロジェクト、ユーザ、ファイルを探す検索欄導入されました。

        ツールバーの右上隅に検索欄が表示され、入力された文字列を検索しま
        す。検索結果はタイプ別のグループごとに表示されます。入力した文字
        列に一致する、プロジェクト、ユーザファイルを検索します。プロジェ
        クトおよびユーザ検索には Swarm のキャッシュが使用されます。ファ
        イル検索では、「p4 fstat」および（インストールされている場合は）
        P4 Search を使用します。

    #1230860, #1240881 (Bug #64899)
        レビューのコメントの E-mail 通知を保留し、後でまとめて 1 回で 
        E-mail を送信することが可能となりました。これに付随し、追加コメン
        トフォームに「Delay Notification」チェックボックスが表示されるよ
        うになりました。このチェックボックスにチェックが付いている状態で
        新しいコメントが投稿されると、同チェックボックスのチェックを外し
        た状態でコメントが投稿されるまで、E-mail 通知は送信されません。

--------------------------------------------------------------------------

Minor new functionality in 2015.3

    #1241441 (Bug #79003)
        Added a PHP 5.6 build of P4PHP. All P4PHP builds have now been
        updated to use P4API 2015.1/1240625

    #1241268 (Bug #81066)
        Updated to the new hex-shaped Swarm logo.

    #1237763, #1239247 (Bug #77648)
        The 'My Reviews' button now filters reviews to show only those
        authored by the current user.

        Added a new author filter to the list reviews API endpoint
        (GET /api/v1.2/reviews). This bumps the version for all endpoints
        to v1.2.

    #1231387, #1231395 (Bug #78004)
        The project sidebar now displays owners and moderators.

    #1229476, #1230017, #1230262, #1230490 (Bug #80185)
        The test status tooltip now shows when the results were reported.
        Internally, Swarm now tracks the start time and average running
        duration for automated tests.

    #1219887 (Bug #80322)
        Improved handling of multiple or out-of-order test results.
        Previously the last result would win. Now results for old versions
        are rejected and we preserve the results of the first failure
        if we receive multiple results for a given version of a review.

    #1215329 (Bug #81449)
        We now show a hard-disk icon for depots when browsing the root of
        a server (previously depots were represented with a folder icon).

    #1214788 (Bug #81450)
        Moved the logout link to the bottom of the user dropdown menu.

--------------------------------------------------------------------------

Bugs fixed in 2015.3

    #1241158, #1247062 (Bug #81061)
        Fixed a bug where sub-groups that reference parent groups caused
        infinite recursion and exhausted all memory.

    #1240050 (Bug #81042)
        Fixed a bug where the Perl trigger script could emit a 'Use of
        uninitialized value' error when the config file was not specified.

    #1235955, #1236887 (Bug #80784)
        Fix a bug where file downloads were not always streamed resulting
        in excessive memory consumption. This was due to output being
        double buffered in some cases. We now clear all output buffers
        when streaming output.

    #1231393 (Bug #81458)
        Fixed a bug where the number of moderators was not being displayed
        next to each branch on the project edit form.

    #1230829 (Bug #80351)
        Fixed a 404 that could occur when marking a file as read when
        diffing two versions of a review if the file was previously shelved
        and had since been removed from the review.

    #1230827 (Bug #80538)
        Fixed an illegal offset warning that could occur when diffing two
        versions of a review. This would happen if a file that existed in
        the earlier shelved version of the review was removed in the later
        version.

    #1228298 (Bug #80404)
        Fixed a regression bug where the follow project link did not work.

    #1225869 (Bug #80501)
        Fixed a layout issue that occurred if the text input for inline
        comments was resized horizontally. Now the text input can only
        be resized vertically.

    #1220502, #1220960, #1222664 (Bug #77401)
        Fixed problems that affected the extensibility of the Linkify
        filter. The last word variable is now updated and passed
        correctly to Linkify callbacks.

    #1216034, #1235980, #1241414 (Bug #80348)
        Pending comments are now preserved when comments are refreshed
        while editing a comment or adding a comment from the comments tab.

--------------------------------------------------------------------------

2015.2の主な新機能
-------------------

    #1071421, #1203684, #1204593, #1206600, #1207516, #1207537 (Bug #64896)
        コメントの編集が可能となりました。コメントを作成したユーザでログ
        インすると、コメントのフッタに「編集」のリンクが表示されます。こ
        のリンクをクリックすると、編集フォームが表示され、そこでコメント
        や添付ファイルの編集を行うことができます。

    #1206282, #1207388 (Bugs #79595, #79596)
        簡体字中国語および韓国語のローカライゼーションが追加されました。

        新しい言語を処理する assembleLocaleData.php スクリプトへの変更を
        伴う AlphaCRC から、JA、KO および ZH-CN のローカライゼーションが
        導入されます。

    #1100113, #1205196, #1206305, #1206658, #1331177 (Bugs #70714, #79174)
       マルチサイト展開がサポートされました。Swarm はこのバージョンから、
       エッジおよびコミットサーバに対応します。新たに Perl ベースのトリ
       ガを使用する必要があります。

    #1099584, #1101368 (Bugs #75355, #75653, #76342, #77572)
        Perlで実行されるSwarmトリガの新しいバージョンが追加されました。
        このトリガは、既存の bash トリガと互換性があります。新しいトリガ
        のバージョンでは、エッジサーバに対応し、強化モードや ktext ファ
        イルのバグが修正されています。

--------------------------------------------------------------------------

Minor new functionality in 2015.2

    #1212292 (Bug #80033)
        Updated the Swarm trigger package to use the new Perl trigger.

    #1207511 (Bug #79934)
        Changed the subject for change submit email notifications from
        'Change @54321' to 'Commit @54321'.

    #1206503, #1207071 (Bug #78167)
        IP protections emulation now includes proxy rules. Previously,
        proxy rules were not taken into account. Now, we treat Swarm
        as an intermediary and apply proxy rules according to the end
        user's IP address.

    #1206494 (Bug #78996)
        Added an option to limit configuration of project branches to
        admin users. With the projects > edit_branches_admin_only option
        set to true, only admins are able to configure branches.

    #1205521, #1205762 (Bug #72454)
        We now list jobs and changed files in review email notifications.

    #1204727, #1207016 (Bugs #78995, #78996)
        Added an option to limit editing project names to admin users.
        With the projects > edit_name_admin_only option set to true, only
        admins are able to rename projects.

    #1202977 (Bug #79396)
        Added an option to the Swarm trigger to skip the enforce and strict
        checks if the change only contains files of the specified type(s).
        File types to skip can be specified via the EXEMPT_EXTENSIONS
        config option.

    #1202975 (Bug #79609)
        Moderators now receive email notification for commits and reviews
        against branches they moderate even if they are not members of the
        affected projects.

    #1198459, #1198806, #1206279 (Bug #79295)
        Refreshed the login page. Added a nice background image of some
        fine folks having coffee and doing important creative work.

    #1197879, #1197890, #1198475 (Bug #66465)
        Moved the project edit button to the project toolbar and renamed it
        to 'Settings'. Tweaked the project form to render with the project
        toolbar and sidebar when editing.

    #1171636 (Bug #70542)
        Swarm now generates host-unlocked tickets on login. This is needed
        to integrate with other Perforce services like p4-search.

    #1171629 (Bug #79944)
        Tweaked line hash handling (ie. #l123) to position the targeted
        line 1/4 of the way down the page. Previously it was positioned
        100px down the page which often felt too high.

    #1149485 (Bug #78994)
        Added an option to the Swarm trigger to skip the enforce and strict
        checks if the change contains more than a given number of files.
        The number of files can be specified via the new EXEMPT_FILE_COUNT
        config option.

    #1126994, #1144472, #1206760 (Bug #79386)
        Fixed a performance problem that could occur with large numbers
        of users, groups and projects. With 5000 users, 5000 groups and
        500 projects load times for the project listing have been reduced
        by >20x.

    #1099546, #1100888, #1101371, #1101414 (Bug #79315)
        Simplified the email notification template. The revised template
        eliminates the grey border and reduces margins.

    #1072284, #1197886 (Bug #79214)
        Renamed the 'History' tab and 'History' links to 'Commits'.

    #1071674, #1073354 (Bug #79203)
        Comment counts now reflect the number of open (non-archived)
        comments. Hovering over the number of comments shows the number
        of archived comments. Previously we only showed the total number
        of comments for a given topic.

    #1069597 (Bug #79182)
        Improved the visibility of 'more context' rows. We now render a
        horizontal grey line help delineate diff chunks.

    #1068547, #1209330 (Bug #73003)
        Updated rules for review transitions to optionally deny authors
        approving their own reviews. If the reviews > disable_self_approve
        option is true, then authors are not able to approve their own
        reviews (even if they are also moderators).

    #1067114 (Bug #76362)
        Imagick module now converts ".tif" files. Previously, only the
        ".tiff" extension was recognized.

--------------------------------------------------------------------------

Bugs fixed in 2015.2

    #1214397 (Bug #80087)
        Fixed a problem where Swarm could continuously reload a review if
        it had unexpected commit-status data (due to a race condition).

    #1208398 (Bug #76535)
        Fixed a bug where OVA setup script did not work with SSL enabled
        Perforce servers.

    #1207465 (Bug #79269)
        Fixed a bug where our handling of Emojis was not compatible with
        newer versions of Gemoji.

    #1207464 (Bug #79856)
        Fixed a bug where some of our 'infinitely scrolling' lists were not
        loading more items. At some zoom levels Chrome reported a lower
        than expected scroll position. This caused our code to conclude the
        user had not reached the bottom of the page. Now we consider the
        user to have scrolled to the bottom if they are within a couple of
        pixels.

    #1206727 (Bug #79800)
        Fixed a bug where attempting to archive a specific version of a
        file resulted in a 500 error.

    #1205188 (Bug #79945)
        Fixed an issue where the project save button could be erroneously
        enabled if a project name is entered and user data has not yet
        loaded (despite having no project members).

    #1152722, #1205188 (Bug #79945)
        Fixed a bug where the project save button could be enabled when
        it should be disabled. Specifically, this could occur when the
        list of users had not yet loaded, or while waiting to redirect
        to a newly created or updated project page.

    #1066846 (Bugs #74987, #76629)
        Fixed a bug where file and directory names could be missing
        characters if they contained non-ascii bytes and the web-server
        was using to a non-UTF-8 locale.

        We now detect the available system locales and explicitly select
        one that supports UTF-8.

    #1065005 (Bug #78165)
        Fixed a bug where notification emails were not threading properly
        in Microsoft Outlook. Outlook uses a non-standard 'Thread-Index'
        header to group 'conversations' and Swarm was not sending this
        header.

--------------------------------------------------------------------------

2015.1の主な新機能
-------------------

    #1024336, #1027042, #1035289, #1035631, #1039648 (Bug #66715)
        ローカライゼーションのサポートが追加されました。ユーザに表示され
        る文字を、文字列置換、エスケープメント、複数化をサポートする翻訳
        コンポーネントを用いて実行することができるようになりました。デフ
        ォルト / フォールバックロケールを設定ファイルに指定することが可
        能です。ユーザのロケールは、ブラウザの HTTP_ACCEPT_LANGUAGE ヘッ
        ダによって自動的に検出されます (この動作は無効にすることが可能)。

        Web ブラウザおよび Web サーバの両方で、翻訳をサポートしています。
        同じメソッドが各環境で利用でき、同じように動作します。また、同一
        のメッセージを両方のコンテキストで使用することができるため、サー
        バ上のロケールを設定したり、検出されたりしてもブラウザ内で選択さ
        れます。

    #993239, #1003694, #1029826, #1034069, #1038235 (Bug #71596)
        ファイルおよびフォルダを ZIP アーカイブとしてダウンロードするこ
        とが可能となりました。さらに、ディポパスをアーカイブすることがで
        きます。ただし、archives => 'max_input_size' 設定に指定のサイズ
        以下に収める必要があります。同設定のデフォルト値は 512MB です。

        アーカイブはバックグラウンドで作成され、ファイルの同期および圧縮
        を示す進捗バーが表示されます。各アーカイブはデフォルトで 12時間
        キャッシュされたのち、削除されます。これにより、その後同じアーカ
        イブをダウンロードするリクエストが発生したさいに、迅速に処理を行
        うことができます。

        archives => 'archive_timeout' 設定は、ZIP アーカイブの作成に要す
        る時間を制御します (デフォルトは 30秒)。

    #1034946, #1035427, #1039713 (Bugs #66965, #77519)
        チェンジリストに表示されるファイル数を制限することが可能となりま
        した。これまでは、ファイル数が数千に及ぶような特に大量の変更を表
        示する場合には、Swarm のメモリが不足することがありました。本リリー
        スから、表示されるファイル数の上限が 1,000(デフォルト) となりま
        す。この制限値は、p4 => 'max_changelist_files' 設定で調整するこ
        とが可能です。

        P4D サーバが 2014.1 以上の場合、ファイル数は Perforce で制限され、
        その他の場合には、Swarm で制限されます。後者の場合においては、今
        後も大量の変更時にメモリ不足が発生する可能性があります。ただし、
        ファイルのリストが早期の段階で適切に調整されるため、閾値の値は高
        く設定されています。

--------------------------------------------------------------------------

Minor new functionality in 2015.1

    #1038843 (Bug #77610)
        Enhanced JIRA integration to better find references to issues
        when they are surrounded by punctuation. Specifically, Swarm
        now detects JIRA issues that are wrapped in round brackets '()'
        and curly braces '{}'.

    #1033167 (Bug #78159)
        Improved the XHProf module to automatically clean-up old report
        files. Previously if XHProf was enabled, the number of log files
        would continue to grow over time. Due to their large size these
        files could end up consuming a significant amount of disk space.

        Note: XHProf is a profiler developed by Facebook.

    #1011531 (Bug #77468)
        Added a reviews => 'commit_timeout' setting to provide control
        over how long processes can spend submitting files to Perforce.
        By default this is set to 30 minutes.

    #1006502 (Bug #67720)
        We now detect errors connecting to Perforce and report them as 503
        (service unavailable). This should assist in debugging p4 port,
        user and password problems.

    #1003872, #1005554 (Bug #78347)
        Minor visual refresh. User avatars now appear rounded. Rows in
        tables no longer appear with alternating background colors.
        These changes are purely aesthetic.

    #1001768, #1006500 (Bug #77277)
        Added a notice to the top of the home page if there are no
        workers running. This should assist in debugging a common server
        configuration problem.

    #991098 (Bug #76671)
        Improved the rules governing review state transitions. Authors
        are now permitted to approve or reject their own reviews if they
        are branch moderators.

--------------------------------------------------------------------------

Bugs fixed in 2015.1

    #1039199 (Bug #74656)
        Fixed an issue where version 1.1 of the web-services API added
        a new required reviewers field and erroneously made it available
        to version 1.0 of the API. We no longer accept required reviewers
        on v1.0.

    #1035544, #1035560 (Bug #66917)
        Fixed an issue that can cause a commit to be partially processed.
        In some cases if a user unshelved files in a review and one or
        more of those files had pending resolves, Swarm would be unable to
        remove files from the review and would abort processing the commit.

        If the server version is 2014.2+, we now use the -f flag to ensure
        that we are able to remove shelved files. Additionally, we ignore
        the error that will occur if this situation arises on an older
        version of P4D.

    #1033935 (Bug #78332)
        The blame button is now disabled for files that have no content.
        Previously an error would occur if blame was used on an empty file.

    #1022486 (Bug #76571)
        Fixed javascript error occurring when switching to History tab
        while viewing a file in Swarm.

    #1022324 (Bug #77803)
        Removed legacy rewrite rules for adding tasks to the queue.

        These rules were left there temporarily for backwards
        compatibility. Currently, the tasks are added to the queue via
        posting to http://<swarm-host>/queue/add/<swarm-token> that has a
        separate rewrite rule.

    #1019647 (Bug #77678)
        Fixed a bug where the swarm-trigger's optional 'strict' and
        'enforce' modes did not work against a unicode enabled server.

    #1016421 (Bug #71596)
        Fixed an issue where progress bar status text was not legible until
        the bar was at least as wide as the text. Now the text appears in
        black over the background and white over the finished portion of
        the progress bar.

    #1011943 (Bug #78436)
        Fixed a performance regression where the projects sidebar could
        take a long time to load. This was most prominent when there was
        a bad link between Swarm and the Perforce server. In some cases,
        the projects sidebar now loads 8x faster.

    #1006678 (Bug #77394)
        Improved validation of branches in project configuration.
        Previously the server would accept branches that had no paths
        defined. Now the server-side validation matches the client-side
        validation and such branches produce an error.

    #1003822 (Bug #78437)
        Attempting to access the '/view' or '/download' URIs for a folder
        (not a file) now produces a 404 response.

    #997596, 1015136 (Bug #77206)
        Minor aesthetic fixes. Adjusted the position of popover and tooltip
        arrows when the browser's view is magnified. Improved the contrast
        of keyboard shortcut hints.

--------------------------------------------------------------------------

2014.4の主な新機能
-------------------

    #982485 (Bug #76736)
        Swarmは、2条項BSDライセンスのもと、提供されるようになりました。

    #965185 (Bug #76239)
        Perforce は、膨大な数のプロテクションエントリを保持する環境にお
        いて、大幅な改善がなされました。この改善は、ファイルを閲覧する際
        に、特に顕著に現れます。

    #905488, #962547 (Bug #73830)
        プロジェクトメンバ全員に対する、コミットおよび新しいレビューリク
        エストの E-mail 送信を無効化するオプションが追加されました。プロ
        ジェクト編集ページに、プロジェクト通知 E-mail を制御するチェック
        ボックスが 2 つ追加されました。

--------------------------------------------------------------------------

Minor new functionality in 2014.4

    #986364 (Bug #76961)
        Added 'apiVersions' to the output of the 'version' endpoint. This
        field includes a list of all of the api versions supported by the
        instance of Swarm (e.g. 1, 1.1).

    #970399 (Bug #70284)
        It is now possible to limit the range of changes shown on the
        history tab to a specific range using change numbers, dates,
        labels, etc.

    #968015 (Bug #66742)
        Project creation can be limited to only users under specific
        group(s) by setting 'add_project_groups' under the 'security'
        config. This feature is disabled by default.

    #967909 (Bug #76291)
        Swarm can now be configured to leave reviews in an approved state
        even if they are updated with modified files. By default, reviews
        will still revert to 'needs review' when they are updated with
        modified files. To have reviews stay approved even when modified
        files are added set 'unapprove_modified' to false under the
        'reviews' configuration.

    #965024 (Bug #74656)
        It is now possible to specify required reviewers when creating
        reviews via the API.

--------------------------------------------------------------------------

Bugs fixed in 2014.4 Patch 1 (since 2014.4/988814)

    #1000792 (Bug #77218)
        Fixed an issue where the workers could stop running if upgrading
        from 2014.2 via RPM packages.

    #991899, #992629 (Bug #77048)
        Fixed an issue where the RPM packages could erroneously disable
        the Perforce PHP extension on upgrade.

    #990382 (Bug #76971)
        Fixed an issue where the RPM packages did not require the DOM
        or mbstring extensions needed for RSS feeds and multi-byte strings.

--------------------------------------------------------------------------

Bugs fixed in 2014.4

    #986536 (Bug #76569)
        Fixed a problem where buttons did not always disable properly when
        submitted. This only affected some browsers and appeared to be
        caused by a race condition between the click and blur events.

    #985713 (Bug #76963)
        Fixed an issue with our icon sprites. Previously when scaling up
        your browser view, some icons would erroneously show pixels from
        adjacent icons. Now the sprites have generous spacing to avoid this
        issue.

    #972442 (Bug #76382)
        Fixed an issue where the submit button on the "Add a Commit" and
        "Already Committed" dialogs could erroneously stay disabled
        after a change had been selected.

    #968046, #969029 (Bug #74760)
        When emulating IP protections, enabled by default, Swarm will
        now correctly treat protection entries as as case-insensitive
        when dealing with a case-insensitive Perforce server.

    #968037 (Bug #75488)
        Fixed an issue where @mentioned and @*mentioned users were not
        added as reviewers when creating a review using the API.

    #967896, #967998 (Bug #73701)
        Fixed an issue where committing to a streams depot via the Swarm
        web interface could erroneously report 'No files to submit'.

    #950565 (Bug #72392)
        Fixed an issue where LibreOffice could become unresponsive.
        Generating doc previews should now be significantly more reliable.

    #939315 (Bug #74463)
        When a 'strict' or 'enforce' Swarm trigger fails due to bad
        credentials, include the active P4PORT setting in the error message
        to help diagnose problems more easily.

    #933049, #933477 (Bug #74860)
        Updating an approved review with unchanged ktext files will no
        longer cause it to erroneously revert to the needs review state.
        Note, this fix only works when operating against a 2012.2 or
        newer Perforce server.

    #898943 (Bug #72908)
        Fixed an issue where the horizontal scrollbar could disappear if
        a collapsed file toggled between side-by-side and inline diff.

    #897986 (Bug #66554)
        Fixed an issue where logging in to comment on the left hand side
        of a side-by-side diff would collapse the comment row.

--------------------------------------------------------------------------

2014.3 Patch 2 (2014.3/958056 以降) の主な新しい機能性
-------------------------------------------------------

    #967594 (Bug #75006)
        Swarm が、すべての Perforce ユーザに無償提供されるようになりまし
        た。実装にあたり、Swarm ライセンスファイルは必要ありません。

--------------------------------------------------------------------------

2014.3の主な新機能
-------------------

    #890602 (Bug #66725)
        差分の表示画面に示される [その他のコンテキストを表示] をクリック
        することで、隣接する行をさらに 10 行を表示するオプションが追加さ
        れました。

    #889932 (Bug #73703)
        編集されたファイルのレビューが更新されると、既存の票が「stale」
        としてマークされます。「stale」票は、薄い色のアイコンで表示され、
        賛成票または反対票としてカウントされません。

    #889492 (Bug #63260)
        レビューでファイルを「既読」としてマークすることができるようにな
        りました。ファイルを既読としてマークするには、ファイルヘッダの右
        端にある「目」のボタンをクリックします。既読オプションは、バージ
        ョンおよびファイルの要約情報とともに各ユーザに対して個別に保持さ
        れます。ファイルの内容が変更されると、「既読」オプションは自動的
        にクリアされます。この機能は、大量のファイルをレビューする際に有
        用です。

    #884641, #887942, #889744, #890743 (Bug #63263)
        Swarm はコメントを軽量タスクとして処理することができるようになり
        ました。タスクを「解決済み」としてマークしたり、場合によりオプシ
        ョンで「確認済み」としたりすることが可能です。

    #877136 (Bug #73157)
        レビューに関連する変更の場合、ファイルが保留されたり変更がコミッ
        トされたりすると、Swarm は常にレビューを更新します。

        これまでは、#review-123 または [review-123] 形式のキーワードが表
        示されない場合には、レビューは更新されていませんでした。

    #854977, #863042, #873042, #875837, #876579, #889563 (Bug #70664)
        Swarm で、これまでには実現が難しとされた、さまざまなタスクの表示
        やドキュメント化を行う API が実装されました。

        この API では、レビューのリスト表示、個々のレビューに関する情報
        の取得、既存の作業中チェンジリストまたはサブミットされた変更にお
        けるレビューの作成、(当該レビューの新しい最新リビジョンとする) 
        レビューへの変更の追加 、プロジェクトのリスト表示、アクティビテ
        ィリストへの新しいエントリの追加、などがサポートされています。

        認証は、パスワードまたはチケットのいずれかを用いる標準的な HTTP
        Basic 認証を使用して処理されます。セキュリティの高い設定では、パ
        スワードが利用できない場合があり、チケットの使用が要求されること
        がありますので、注意してください。

--------------------------------------------------------------------------

Minor new functionality in 2014.3 Patch 1 (since 2014.3/896879)

    #957494 (Bug #74292)
        Added support for optional POST params when configuring automated
        tests on a project. Data can be specified in either get=param
        style or as {"json" : "values"}

--------------------------------------------------------------------------

Minor new functionality in 2014.3

    #886023 (Bug #73067)
        Comment attachments will now be cached by the browser for 12 hours.
        This will decrease jumpiness when rendering attached images.

    #882741 (Bug #73058)
        The Swarm cron script now supports starting workers on SSL-enabled
        Swarm hosts that utilize a self-signed certificate.

    #879274 (Bugs #62048, #69646, #71743, #72202)
        The Reviews page now updates the URL to reflect search terms. This
        allows users to bookmark or share searches and ensures the search
        results are shown correctly when navigating browsers history.

    #878436 (Bug #73357)
        Swarm will now linkify occurrences of "changelist <#>" in comments
        and changelist descriptions.

    #878206, #878814, #879346, #879579 (Bug #72736)
        The Swarm OVA is now built using Swarm packages. This allows the
        user to more easily upgrade Swarm.

    #875126 (Bug #66253)
        The jobs page now updates the URL to reflect search terms. This
        allows users to bookmark or share searches and ensures the search
        results are shown correctly when navigating browsers history.

    #871859 (Bug #66355)
        Dropdown menus in Swarm can now be operated via the keyboard.

    #870337, #870357 (Bugs #70905, #71325, #72767)
        Several enhancements have been made to the Swarm JIRA module. JIRA
        Swarm links now include a snippet of the change/review description.
        Additionally, editing a submitted change description or
        adding/removing jobs on a change or review will update JIRA Swarm
        links.  Note, old links are not automatically updated to include
        descriptions.

    #862937, #870621 (Bug #69205)
        Swarm now has a default tab-size of 4 in Chrome, Firefox and
        Safari.  Internet Explorer does not support tab-size and will
        still display a tab width of 8.

    #860398 (Bug #66357)
        Added a 'system' avatar for activity not associated with a
        particular user (for example when tests pass or fail).

    #860346 (Bug #73032)
        Swarm now allows changes by specific users to be ignored from the
        perspective of starting and updating reviews. This is enabled by
        specifying 'ignored_users' under the 'reviews' config.

    #860321 (Bug #73057)
        Mainlines are now listed first under the Review queue's branch
        filter.

    #855740 (Bug #67654)
        Added support for rendering SVG images in file preview, file diffs
        and comment attachments.

    #853423 (Bug #72412)
        The #review keyword is now more forgiving of nearby punctuation.

    #848771 (Bug #72359)
        Swarm now automatically reverts review state back to 'Needs Review'
        when approved reviews are updated with modified files.

    #846902 (Bug #72448)
        Added a swarm of bees that fly around your cursor on the error
        page.  As you move your mouse more bees surround your cursor. Over
        time, if you hold your mouse still, the bees go away.

    #842916, #851529 (Bug #72559)
        We now do a case insensitive lookup for @mentioned jobs.

    #842660 (Bug #73720)
        Basic Auth is now a supported means of authentication. This means
        that actions which previously required 2 steps (performing a login,
        writing the resulting cookie to a cookie jar, and then performing
        the actual action) can now be streamlined into a single request.

        The username must match a valid perforce user with permissions to
        perform the action, and the password can be a valid ticket or the
        user's password.

        Note: Some p4d security levels only allow the use of tickets in
        this context.

    #840855 (Bug #72696)
        Upgraded jQuery to 1.11.1 and added the jQuery sourcemap.

    #839881 (Bug #72704)
        Adjusted the sorting of files and directories when browsing to put
        hidden (e.g. '.foo') files and directories last.

    #836802 (Bug #72385)
        For inline comments, the row will now collapse when the last open
        comment is archived.

--------------------------------------------------------------------------

Bugs fixed in 2014.3 Patch 2 (since 2014.3/958056)

    #967444 (Bug #73582)
        Fixed an issue where the Debian packages could fail to properly
        install the Perforce PHP extension. The Debian packages now work
        correctly on Ubuntu 13.10, 14.04, 14.10.

--------------------------------------------------------------------------

Bugs fixed in 2014.3

    #893456 (Bug #73882)
        Fixed an issue where URL-encoded characters could erroneously show
        up in filenames under the activity feed or comments tab.

    #892728 (Bug #73833)
        Logging in with the incorrect cAsE user id on a case insensitive
        p4d will no longer prevent transitioning and approving reviews.

    #892681 (Bug #73832)
        Fixed an issue where using characters like % and # in your filename
        would cause errors when trying to show full context.

    #892564 (Bug #73824)
        Fixed an issue where placeholder text in IE erroneously acted as
        default values for new inline comments under sideways diff mode.

    #892532 (Bug #73826)
        Fixed an issue where the comments could overlay code lines if the
        comment was wide enough to wrap and diff scrollbars were showing.

    #891999 (Bug #73759)
        Swarm will display a warning if thread-safe PHP is detected. This
        is because P4PHP is does not support threaded operation.

    #891941 (Bug #71531)
        Ensure all emails are set to use UTF-8 encoding so extended
        characters display properly.

    #890428 (Bug #71549)
        Attempting to commit a review with out of date files no longer logs
        an exception. An error is still shown to the user in the Swarm UI.

    #890422 (Bug #72918)
        If Swarm encounters a task file it cannot delete; it will no
        longer process it and will abort the worker. This will prevent
        endlessly reprocessing the task.

    #890342, #892319 (Bug #73718)
        The windows trigger script now wraps the path to curl in quotes
        allowing curl.exe to be under a path with spaces.

    #888871 (Bug #73599)
        Fixed an issue where using the context menu to paste content
        into the comment form would fail to enable the post button.

    #887895 (Bug #71805)
        Adding a new comment will no longer show files that were attached
        to a previously posted comment.

    #886698 (Bug #73581)
        Performance improvements for rendering larger files in IE.
        Performance was increased by about 30% for the rendering of the
        side-by-side Diff mode. For files with more than 1000 lines this
        can still be very slow, we plan to continue making improvements.

    #880741 (Bug #65586)
        Introduced tab history tracking for IE9. Previously IE9 would load
        the correct tabs for urls with tab ids but would not insert tab
        ids when navigating tabs in Swarm.

    #879459 (Bug #67480)
        ARIA labels have been added to the filter buttons on the Reviews
        Queue in order to expose their meaning to screen readers.

    #877109 (Bug #73296)
        Swarm will no longer enter an endless loop when the 'swarm' group
        references recursive sub-groups.

    #873881 (Bug #73084)
        Fixed an issue where users would sometimes be required to login to
        comment despite having recently logged in.

    #863379 (Bug #66712)
        Swarm will no longer fail to update reviews when the Swarm admin
        user has changed.

    #861147 (Bug #73037)
        The json output for projects no longer leaks automated test and
        deploy settings. These values can include sensitive data such as
        auth tokens.

    #860313, #861755 (Bug #73056)
        Improved handling of empty descriptions in commit and review email
        notifications. We no longer append a trailing '-' to the subject
        and we no longer output an empty description block in the body.

    #855747 (Bug #72716)
        Fixed a bug where selecting the already active project/branch
        filter would erroneously clear the filter.

    #860349 (Bug #61897)
        We now prevent service and operator type users from logging in.

    #851970 (Bug #72825)
        Fixed an issue where Swarm was generating 'Unknown command' errors
        on Perforce Server's using structured logs. Instead of running a
        null command, we now run 'help' to avoid the error. Further, we
        only test the connection if it appears necessary which should
        provide a minor performance boost.

    #849546 (Bug #72860)
        Following an inline comment link to a file open for 'add' no longer
        produces a JavaScript error.

    #848957 (Bug #72845)
        The trigger script will now fallback to curl if wget returns an
        exit code of 126 or higher. Previously we only fellback for 127.

    #842648 (Bug #72680)
        We now correctly detect files of type 'import' as being adds.

    #842413 (Bug #72707)
        Reviews now only reference projects/branches impacted by the
        current version.

    #841620 (Bug #70219)
        Invalid/non-existent jobs added to a change no longer result in a
        HTTP-500 error.

    #841606 (Bug #71843)
        Uploading a directory now results in an error message, not an
        unreadable white bar.

    #836796 (Bug #72523)
        IE11 is no longer erroneously detected as being Firefox by Swarm's
        generic error handling code.

    #836814 (Bug #72435)
        Modal dialogs now display on top of tooltips, previously they could
        erroneously overlap the dialog.

--------------------------------------------------------------------------

2014.2の主な新機能
-------------------

    #825537, #825687 (Bug #72144)
        レビューにオプションで必須レビュー担当者を指定することが可能とな
        りました。必須レビュー担当者が当該レビューに賛成票を投じるまで、
        そのレビューは承認されません。

        レビュー担当者の管理や必須レビュー担当者の指定を補助することを目
        的に、新たに「レビュー担当者の編集」ダイアログが追加されました。
        レビュー作成者、perforce 管理者、perforce スーパーユーザは、常に
        レビュー担当者を編集することができます。

        さらに、次の条件下にある各ユーザもレビュー担当者を編集することが
        可能です。
        - レビューがモデレート済みの場合は、そのモデレータ
        - レビューがプロジェクトの一部であるがモデレートされていない場合
          には、プロジェクトメンバ全員 
        - レビューがプロジェクトの一部ではない場合、認証されている任意の
          ユーザ

        最後に、各ユーザはレビューを残し、レビュー担当者のリスト配下にあ
        るアバタをクリックすることで、それぞれの投票を必須としたり、任意
        としたりすることができます。これは、参加、賛成票、反対票などの既
        存のオプションに追加されます。

    #823254, #825263 (Bugs #67052, #67054)
        オプションでブランチにモデレータを設定することができるようになり
        ました。モデレータが指定されると、モデレータに指定されたユーザの
        みが、当該ブランチ配下のレビューを「承認」または「却下」すること
        が可能です。

        モデレータが設定されているブランチ関連のレビューの場合:
        - モデレータのみがレビューの承認 / 却下を行えます。また、これら
          のユーザは、他のすべての遷移を実行することが可能です。
        - 作成者は、レビューが必要 / 修正が必要 / アーカイブ済みの間を移
          動させたり、コメントを添付したりすることができます。これらのユー
          ザは、レビューの承認 / 却下を行うことはできません (モデレータ
          であったとしても)。
        - メンバは、レビューが必要 / 修正が必要の間を移動させたり、コメ
          ントを添付したりすることができます。これらのユーザは、承認 / 
          却下やアーカイブを実行することはできません。
        - プロジェクトメンバ、モデレータまたは作成者ではないユーザは、い
          かなる遷移も実行することはできません。

        作成者またはプロジェクトメンバで、レビューがこれらユーザの許可し
        たステータスの 1 つにない場合 (たとえば、却下したなど)、同ユーザ
        はそのレビューを遷移させることはできませんので、注意してください。

    #805100, #805438 (Bug #66173)
        デフォルトで、Swarm の Web UI からコミットされたレビューは、レビ
        ュー作成者に帰属します。アクティビティ /E-mail 通知には、コミッ
        ト実行者およびレビュー作成者両方の詳細情報が記載されます。これは、
        デフォルトで true になっている設定オプションです。

    #804532, #820256 (Bug #67053)
       オプションで、プロジェクトに 1 名以上の所有者を指定できるようにな
       りました。プロジェクトに所有者が設定されると、(管理者およびスーパー
       ユーザにくわえて) 所有者のみがプロジェクトの編集が可能となります

    #796111, #796324, #804292, #803304 (Bug #69605)
        ドラッグ & ドロップでコメントボックスにファイルを添付できるよう
        になりました。この機能を有効にするには、「//.swarm」ディポを作成
        するか、ディポストレージの基本パスに Swarm が書き込める場所を設
        定してください。

--------------------------------------------------------------------------

Minor new functionality in 2014.2

    #834780 (Bug #72549)
        Updated the P4PHP binaries to be built with a patched P4API that
        does not reference the Heartbleed-vulnerable OpenSSL version.

    #825849 (Bug #66469)
        The Swarm favicon is now larger.

    #824751 (Bug #72388)
        Fixed a bug where trigger tokens were not protected from non-super
        users that requested JSON formatted '/about' output.

    #820025 (Bug #71330)
        Multiple Swarm instances can now safely operate on the same machine
        where the address only varies by port, even if SERVER_PORT is
        misreporting.

    #811552, #814057, #814086 (Bug #67051)
        Project creation can be limited to admin users by setting
        'add_project_admin_only' under the 'security' config. This feature
        is disabled by default.

    #810137, #812142 (Bug #66408)
        Ensured the horizontal scroll bar is always visible when viewing a
        change or review diff.

    #805410, #805415, #805458 (Bug #72039)
        Upgraded Zend Framework from 2.1.4 to 2.2.6 for a number of fixes
        and enhancements.

    #805070 (Bug #72042)
        Enhanced the queue status to report future-tasks separately.

    #801759 (Bug #71598)
        Added support for GitHub style line links (e.g.: '#L123') and
        highlighting of linked line; additionally, if you specify a range
        of lines (e.g.: '#10-20'), Swarm will highlight all of the lines in
        the range.

    #800253 (Bug #71712)
        Improved the configuration error message to alert the user if the
        data directory is unwriteable, or no php.ini is found.

    #797479, #799428, #800567, #801819 (Bugs #71679, #71718)
        Added a new URL shortening feature. This adds a small 'bookmark'
        button to the file browser page. Clicking the button generates a
        short URL and displays it in a small popover dialog that the user
        can easily copy from. A short link like this will redirect the user
        to a (presumably) much longer address. Also added support for a
        dedicated short-link hostname; this is a domain to use for short
        links to make them even shorter. Short links are handy for email,
        chat, etc.

    #796834, #803372 (Bugs #71521, #71738)
        Enhanced the trigger script to operate with in-place edits, or
        externalized configuration (implicit and explicit via -c config).
        This is helpful so that configuration can be more easily separated
        from the script itself.

    #791347 (Bug #71159)
        Expose a configuration setting to allow suppressing the Reply-To:
        email header field. This is helpful when you don't want to expose
        Perforce user email addresses in email notifications.

    #790928 (Bug #71396)
        When copying lines of text from a review or changes page, line
        numbers in diff no longer end up in your clipboard. All supported
        browsers still display the line numbers. IE still copies the line
        numbers if you multi-select lines.

    #790472 (Bug #71366)
        Remove the border styles from the diff table to provide a cleaner
        look, and also reduce visual glitches to table borders.

    #789318 (Bug #71717)
        Swarm now compresses JSON sent to the browser for better
        performance.

    #789217, #789221 (Bug #66706)
        Upgraded jQuery from 1.9.1 to 1.11.1 for performance improvements.

    #787961 (Bug #70991)
        Workers will effectively restart if Swarm detects the config.php
        file has been changed. This helps prevent the long running workers
        from using stale config.php settings.

    #782170, 794566 (Bugs #71160, #71327)
        Improved the performance of the home page, particularly when there
        are large numbers of projects or activity events.

    #781997 (Bug #70687)
        Display a tip at the bottom of review and change pages indicating
        the user can use the N and P keys to move between the changes.

    #781805 (Bug #71393)
        Upgraded JSRender from 1.0pre to 1.0.0beta.

--------------------------------------------------------------------------

Bugs fixed in 2014.2 Patch 2 (since 2014.2/841040)

    #853220 (Bug #72903)
        Administrators can now disable system info along with the related log
        and php info pages by setting 'disable_system_info' to true under the
        'security' config. By default, system info is still accessible to
        authenticated admin or super level users.

    #853054, #853496, #853533 (Bug #72881)
        The CSRF token is now passed as a POST param not a GET param. This
        should reduce the risk of exposure in logs, referrers, etc.

    #846204, #853041 (Bug #72805)
        Fixed a local XSS vulnerability in error messages when posting
        forms in Swarm.

--------------------------------------------------------------------------

Bugs fixed in 2014.2 Patch 1 (since 2014.2/835154)

    #840956 (Bug #72712)
        Made the details about changes to reviewers (e.g. 'Added user as a
        required reviewer') easier to distinguish from the description of
        the review in email notifications.

    #840731 (Bug #72698)
        Adjusted edit reviewers activity to clearly report when users are
        added. Previously we just stated 'Made user a required reviewer';
        it was unclear if they were being added or edited.

    #839300 (Bug #72658)
        When upgrading Swarm, browsers would sometimes hold onto outdated
        CSS and JavaScript potentially resulting in errors. Links to the
        minified CSS/JS now include the Swarm patch number to avoid this.

    #838036, #838043, #838150 (Bug #61429)
        Added CSRF protection to all mutative actions. For authenticated
        users, requests that are not a GET (e.g. POST, DELETE, PATCH, etc.)
        must now include a valid _csrf token. Actions which are
        'login_exempt' or 'csrf_exempt' do not require the token to be
        passed.

    #835869 (Bug #72611)
        Fixed an issue where Swarm was not setting the 'Remember me' cookie
        with the secure flag when appropriate.

    #835868 (Bugs #72548, #72568)
        Swarm can now be used in deployments where a proxy/balancer handles
        encryption and forwards plain HTTP traffic on to the Swarm server.
        When 'https_strict' is enabled, we now always send the HSTS header
        and we always flag cookies as secure only. Additionally, we now
        allow the administrator to disable the HTTPS redirect for HTTP
        clients by setting 'https_strict_redirect' to false under the
        'security' config.

    #835821 (Bug #72565)
        We now only start a session when needed (e.g. anonymous users don't
        get a session until they try to login). We also attempt to clear
        the session cookie on logout or session expiration.

    #835815, #835866 (Bug #72678)
        The diff endpoint will now produce a 404 error when attempting to
        diff a non-existent file. Previously a 500 error was produced.

    #835789 (Bug #72566)
        Swarm now supports specifying a session lifetime. If the session is
        not accessed for the specified duration, the user will be logged
        out.  By default the duration is 30 days but can be adjusted by
        setting the 'gc_maxlifetime' under the 'session' config. This
        feature will apply when using the default file based session
        storage. Other storage backends are presently unverified.

    #835577 (Bug #72564)
        Swarm no longer sends two Set-Cookie headers for the SWARM session
        ID on login. There is no functional change, this is just an
        aesthetic improvement to the response.

    #835554 (Bug #72571)
        Fixed an issue where toggling the 'Remember me' checkbox on login
        did not correctly adjust the session lifetime.

--------------------------------------------------------------------------

Bugs fixed in 2014.2

    #833850 (Bug #72510)
        Fixed an issue on Safari 5.1 where comment user avatars were not
        being sized correctly.

    #833609 (Bug #72505)
        Fixed an issue to ensure commits via Swarm keep the restricted or
        public type of the authoritative shelf.

    #827517 (Bug #72362)
        Fixed an issue where it was not possible to @mention a user that
        contained a backslash (such as an AD domain user).

    #826264 (Bug #72378)
        Fixed an issue with the job dialog automatically refreshing when
        attempting to select a row.

    #821123 (Bug #72390)
        Fixed a race-condition where automated tests for a review could
        fail if the pending review was committed before the tests ran.

    #821027 (Bug #72248)
        Fixed an issue where you could not change the review status of a
        review that was somehow stuck. Now, such a review can be
        transitioned to Needs Review, Needs Revision or Archive to clear
        the status.

    #820630 (Bug #72225)
        Fixed an issue in Firefox where the archive comment tooltips would
        get orphaned.

    #820120 (Bug #72391)
        Fixed an issue where the reviews queue would reload when the search
        input loses focus, even if the search value had not changed.

    #820005 (Bug #71764)
        Fixed an issue where Safari 5.1.x would throw a JavaScript error
        when navigating files using the back or forward buttons.

    #819959 (Bug #71459)
        Fixed a bug where protection table entries with spaces caused
        errors.

    #819822 (Bug #72224)
        Fixed an issue where no error message was displayed for
        browser-to-Swarm network errors.

    #814092, #824517 (Bug #64793)
        Fixed an issue where timezones were incorrect when Swarm was
        connected to a Windows p4d server.

    #813797 (Bug #72064)
        Fixed an issue where modal cancel buttons were being marked as
        ARIA-hidden.

    #809521 (Bug #71986)
        Fixed an issue with the 3D model viewer where it was looking at
        0,0,0 instead of the center of the model.

    #804290 (Bug #71851)
        Fixed a bug where the reviews page would issue excessive XHR
        requests, impairing browsing performance.

    #800358, #801075 (Bug #72003)
        Adjusted avatar styles to only show the default avatars when the
        user's Gravatar has finished loading. This prevents a momentary
        flash of the default avatar that could sometimes occur if Gravatar
        was slow.

    #799622 (Bug #71367)
        Swarm now normalizes the hostname specified in the config file to
        properly handle schemes and non-standards ports.

    #799558 (Bug #71680)
        Swarm no longer prevents the browser from handling control/command
        clicks in the Swarm File Browser.

    #794840 (Bugs #70317, #70295)
        Fixed several small issues with the file browser. Previously the
        handling of what controls were shown on different tabs was spread
        out and inconsistent. We also previously missed detecting all the
        cases where the tab had changed.

    #792725 (Bug #65644)
        Fixed an issue on IE9 where the archived comments area would toggle
        twice the first time it was clicked, so you would need to click
        again.

    #792034 (Bug #71138)
        Fixed an issue where certain special characters, like '@', '#', and
        '%' were escaped in email depot paths.

    #790454 (Bug #70231)
        Fixed an issue where linking to an archived comment did not expand
        the collapsed archive area to scroll to the comment.

    #790437 (Bug #71372)
        Enhance the N/P keydown listener to only handle one keydown per
        keypress. This should prevent issues with the focus moving further
        than expected.

--------------------------------------------------------------------------

2014.1の主な新機能
-------------------

    #774422, #775409 (Bug #70659)
        Swarm のファイルブラウザや差分機能で 3D モデルファイル (.STL、.
        OBJ、.DAE) をレンダリングできるようになりました。ビューアは、MTL
        ファイルを含め、モデルオブジェクトで参照されているリソース内で 
        pull を実行しますが、Web で表示可能な画像の場合は、テクスチャの
        みが表示されます (たとえば、.PSD テクスチャはレンダリングされま
        せん)。最新のブラウザを使用し、かつハードウェアアクセラレーショ
        ンが有効な場合、ビューアがスムーズに作動します。最新のブラウザは
        使用しているがハードウェアアクセラレーションが利用できない場合、
        ビューアは WebGL を用いずに実行され、動作が遅くなることがありま
        す。この場合、CPU 利用率を低減するために、自動ローテートは行いま
        せん。ブラウザが最新でない際には、単に「ビューアがサポートされて
        いません」というメッセージが表示されます。

    #772465 (Bug #68885)
        Git ユーザは Perforce Git Fusion から Swarm を用いることで 
        pre-commit レビューを実行できるようになりました。単純に「master」
        がターゲットブランチである /reviews/master/new に push するだけ
        で、pre-commit レビューを実行できます。使用に関する詳細は、Swarm
        のドキュメントに記載されています。

    #767962, #775774, #776148 (Bug #66723)
        制限されている変更は、ユーザにそれらを表示するパーミッションが付
        与されていない場合、UI からフィルタリングすることができるように
        なりました。

--------------------------------------------------------------------------

Minor new functionality in 2014.1

    #775670 (Bug #65494)
        Swarm checks for the existence of the config.php file and if not
        present, displays a suitable error to the user.

    #775412 (Bug #68201)
        RTF files, although text, will now be rendered through the
        LibreOffice module if present.

    #772469 (Bug #70803)
        The strict and enforce trigger types can now be scoped to just
        changes in a review using the -r flag. This allows unreviewed
        changes to proceed, but changes in a review must be approved.

    #771462 (Bug #70758)
        When calling automated tests for a review, Swarm now lists only
        branches impacted by the current change in the {branch} and
        {branchName} keywords.

    #770126 (Bug #70798)
        The amount of time and memory that worker processes use is now
        constrained. Previously, a worker could use an unlimited amount of
        memory and run for ever (no limits). Now, the limits for a worker
        can be set in the config file and default to 1GB and 30min
        respectively. The 30min timeout is reset for each task. No task
        can spend more than 30min of CPU time.

    #765295 (Bug #70583)
        For a project's branches listed on the project page, the mainline
        branches are displayed first, and the remaining are now sorted
        alphabetically.

    #762726, #763003, #770626, #773997 (Bugs #70611, #70612, #70613)
        Further reduced memory consumption in the processing of users and
        groups. For example, with 10,000 users and over 1,000 groups, Swarm
        previously used ~140MB of memory when populating the caches and
        ~120MB when reading from the caches; with these changes, memory
        usage drops to ~35MB and ~12MB respectively.

--------------------------------------------------------------------------

Bugs fixed in 2014.1

    #777472 (Bug #70940)
        Fixed an issue where improper permissions on the token directory
        would result in an infinite loop.

    #774788 (Bug #70842)
        Fixed an issue in Chrome when viewing a large image retrieved from
        cache would cause the page to continually refresh.

    #773886 (Bug #70813)
        Fixed display issues in IE with the filename bar on a review page.

    #772345 (Bug #70774)
        Improved the scrolling performance in Chrome on Review pages by
        manually instructing the browser which areas to repaint when
        scrolling a file.

    #769901 (Bug #70797)
        Fixed an issue where filenames with special characters were
        improperly displayed in a comment tagline.

    #769859 (Bug #69623)
        Fixed an IE11 performance issue when viewing the Reviews page.

    #766082 (Bug #70599)
        Fixed an issue when browsing project files would cause a HTTP 500
        error if one of the project's branch definitions contained a path
        ending with a slash (as opposed to '/...').

--------------------------------------------------------------------------

2013.3の主な新機能
-------------------

    #749961, #750778, #751112 (Bug #69119)
        Swarm で、参加者がレビューに賛成票や反対票を投じることができるよ
        うになりました。レビューページでは、参加者の列を、賛成票 / 反対票
        の列に変更することができます。

    #730156, #747698, #748957 (Bug #69279)
        Swarm で、IP ベースの Perforce プロテクションをエミュレートできる
        ようになりました。Swarm はユーザの IP アドレスをチェックのうえ、
        これを使用して、たとえばファイル参照、ファイルコンテキストの表示、
        ファイルのコメントの表示 / 追加など、必要な制限規則に適用します。

    #724625 (Bug #60905)
        レビューおよび変更に対して、5 段階のレベルでコメントする機能が追
        加されました。変更 / レビュー状態にあるファイルにはフッタが追加さ
        れ、既存のインラインコメントインターフェースに類似のコメントの表
        示や追加を行うことができるようになりました。

--------------------------------------------------------------------------

Minor new functionality in 2013.3

    #751165 (Bugs #68207, #69624)
        Eliminated redundant commit activity and email notification. This
        would occur when a change linked to a review was committed. Now,
        the commit is reported only once.

    #751085 (Bug #69749)
        Old invalidated cache files are now cleared out periodically.

    #750074 (Bug #70114)
        Swarm will log warnings when Perforce commands take longer than a
        prescribed time. By default, the print, submit, sync, shelve, and
        unshelve commands' threshold is 10 seconds; for all others, it is 3
        seconds.

    #749100 (Bug #70023)
        Swarm will perform XHProf profiling if the 'xhprof' PHP extension
        is present and requests take longer than a prescribed time (by
        default, 3 seconds). Data collected will be placed in the
        data/xhprof directory.

    #748526 (Bug #70110)
        When browsing a project's branches, mainlines now appear first and
        are bolded as they are the most frequently accessed codelines.

    #747404 (Bug #70017)
        The Swarm distribution now includes P4PHP binaries for PHP 5.5.

    #745637 (Bug #69980)
        Commit email notifications now include a link to their associated
        review.

    #734207, #751251 (Bug #69487)
        Swarm can now display deleted files and folders when browsing
        files.

    #732930 (Bug #69636)
        Added support for hashtag (more formally known as "octothorpe"!)
        style review keywords; e.g. #review or #review-1234. Note the
        keyword is only honoured if it is preceeded and followed by either
        whitespace or EOL/SOL. Unlike the square-bracket convention
        [review], the hashtag style review keyword can appear anywhere in
        the description, not just at the beginning or end.

    #728989 (Bug #60909)
        Users can now comment on jobs in Swarm under the new 'Comments' tab
        on the job page. When there is a new comment, Swarm will send an
        email notification to users listed in 'user' fields in the job,
        @mentioned in the job description and users of associated changes.

    #728163 (Bug #69542)
        Avoid session locking to improve performance when making multiple
        simulatenous requests. This should improve the ability to browse in
        other tabs while file previews are being converted/transferred.

    #723845 (Bug #64834)
        Added a system information page (/info), accessible to users with
        admin privileges. The page displays Perforce Server information,
        PHP info, and the Swarm log, which can be downloaded.

    #722080 (Bug #69406)
        Enhanced the 'jobs' route to automatically prepend 'job0...' if the
        given ID is numeric and doesn't exactly match an existing job. For
        example, /jobs/12345 will resolve to /jobs/job012345.

    #721850 (Bug #69380)
        Added a new 'disable_commit' option under the 'reviews' section in
        the configuration. Enabling this option will remove the "Approve
        and Commit" and "Commit" options from the Swarm web interface.
        External commits via traditional Perforce clients will still be
        possible. This setting is false by default.

    #720456 (Bug #69290)
        If a user adds themselves as a review participant, Swarm will no
        longer email the new participant, though all other participants
        will still be notified.

    #719792, #719938 (Bug #69245)
        Added icons next to changes listed on the jobs page to indicate
        their type (review, commit, pending).

    #718564 (Bug #69206)
        Added new 'http_client_options' configuration. This allows
        administrators to specify HTTP communication options (particularly
        useful for HTTPS related options) either globally, or host-
        specific.

    #716765 (Bug #65289)
        Improved HTTPS support via a 'strict_https' option. When enabled,
        viewing an HTTP link will include a meta-refresh to the HTTPS
        version, a strict transport security header will be included for
        all HTTPS requests (pinning the browser to HTTPS for 30 days), all
        qualified URLs will use HTTPS for the scheme, and cookies on HTTPS
        connections will be flagged HTTPS-only

    #716542 (Bug #66938)
        Updated the Jobs page to allow selecting and re-ordering columns
        representing job fields.

        Columns can now be selected via the 'Select Columns' drop-down
        button located beside the search box.  Users can select columns to
        show in the table below by checking them in the drop-down (showing
        all available fields, where the selected ones are always located at
        the top of the list).

        Selected columns can also be re-ordered, either by dragging them
        into desired spot in the drop-down or in the table header.

    #714786, #715519, #715658, #719803, #720491 (Bugs #69093, #69647)
        Swarm has a new design that is cleaner and brighter with fewer
        borders. The projects sidebar has been moved to the left-hand side
        of the home page. This fixes an issue loading activity on mobile
        devices. Events in the activity table are now color-coded (with a
        thin vertical line on the far-right edge) to indicate the type of
        activity.

    #714421 (Bug #69090)
        Enhanced our emojify filter to make use of Gemoji images if they
        are installed under public/vendor/gemoji. Gemoji provides support
        for more emojis and works on more browsers and platforms than the
        unicode codepoints we normally use. For more information about
        Gemoji, see https://github.com/github/gemoji.

    #713201 (Bug #68815)
        Introduced 'use_bcc' configuration item under 'mail' to address
        recipients of changelist notifications via the BCC field instead of
        the TO field. See the Email configuration section under
        Administration of the documentation.

--------------------------------------------------------------------------

Bugs fixed in 2013.3 patch 1 (since 2013.3/759531)

    #762450 (Bug #70489)
        Fixed an issue with the automated test and deployment integrations
        where the branch ID was passed but documented as the branch name.
        We now provide both the ID and name for branches and projects, and
        the documentation has been corrected.

    #762417 (Bug #70490)
        Addressed a browser performance problem involving collapsed files
        on review and changes pages.

    #761990, #762232 (Bug #70467)
        Improved the efficiency of processing Perforce groups to reduce
        memory consumption. For example, with thousands of users and
        groups, memory consumption is reduced by approximately 80%.

    #761155 (Bug #70461)
        Fixed the queue location when using the SWARM_DATA_PATH override.

--------------------------------------------------------------------------

Bugs fixed in 2013.3

    #757302 (Bug #69995)
        Fixed a bug where multibyte UTF-8 sequences in user ID's could lead
        to HTTP 500 errors.

    #755964 (Bug #70225)
        Fixed the activity display for a user whose ID contains a period.

    #751230 (Bug #69672)
        Fixed erroneous 'approved' email when committing a review from
        Swarm where the review was already approved.

    #751219 (Bug #69696)
        Fixed an issue where including an invalid change number when adding
        a commit to a review would throw an exception instead of returning
        a nicely formatted error.

    #751195 (Bug #65646)
        Fixed an issue where the 'Commit' button in the Commit Review
        dialog became prematurely enabled.

    #751100 (Bug #69666)
        Fixed an issue where some errors were not being displayed when
        failing to commit a review from Swarm.

    #751043 (Bug #67471)
        Fixed an issue where a long description of a history entry would
        not be collapsed.

    #751013 (Bug #68809)
        Fixed an issue where a change description that contained a line
        with only a period as its content would cause email notifications
        to be truncated at that point.

    #747494 (Bug #69651)
        When showing historic context lines on comments, the old context
        will now only be shown once when it applies to multiple sequential
        comments.

    #747607 (Bug #70022)
        Swarm now properly disconnects from the mail server after sending
        an email. Previously, a timeout error could occur if a worker
        processed multiple email related tasks.

    #746579 (Bug #65666)
        Swarm no longer throws an HTTP 500 error when an invalid depot is
        entered within the change select dialog.

    #745635 (Bug #69981)
        When editing a review description, mentioning a user (via @user)
        will now actually add that user as a review participant.

    #745911 (Bug #69204)
        On the history tab, searching for a user with invalid characters
        will no longer generate an error.

    #743323 (Bug #69928)
        Previews of office type documents no longer silently fail on CentOS
        and Red Hat Enterprise Linux.

    #736065 (Bug #69737)
        Work around a Chrome bug where clearing out the password field on a
        long page would freeze the browser. See http://crbug.com/180868 for
        details.

    #736112 (Bug #69743)
        Fixed a race condition that could cause the commit status to become
        erroneously stuck at 'unshelving...'.

    #732093 (Bug #66240)
        Fixed a bug where login would fail against a case-insensistive
        Perforce server if the username did not match case exactly.

    #719604 (Bug #69248)
        Fixed a bug where Unicode or UTF-16 text files were not displaying
        properly in Swarm; Perforce converts them to UTF-8 and Swarm now
        flags them as such.

    #716735 (Bug #69129)
        Fixed a bug where the wrong timestamp would be shown in the
        activity feed for certain timezones (e.g. AEST).

    #712670 (Bug #68949)
        Fixed a minor bug where the user could erroneously select a header
        row in the 'Select Job' dialog.

--------------------------------------------------------------------------

2013.2の主な新機能
-------------------

    #680316, #681228, #691940 (Bugs #66717, #65503)
        コードレビューをバージョン化できるようになりました。レビューが更
        新されると、予定されている作業の履歴が管理されます。これによりユー
        ザは、レビューに加えられた各変更の差分や、新しいレビュータイムラ
        インを使用して当該レビュー前後のバージョン間の差分を確認すること
        ができます。

    #679062 (Bug #66799)
        JIRA モジュールにおいて、重要な機能改善がいくつか行われました。
        変更がサブミットされたり、レビューが作成 / 更新されたりすると、
        関連性のあるジョブから一連の JIRA の問題や、説明内のコールアウト
        を見つけ、JIRA の問題を Swarm 内の当該レビューや変更にリンクしま
        す。さらに、JIRA プロジェクトリストは自動的に fetch されるため、
        これを config.php にハードコーディングする必要がなくなりました。

    #676580 (Bugs #60923, #67538)
        Swarm 内のストリームベースのレビューをコミットする機能が追加され
        ました。この変更をもって、ストリームベースのプロジェクトが使用で
        きるようになりました。

    #668325, #680003 (Bugs #67216, 67653)
        Word/Power Point/Excel/Visio などの office 関連のドキュメントお
        よび、リッチテキストファイルがサポートされました。この機能を利用
        するには、必ず Swarm の Web サーバに LibreOffice をインストール
        してください。Swarm OVA には、どう機能を有効にするために必要とな
        る LibreOffice コンポーネントがインストールされています。

    #667587 (Bug #66586)
        BMP/EPS/PSD/TGA/TIFF 形式ファイルのプレビュー機能が追加されまし
        た。この機能を利用するには、Swarm Web サーバに必ず ImageMagick 
        PHP 拡張機能をインストールして有効にしてください。Swarm OVA には、
        同機能が同梱されています。

    #667207, #677868, #688353 (Bugs #64759, #65017, #67979)
        Swarm のレビューおよび変更機能は、より豊富なジョブ連携機能を提供
        するようになりました。ユーザは、変更やレビューに関連するジョブの
        情報を追加 / 削除することができます。Swarm は、P4V と同様に「レ
        ビューをコミット」ダイアログでジョブを選択できるようになりました。
        また、レビューファイルを更新する際にジョブが存在する場合は、その
        レビューに当該ジョブが追加されます。

--------------------------------------------------------------------------

Minor new functionality in 2013.2

    #695725 (Bug #60941)
        Users with permissions to edit projects can now also delete them
        via a new 'Delete' button in the 'Edit Project' page (confirmation
        is required via the tooltip).

    #695350 (Bug #68256)
        The default diff mode is now side-by-side; your last used diff mode
        will be remembered so this change primarily affects new users.

    #692127 (Bug #68153)
        Swarm now includes Linux variants of P4PHP that are built with
        glibc 2.3.3 to support older distributions, such as Red Hat
        Enterprise Linux 5.9. See the INSTALL.txt for more information.

    #689920 (Bug #68028)
        Swarm's session name now defaults to 'SWARM' for web servers
        running on port 80 or 443. For Swarm instances running on any other
        port, the session name defaults to SWARM-1234 where 1234 is the
        port number in use. This allow running several Swarm instances on a
        single server differentiating them by port and session name.

    #689744 (Bug #66724)
        Revised icons for added, deleted and edited files. These icons are
        colorful with larger +, - and pencil symbols. They should make it
        easier to distinguish between the various actions.

    #689613 (Bug #67755)
        Swarm can now be configured to use a custom avatar URL pattern
        allowing administrators to provide their own avatar server or
        disable custom avatars altogether. By default, custom avatars
        continue to come from Gravatar.

    #688945 (Bug #68046)
        Added a goto route for full or partial Git Fusion SHA1 commits that
        will redirect to the corresponding changelist. e.g.:
        http://myswarmhost/42697a7a79

    #680508 (Bug #62181)
        Swarm now anchors the file toolbar to the top of the window on
        changes/review pages so it stays in view while you are scrolling
        through a file.

    #675826 (Bug #67413)
        Added support for emoji shorthand (e.g. :smile:); see
        http://www.emoji-cheat-sheet.com for the full list.

    #672699 (Bug #66610)
        Users can now filter the history tab by user when browsing.

    #672363 (Bug #63199)
        Added a apple-touch-icon for iOS (and apparently Android) devices.
        Just one size (144x144) for simplicity.

    #671993 (Bug #67389)
        Restyled the error pages to incorporate our new mascot Bizzy
        Heisenbug and be more scalable/responsive.

    #669938, #693013 (Bugs #66534, #68206)
        Swarm no longer emails the user who commented or performed a review
        state change. Other interested parties are still emailed.
        Additionally, editing a review's description no longer generates an
        email.

    #666778 (Bug #67154)
        Added a new 'prevent_login' configurable to specify a list of
        Perforce users that are not allowed to log in to Swarm.

    #665482 (Bug #67108)
        We now collapse multiple occurrences of certain characters (e.g.:
        ASCII lines) in the subject lines of change notification emails.

    #664426 (Bug #67065)
        Added hooks for previewing non-web-safe file fomats. A custom
        module is required to add support for other formats. In the
        module's bootstrap method you can grab the format manager and add a
        new handler. See the Imagick or LibreOffice modules for example
        usage.

    #664389 (Bug #65015)
        Added a 'My Reviews' filter to the review queue to show only
        reviews the current user is participating in.

    #661459 (Bug #66679)
        Improve configuration error page displayed if PHP-specific
        misconfigurations are detected (such as an unsupported PHP version,
        or missing PHP extensions). All detected misconfigurations are now
        shown in a list. Also, the path to all php ini files is shown to
        ease administration.

    #660436, #669261 (Bug #66573)
        Email notifications from Swarm now include additional email
        headers, 'X-Swarm-Host' and 'X-Swarm-Version'.

    #657062 (Bugs #66598, #66599)
        We now show the text of comments and the description of file
        updates on the review history tab.

    #656605 (Bug #66931)
        Added the ability to set the DATA_PATH via environment variable,
        SWARM_DATA_PATH. This can facilitate hosting multiple Swarm
        instances using a single Swarm installation.

--------------------------------------------------------------------------

Bugs fixed in 2013.2

    #704590 (Bug #68710)
        Queueing tasks will no longer log a PHP warning in the Apache error
        log when multiple tasks are added in the same millisecond.

    #703451 (Bug #68531)
        Fixed an issue where Swarm would display a 404 error if attempting
        to access the Apache info or status modules' handler paths. Swarm
        now detects if those modules are enabled, and if so, allows access
        to their paths.

    #696121 (Bug #67233)
        Fixed an issue when using Safari where PDF documents would be cut
        off strangely at the bottom of the window.

    #696076 (Bug #68041)
        Fixed an issue when using Internet Explorer where hitting enter in
        a text field would erroneously trigger nearby buttons.

    #691483, #692576 (Bug #68129)
        Swarm no longer "linkifies" deleted user IDs when showing the author
        of a change, comment, activity, etc.

    #689915 (Bug #68056)
        Fixed a bug where URLs using IP addresses were not being linkified.

    #689661 (Bug #68044)
        Fixed issue where Swarm would fail if the 'json' or 'session' PHP
        extensions were not installed; Swarm now checks for the presence of
        these extensions.

    #688137 (Bug #68043)
        Fixed .htaccess rules to allow viewing of documentation when PHP is
        not installed.

    #686394 (Bug #67908)
        Fixed an issue where older systems (e.g.: RHEL/CentOS) would not
        recognize a form of regular expression named capture groups; Swarm
        now uses a more backwards-compatible form.

    #686358 (Bug #67905)
        Fixed an issue where older systems (e.g.: RHEL/CentOS) would fail
        to fetch activity or reviews due to unexpectedly treating the ID as
        a float instead of an integer.

    #685439 (Bug #66446)
        Fixed an issue where the initial activity import could result in
        out of order activity records.

    #684802 (Bug #67816)
        Fixed an issue where token-based auth (alone) wouldn't work for
        deploy and automated test integration if require_login was enabled.

    #681666 (Bug #67720)
        Fixed an issue where it was possible to get an unexpected connect
        exception when accessing Swarm with a partially expired session.

    #681586 (Bug #67507)
        When logging warnings and errors, we no longer include context.
        Large values and excessive escapement made context useless.

    #680229 (Bug #67669)
        Fixed a race-condition where committing through Swarm could fail if
        the change was renumbered upon submit.

    #680188 (Bug #67652)
        Fixed display issues exposed in Firefox when navigating files.

    #679223 (Bug #67616)
        Fixed validation of group names. The rules we were enforcing in
        Swarm did not match the rules enforced by the server.

    #678458 (Bug #67592)
        Fixed a bug that prevented the minified consolidated web assets
        from being included in the distribution.

    #676317 (Bug #67445)
        Fixed an issue where the Comments 'Archive' and 'Restore' buttons
        weren't labelled for screen readers.

    #673297 (Bug #67431)
        Fixed a bug where Swarm only matched the first keyword and stopped.
        If someone used the [review] keyword at the start and end of their
        description this would have left one behind.

    #671254 (Bug #67342)
        Fixed a bug where commenting above a padding line caused a comment
        indicator to appear on the padding line.

    #671092 (Bug #67126)
        Added roles and ARIA labels to fix an issue where the All Projects/
        My Projects dropdown was undiscoverable by NVDA, and where the Add
        Project Link wasn't being described at all by NVDA.

    #669528 (Bug #67262)
        Fixed a bug where the display of ignored whitespace on context
        lines in Swarm was inconsistent with p4 diff/P4Merge if you used
        the 'Show Full Context' feature.

    #668045 (Bug #67214)
        Improved handling of purged files in diff. We no longer attempt to
        show or diff purged files.

    #668043 (Bug #67162)
        Fixed a bug where searching within Help was not working.

    #667916 (Bug #67195)
        Improved Approve & Commit error handling to ensure the attempted
        change is deleted on failure.

    #667915 (Bug #67106)
        Fixed an issue where the pdf preview area was very small on Firefox
        and Internet Explorer.

    #667770 (Bug #67185)
        Fixed an endless loop that could occur when Swarm attempted to
        obtain a client to use from its client pool if file permissions
        were invalid.

    #667226 (Bug #67166)
        Fixed an issue in Swarm Jobs Search where it would still reload
        your query on search blur even after you had just loaded the query
        using the enter key.

    #666601 (Bugs #65684, #67055)
        Fixed an issue where using the back button on a Job page would take
        you back to search page with the previous search filled into the
        field, but not properly filtered in the results.

    #665678 (Bug #67210)
        Fixed a bug where a changelist description that had a numbered list
        item could be linkified if the previous line ended with "change".

    #657378 (Bug #66826)
        Fixed a bug where avatar selection was not consistent when using
        the Suhosin version of PHP. This is because srand() is disabled for
        security reasons.

--------------------------------------------------------------------------

2013.1の主な新機能
-------------------

    #647347 (Bug #66023)
        レビューの取得 / 公開機能の代わりに、複数のレビュー担当者を指定
        できるようになりました。このため、今後レビューの取得 / 公開機能
        を使用することはできません。その代わりとして、レビュー作成者以外
        でレビューに参加している任意のユーザが (たとえば、レビューへコメ
        ントをする、ステータスを変更する、コードを push するなど)、「レ
        ビュー担当者」となることができるようになりました。これに伴い、
        Swarm では、レビューの説明の下に、レビュー担当者のアバターが表示
        されるようになりました。「レビュー担当者」という文字に続き、右側
        にアバターが表示されます。ユーザはクリックすることで、各自をレビ
        ューに参加することができます。

        レビューキューでは、新しい「レビュー担当者」の列が追加されました。
        レビュー担当者の列には、レビュー担当者の人数や、マウスのカーソル
        を当てることで、ツールチップにレビュー担当者全員の名前がリスト表
        示されます。同様に、登録済み / 未登録フィルタが、登録済みレビュー
        担当者 / 未登録レビュー担当者フィルタに変更されました。

    #647277, #647325 (Bug #65934)
        Swarm は、ライセンス登録済み Perforce サーバを実行する際に、ライ
        センスを要求するようになりました。Swarm ライセンスを保有していな
        くても、Swarm の機能が制限されることはありませんが、ページごとに
        ライセンス違反に関する通知が表示されます。

        Swarm は、ライセンス未登録の Perforce サーバを実行する際に、ライ
        センスを要求することはありません。

        Swarm でライセンス登録されているユーザが Perforce サーバよりも少
        ない場合、「swarm」グループまたはサブグループのメンバーのみが、
        Swarm にログインすることが可能です。非メンバーがログインを試みた
        ときに swarm グループに空きがあると、security => disable_autojoin
        が true に設定されていないかぎり (デフォルト設定は false)、それ
        ら非メンバーは自動的に同グループに追加されます。

        バージョン 2012.1 より前の Perforce サーバでは、Auto-join 機能が
        サポートされていません。この場合、Auto-join 機能は無効化されたよ
        うな状態となり、Swarm は単純にログイン失敗の処理を行います。

        ライセンスの購入や、無償の評価版に関しては、sales@perforce.com
        にお問い合わせください。

    #645705, #646629, #647327 (Bugs #63686, 65936)
        Swarm に、レビューの実施や厳密なコンテンツのチェックに関するトリ
        ガタイプが新たに追加されました。「-t enforce」タイプを使用すると、
        サブミットが承認済みのレビューに関連付けられます。「-t strict」
        タイプではさらに、サブミット対象のコンテンツが承認済みレビューの
        コンテンツと一致するように動作します。前述のいずれかのタイプで
        「-g <group>」を使用することで、チェックを免除するユーザグループ
        を指定できます。詳細は、トリガに関するドキュメントを参照ください。

    #645011, #645217 (Bugs #60966, #63100)
        Swarm はオプションで review デーモンとして稼働することができ、ユー
        ザが各自のユーザフォーム内のレビューエントリで関心を示したパスの
        変更に関する通知を E-mail で送信します。詳細は、E-mail 通知のド
        キュメントを確認ください。

--------------------------------------------------------------------------

Minor new functionality in 2013.1

    #652213 (Bug #66450)
        Swarm pages now include meta information that inform Internet
        Explorer to always use the latest document standards when
        rendering. This prevents users from accidentally running Swarm in
        Compatibility Mode, which is not supported.

    #650691 (Bug #65055)
        Swarm now supports additional browser versions: Apple Safari 5.1+
        and Microsoft Internet Explorer 9.

    #648677 (Bug #66005)
        Added logic to automatically upgrade review records anytime they
        are saved. This is necessary to accommodate changes made to review
        records since 2013.1.BETA/629891.

    #648653
        Added .ico files to the list of 'viewable' (browser-safe) image
        file types.

    #648129, #648274 (Bug #66473)
        The Swarm virtual appliance (OVA) is now based on Ubuntu 12.04.2
        LTS. Connections to SSL-enabled Perforce Servers is now possible.
        The supplied config.php file contains more default entries to make
        customization easier (logging level, notifications to honor P4
        reviews). PHP upgraded to 5.4.15 and is now available in the path.

    #648004 (Bug #66467)
        Swarm now supports a facility for automated deployment for code
        reviews. When configured, a 'Try it out' button will appear on code
        reviews so that reviewers can run the code with minimal effort.
        This facility works very much like the automated tests integration.
        You can optionally specify a 'deploy' url and can pass it
        paramaters such as {change}, {status}, {review}, {project},
        {branch}, {success} and {fail}.

        Everytime a code review is started or its files updated, the deploy
        url will be called. If the build works, your deploy script simply
        requests the {success} address and includes a 'url' get or post
        parameter. If the build fails, your deploy script can optionally
        request the {fail} address. Including a failure url parameter is
        optional but supported.

    #647030 (Bug #66255)
        Changed the title for the personal activity stream from 'Activity'
        to 'Followed Activity'.

    #646877
        Removed the 'Re:' prefix from comment email subjects. They were
        interferring with threading in Gmail.

    #646335 (Bug #66376)
        For Perforce activity initiated from Swarm, the Perforce Server log
        now correctly shows the client as Swarm instead of P4PHP.

    #645421 (Bug #66365)
        Users can now associate additional submitted changes to an existing
        review.

    #645245 (Bug #65597)
        Update the included P4PHP binaries from 2013.1/617119 to the latest
        patched version (2013.1/644389), which includes a crash fix.

    #642465
        Added two links to the committed change on the review page. One
        link is in the byline: '... committed 2 days ago in 54321' (the
        change number is a link). The second link is left of the
        add/edit/delete file count. Previously Swarm showed the change
        number in this location, but it was not a link.

    #640209 (Bug #65894)
        From the Reviews page, Users can click the review state icon to go
        to the review detail page.

    #640072 (Bug #65935)
        Swarm can now properly operate behind a forwarding Perforce
        replica.

    #639765
        The Swarm trigger now tries to use 'wget' first, then 'curl', as
        'wget' is more common. Also modified added the -o flag for
        displaying its trigger table entries.

    #639202, #639414, #639415, #639426, #647014, #647348 (Bug #65937)
        JavaScript performance improvments were made to fix issues around
        logging in and commenting when having many files expanded.

        On a change with 20,000 lines of code, Chrome was taking 140
        seconds to log in; now it takes under a second to log in or
        comment. The expand all on that change was taking around 20 seconds
        in Chrome, but now takes about 3 seconds.

    #637198
        Renamed comment 'close/reopen' to 'archive/restore'.

    #636834 (Bug #64168)
        A notice is displayed if there is no activity to display.

    #636826 (Bug #66031)
        Swarm now allows ticket based login for end-users.

    #636565
        Users @mentioned in change descriptions or comments were not
        previously notified.

    #634561
        Don't send email notification for passing tests unless they were
        previously failing.

    #634313 (Bug #65893)
        Searching on the review page is now case-insensitive.

    #633930
        Swarm now shows the 'committed' icon for reviews that are both
        approved and committed. This is just one more visual clue that the
        review you are looking at is committed.

    #630853 (Bug #65040)
        Swarm now has a new logo; ooh, ahh.

    #620870 (Bug #65042)
        Improve the layout for editing a Swarm project.

--------------------------------------------------------------------------

Bugs fixed since 2013.1/667767

    #674403 (Bug #67464)
        Fixed a bug where invalid email addresses could prevent valid
        email addresses from receiving messages.

    #673093 (Bug #67415)
        If the change spec was missing the 'Type' field, viewing changes
        was not possible. Swarm is now tolerant of Type not being present.

    #673030 (Bug #67381)
        Fixed a race condition when grabbing tasks out of the queue; in
        some cases, two workers could grab the same task. This manifested
        as unlink warnings in the Swarm log file.

    #672407, #674413 (Bug #67397)
        If custom triggers send output to stdout or stderr, it could cause
        Swarm to malfunction when processing Perforce forms. Swarm is now
        more tolerant of noisy triggers.

    #672230 (Bug #67274)
        If the Perforce Server was restarted during the lifetime of a Swarm
        worker (e.g. a p4d restart), the worker's connection would become
        unusable causing it to throw away tasks. The workers now attempt to
        auto-reconnect to Peforce and they will only process tasks if they
        have a valid connection.

    #671840 (Bug #67299)
        Updated the license validator to handle any command exception; this
        fixes an error that could occur at login on 2010.2 Servers.

    #671322 (Bug #67354)
        Fixed a bug where Swarm's defense against ClickJacking attacks was
        not properly enabled.

    #671321 (Bug #67350)
        Fixed an XSS vulnerability in branch name rendering.

    #670131 (Bug #67309)
        Fixed a bug where users were not being emailed notifications for
        submitted changes against projects they followed (but were not
        members of).

--------------------------------------------------------------------------

Bugs fixed since 2013.1/652715

    #667718 (Bug #67180)
        Noisy change triggers could prevent Swarm from capturing the number
        of newly created changelists. Swarm now skips over trigger output.

    #667713, #667741 (Bug #67179)
        Certain empty fields in jobs (such as 'user') could cause a 500
        internal server error. Swarm now checks for empty values before
        performing additional processing on special job fields.

    #665389 (Bug #67021)
        Swarm did not show or diff the contents of Unicode or UTF16 files.
        These file types are now treated as text and safe to show or diff.

    #664119 (Bug #67045)
        Swarm's enforce trigger (designed to prevent un-approved submits)
        would occassionally reject an approved submit because of a subtle
        inconsistency in how Swarm was writing review records.

    #662273 (Bug #66963)
        Login and other operations that checked a user's group membership
        could fail with a 500 internal server error if the Perforce Server
        contained any groups with a null id (ultimately due to Perforce
        Server Bug #37630).

    #661073 (Bug #66703)
        The reviews page could issue an excessive number of XHR requests
        against the Swarm server when loading more reviews. Fixed the logic
        that throttles these requests.

    #660074 (Bug #66886)
        Fixed an issue where Swarm could produce a 500 internal server
        error when connecting to a SSL enabled Perforce Server for the
        first time.

--------------------------------------------------------------------------

Bugs fixed in 2013.1

    #652570 (Bugs #64063, #65566, #65711)
        Dates and times of committed changes and created/updated jobs shown
        on various Swarm pages (Change, Changes, Job, Jobs, Review) were
        incorrect if the user's client machine was in a different timezone
        than Swarm and/or the Perforce server.

    #652515 (Bug #65637)
        IE10 failed to load a single file change if your page first loaded
        with a tab other than Files, such as Comments or History.

    #651899 (Bug #66551)
        The undocumented activity delete action would not function when
        using the -m <max> argument.

    #651855 (Bug #66540)
        If require_login was enabled, console actions would not function.

    #651312 (Bug #66593)
        Web-safe images were not being properly displayed if their filename
        extension was in upper case.

    #647388 (Bug #65304)
        Branches with multiple paths did not map correctly into the
        project's file's branch folder.

    #647380 (Bugs #65525, #65555)
        Filtering the activity or the review queue too quickly would result
        in the toggled filter buttons being out of sync with the actual
        filtered content.

    #647349 (Bug #65831)
        Searching for jobs using an invalid field would cause an HTTP-500
        error.

    #646245 (Bug #65581)
        Logging in would always redirect you to the homepage instead of
        refreshing the current page if the config.php setting
        require_login=true was set.

    #645363 (Bug #65053)
        The changes pages would show up blank when navigating to them using
        your back/forward buttons in your browser.

    #645356
        Made the 'already committed' change selector dialog work even if
        the current change has no base path defined. Previously, if there
        was no base path Swarm would report a 500 error.

    #645338
        Fixed an issue where the review state menu was inoperable if a
        commit was underway. This was happening because Swarm polls for
        commit-status every second and rebuilds the menu. Now, Swarm only
        rebuilds the menu if there is new data.

    #645255 (Bug #65051)
        Avatars' height could be slow to render; Swarm now makes avatars
        take up their proper space before they are loaded.

    #642636 (Bug #65052)
        Browsing history against a remote depot incorrectly would report
        'no matching changes'; Swarm now correctly reports that change
        details are not available.

    #640153 (Bug #64605)
        Email notifications would show occasional signs of corruption.

    #638212 (Bug #66076)
        Invalid UTF-8 characters in a Perforce user name could prevent the
        add/edit project functionality from working correctly; Swarm now
        filters out invalid UTF-8 characters.

    #637913 (Bug #66053)
        Swarm would not warn if the P4PHP extension was missing or not
        loaded; it now displays a message with a link to the documentation
        on how to configure it.

    #637871 (Bug #66073)
        Authentication triggers that outputted additional text could
        prevent Swarm from processing the login correctly; Swarm is now
        more tolerant of "noisy" authentication triggers.

    #637643 (Bugs #65236, #65474, #65491)
        Empty paths, embedded wildcards or non-existent depots in a
        project's branch definition would cause an error at the project's
        files page; these scenarios are now guarded against during entry.

    #636855 (Bug #66021)
        Swarm would duplicate activity if activity occurred after its
        triggers were provisioned, but before any workers were provisioned.

    #636427 (Bug #65632)
         If the user's ticket expired, an error to be shown the first time
         a page was shown after session expiration.

    #635184 (Bug #65978)
        Browsing files for a project produced 404 errors due to malformed
        URLs in certain environments.

    #634443 (Bug #64376)
        Collapsing comments in inline mode wouldn't work correctly in
        certain scenarios.

    #633171 (Bug #65558)
        Under certain circumstances with user auto-creation, new users
        could not log in, due to the user form-commit trigger not firing;
        Swarm now handles this situation properly.

    #632803 (Bug #65567)
        Swarm would incorrectly display a caret on the review state button
        if you weren't logged in.

    #632794 (Bug #65833)
        The blame button would dissapear when using the view or download
        button in the file browser.

    #631059 (Bug #65790)
        Plain text files were inappropriately syntax-highlighted.

    #630180 (Bug #65549)
        Line numbers could be duplicated in browse files view after
        revisiting the page.

--------------------------------------------------------------------------

2013.1Beta版の主な新機能
-------------------------

    #623534 (Bug #63691)
        「require_login」が有効の場合、匿名ユーザのみがログイン画面にア
        クセスできます。

    #621958, #622013 (Bug #60937)
        プロジェクトのファイルおよび履歴を、プロジェクトの概要ページから
        直接閲覧することができます。

    #619149, #622680 (Bug #65003)
        Perforce コマンドは、可能なかぎり、認証済みユーザとして実行され
        ます。

--------------------------------------------------------------------------

Minor new functionality in 2013.1 Beta

    #625175 (Bug #65033)
        User can click the tests result icon on a review to open the
        results URL passed back from the automated tests.

    #624174 (Bug #65032)
        If a valid user id is @mentioned it will now be included on emails
        and, if in a review, added as a review participant.

    #624156 (Bug #65002)
        Authentication tokens are now required for the trigger script to
        queue events to Swarm.

    #624051 (Bug #65013)
        Users can edit the review description.

    #623812, #624003 (Bug #60925)
        Only project members, admins or supers can edit a project.

    #622008 (Bug #65034)
        An icon representing the automated tests status is now displayed on
        the review page.

    #621443 (Bug #65041)
        Jobs affecting a project can be accessed directly from the project
        overview page.

    #619330 (Bugs #65012, #64455)
        Improve the review byline and avatar to reflect the author and
        affected projects.

    #619083, #624718 (Bug #64995)
        Users can see all the committed changes associated with a review.

    #618709, #619502 (Bug #63914)
        Users can close/dismiss comments.

--------------------------------------------------------------------------

Bugs fixed since Beta 2013.1/627815

    #629873 (Bug #65689)
        If running a 2012.1 or newer Perforce Server, add project could
        fail with a HTTP 500 response.

--------------------------------------------------------------------------

Bugs fixed in 2013.1 Beta

    #625383 (Bug #65228)
        When a user enters a malformed or unsupported P4 username, it can
        generate an HTTP-500 error.

    #623461 (Bug #63734)
        Swarm attempted to display non-web-safe images, such as psd files;
        restrict display of images to gif, jpg, png, & bmp.

    #620292 (Bug #65069)
        Reviews that were created upon submit by including the [review]
        keyword did not show in either the opened or closed tabs after
        being approved.

    #618290 (Bug #64976)
        Swarm OVA has PHP timezone hard-coded to America/Los Angeles. This
        causes Swarm to show the incorrect time for events if the OVA runs
        in a different time zone.

    #618219, #624007 (Bug #64760)
        The Blame button would sometimes result in an HTTP-404 or an
        HTTP-500 error.

--------------------------------------------------------------------------

Minor new functionality since Beta Preview 2013.1/614107

    #617359, #617382, #617383 (Bug #64837)
        Improving the already committed dialog. It will now load more
        changes when scrolled, allows filtering by user and allows changing
        the 'path' being filtered.

    #616871 (Bug #64919)
        If you follow a user, their activity now appears in your
        personalized activity stream.

    #616687 (Bug #64913)
        A monospaced font is now used for input for the description when
        selecting 'approve and commit' or 'commit' on a review.

--------------------------------------------------------------------------

Bugs fixed since Beta Preview 2013.1/614107

    #617444 (Bug #64888)
        Selecting Approve and Commit on a review failed to clear the Swarm
        managed shelved change.

    #616978 (Bug #64940)
        The 'open file' button on changes and reviews lacked a tooltip.

    #616305 (Bug #64895)
        The example config.php file contained a syntax error.

    #616258 (Bug #64941)
        The unassigned filter on the reviews page did not work.

    #614938 (Bug #62155)
        Unassociated jobs could be shown on a change/review if they had a
        matching component e.g. 'foo-bar' when only 'foo' is present.

--------------------------------------------------------------------------

Credits

    Perforce Swarm, from the fleet fingers of Petr Havlik, Nellie LeMonier,
    Stewart Lord, DJ Mountney, Geoff Nicol, Jessica Weber, Marc Wensauer,
    and Allan Yu.

END