Documentation

For details about using P4Web, see the P4Web documentation on the Perforce Web site or consult the embedded help files.

Requirements

• P4Web requires a Perforce Server at Release 1999.2 or higher.

• P4Web works with most web browsers. Some older browsers do not provide the authentication support needed by P4Web. Such browsers can be used only when P4Web is running in Viewer mode.

• Starting with release 2003.2, P4Web uses limited JavaScript, but can function if JavaScript is disabled.

• Starting with release 2003.2, P4Web makes extensive use of CSS style sheets and HTML tables. If you encounter rendering or performance issues with P4Web, upgrade your Web browser. For Netscape users, release 7.1 or higher is required.

• To resolve files interactively using P4Web on Windows and Unix, you must have P4, the Perforce Command-Line Client, installed.

• On Macintosh, UNIX, and Windows, P4Web can launch a text editor. To the text editor to be launched when you edit text files, set P4EDITOR before running p4web as described in the help topic "How to Use P4Web."

Installation

• User
  By default, P4Web is installed as an application. However, if P4Web is currently installed as a service:
  • if the Windows user has administrator permission, the installer updates the P4Web service.
  • if the Windows user does not have administrator permissions, the installer does not change the P4Web service and omits the P4Web component from the list of choices.
  
  
• Administrator Typical
  If you choose to install P4Web as a service, any existing installation of P4Web as a application is replaced. The P4Web service is configured to run in Viewer mode.
  

• Administrator Custom
  If you choose to install P4Web as a service, any existing installation of P4Web as a application is replaced. To specify whether P4Web runs in Viewer and Standard mode, click the corresponding radio button.
  

• Uninstall
  Removes the currently installed P4Web application or service.

Latest Changes

New Functionality in Release 2008.2

• P4Web can now advertise as a Zeroconf service. For details, see the "Administering P4Web" topic in P4Web help.

• P4Web now supports inetd in all modes (not just in Viewer mode). For maximum security, do not use inetd for a publicly-available instance of P4Web.

• P4Web can now return XML output. For details, see the "XML Output" topic in P4Web help.
• P4Web can now return specified chunks of full-page results. For details, see the "Action Codes" topic in P4Web help.
• The two "View Annotated File Text" and "View Fully Annotated File Text" menu items have been combined into a single "View Annotated File Text".

  This option displays a detailed Annotate screen with show/hide options for deleted lines and user, and the ability to toggle display of changelist numbers and revision numbers. The changelist or revision numbers in the left column have tooltips that display the corresponding filelog information. To display the old, smaller, simpler annotate screens, check the "Disable enhanced annotate display options" on the Settings screen. This older version has also been enhanced with the ability show and hide deleted lines. All annotate screens accept a revision range.

• In the two-pane diff, if Javascript is enabled, you can move to the next and previous diff chunk by typing n and p or pressing the down- and up-arrow keys.

• The two-pane diff now displays the total number of added, changed, and deleted chunks.

• Revision History indicates whether the P4Web workspace contains the head revision (green badge) or an older revision (yellow badge).

• P4Web supports http://[host]:[port]/crossdomain.xml in the same way it supports robots.txt: If P4WEBCROSSDOMAIN is set, that path is used, otherwise //depot/crossdomain.xml is used.

• P4Web now uses a custom login screen rather than the browser's built-in login dialog.

• You can now hide and show columns in the Path Browser Details listview by clicking the arrow icon located to the left of the header row.

• The Jobs screen now displays an ellipsis (...) to indicate fields that have been truncated to fit the display.

• P4Web now can diff any two files or any two folders. Choose the Diff Two option from the Action menu and specify the desired folders or file revisions.

Bugs fixed in 2008.2

#190006

