OpenSolaris

Heads up: Removal of user visible SCCS keywords

Date: Wed, 01 Aug 2007 13:40:31 -0700
From: Stephen Lau <stevel at sun dot com>
To: on-all at eng dot sun dot com, onnv-gate at onnv dot sfbay dot sun dot com,
Subject: Heads up: Removal of user visible SCCS keywords

This is a heads up to let you all know of an important impending change
  as we switch from Teamware to Mercurial.  Currently, onnv-gate has
multiple occurrences of user-visible SCCS keywords (%I%, %E%, etc.).
We've flagged and filed bugs for the ones that we've found[1].
Unfortunately, we (the SCM Migration project team) aren't experts in
that code, and can't know whether or not they can safely be replaced or
removed; what we *do* know is that when we switch to Mercurial, those
keywords will be visible in _unexpanded form_, so:

$ genmsg -v
genmsg version %I%

This is teh sux0r[2].  If you are responsible for any code that has user
visible SCCS keywords, or consume any such keywords (or have a
dependency in some form or another on this output), you must fix this
code to either eliminate or replace the use of SCCS keywords (and no,
Mercurial does not have an equivalent keyword feature).  If they aren't
replaced, they will be carried through and left unexpanded when we
switch to Mercurial.

If the module or binary version can be determined by other means (e.g.:
showrev(1) output), you may simply wish to delete the keywords.

When a date is chosen for transitioning onnv-gate to Mercurial, we will
let you know so nobody is surprised.  We don't have an exact date yet,
but expect it sometime in the September-October timeframe.

If you have any questions, please email scm-migration-dev at opensolaris dot org
If you have questions regarding source in usr/closed, please email
tonic-iteam at sun dot com.

We have a list of files with SCCS keywords in them here:
http://donuthole.sfbay.sun.com/~stevel/sccs_affected_files
This list is just a list of all files in onnv-gate with SCCS keywords,
and doesn't distinguish user-visible ones from non user-visible ones, so
if you see files on the list you maintain, please verify whether they
are user-visible or not.  You're welcome to do both, but only user
visible ones *need* to be changed before the Mercurial migration.

[1] flagged with the 'rm_sccs_keywords' keyword (along with other bugs)
http://monaco.sfbay/list.jsf?product=solaris&keyword=rm_sccs_keywords
(If you find other occurrences we haven't filed bugs for, please attach
the 'rm_sccs_keywords' keyword and add 'tonic-iteam at sun dot com' to the
interest list to the bug you file to track it)

[2] http://www.urbandictionary.com/define.php?term=sux0r

cheers,
steve
~--
stephen lau // stevel at sun dot com | 650.786.0845 | http://whacked.net
opensolaris // solaris kernel development