What's new in 2015.2
This section provides a summary of the notable changes in Swarm for the
2015.2 release. Full details are available in the distribution's
RELNOTES.txt
file.
Major new functionality
- Editable comments
-
Comments are now editable. If you are logged in, and the author of a comment, you now see an Edit link in the comment's footer. Clicking this link allows you to edit the comment text, remove selected attachments or add new ones.
See Comments for details.
- New localizations for Simplified Chinese and Korean
-
These localizations do not ship with the publicly released Swarm, but are available through Perforce's region-specific resellers.
- New trigger script
-
Swarm now includes a trigger script written in Perl. The new trigger is compatible with the existing Bash trigger. The new trigger adds support for using Swarm with a Perforce service configured using the commit-edge architecture, and also fixes a bug with strict enforcement mode and
+k
file types. - Edge server support
-
Support for multi-site deployments utilizing the commit-edge architecture is now included in Swarm. Use of the new Perl trigger to required for Swarm installations connecting to a Perforce service configured using the commit-edge architecture.
See Setup Swarm triggers with a Linux-hosted Perforce service and Trigger options for details.
Minor new functionality
- Email subjects
-
The
Subject:
line of notifications for submitted changes has been revised fromChange @54321
toCommit @54321
. - Proxy rules included in IP protections emulation
-
Swarm now applies Perforce proxy rules during emulation of IP protections. Previously, proxy rules were not taken into account. Now, Swarm now applies proxy rules as an intermediary according to the user's IP address.
See IP address-based protections emulation for details.
- Option to limit project configuration changes
-
Two options have been added to limit project configuration changes to users with admin privileges:
-
edit_name_admin_only
: when set, only administrators can edit the name of projects. -
edit_branches_admin_only
: when set, only administrators can modify the branch configuration in projects.
See Projects for details.
-
- Exemptions for strict/enforce
-
With the new Perl trigger, two options have been added to exempt changelists from strict or enforce verifications by file count and file types.
See Trigger options for details.
- Moderator notifications
-
Moderators now receive email notifications for commits and reviews for the branches they moderate, even if they are not members of the associated projects.
See Notifications for details.
- Refreshed login page.
-
The login page now includes a nice background image. See Log in / Log out for an example.
- Project toolbar
-
The button for editing a project's settings has moved into the project's toolbar, and while editing a project, the toolbar and sidebar now appear.
- Host-unlocked tickets
-
Swarm now generates host-unlocked tickets on login. This is needed to integrate with other Perforce services like p4-search.
- Line hash handling improved
-
When using line hash handling (e.g.
#l123
, the targeted line is now positioned 1/4 of the browser height from the top. Previously, it was positioned at 100px from the top. - Performance improvements
-
A performance problem that could occur with large numbers of users, groups, and projects has been fixed. With 5,000 users, 5,000 groups, and 500 projects, load times for the project listing have been reduced by more than twenty times.
- Email template improvements
-
The email notifications template has been simplified by removing the grey border and reducing the margins.
- History is now Commits
-
The History tab has been renamed to Commits. See Commits for details.
- Comment counts
-
Comment counts for reviews and jobs now reflect the number of open (non-archived) comments. Hovering over the number of comments shows the number of archived comments. Previously, only the total number of comments was shown.
- More context more visible
-
The visibility of the Show More Context rows in diffs has been improved. See Diffs for details.
- Option to limit self-approval
-
An option has been added to prevent authors from approving their own reviews, even if they are a moderator or user with admin privileges.
See Disable self-approval of reviews by authors for details.
- .tif images presented
-
The Imagick module now converts
.tif
files for display. Previously, only the.tiff
filename extension was recognized.
Known limitations
- Access Control
-
Swarm maintains a variety of information in the Perforce service's keys facility. By default, users with list-level privileges can read these keys, which can include comments that contain excerpts of code they may not normally have access to.
Perforce server version 2013.1 and higher have a configuration setting to require admin-level privileges. See Hiding Swarm storage from regular users.
- Virtual host recommended
-
Swarm must be installed to the root of a domain. We recommend creating a virtual host dedicated to Swarm.
- LibreOffice
-
Due to issues with LibreOffice's headless mode on the Mac platform, Swarm cannot display Office-type file formats if it is installed on the Mac platform.
- Task Stream Reviews
-
Pre-commit reviews in a task stream are not yet supported.
- Trigger script for Windows
-
We include a trigger script for both Linux/Mac and Windows; however, the Windows variant currently lacks support for the following features:
-
enforce (enforce that submits are tied to an approved Swarm review)
-
strict (ensure the content of submits matches the content of their associated approved Swarm review)
-
- Trigger table entries with '%quote%' not supported on 2010.2
-
The Swarm trigger scripts (found in p4-bin/scripts) document the trigger table entries to add, making use of
%quote%
to surround the pathname to the script; however,%quote%
is not supported on 2010.2 Perforce Servers (they are harmless though). If you're running a 2010.2 Perforce server, ensure that there are no spaces in the path to the trigger script. - 2014.2 RPM package upgrade issue
-
Upgrades from 2014.2 RPM packages are incorrectly treated as new installations by the packaging system. This is due to the package being renamed in 2014.3. Minor configuration issues might result.
- RHEL/CentOS 7.x support
-
Multiple issues prevent Swarm RPM packages from installing correctly on RedHat Enterprise Linux, or CentOS, versions 7.0 or higher.