Always offer browse depot selection in multiuser mode. (Bug #32704)

#188290

Favicon no longer causes unexpected logout. (Bugs #32359, #32393)

#188221

Extraneous characters are no longer added to P4USER and P4CLIENT variables. (Bug #32357)

#186658

All lines are properly numbered when viewing a file. (Bug #31832)

#185786

P4Web no longer requires a client in browse only mode. (Bug #32227)

#164103

Ampersands (&) in URL Jobview strings are replaced with spaces (because P4Web uses ampersands to delimit arguments). (Bug #30519)

#163829

P4Web trims trailing spaces from Back-In-Time browsing values. (Bug #30583)

#163620

On non-Windows systems, if a folder path contains spaces, you cannot resolve that folder interactively, even if you are connected locally.

P4Web no longer tries to interactively resolve all unresolved files in the depot when you choose a folder and run interactive resolve on that folder. Now it tries to resolve only the unresolved files in the folder. (Bug #26084)

#163604

If you enter an invalid client name on the Settings screen, you are now warned that it is invalid. If you then click the Files tab, you are redirected to the Choose Client screen. (If JavaScript is disabled, you are prompted to set your client). (Bug #30543)

#161657

The Javascript menu on the "Interactive resolve was launched for [filename]" screen is now positioned correctly. (Bug #30372)

#161123

Because it is not possible to pass a file path that contains a space to an external interactive resolve on Unix-related platforms (including MacOS and Linux), P4Web foregoes the external resolve and generates the internal interactive resolve screen. (Bug #26084)

#161083

The separators on the Javascript menus have been cleaned up. (No bug number)

#161082

You can now successfully edit the current client using the Javascript menu item. (Bug #30163)

#159341

P4Web no longer confuses a file or directory path containing an @ with the terminating @ delimiting the current state arguments in a URL. (Bug #30061)

#159140

P4Web now correctly terminates each HTTP header line with CRLF (instead of LF) and terminates the header itself with CRLFCRLF (instead of LFLF). (Bug #30049)

#159004

If you attempt to open a file that is synced to #none in your browser, P4Web displays an error message instead of a blank screen. (Bug #29801)

#159000

P4Web now displays the correct line numbers even when your client workspace line endings are not "local". (Bug #29413)

New Functionality in Release 2008.1

• To enable multiple users to connect to P4Web and its Perforce server using their own user name, specify the -M flag. (By default, P4Web connects to the Perforce server using the user name specified when P4Web is launched.) When a user logs into P4Web, the user can specify a client or choose a browse-only option. To view the settings that P4Web is using, display the Information screen.

• P4Web now supports inetd. To enable inetd support, specify the -i command line flag, which means "run for inetd (socket on stdin/stdout)" in the line in the configuration file that invokes P4Web. This flag suppresses all the messages normally printed to the console except for messages triggered by the -v flag. (In a production environment, you are not likely to use the -v and -i flags together. However, you might use them together when debugging.) For the 2008.1 release, -i only works with -b (browse only without authentication).

• You can now override MIME type mappings: the -m command line flag enables you to specify a custom MIME type map file. The custom file is checked before the existing internal table is searched. The environment variable P4WEBMIMEFILE can be used instead of the -m command line flag to specify the custom MIME type map file (unless P4Web is running as a Windows). The custom MIME type map file is a plain text file containing one line per file type extension. Each line must begin with a period followed by the extension, followed by one or more tabs and finally the MIME type string.
  Example MIME type mappings file:

  .h		text/plain
  .c		text/plain
  .C		text/plain
  .cc		text/plain
  .cpp		text/plain
  .java		text/plain
  .pl		text/plain
  .py		text/plain

• For security purposes, you can specify a top level path for remote users' client workspaces, using the new -r flag. Folder names must be terminated with a forward slash or backslash. The -r flag controls the root directory used for clients created by remote users (enabled by the -sD flag).

  The following examples show the use of the -r flag to specify the top level path and illustrates how P4Web enforces the limitation.

  Example 1: -r c:\root\
  

  c:\root		allowed
  c:\root\myclient		allowed
  c:\rooting		not allowed
  c:\windows		not allowed

  Example 2: -r c:\root

  c:\root		allowed
  c:\root\myclient		allowed
  c:\rooting		allowed
  c:\windows		not allowed

  Windows Warning: The backslash character CANNOT be immediately followed by a quote character; doing so confuses the command line parser. If the path to the folder contains spaces, you must enclose the path in quotes of course, but you must also double the backslashes prior to the closing quote.

  Examples:

  -r c:\roots		correct
  -r c:\p4web roots		wrong - needs quotes
  -r "c:\p4web roots"		correct
  -r "c:\p4web roots\"		wrong - needs last backslash doubled
  -r "c:\p4web roots\\"		correct
  -r "c:\\p4web roots\\"		wrong - do not double any other backslash except the one before the trailing quote

• P4Web by default no longer allows remote users to use a client with an empty Host field. To override the default, specify the -sG flag.

• If you are accessing P4Web remotely in Standard mode, P4Web indicates the location of your workspace files as follows:
  • the message "(workspace files are located on remote machine [hostname])" has been added to the File Details header of Revision History, etc.
  • the message "(workspace files are located on remote machine [hostname])" has been added to the Path Browser after the linked path.
  • the word "Remote" is displayed before the phrase "Workspace Tree."

• You can force your browser to download a file (even if it is of type HTML, TXT, etc.) using the Download File from Workspace menu item. This feature, in conjunction with Upload File to Workspace, enables you to edit files when working remotely.

• JavaScript menus replace the dropdown box menus, provide a context menu for most items on list screens, and enable more diffing options for the revisions in the Revision History screen. Changes include the following:

  If you hover your mouse over the diff icon in the heading for the Revision History table, P4Web displays a tooltip that explains how to use the radio buttons and menus to diff any two revisions.

  The Diff and Thumbnails Options CSS mouseOver menus in the toolbar has been converted to JavaScript onClick menus.

  The order of the menu items in the pulldowns for Paths, Files and Jobs has been changed.

  Sync to Head Revisions and Revert Unchanged Files menu items for folders have been added.

• If JavaScript is enabled and you click Open for edit in default changelist or Open for delete in default changelist in the Path Browser toolbar, P4Web displays a JavaScript confirmation dialog.

• If the user enters an invalid client name, P4Web now redirects to the new Choose Client screen, where the user can choose an existing client, create a new client or decide to browse only (using the default client). After successfully choosing an existing client, the user is taken to the Path Browser screen, because the original context (Referrer) has now been lost.

• On the Path Browser screen, P4Web now displays the filetype for files that are open for add.

• To aid scripting, P4Web now returns 1 if it encounters a fatal error while parsing the command line arguments.

• The View Files in Label command has been enhanced with links to the Revision History for each file, plus icons for diffing against the previous revision and viewing the file. If the the page content limit is exceeded, the previous smaller, unlinked version of this page can be accessed using a link at the bottom of the page.

• The file details that are displayed at the top of the Revision History page have been added to the file status pages.

• Alternating-color backgrounds have been added to enhance the readability of Perforce objects pages.

• P4Web now retains the show/hide settings for filter boxes.

• Filters have been added to the Branches, Clients and Users screens. The filters for Submitted Changelist, Labels and Jobs have been enhanced. These filter settings are saved in a browser cookie.

• The text on all the filter Clear buttons has been changed to "Reset Defaults".

• Some of the names of the choices in the filter dropdown for the Depot/Workspace Tree have been changed:
  • "No filter" is now "Files in current path or opened in subfolders"
  • "Hide files in subfolders" is now "Files in current path"

• All of the filters now have a message after the Show/Hide control displaying the current filter (if any).

• If a select box is used as the label for a radio button, the corresponding radio button is selected whenever the select box receives the focus (instead of only when the selected value changes).

• The Branches, Labels, Clients and Users list screens now display both the Updated and the Accessed dates.

• You can now optionally display line numbers when viewing a text file.

• Browse Only commands now generate a permalink at the bottom of their output screens. The link is simplified if possible.

• If a local resolve fails when trying to spawn p4 resolve, P4Web uses the internal interactive resolve.

• The RSS links for the Submitted Changelist and Jobs screens have been moved leftward and up one line.

• The RSS feed for Jobs now has the first 30 or so characters of the description included in the title for each job to help you scan the initial list of jobs in your RSS reader.

• If the Recent Activity toolbar button is inoperable for a given screen, it is no longer displayed on that screen.

• If you send a URL to P4Web that has no arguments enclosed in @s and you have saved the default settings, P4Web applies the default settings (by relocating the URL to a new URL that includes those setting enclosed in @s).

• P4Web now supports *.msi files with the proper MIME type and supports the new Office 2007 Document MIME Types.

  Additionally, the following MIME types have been added to P4Web's internal table of MIME types:

  .h		text/plain
  .c		text/plain
  .C		text/plain
  .cc		text/plain
  .cpp		text/plain
  .java		text/plain
  .pl		text/plain
  .py		text/plain

• The screen title "Edit Client:" is changed to "New Client:" if the spec sent from the server has no Update or Access dates.

• If you enter the name of an existing client when trying to create a new client through the Choose Client screen, P4Web displays a warning screen that enables you to switch to the existing client or try again.

• P4Web now warns you if you try to open for edit or delete all the files under Perforce control.

• The two checkboxes on the Jobs filter now work in tandem (Integrations implies Current Path). If JavaScript is enabled, when you check Integrations, Current Path is automatically checked.

• There is a new "Show P4 command log" checkbox at the bottom of the Settings screen. When checked a list of all the p4 commands run will be displayed at the bottom of each screen.

• Except for Internet Explorer, P4Web uses Courier New instead of Courier for its fixed width font. This enables you to resize the fonts in browsers like Firefox.

• P4Web now servers its RSS feeds with "Content-Type: application/rss+xml".

Bugs fixed in 2008.1

#170393

If you are viewing a folder and select the Revert Unchanged Files menu item, P4Web no longer reverts all files in that folder; it now correctly reverts just the unchanged ones. (Bug #31356)

#161087

P4Web no longer loses the last check box value if both of the last 2 check boxes on the Setting screen are checked when they initially were not checked. (Bug #30285)

#157556

If the incoming URL has no @s in it, P4Web now adds in any saved default settings in the -b (browse without authentication) mode as well as in the modes requiring authentication. (Bug #28209)

#157169

P4Web now once again prints the "Page content limit exceeded" error on the Path Browser screen rather than silently failing. (Bug #29799)

#156055

The "File not found, or file is empty." error message is now displayed if you run "View Workspace File Text" on empty file. (Bug #29608)

#154805

P4Web uses the MSIE only javascript onLoad="document.execCommand('ClearAuthenticationCache')" command to log you out of MSIE version 6 or later. If javascript is disabled in MSIE or the MSIE version is less than 6, you MUST close MSIE to finish the logout process. (Bug #29370)

#151685

To log out when using Opera or Internet Explorer, you must enter an invalid password in the login dialog. (Bug #16809)

#150875

For 2007.2 and later servers, P4Web no longer ignores P4PASSWD. (Bug #28743)

#147179

The P4Web logfile (specified using the -L flag) is now not opened until the connection to the Perforce server port has been established. This change fixes the problem caused by using the -U flag to start as root, then switch to a non-privileged account, which left the log file with root only permissions so it couldn't be written. Side effect of fix: some fatal startup errors are written to stdout but not written to the log file. (Bug #28367)

#147051

If the initial p4 test-for-server-access command fails in -b mode, P4Web tries logging in again using the -P value. (Bug #24247)

#145932

P4Web does not display the Recent Activity and P4 Command Input toggle buttons on pages that are generated following an action that changes the metadata (edit, sync, etc.). (Bug #28141)

#144952

For Jobs RSS feeds, P4Web now escapes < > & and other HTML tag characters in the descriptions of jobs. A job description used in the title of an RSS feed is truncated to 30 characters. (Bug #28122)

#143354

For Full Annotate, P4Web no longer marks all lines as deleted if Back-in-Time Browsing is on. (Bug #27917)

#14334

Full Annotate now ensures that every line is terminated with a line feed. (No Bug#)

#143142

Diffing two revisions of a file now works correctly when Back-in-Time browsing is on. (Bug #27897)

#143139

For Submitted Changelists RSS feeds, MaxResults values less than zero are treated as the same a zero, meaning a value of 125. (Bug #27893)

#143080

If you display a submitted changelist, choose Sync to changelist, click Preview, then choose View Changelist, P4Web now generates the correct URL. (Bug #27882)

#142803

If you are running a remote interactive resolve for a text file and you click the Preview Resolve button and then click the Resolve button on the Preview screen, the built-in interactive resolve is run (P4Web no longer displays a "wrong file type" error). (Bug #27841)

#141284

You can now successfully delete a branch with a colon in its name. (Bug #27498)

#141273

You can now successfully delete a label with a colon in its name. (Bug #27482)

New Functionality in Release 2007.3

• P4Web has a new color scheme and improved format for the display of connection information. (No Job)

• The server:port information is now displayed in the title of the HTML pages generated by P4Web. Additionally, if the page is a file or folder browser page, the current path is used instead of the word "File". These changes make it easier to create meaningful bookmarks and to distinguish multiple P4Web tabs and pages. (SIR #3691)

• Numerous aesthetic enhancements to the P4Web user interface and layout have been made.

• When you switch between Depot View and Workspace View, you are positioned to the same folder if possible. In some cases, (for example, the folder is not synced or you are viewing a folder that resides outside your workspace) the correspondence between the depot and workspace locations cannot be determined. In this case you are positioned to the workspace root. (SIR #12296)

• On pages that display a list of files preceded by a checkbox (for example, the Pending Changelist page), if JavaScript is enabled, a new Select All checkbox is displayed above the file list and the Redisplay checked or unchecked radio buttons are removed. (SIR #23564)

• If you use the Settings page to "Enable page caching", any links you have visited during the current session are displayed in purple rather than blue. Note that "Enable page caching" is only available in browse only modes. (SIR #10924)

• The Settings page has a new checkbox that displays fixes when a job is described. (SIR #12165)

• The Settings page has a new Save as Default checkbox. When you enable Save as Default, the current settings are saved when you click Save and persist across browser sessions. (By default, settings are in effect only during the current browser session.) Note that the settings are saved using cookies, which are browser- and site-specific. (SIR #23982)

• The Settings page has a new Restore Defaults button. Clicking Restore Defaults resets all options (including those set on other pages) to their default values and removes the cookie that contains saved setting from your browser. (SIR #24988)

• The file details for a file can be hidden if JavaScript is enabled by clicking the minus box next to the file path. Also the head revision file size is shown in the header along with more details if the file is open.

• The Path Browser, Submitted Changelists, Labels and Jobs filters are hidden if no filter is set and JavaScript is enabled. The showing and hiding of these filters can be toggled by clicking the plus or minus box next to the filter title.

• The Path Browser, Submitted Changelists and Jobs screens now have a Clear button for their filters. Clicking it instead of the Filter button will restore all the filter settings to their defaults.

• When you set a Jobs filter, the number of jobs to be shown, the fields to be displayed, and the Jobview are all saved in a cookie. This info will be reapplied whenever you display Jobs and no filtering information is found in the URL.

• If the current job filter yields no jobs, P4Web now shows the Filter Form so the you can immediately change the filter without having to go back to the previous screen.

• If you are editing a Pending Changelist and click the Add Job button and then filter the Jobs, that filter will not be remembered the next time you click the Jobs tab - any previous filter will be restored.

• The text labels for checkboxes are now interactive - when you click one, it toggles the checkbox just like clicking directly on the checkbox itself. The text labels for radio buttons are now interactive - when you click one, it selects the radio button just like clicking directly on the radio button itself.

• If there is a radio button or checkbox with a text field or a drop-down associated with it, the corresponding radio button or checkbox will automatically be selected for you when you click in the text field or change the value of the drop-down - provided JavaScript is enabled.

• If you add a file that does not yet exist in the workspace on the P4Web machine, the file type is assumed to be text, even if you specified a different file type when adding the file. A link for changing the file type has been added to the result page that is displayed when you add files.(SIR #25042) You must set the file type before uploading it. (SIR #25042)

• When you connect to P4Web specifying a nonexistent client, you now have the option to create the client or to switch to an existing client. (SIR #24968)

• The message "Change created with file(s)." now includes a link to the changelist.

• If you try to submit a changelist and it fails because one or more files need resolving, the file names are now links to the Revision History page for the file, and the word "resolve" in the error message is a link to the Resolve page for the file. (SIR #24975)
• The Sync page now has a link to a list of available labels that contain files in the current path. (SIR #5536)

• If the output page from running a raw p4 command contains successive lines for the same file (for example, a file is opened for edit on the first line and a message on the second line indicates that another user also has the file open), the subsequent lines begin with an ellipsis (...) to make it clearer that this information pertains to a single file. (SIR #12299)

• Extraneous white space on the Revision History page has been eliminated. (SIR #12788)

• The Head: and Have: revision numbers in the information header for a file are now links to the have and head revisions.

• On the "View - File Revision Text:" screen, each line of the file is enclosed in a <a name="nn" title="nn"> tag where nn is the number of the line (e.g. <a name="37" title="37"> for the 37th line of the file). You can therefore directly link to a specific line in a file by adding a #n to the URL for "View - File Revision Text:" (e.g. http://localhost:8080//depot/main/jam/command.c?ac=64#4 to link to the 4th line of //depot/main/jam/command.c). There is also a <a name="end"> tag after the last line so you can link directly to the end of a file.

  If you hover your mouse over a line, a tooltip will display the line number for that line.

• The "Open head rev in browser" icon has been removed from the toolbar and replaced with the link from the Head: revision number field in the header. (SIR #25238)
• P4Web has a '-U username' command line flag that enables it to be started as root on UNIX platforms and drop its root privileges after binding to its listen address. (SIR #17340)

• P4Web now has a Details listview. Three radio buttons on the toolbar enable you to choose a simple list, a detailed list or thumbnails. When Details has been selected, the File Browser page displays details such as size, last depot change, your change (if any) and other users' changes (if any). If the Details listview is enabled, the Revision History page displays the file size in the header. If the file is open, the Revision History page includes links to the pending changelists in which the file is open. (SIR #20341)

• If the filetype of an opened file has been changed, "(opened as [newfiletype])" is displayed in red after the have revision filetype on both the Path Browser screens and the File Browser header.

• Label descriptions on the Labels page are now truncated to 4000 bytes. (SIR #18607)

• In the Pending Changelist page, the dropdown list that enables you to move files to another changelist now includes the first 30 characters of the changelist description. (SIR #5537)

• The AltRoots field in the Client Edit Spec has been reduced to two lines. (SIR #9239)

• Pending Changelists now display two icons in front of most files in the changelist. Clicking the first icon enables you to edit the text in the file. Clicking the second icon diffs the synced revision against the head revision. The edit icon is not displayed for binary or deleted files. The diff icon is not displayed for added or deleted files. (SIR #24667, #24763)

• Submitted Changelists now display two icons in front of most files in the changelist. Clicking the first icon displays the text of that file revision. Clicking the second icon diffs the revision with its preceding revision. The view icon is not displayed for binary or deleted files. The diff icon is not displayed for added or deleted files. (SIR #009964)

• P4Web now uses cache-control for the icons. Icons are read a maximum of once a day, unless you clear your cache or click Refresh. (SIR #15364)

• A new command line flag (-T) enables you to specify the tabs that are displayed along the top row of each P4Web pane. By default, all tabs are displayed. To specify tabs, specify the first letter of the each of the desired tabs. If you omit the Files tab, the first tab you specify is the initially-activated tab that is displayed in your browser. The Setting tab is always displayed and cannot be hidden.

  Example: p4web -T fps displays the Files, Pending and Submitted Changelist tabs.

  An additional, previously hidden tab might be displayed, if it is linked from some other page. For example, -Tf displays the Submitted Changelist tab if you click a changelist number on the Revision History page. When you click on the Files tab, the Submitted Changelist tab is hidden again. (SIR #19372)

• The P4WEBLOG environment variable can now be used with both P4Web running as a service and with normal P4Web execution.

• P4Web now automatically wraps long changelist descriptions. (SIR #12792, #23396)

• The Information (About) page now displays the flags specified when P4Web was started. (SIR #24518)

• When running P4Web as a Windows service, you can set its command-line flags using the registry. To do so, edit the HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Perforce Web\Parameters\P4WEBSERVICEFLAGS registry entry
  entry and set its value to the same values you would use on the command line.

  Note: You must specify the P4PORT and P4USER values in the registry setting. If you omit them, P4Webs crashes when attempting to start. (SIR #24554)

• P4Web has a large number of security enhancements, especially for remote users (users whose browser is running on a different machine than the machine where P4Web is running). To enable these security enhancements, specify the desired settings using the new -s flag, as described in the P4Web help topic Administering P4Web.

• An Edit Workspace File in Browser option has been added to the command drop down list in the Revision History pane. This option enables you to edit the file in the browser and save it to the local machine. (SIR #23518, #11446)

• To download a file to a remote system, option-click the "Open file in browser" Workspace file name link. (SIR #18647)

• You can now upload a binary file to your workspace using a browser that is running on a remote computer. The file in your workspace must be open for edit or add. Choose Upload Workspace File From Browser and click Go. On the subsequent page, browse to to the file you want to upload. Click Submit and the file is uploaded to your workspace. (SIR #23519)

• If your browser is on a different computer than P4Web, you can now resolve text files interactively. P4Web displays a page with a edit box containing the merged file, complete with conflict markers. Edit the file to remove the conflicts, then click Accept Merged, or click Accept Yours or Accept Theirs. (SIR #8412)

Bugs fixed in 2007.3

#154576

Removed an poorly coded assert because it causes problems on old version of Win/XP when using a client with a NULL root. (Bug #29179)

#144667

P4Web now adds the &cl=[client] argument to the URL for showing the #have revision in the File Browser header. (Bug #28093)

#142085

When diffing files, P4Web attempts to recognize inconsistent line endings. It prints an error message if it thinks it has detected inconsistent line endings giving the line number of the last such instance. This is important because inconsistent line endings can often lead to questionable results. (Bug #27595)

#142084

P4Web no longer fails to escape characters special to urls for the Jobs listing screen. Bug #27601)

#140259

The "Sync to head revisions" toolbar button now displays the results of running the command. (Bug #27364)

#140251

The WMV mime definition has been added to P4Web so that WMV files are now handled correctly by Internet Explorer. (Bug #27354)

#138973

You can no longer turn on "Enable page caching" on the Setting screen when you are in read/write mode because it can result in stale result pages being displayed. (Bug #27129)

#138936

"View - workspace file text" now works in Workspace mode even if the file is not in the depot and not open for add. (Bug #27127)

#138399

If a user enters nothing in the browser's login dialog, p4web will immediately redisplay that dialog with no further processing. (Bug #27012)

#136624

If you attempt to use global options when running a raw P4 command, you will get the following error message: "Error: You can not use global options with P4 commands within P4Web. See P4Web help for more information." (Bug #20709)

#136113

The P4Web Log File in now cloned for each new thread. This prevent potential concurrency problems when under a heavy load. (Bug #26370)

#135961

If you attempt to locally edit a file that is open for edit but doesn't actually exist on the P4Web machine (e.g. you are using a different client, you deleted the file outside of Perforce), then the editor will start (with an empty file) as always, but now you will get the following warning as well: "Warning: This file does not exist on the local system where P4Web is running." (Bug #26313)

#133376

The Help link for Jobs > JobNumber > Add job to pending changelist is now valid. (Bug #25940)

#129805

Several memory leaks and crashes due to malformed URLs have been fixed. (Bug #25353)

#128932

The page heading "View - Head Revision Text" has been changed to "View - File Revision Text" since it is used for viewing other revisions as well as the head revision. The Revision number is now always given for the head revision when you chose "View - head rev text" from the drop-down menu. (Bug #25247)

#127628

P4Web now displays the correct icon for unopened, unsynced files when you filter by unsynced files. (Bug #25106)

#127468

The layout when filtering the Path Browser by unsynced files has been corrected. (Bug #25109)

#127381

If you are filtering in the Path Browser and no files are found that meet the filter conditions, more information from the Perforce server will be display if it is available. (Bug #25004)

#124869

A warning message is now generated if you try to add a file that is already under Perforce control. (Bug #25048)

#124591

P4Web now uses yyyy/mm/dd format is describing a changelist and in RSS feed descriptions. This date format is now used everywhere in P4Web. (Bug #25009)

#124590

If you try to connect to an invalid host or port, the P4Web error message in now properly formatted. (Bug #25012)

#123945

The Job Fixes page now shows all the fields for the Job, not just the first five. (Bug #25235)

#123271

Browse with authorization (-B) now has a logout button. Browse without authorization (-b) continues to not have a logout button. (Bug #24773)

#121975

P4Web prevents remote users from sending a raw p4 command that contains both -i and -o. (Bug #23976)

New Functionality in Release 2007.2

• P4Web now displays image thumbnails for graphic files in the depot. (SIR #21728)

• P4Web now displays a two-pane diff if the P4DIFF environment variable is not set or the browser is not running on the same machine as P4Web. (SIR #11526 and #23650)

• P4Web now supports the https protocol. If you start P4Web with the -ss flag, all links generated in a P4Web page are https links. For details, refer to Administering P4Web.

• To log all requests sent to P4Web, specify the "-L logfilename" command line flag when you launch P4Web. The IP address of the originator and the HTTP header are always logged. If the user passes authentication, the P4 user and client are also logged; otherwise P4Web logs a message indicating that the command was not run.

  When running in https mode, the originator (From: field) logged is the machine where the https wrapper (stunnel) is running, probably 127.0.0.1. To log the actual originator in https mode, use the https wrapper's logging function. (SIR #8913)

• P4Web supports the new "p4 change -u" flag that allows you to edit the Description and/or Jobs for a submitted changelist if you own that changelist.

• P4Web supports the new +Sn (n >= 1, n <= 512) filetype modifier. (SIR #24066)

• P4Web supports the new utf16 filetype. (SIR #24246)

• The "expired ticket/invalid password" error message is more concise.(SIR #23923)

• The Workspace: ("Open file in browser") file name link once again works correctly. Because modern browsers do not allow reading files from your local hard disk (except for file:// URLs), this link now sends a request back to P4Web to read the file. P4Web displays a temporary copy of the file, not the actual file itself. If you edit this file and save it, be sure to use "Save As" and specify the correct folder.

  For security reasons, this link is not available unless P4Web and your browser are running on the same machine. (SIR #18647)

• P4Web assumes "*" if the Filter Files By Field is blank. (SIR #23563)

• If JavaScript is enabled, P4Web now has a Remove All Jobs button on the Pending Changelist Submit form.

  Note: After clicking the Remove All Jobs button, you might not be able to use your browser's Refresh function to restore the jobs. In this case, click in the Location/Address/URL field and press Enter. (SIR #23520)

• The Settings pane has been redesigned to make it more visually appealing. (SIR #23514)

• P4Web now displays files in the current folder that match the "Files matching:" pattern when you include subfolders. (SIR #23537)

• P4Web displays a favicon.ico for most browsers. You can configure the icon. For details, refer to Administering P4Web. (SIR #14814)

• P4Web now automatically logs you in when you restart your browser, if you have a valid ticket and your browser and P4Web are running on the same machine.

  To store the settings, P4Web creates a cookie. The cookie name contains the port number, preceded by "P4W." The host name and user are stored in the cookie. These cookies expire after seven days. (SIR #22284)

• You can run the P4Web service in local mode, so that it accepts requests only from the machine where it is running. To run P4Web in local mode, set the environment variable P4WEBLOCALONLY to 1 before starting the service, by issuing the following command:
    p4 set -S "Perforce Web" P4WEBLOCALONLY=-l
  (SIR #22115)

• P4Web now uses cache-control for most icons. The cached icons are read once a day at the most (unless you clear your cache, of course). (SIR #15364)

• You can directly link to a specific revision of a file using the following syntax:

  Using a Revision number:
  http://localhost:8080//depot/folder/filename.ext?rev=12
  where
    //depot/folder/filename.ext is the full depot path to the desired file
    12 is the revision number

  Using a Changelist, Client, Label, Date:
  http://localhost:8080//depot/folder/filename.ext@revspec where
    //depot/folder/filename.ext is the full depot path to the desired file
    revspec is the changelist number, client name, label name or date in yyyy/mm/dd:hh:mm:ss format

  Examples:
  http://win-mrp4:8080//depot/s/BranchView.cpp@5826
  http://win-mrp4:8080//depot/s/BranchView.cpp?rev=54
  

  Note: for versions prior to 2007.2, you can also use the above EXCEPT you must type "?rev1=" rather than "?rev=" prior to the revision number. Both "rev=" and "?rev1=" work for 2007.2 and later versions of P4Web. (SIR #11036)

• P4Web action codes are now documented in the online help. (SIR #4505)

Bugs fixed in 2007.2

#138750

P4Web no longer crashes if you request Perforce Info and the broker is part of your connection. (Bug #27067)

#137222

P4Web no longer experiences intermittent slowdowns on some Windows systems. (Bug #25526)

#131881

If P4Web detects a fatal error condition due to a catastrophic fstat failure, it now displays a helpful diagnostic message before crashing. Unfortunately, the error is so severe that there is no way to recover; furthermore P4Web will need to be restarted after the error condition (e.g.non-writable HOME directory) has been fixed. This problem will occur if the p4 tickets file cannot be successfully written. (Bug #25691)

#131028

The -L output is now correct if the URL contain a % character. The "%" was being lost and it appeared as though the URL was being corrupted and causing problems. But only the displayed output was wrong - the internal URL was always correct. (Bug #25523)

#127836

If the first or last line of a file is added or changed, the P4Web diff output is now correct. (Bug #25112, #25115)

#127763

In the 2 pane diff, if a change is followed one line later by an add, the output is now correct. (Bug #25146)

#124294

P4Web diff now correctly handles a diff in the last line of a file. (Bug #24986)

#124203

P4Web no longer crashes if you give a raw P4 command more than 125 arguments. P4Web displays an error message and the command is not run. (Bug #24969)

#124202

The Redisplay button on Pending Changelists has been moved below the list of files (rather than just above that list) to ensure correct display if the changelist exceeds the page content limit. (Bug #24977)

#123153

In the Jobs list, descriptions containing right or left carets are now displayed correctly. (Bug #24843)

#123143

The two-pane diff now correctly handles the case where a block of text is inserted at the beginning of a file. (Bug #24840)

#123271

Browser with authorization (-B) now has a logout button. Browse without authorization (-b) continues to omit the logout button. (Bug #24773)

#122294

The revision numbers have been reversed in the Diff2 revisions icon's alt-text and the corresponding Diff header so they now match the diff2 command that was run. (Bug #24677)

#112921

Memory leak fixed. (Bug #23779)

#114494

Security has been improved by running p4 login on all commands that come from a browser on a different machine than P4Web, if login is required and the server is version 2004.1 or higher. (Bug #17022)

#116178

P4Web no longer crashes if there is no POST data when processing a raw p4 command. (Bug #23800)

#116368

For security purposes, the client's Root, AltRoots and Owner fields are read-only when editing a client using a browser that is not running on the same computer as P4Web. (No Job)

#116437

If connected to a Unicode server, P4Web now passes the -C value when spawning p4 resolve. (Bug #23859)

#116533

P4Web no longer enables the current user to use a workspace owned by another user if the browser is not on the same computer as P4Web. This restriction does not apply to P4Web browse-only instances (-b and -B flags) of course. (No Job)

#116573

If an interactive resolve fails because the DISPLAY environment variable is not set, P4Web displays an error message instead of going into an infinite loop. (Bug #23871)

#116611

P4Web no longer allows remote users to use or edit a workspace that has a root that is the same as P4Web's current working directory. This fix prevents someone from switching to an non-existent client name and then editing it, thereby gaining access outside of the union of their own client roots. (Bug #23881)

#116767

For security purposes, a remote user cannot change a file's Perforce filetype to symlink. (Bug #23896)

#116952

Right and left carets and the pipe symbol are no longer allowed in raw p4 command strings. (Bug #23933)

#119313

The URL "http://localhost:8080/?ac=20" no longer causes P4Web to spawn a thread that hangs. (Bug #23972)

#119325

You cannot use the raw p4 print command with wild cards in P4Web. (Bug #23974)

#119338

You cannot use a remote connection to run a raw p4 reopen command and change a file into a symlink. (Bug #24010)

#119453

P4Web now displays the new "Senseless juxtaposition of wild cards" message from the server. (Bug #24036)

#119454

P4Web no long mixes raw output from running raw p4 commands with HTML tags if an error occurs. (Bug #23932)

#119526

In browse-only mode, the (non-functioning) Edit button at the bottom of specification forms has been removed. (Bug #24267)

#119844

The RSS 2.0 feed on the Jobs pane now includes the visible fields that you have filtered for. (Bug #24309)

New Functionality in Release 2006.2

• P4Web now has a logout icon to the right of the cancel icon.

  When you click the logout icon, you are now presented with an "instructions" screen that uses the META Refresh tag to automatically fire off the logout command. There is a link in the "instructions" screen in case a browser does not support META Refresh. (SIR #21643)

• P4Web supports the p4 submit -f flag for 2006.2+ servers.
  P4Web supports the p4 submit -R (revert unchanged files) flag for 2006.1 servers.
  There is a new drop-down field next to the Submit button on the submit form to provide the interface to this functionality. (No Job)

• P4Web's "P4 command input" feature now supports "groups" and "reviews". (SIR #20637)

• P4Web now documents what flags are being used for the integration options. This should make it easier to know what option the server is talking about when it gives an error message like "-d required." (SIR #12147)

Bugs fixed in 2006.2

#114681

P4Web no longer crashes if given an invalid P4CHARSET value. (Bug #23554)

#113840

The P4Web logout button is not available when P4Web is run in browse only mode (-b or -B). (Bug #23421)

#112223

The environment variable P4WEBROBOTS can be used to point to any file in the depot to user for robots.txt requests. It must point to a file using depot syntax. If it is not set, the path used is //depot/robots.txt. (Bug #23232)

#112192

The link for the header on the RSS changelist page now contains the path information. (Bug #23206)

#110792

The toolbar icons in P4Web have been padded with additional space and also have had separators added where appropriate. (Bug #22876)

#110429

The environment variable P4WEBRSSAUTHOR can be used to set the <author> field of a P4Web RSS feed.

By default, P4Web outputs the user@client (changes) or user (jobs) as the author. However the RFC 822 standard indicates that the <author> field should contain a valid email address. However getting the associated user's email address would entail running p4 users for every RSS request doubling the load on the server. To avoid this extra overhead, the user@client or user is output as the author - but this is not valid and causes problems with some RSS readers.

Therefore the new environment variable P4WEBRSSAUTHOR can be used to force a valid email address into the author field. Set P4WEBRSSAUTHOR to the email of the person responsible for the P4Web instance. If P4WEBRSSAUTHOR is not set, P4Web displays user@client and user. (Bug #22216)

#110290

The Jobs RSS feed dates have been changed to RFC 822 standard.
for example <pubDate>Fri, 2006/09/15 08:19:53 EDT</pubDate>
has become <pubDate>Fri, 15 Sep 2006 08:19:53 EDT</pubDate> (Bug #22215)

#106746

P4Web now returns the 200 OK response for its RSS feeds. (Bug #21808)

#106661

P4Web now correctly displays the Workspace Mode for clients with top level roots (e.g. / or C:\). (Bug #21980)

#105426

When a user describes a changelist from the Fixes portion of a Job and the changelist is discovered to be a pending change, P4Web adds a "Status: pending" line to the output. If not in browse only mode, P4Web makes the word "pending" clickable so it takes you to the editable version of the changelist under the Pending tab. (Bug #15069)

#105391

P4Web no longer offers to let you change your password in authenticated viewer mode (-B). If you attempt to use an instance of P4Web running in -B mode and enter a wrong password, you should click the Logout icon and then try logging in again. (Bug #21871)

#105150

If the maximum number of submitted changelists is not provided when generating an RSS feed for Submitted Changelists, a maximum of 125 is used. This prevents buffer overflow and crashing of P4Web. (Bug #21846)

#104900

P4Web now runs "p4 login" whenever it needs to authenticate user & password for a server that supports the login command. (Bug #21625)

#104792

File tab Filter -> "Changed Unopened Files" now works correctly. (Bug #20792)

#104702

P4Web no longer fills in Select Fields that are not required; it generates a blank choice and sets the initial selection to that. (Bug #19470)

#104693

"[Click here for job field descriptions]" in the Job Edit Form no longer wraps. (No Job)

#104576

P4Web now correctly generates the <'?xml version=\"1.0\" encoding=\"ISO-8859-1\"?> header for its RSS feeds. (Bug #21811)

#104520

P4Web now generates the <meta http-equiv="content-type" content="text/html; charset=UTF-8"/> header element when the charset is Unicode. (Bug #18118)

#104518

File tab Filter -> "Opened Unchanged Files" now works correctly. (Bug #20791)

#104517

Files tab -> "Files missing from workspace" now works correctly. (Bug #20793)

#104516

The "Unsynced files" filter now correctly shows the files that need syncing. (Bug #20794)

#104486

When a file whose filetype includes +l is already opened, P4Web now displays the icon with a lock sub-icon (badge). (Bug #20999)

#104368

In certain cases, P4Web would generate an invalid URL and hence invalid XML for its RSS feeds. This has been fixed. (Bug #21792)

#103516

When you set a filter in the Files view of p4web, subfolders that do not contain files matching the filter are no longer displayed. (Bug #18121)

#103507

The P4Web help page "P4Web User Guide - Using the File view" has been cleaned up so that the icons are displayed and the links work. (Bug #20706)

#103446

Using 'View Changelist' from the 'Sync to Changelist' pane now works correctly. (Bug #18826)

#103420

P4Web now correctly handles a malformed "p4 command input" that ends in a / character. (Bug #20638)

New Functionality in Release 2006.1

• P4Web supports raw commands via the new "P4" command icon or as a URL input. Raw command functionality is restricted appropriately in Browser mode and for commands requiring the "-o" flag. See P4Web Help for more details on the implementation and restrictions of this new functionality. (SIR#4686)

• Really Simple Syndication (RSS 2.0) functionality has been implemented for the Submitted Changelist/Jobs tabs and User Reviews/JobView fields. Filter Submitted changelists and Jobs then click on the "XML" button to generate a custom feed. Multiple RSS feeds for different configurations of filters can be generated. See P4Web Help for more details on the implementation of this new functionality.

Bugs fixed in 2006.1

#92242

Added support for old filetype names. (Bug #19129)

#91956

The number of lines shown in the Jobs pane "Visible fields:" selection box has been increased. This prevents the scrollbar from disappearing on some browsers. (Bug #19827)

New Functionality in Release 2005.2

• P4Web in unauthenticated viewer mode (-b) can now be run as a service when security is greater than zero. Follow these steps to enable this functionality:
  1. On the Windows system where P4Web is installed, set the registry variable

     HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\PerforceWeb\Parameters\P4TICKETS

     to the location of the ticket file created by p4 login - for example

     C:\Documents and Settings\johndoe\p4tickets.txt

  2. Execute the command 'p4 -u guest login' and start the P4Web Service. Or, reverse the order and start the P4Web Service and invoke 'p4 -u guest login'. (SIR #17085)

• Adding a Job Fix to a Pending Changelist in P4Web is more intuitive. An "Add Job Fix" button is now available when editing a job. Clicking it will present a list of jobs; select one and a new changelist specification form will appear with the chosen jobname in the Jobs field. The "Update Changelist" button must be clicked to finish adding the job. (SIR #15067)

• Jobs can now be linked to Submitted changelists. The option "add fix to changelist..." has been added to the dropdown menu present while viewing a submitted changelist. If selected a list of jobs will be displayed. Choosing a listed job will refresh the screen and place the selected job under the submitted changelists Jobs field. Click the "Add Jobs" button to finishing linking the job to a submitted changelist. (SIR #15067, #15182)

• There is a new menu icon on the FileLog pane: "Open head rev in browser". This performs the same functionality as "Open head rev in browser" in the drop-down list. (SIR #15255)

• In the Jobs pane the default number of jobs displayed is now 25.

• View Tabs function with various sized fonts. Now there is no fixed width for these Tabs and wrapping has disappeared.

• P4Web now translates the URL http://www.hostname.com:8080/robots.txt as //depot/robots.txt. This change enables bots crawling websites served by P4Web to always locate robots.txt in the same location, regardless of the P4Web instance. To function properly there must be a depot named "depot" in the Perforce Server targeted by P4Web. The client workspace used by P4Web must also include the view //depot/robots.txt. (SIR #18727)

Bugs fixed in 2005.2

#83156

MS Internet Explorer and Mozilla based browsers (e.g. Firefox, Mozilla, Netscape) block file:// URLs from P4Web (for security reasons file:// URLs are blocked unless the HTML page is on a local file system). This causes the Workspace: link in the Revision History to no longer work when clicked.

To workaround this restriction right click the Workspace: link and Copy Shortcut to the clipboard. Then press F6 and Ctrl+V to paste the copied Shortcut into the Address field and press Enter to view the local file.

New Functionality in Release 2005.1

• P4Web may now run against a unicode server.

Bugs fixed in 2005.1

#77384

P4Web run as a Windows service now honors the P4MERGE services registry entry to launch the specified program from an interactive resolve when the "merge" option is chosen. (Bug #17137)

#75136

P4Web run as a Windows service now supports interactive resolve. (Bug #16226, #16263)

#74762

URLs containing leading spaces are now handled correctly by P4Web. Specifically any relative links (such as Revision History) containing leading spaces will not lose the leading space when expanded to its full URL. (Bug #16510)

#74328

P4Web in Standard Mode will no longer honor P4PASSWD when run against a secure (4.2+) server with a security level < 2. (Bug #16477)

#72370

P4Web is now able to operate with a unicode server (Bug #4455, #15992)

#72269

The workspace file link on the File State page is now always displayed when in workspace mode even when the file is not in the depot. (Bug #16074)

#70471

Now more than one P4Web service can be run simultaneously on the same machine. (Bug #15687, #15690)

New Functionality in Release 2004.2

• P4Web may now be run as a Windows service.

• P4Web supports the new security features of 2004.2+ servers.

• P4Web has better diff support. Specifically, it will honor the P4Diff flag and launch the specified executable. Also, all supported diff options are now available from the Settings page.

• P4Web now has an input field for quick navigation to a new path from any page.

• All pages allowing the user to change file type have a select box with checkboxes and radio buttons to allow the user to select from all supported file types.

• Filter options on the Workspace Tree page have been expanded to match the set of filters available for the Depot Tree.

Bugs fixed in 2004.2

#62920

The Description field text of the Label, Client and Branch Specification pages render using original formatting instead of being wrapped to fit the size of the table fields. (Bug #14635)

#61155

The sub-navigation menus from the Integrate Using Branch and Sync Workspace to Label pages now work correctly. (No job)

#61152

P4Web no longer crashes when clicking on a link to a label, branch, client, user or job name which has a leading '/'. (Bug #14513)

#59844

The Description field of the Submitted Changelists page now shows the full text of the description. (Bug #13683, #8184)

#59606

The Open for Edit and Change Filetype pages now show the type of the file(s) at the head revision. The Change Filetype page will also show the opened type if that differs from the head type. (Bug #12144)

#59396

Now all filters on the Depot Tree page honor the "Show only files in client view" setting. (Bug #14100, #14348)

#59313

The Change Filetype page now has a select drop-down menu, checkboxes and radio buttons to allow the user to select from any of the supported filetypes, modifiers and format revisions. This set of options is also available from the Open for Edit and Open for Add pages. (Bug #3342, #12143, #12327)

#58882

The Depot/Workspace Tree pages have a checkbox to include subfolders in the Files Matching pattern. (Bug #14099)

#58333

The Settings page now has an option to allow the user to configure the diff output format used for all diff and diff2 commands used by the current P4Web session. (Bug #8448)

#58187

Some Filter options for the Workspace/Depot Tree pages have been re-worded. Specifically:

Old wording:	New wording:
Current path files and open files	No filter
Current path files	Hide files in subfolders
Open files	Opened files
Open files - all clients	Opened files - all clients
Open unchanged files	Opened unchanged files

(Bug #14100)

#58171

The Filter options on the Workspace Tree page now match the Filter options on the Depot Tree page. Although these pages are now consistent with each other, Workspace Tree will never show files opened for delete as these files do not exist in the workspace. (Bug #12069)

#58058

The Files Matching pattern will "stick" until it is unset from either the Tree Filter form or the Submitted Changelists form. (Bug #12149)

#58023

P4Web has an input field for quick navigation to a new path from any page. (Bug #13682, #12784)

#57898

P4Web can handle filenames with '@#%*' characters if the server is 2004.2 or later. (No job)

#56746

P4Web now honors the P4DIFF and P4MERGE environment variables, and will launch external applications specified by these environment variables if the browser and P4Web are running on the same machine. (Bug #5307, #6052)

#56241

P4Web now uses 'p4 login' internally to handle authentication if the server is 2004.2 or later. (No Job)

#55599

P4Web may now be run as a service on Windows machines. (Bug #8425)

Minor New Functionality in Release 2003.2

• P4Web has a new look! The page layout and menu organization have undergone an overhaul to improve usability. Icons, menu organization and tool bars are now more consistent with the other Perforce graphical user interfaces.

• P4Web has extended support for diff to allow line endings to be ignored. This support is only available with 2003.2+ Perforce Servers.

• P4Web has extended support for integration when used with 2003.2+ Perforce Servers. Specifically, P4Web provides options for re-branching source over deleted targets, and for deleting modified targets if source files were deleted.

• All Preview result pages have a button at the bottom to allow the user to perform the previewed action. This capability exists for Sync, Remove from Workspace, Add/Replace files in Label, Revert, Resolve and Integrate pages.

• The P4Web Settings page provides the capability to change or set the current user's password.

• The "View Fixes" page has been retired. "View Changelist" now incorporates the changelist and fixes onto one page.

• P4Web now incorporates server, P4Web and browser information on one Information page.

• When used with JavaScript-enabled browsers, P4Web does not require button activation to select items from the sub-navigation menus.

Bugs fixed in 2003.2

#64799

P4Web is more robust when parsing invalid URLs. Specifically, if a request requires form data, P4Web should no longer crash if form data does not exist. This scenario can only occur if the user manually enters random values into the URLs. (Bug #14963)

2003.2/60355

#60355

The P4Web Viewer no longer crashes when trying to change configuration settings. (Bug #14464)

2003.2/54243

#54233

The Submitted Changelists page no longer erroneously displays pending numbered changelists in addition to submitted changelists when the current path is //. (Bug #13465)

2003.2/53528

#53516

The result page from the "Sync to Head" shortcut no longer displays the title "Unknown Command Status". (Bug #13272)

#53513

Changelist descriptions are now displayed using a fixed-width font instead of a variable-width font so that any columnar data will line up correctly. (Bug #12981)

#53510

Hyperlinks from P4Web containing colons are no longer incorrectly truncated. (Bug #13135)

#53503

P4Web now correctly generates links to files and directories which contain high-order ASCII characters. (Bug #13296, #4582)

2003.2/51929

#51653

All fields of the Job Specification page now use the same font. In previous 03.2 beta releases, the font used to display the Description field differed from the rest of the fields on the page. (Bug #12921)

#51641

All text fields in the Job Specification page now have their original formatting preserved. Previously word wrapping and and paragraph filling were enabled in all text fields except for fields 105 (Description), 115 and 117. (Bug #12833)

#51547

Now http URLs embedded in the Description fields of changelists and jobs are treated as hyperlinks. (Bug #10850, #12790)

2003.2/51425

#51423

P4Web now properly displays an error on the Depot Tree View when the user does not enter the correct password. This bug was only present in the 03.2 beta version of P4Web. (Bug #12846)

#51403

The ability to view changed unopened files has been restored to the 03.2 release of P4Web. This menu option was missing only from the 03.2 beta version of P4Web. Now this menu option is in the File Filter of the Depot Tree View. (Bug #12832)

2003.2/51318

#50688

The Sync to Head menu items have been removed from the Depot Tree and File View submenus because it was too easy to accidentally sync when using a JavaScript-enabled browser. Now users can still easily perform that task using the "Sync..." menu option or the Sync toolbar button. (Bug #12568)

2003.2/50527

#50163

Job names with embedded spaces are now handled correctly. (Bug #11876)

#49877

The User Specification page now has an Edit button when displaying the specification for the current user. The Client Specification page also has an Edit button when displaying the specification for the current client. (Bug #7218, #12298)

#49871

P4Web no longer crashes or shows incorrect results when trying to access a label, branch, job, changelist, user or client in workspace mode when the entity's name matches a root directory on the machine running P4Web. (Bug #12321)

#48925

P4Web now generates Revision History on files in workspace mode by default if the file is in the depot. (Bug #12003)

#48527

P4Web no longer ignores the "use integrated changelists" option when filtering submitted changelists by user or client. (Bug #11892)

#48508

P4Web's Setting page now allows the user to enable the browser to cache its pages. (Bug #11860)

#48389

P4Web now uses icons and toolbar buttons which are more consistent with the other Perforce graphical user interfaces. (Bug #5220, #7030, #11468)

#47240

Button placement has been improved. The buttons on the sub-navigation menus are displayed as expected (to the right of the select menus). Buttons on forms are displayed at the bottom of the page. (Bug #3422)

#47023

The Depot View (formerly Path Browser) page now displays a file filter. This filter may be used to set various options previously available only via the Settings page (such as Show deleted files). Also, this filter is used to select a subset of files from the current directory (such as unsynced files, opened files, etc). (Bug #9463, #10289)

#46922

The Revision History (formerly File Browser) page now displays its links in a less confusing manner. (Bug #11794)

#46149

The Run, Show and Goto menus in P4Web have been replaced by a new menu structure. The main categories roughly match those used by P4Win and P4V, and are implemented as tabs. Each tab may have additional sub-navigation selection menus as needed. (Bug #3419, #4427, #4441, #11468, #10289)

#45686

P4Web's Information pane at the top of each page now incorporates the current path, links to edit the current client and current user, and a link to a new Information page. (Bug #10286, #11468)

#45126

Launching the editor from P4Web would cause the browser to hang (i.e. not finish painting the page) until the editor exited. This has been fixed. (Bug #11221)

#45067

P4Web no longer elicits "too many rows scanned" errors at the top of a depot tree display with extremely large depots. (Bug #9099, #9252)

Minor New Functionality in Release 2003.1

• The new Cancel button can be used to stop execution of the operation currently being processed by P4Web. With a Perforce Server at Release 2003.1 or later, Cancel will also halt server-side processing of the operation.

Bugs fixed in 2003.1

2003.1/48236

#48236

P4Web no longer crashes upon startup on Cygwin 1.3.2. (Bug #10274)

2003.1/47811

#47811

P4Web no longer crashes when trying to display a page that only contains an error message. (Bug #11767)

2003.1/44445

#43851

Documentation for installing P4Web on Mac OS 10.x has been clarified. (Bug #10466, #10939)

#43850

P4Web now always sends at least the HTTP status header line for every page it renders. (Bug #10661, #10898)

#43825

P4web now supports spec formatting changes internal to the 2003.1+ Perforce Server.

#43755

P4Web now provides the capability to stop a Perforce Server command when used with 2003.1+ Perforce Servers. (Bug #4548)

2003.1/42601

#42538

Tooltips on the file state icons and shortcut buttons now work correctly for all supported browsers and platforms except for Opera 5.0 on Linux. (Bug #7803, #10661)

Major New Functionality in Release 2002.2

• P4Web supports multiple client roots when used with 2002.2+ Perforce Servers. This support allows for access to client roots through multiple UNIX paths (using symlinks, or varying NFS mount points).

• P4Web has two new options for displaying annotated file text when used with 2002.2+ Perforce Servers. The "Show Annotated file text" page displays each line of a files head revision with the line number where it was introduced. The "Show Fully annotated file text" page also displays deleted lines, and shows the range of revisions for each line.

• P4Web has extended support for integration when used with 2002.2+ Perforce Servers. Specifically, P4Web allows you to use indirect integration history when seeking the base for merging. Formerly both source and target had to be directly related by branching.

• P4Web has extended support for diff and resolve to allow whitespace and whitespace-only changes to be ignored. This support is only available with 2002.2+ Perforce Servers.

Bugs fixed in 2002.2

2002.2/42083

#42083

The Branch or Integrate page no longer provides an option to use indirect history to determine the base for merging. Now this option is only available by using branch with the 'indirect' option set.

2002.2/38427

#38012

Documentation regarding browsers supported by P4Web has been clarified. (Bug #9480)

2002.2/37867

#37867

P4Web now renders the Recent Activity pane more quickly when users are viewing the root directory. (Bug #9499)

2002.2/37442

#37097

P4Web now correctly renders content based on mime type for compiled html help files on Microsoft Internet Explorer. (Bug #9397)

2002.2/36727

#36648

P4Web now correctly renders content based on mime type for MS Word template files. (Bug #8961)

2002.2/36307

#36213

The Revert page from the path browser now has a Preview Revert button. This functionality is only available for 2002.2+ Perforce Servers. (Bug #9154)

#36211

P4Web now issues an error if the user tries to go to workspace mode while using a null client root. (Bug #7941)

#36209

P4Web now supports the "p4 annotate" command to show file text with revision information per line. This functionality is only available for 2002.2+ Perforce Servers. (Bug #9141)

#36188

P4Web now allows users to perform diffs and resolves using the new Ignore Whitespace options. This functionality is only available for 2002.2+ Perforce Servers. (Bug #9143, #9144)

#36120

P4Web allows the user to specify the indirect option when creating or editing a branch spec. This option provides the ability to use indirect integration history for determining the base for merging. This functionality is only available for 2002.2+ Perforce Servers. (Bug #9126)

#36111

P4Web provides an option on the Branch or Integrate page for the integrate -i option. Specifically, this option supports using indirect integration history to determine the base for merging. This functionality is only available for 2002.2+ Perforce Servers. (Bug #9125)

#36106

P4Web now provides support for multiple client roots. This functionality is only available for 2002.2+ Perforce Servers. (Bug #9108)

Major New Functionality in Release 2002.1

• P4Web supports jobs. Functionality includes the ability to list jobs (including the ability to filter and select visible fields), to display job details, to create/edit/delete jobs, and to display job fixes.

• P4Web has extended support for labels. In addition to listing labels and displaying their details, functionality includes the ability to list files currently in the label, to create/edit/delete labels, to run labelsync, and to sync a workspace to a label.

• P4Web has extended support for branches. In addition to listing branch specs and displaying their details, functionality includes the ability to create/edit/delete branch specs, to integrate using a branch spec, and to compare file contents branched through a branch spec.

• Additional Browser support. P4Web supports Opera, iCab, and Mozilla 5.x Browsers. NOTE: P4Web is tested against the actual Mozilla browser; Mozilla-compliant browsers, such as Konqueror, are not tested and, therefore, not specifically supported.

• P4Web's Viewer mode now supports user authentication. See Passwords and Authorization for more information.

Bugs fixed in 2002.1

2002.1/34618

#33822

The P4Web helper on MAC OSX generates an error if the browser is not running on the same machine as the helper. (No job filed)

#33446

The Run menu now has a Label option instead of a Create Label option. The new Label option allows the user to choose whether to create, edit or labelsync using a specific label. (Bug #7769)

#33074

The Labelsync page now has an option to labelsync to the head revision. The option to labelsync to a specific revision number was removed because this option is not useful when applied to multiple files. (Bug #7750)

#33057

P4Web no longer generates duplicate "client unknown" errors when the client has not been defined. Also, the Path Browser page does not generate additional directory links after that error has been reported. (Bug #7794)

#33025

The "Branch or Integrate" page, formerly called the Integrate page, now has a link to the Branches list page. (Bug #4571)

#32959

The Jobs page now has a link at the top of the page to the form at the bottom of the page. (Bug #7728)

# 32878

The Delete label, branch and job confirmation pages now include links to the appropriate detail pages. (Bug #7795)

#32859

The forms in the Run menu do not present redundant file selection options when the current path is at the head of the depot tree. (Bug #7064)

#32798

The Sync page now contains a separate option to sync to a changelist. Now the Sync menu options from the Path Browser, Label Detail and Changelist Detail pages display the same Sync form with the appropriate options selected based on context. (Bug #7734)

#32626

P4Web now provides a more useful error and a link to retry the connection when the user fails to connect due to a username/password error. (Bug #7791)

#32599

P4Web now correctly renders content based on mime type for Visio and MS Project files. (Bug #7833)

#32575

The "Show Depot File in Browser" and the revision links on the File Browser page now render files containing more than one period using the correct mime type. (Bug #7834)

2002.1/32489

#32345

The P4Web viewer generates a password error when the password used by the viewer is missing or incorrect. (Bug #7773)

#31457

The default selection for most Run menu forms is now "Selected Files" instead of "Files in path". Only the Sync form still uses "Files in path". This helps protect the user from unintentionally performing an operation on all files in a path. (Bug #7631)

#31333

The integrate form allows the user to prevent automatic sync to head revision. This option is only available with 2002.1 Perforce Servers (and beyond). (Bug #7630)

#31122

Paths in workspace mode are now displayed correctly with Opera 6.0 when P4Web is running on NT. (Bug #7532)

#31104

The -P option to set the password now generates a warning when used incorrectly. The -P flag can only be used when P4Web is invoked without authentication (ie with the -b flag). (Bug #7587)

#30823

The Path and File Browser pages no longer erroneously display the "not in client view" icon when a file is opened for branch from a remote depot. Now they correctly display the "opened for branch" icon. (Bug #7523)

#30768

The Path and File Browser pages no longer erroneously display the "not in sync" icon when a file is unmapped. Now it correctly displays the "not in client view" icon. (Bug #7523)

#30627

The Submitted Changelists form now unsets the pattern value correctly when the user clears the field. (Bug #7517)

#30623

Removing all files (with 'rmdir' set in the client specification) from a directory in workspace mode and switching back to the path browser now shows the path to the missing directory so you can navigate out of it. This feature didn't always work on non-NT systems. (Bug #7399)

#30616

Submit now provides the option to reopen files after they have been submitted. (Bug #7509)

#30600

The Submitted Changelists form no longer loads the "changelists up to" text box with the highest changelist by default, as this behavior interferes with setting a useful bookmark. (Bug #7497)

#29981

Launch editor on Unix does not automatically launch an xterm instance with the editor when the DISPLAY environment is set. (Bug #7201)

#29928

Launch editor now works correctly when the P4EDITOR variable has more than one word. (Bug #7322)

#29663

The Integrate form from the Path Browser no longer appends "/..." to the path unless it is required. (Bug #7223)

#29596

Files opened for add that were deleted at the head revision are now visible in the path browser even when the Show Deleted Files setting is turned off. (Bug #7235)

#29593

The Open for Add form now includes files deleted at the head revision in the list of files to add. (Bug #7196)

#29275

The Submitted Changelists form allows the user to filter changelists by user and/or by client. This feature is only available if the Perforce Server is 2002.1 or later. (Bug #6948)

#29112

The Changelist Detail page now has menu options to sync all files to changelist, sync only files in changelist, and show fixes in changelist. (Bug #5787)

#29092

The Show button on the Submitted Changelists page now works correctly with all supported browsers. (Bug #7123)

#29076

In workspace mode on the Mac, files no longer are displayed as directories. (Bug #7007)

#28656

To improve performance, files selected in the Selected Files field of the Run menu forms are sent to the Perforce Server using client syntax. (Bug #7011)

#28510

The File Browser page shows all three file mappings when used with a 2002.1 or later Perforce Server. (Bug #3383)

#28469

Show the user@client that has a file opened in the path browser only if the file is opened in the current client by a different user. (Bug #5282, #6018)

#28443

P4Web allows the user to suppress the display of opened files in the path browser. (Bug #5796)

#28157

The File Browser page now shows the user who has the file locked if the file is locked by another user. This feature is only available if the Perforce Server is 2002.1 or later. (Bug #6577)

#28123

P4Web now has improved mime type detection for displaying file content. (Bug #4090, #4446, #5071)

#28046

Pressing the Redisplay button on the Edit Pending Changelist form does not cause the Opera 5.12 browser to hang. (Bug #6624)

#27976

The "Open for add" Run menu option is now always available from the File Browser page. (Bug #5513)

#27268

Redisplay buttons on forms now work correctly on Netscape when user is in workspace mode. (Bug #6632)

#27083

Labels List now allows users to show labels with files in the current path. (Bug #4897)

#26195

Edit Pending Changelist and Submit forms now have ability to allow user to check or uncheck all files in the list. (Bug #3432)

#26055

Action is now displayed for each file in the Revert form. (Bug #5476)

#25895

Forms from the Run menu now give user the ability to check or uncheck all files in the list. (Bug #3432)

#25658

The default page content limit is now displayed in the Settings page. (Bug #5436)

#25524

File Browser now shows depot path of file when in Workspace mode. (Bug #5772)

#25490

P4Web no longer generates spurious Perforce Server error messages in the log. (Bug #6085)

#25297

Forms which present choices relevant to the current user now correctly check case of user name, based on Perforce Server case sensitivity. (Bug #6017)

Major New Functionality in Release 2001.1

• A P4Web Helper can now show you your actual Perforce client workspace path hierarchy, as well as the depot path hierarchy. Use "Go To->Workspace root" or "Go To->Settings" to initiate workspace path browsing. See Settings and Preferences for more information.

• You can now set a Back-in-Time Browsing® point to see what your Perforce depot looked like at that time. See Back-in-Time Browsing® for more information.

• Users are no longer allowed to switch Perforce ports. After a P4Web Helper starts up, it always uses the same Perforce user and port. Only users who know the password stored in the Perforce Server at the startup port can connect to a P4Web Helper. See Passwords and Authorization for more information.

• You can now set a limit to the size of the pages displayed by P4Web. This feature helps users whose browsers are easily swamped by large pages. See Settings and Preferences for more information.

Bugs fixed in 2001.1

2001.1/25842

#25842

Files displayed or run by browser are exempt from page content limit. (Bug #6439)

#23813

Support for "integrate -t" added. (Bug #5848)

#23767

No longer attempts to run xterm on Mac OS. (Bug #5819)

#23419

Support for changing current client in Viewer restored. (Bug #5755)

#23409

Workspace browsing available via "Go To", not "Go To->Settings." (Bug #5614)

#23296

"Resolve preview" window no longer closes instantly. (Bug #5668)

#23061

Fixed "Launch editor" warnings. (Bug #5631)

#22960

"Launch editor" now can create new file. (Bug #5615)

#22934

Files opened for add appear in the Path Browser even if directories haven't been created yet. (No Job)

#22860

Workspace mode shows only current path contents instead of "phantom" new files in subdirectories. (Bug #5564)

#22466

Corrected "Add" page for unmapped paths. (Bug #5524)

#22444

Corrected help file link on "Open File for Add" page. (Bug #5523)

#22443

Submitted Changelists fixed for workspace mode. (Bug #5519)

#22388

Empty workspace root no longer causes error. (Bug #5495)

#22333

The File Browser page no longer displays a link to workspace files that don't exist. (Bug #5483)

#22326

Displaying empty file content doesn't cause browser errors. (Bug #5471)

#21436

"Show deleted files" preference works with directories containing only deleted files. (Bug #5196)

#21773

Directories with only deleted files no longer appear in a P4Web Viewer's Path Browser unless "Show deleted files" is in effect. (Bug #5240)

#21336

Attempts to add previously deleted file no longer cause error. (Bug #5142)

#21808

"Launch Editor" doesn't crash when attempting to edit file that doesn't exist. (Bug #5298)

#19642

"Pending changelist" page shows only the files opened by the current user so that files opened by another user won't be included in a "Submit." (Bug #4689, #4705)

#21823

Edit Pending Changelist and Submit Default Changelist now use same form. (Bug #5278)

#21530

Revert buttons on Submit/Edit Pending Changelist forms now work correctly with default changelist. (Bug #5143)

#21066

Can now revert changelists (Bug #4786)

#22218

The "Entire depot/Client view" preference is no longer listed in the Show menu, because it's now available in "Go To->Settings" and in a shortcut button. (Bug #5418)

#21380

P4Web Viewer now allows "Client view only" preference. (Bug #4864)

#20087

Client view page now has a link to make that client the current client. (Bug #4058)

#20101

Client edit form has a larger views field. (Bug #4597)

#21863

Client syntax can be used in a Path Browser URL. (Bug #5238)

#21203

Submitted changelists page now accepts user-selectable changelist range and file matching pattern. (Bug #4022, #4404)

#21440

P4Web now shuts down properly when "Shut Down" is chosen from the "Special" menu on the Mac. (Bug #5156)

#22078

The Mac doesn't crash after waking up from sleep while running P4Web. (Bug #3646)

#21258

On the Mac, P4Web no longer includes "invisible" system-generated files (e.g. "icon " and ".DS_Store") when listing files to open for add. (Bug #4945)

#21435

P4Web now accommodates "%" and other special characters in filenames passed in URLs. (Bug #4993)

#20780

file@rev1,@rev2 in URL can be used to show a Submitted Changelists page for that file and revision range. (Bug #4891)

#21576

Interactive resolve now works correctly when selecting individual files. (Bug #5202)

#21914

Filelog page now gives links to file text at each revision. (Bug #4681)

#20190

Filelog page now gives links to File Browser page for files integrated to/from the current file. (Bug #4057)

#20735

Path browser at depot root level now shows all depots, including depots that do not contain any files. (Bug #4472)

#21268

P4Web displays improved error message at startup when P4Web port is already in use. (Bug #5153)

Unsupported Operations

This release of P4Web does not support:

• Doing single-file or single-directory operations from Path Browser page.
• Diffing non-consecutive file revisions.
• Changing user name from a P4Web page. (2957)
• Showing unintegrated file state in Path Browser and File Browser.
• Showing pending changelists for client workspaces other than the current one. (5429)
• Showing submitted changelists that have no associated files. (5431)
• Operations that require Perforce superuser, admin or review privileges.

Limitations and Known Problems

• This release of P4Web uses little JavaScript and no frames. Consequently, it might not look as sophisticated as other web-based applications. However, it is equally as usable in browsers that don't support JavaScript or frames as it is in browsers that do.

• The 03.2+ versions of P4Web perform best when used with newer versions of our supported browsers. Netscape users should please note that the 03.2+ versions of P4Web are only supported with browser versions 7.1 and above.

• Using Internet Explorer on Macintosh Classic platforms (MacOS 9.x and below) causes P4Web performance problems. P4Web users on Mac Classic can try Netscape instead.

• On Mac and Windows, the "launch" commands are only available when your browser and your P4Web Helper are running on the same host machine.

• Neither the "Revert" button nor the "Revert if unchanged" operation work on files opened for branch or add. Revert those files with "Revert even though changed." (3400)

• If your browser and P4Web are running on the same machine and you are using Firefox as your browser under Windows Vista, connecting to P4Web on localhost is slower than connecting to remote instances. Other browsers do not exhibit this symptom, and this does not affect connecting to a remote server running P4Web. You can configure Firefox to improve performance for this type of connection as follows:
  1. In the URL field, type "about:config"and press enter. Firefox displays a list of settings.
  2. In the Filter field.type "disableIPv6". Firefox displays "network.dns.disableIPv6".
  3. Right-click on the "network.dns.disableIPv6" line and select "Toggle" to set the value to True.

Please Send Us Your Feedback

Your feedback will help us improve P4Web. Please email your enhancement requests and bug reports to support@perforce.com. Be prepared to tell us:

• The version ID of the P4Web and the browser you were using. (Cut and paste this information from any P4Web page.)
• For bug reports, the URL of the P4Web page in question.