jobspec.txt.public #1

#
# Copyright 2005 Perforce Software.  All rights reserved.
#

# A Perforce Job Spec Specification.
#
#  Updating this form can be dangerous!
#  See 'p4 help jobspec' for proper directions.

Fields:
	101 Job word 32 required
	102 Status select 10 required
	126 DuplicateOf word 32 optional
	106 Type select 10 required
	108 Severity select 10 required
	119 Priority select 10 optional
	118 Difficulty select 20 optional
	107 Subsystem select 10 required
	120 Dependency text 32 optional
	113 Release line 10 optional
	109 OwnedBy word 32 optional
	103 ReportedBy word 32 required
	116 ModifiedBy word 32 always
	104 ReportedDate date 20 once
	110 ModifiedDate date 20 always
	114 CommitRelease line 20 optional
	105 Description text 72 required
	123 Categories text 72 optional
	125 InterestedIn text 72 optional
	129 DuplicateJobs text 72 optional
	127 ClosedOwner word 32 optional
	128 RelatedJobs text 72 optional
	130 Fixes line 72 optional
	131 ClosedBy word 32 optional
	132 Attachments text 72 optional
	133 DepotAreas text 72 optional
	121 History text 72 optional

Values:
	Status open/inprogress/punted/closed/duplicate/obsolete
	Type BUG/SIR/problem/port/build/todo
	Severity A/B/C
	Priority 00/10/20/30/88/99/high/medium/low/undefined
	Difficulty undefined/easy/medium/hard
	Subsystem ejp/jam/p4perl/p4python/p4ruby/p4web/p4win
	History ListOf(line)
	InterestedIn SetOf(UserID())
	DuplicateOf JobID()
	DuplicateJobs SetOf(JobID())
	ClosedOwner UserID()
	RelatedJobs SetOf(JobID())
	Fixes SetOf(Changelist())
	ClosedBy UserID()
	DepotAreas SetOf(DepotPath())
	OwnedBy UserID()
	ReportedBy UserID()
	ModifiedBy UserID()
	Attachments SetOf(FilePath())

Presets:
	Status open
	Type setme
	Severity C
	Subsystem setme
	ReportedBy $user
	ModifiedBy $user
	ReportedDate $now
	ModifiedDate $now
	Description $blank

Comments:
	#
	# Job:        unique job number.
	#
	# Status:     status of a job, tracking its movement.
	#                open - initial state
	#                inprogress - being worked on
	#                punted - no fix available
	#                closed - fix entered into code line
	#                duplicate - different wording of an existing job
	#                obsolete - features that no longer exist
	#
	# Type:       describes type of job.
	#                BUG - reproducible problem
	#                SIR - enhancement request
	#                problem - unreproducible problem report
	#                port - a porting request
	#                build - a build request
	#                todo - a coding/build/release task to do
	#
	# Severity:   identifies criticality or severity of a job
	#                A -  data corruption, erroneous results, malfunction
	#                     or performance constraint. Severity A bugs are
	#                     subject to review by Development.  Severity may
	#                     be downgraded with a specified reason.
	#                B -  partial feature malfunction; system operational.
	#                C -  minor nit, cosmetic defect, request for
	#                     information, most sirs fit in this category.
	#
	# Priority:   used by release/development to manage priorities
	#
	# Difficulty: development effort required to resolve a job
	#                undefined/easy/medium/hard
	#
	# Subsystem:
	#	ejp/jam/p4perl/p4python/p4ruby/p4web/p4win
	#        ejp         Time-lapse View
	#        jam         Jam build utility
	#        p4perl      Perl/P4API extension
	#        p4python    Python/P4API extension
	#        p4ruby      Ruby/P4API extension
	#        p4web       Web P4 Client
	#        p4win       Windows P4 GUI Client
	#
	# Dependency:    Job dependencies across products. (manual entry)
	#                One or more subsystems separated by spaces
	#                (e.g., a P4 fix required by P4Win and P4Web would
	#                have the values "p4win p4web" for this field).
	#
	# Release:       Where reported: none/all/2004.1/2003.2/2003.1/etc.
	#                'all' - not tied to a specific release.
	#                'none'- release is not known or not applicable.
	#
	# OwnedBy:       Who's fixing the bug. (manual entry)
	#
	# ReportedBy:    Who reported the bug. (automatic entry)
	#
	# ReportedDate:  When the bug was first entered. (automatic entry)
	#
	# ModifiedDate:  Last time the bug was updated. (automatic entry)
	#
	# CommitRelease: Target or promised release; used by developers.
	#
	# Description:   Textual description. First 31 chars are significant,
	#                be brief.
	#
	# Categories:    Defined by the Product Advocate for grouping of jobs.
	#
	# History:       List of changes made to the Job over time
	#
	# InterestedIn:  Users who wish to be notified of changes to job
	#
	# DuplicateOf:   Job of which this is a duplicate
	#
	# DuplicateJobs: Jobs which duplicate this job
	#
	# ClosedOwner:   The user to own then job when it is closed
	#
	# RelatedJobs:   Jobs which may be associated with this job
	#
	# Fixes:         Changelists which fix this job
	#
	# ClosedBy:      User who marked this bug closed 
	#
	# DepotAreas:    Depots paths assumed to be the the cause of the job
	#
	# Attachements:  Optional list of example, core, source, etc files
	#
	#### LIMIT LINES TO 80 COLUMNS ----------------------------------- ####