Generic requirements

From Ingres Community Wiki

The table below was taken from Piccolo help. It's a summary of the most commonly-used Piccolo functions. I left out reviewer-only functions.

I avoided Piccolo terms and commands in order to cast the functions as generic requirements for code management. I grouped the requirements roughly into reporting functions, code functions, and label functions.

I was stuck by the large number of reporting functions versus the functions that actually manage code.

I've made no attempt to mark any particular function as "critical" or otherwise. What may be unimportant to me may very well be "critical" to another engineer or a manager.

Function	Qualifiers	Sub qualifiers
Report bug numbers	To output file
	All changes in subscription list
	All changes in the source code library
	For an individual file version number
	For an individual file or set of files
	For a list of files of specific versions
	From a list of change numbers
	After a certain date
Report change numbers	To output file
	All changes in subscription list
	All changes in the source code library
	For an individual file verison number
	For an individual file or set of files
	For a list of files of specific versions
	From a list of change numbers
	After a certain date
Report subscribed clients	To output file
Report description of change(s)	To output file
	Formatted output style	All information
		All info up to 500 lines
		All except file diffs
		One-line summary including release notes
		One-line summary including change info
		List of files in the change
		One-line summary of the change
		One-line summary of the change including review notes
	For all changes in the library, whether subscribed or not
	From a list of change numbers
	From all changes
	From a file listing change numbers
	From a list of bug numbers
	From a file listing bug numbers
	For all bugs
	For all changes in the library, whether subscribed or not
Report change history of file(s)	To output file
	Formatted output style	All except file diffs
		One-line summary including release notes
		One-line summary including change info
		One-line summary including diffs
		One-line summary of the change
		One-line summary of the change including review notes
		One-line summary
	From a list of bug numbers
	From a file listing bug numbers
Report subscribed files with versions	To output file
	From a list of files
	From a file list of files with versions
	By current directory
	List deleted files only
Report mapping for current directory	To output file
	Show directory mapping only
Report integration history on file(s)	To output file
	From a list of files with versions
	By current directory
	From the entire library, regardless of subscription list
Report outstanding integrations for file(s)	To output file
	Include added files
	From the entire library, regardless of subscription list
	By current directory
	From a list of files with versions
	From a list bug numbers
	From a list change numbers
	From a file list of bug numbers
	From a file list of change numbers
Report files that are linked	To an output file
	From a list of files with versions
	From the current directory only
	From the entire library, regardless of subscription list
Report file(s) changed from current subscription	To an output file
	From a list of files with versions
	From a list of change numbers
	From a file list of files with versions
	From a file list of change numbers
	From the current directory
	For subscribed files at a greater version than the file list
	For subscribed files at a greater version than a label
	For all files changed for the library, regardless of the subscription list
Report file(s) marked for edit	To an output file
	From the current directory
	Show all files marked for edit, regardless of user
	On all files marked for edit for the library, regardless of the subscription list
Report differences of file(s) with the library version	To an output file
	From a list of files with versions
	From a file list of files with versions
	Ignore blanks
	From with a specific library version
	Use Unix-style output
	From files with their counterparts on a label
Report release notes	To an output file
	From a list of bug numbers
	From a file list of bug numbers
Report differences between library versions of file(s)	To an output file
	Ignore white spaces
	From a list of library files with directories and versions
	From a file list of library files with directories and versions
Report library directories	To an output file
	In the current directory
	From a file list of directories
Report library files and directories	To an output file
	From a list of library directories
	List only deleted files
Report file location of library file(s)	To an output file
	From a file list of library directories
	From a file list of files with library directories
Report version(s) of file(s) currently marked for edit or submission that are cross-integrated	To an output file
	From a list of files with versions
	From a file list of files with versions
	From the current directory
Report version(s) of file(s) currently marked for edit or submission that need cross-integration	To an output file
	From a list of files with versions
	From a file list of files with versions
	From a change number
	From the current directory
	For versions greater then the current level
	From a label
Report files marked for edit or submission	To an output file
	From the current directory
	For all files, including all subscribed clients
	For all files for the library, regardless of the subscription list
Remove cross-integration links with other files	From a file list
Ignore a change pending for cross-integration	From a file list of files with verisons
Create an integration link between files	From a formatted list of files
Integrate changes from another library	To an output file
	"Silent" integration (automatic)
	List summary line and exit
	Integrate only to specified file version
	From a set of linked files with versions
	From a set of files in the current library
Get or remove a copy of file(s)	To output file
	From a list of files
	From a specified file version number
	From a label
	From a file list of files with versions
	Force update of subscribed files
	Write to standard output
	Remove the file from the "have" list
	Remove the file from the subscription list
Add library directories to subscription list	From the current directory
	From a list of library directories
	From a file list of library directories
Remove directories from subscription list	From the current directory
	From a file list of library directories
Mark file(s) as editable	From a list of files
	From a file list of files
Mark a file as ready for submission and lock out others from editing file(s)	As a new submission
	As to be deleted from the library
	From a list of files
	From a file list of integrated files
Restore file(s) back to library version and mark as read-only	From a list of files with versions
	From a file list of files with versions
Submit a change	Include release notes from a file
	Include description notes from a file
	From a file list of files
Reject a change	Include description of rejection
Manage code labels	Write list of files from a label	To an output file
	Write label description notes
	Remove label name
	Force update of label information
	List only deleted files
	Read a label description from a file
	Create a new label
Edit release notes	From an input file
	Overwrite existing notes
	Remove existing bug notes