OpenSolaris

1. Community: OS/Net (ON)
   1. Blogs
   2. Development Process
   3. Developer's Reference
      1. Introduction
      2. Prerequisites
      3. The Source Tree, part 1
      4. The Source Tree, part 2
      5. Building OpenSolaris
      6. Installing and Testing OpenSolaris
      7. Integration Procedure
      8. Best Practices and Requirements
      9. Glossary
   4. Discussions
   5. Installation (from source) Quickstart
      1. Annotated nightly(1) Mail Example
   6. Currently Known Issues
   7. CRT
      1. Advocates & Sponsors
      2. Becoming a CRT Advocate
      3. Charter
      4. RTI nits to avoid
      5. Sponsor Tasks
      6. Becoming a Sponsor
   8. Schedule
   9. ONNV Flag Days, Heads Ups, and Project Integration History
      1. All
      2. Builds 91-95
      3. Builds 86-90
      4. Builds 81-85
      5. Builds 76-80
      6. Builds 71-75
      7. Builds 66-70
      8. Builds 61-65
      9. Builds 56-60
      10. Builds 51-55
      11. Builds 46-50
      12. Builds 41-45
      13. Builds 36-40
      14. Builds 31-35
      15. Builds 26-30
      16. Builds 21-25
   10. Leaders
   11. Observers
   12. Putback Logs
   13. Developing Solaris
       1. Quality Death Spiral
   14. wx
   15. findunref and unreferenced files
   16. Bourne/Korn Shell Coding Conventions

heads up: wx now checks comments against bug database

Date: Thu, 3 Aug 2006 13:26:43 -0700
From: Danek Duvall <danek.duvall at sun dot com>
To: on-all at sun dot com, onnv-gate at onnv dot eng dot sun dot com
Subject: heads up: wx now checks comments against bug database

With my recent putback of

    6445267 wx should cross-check delta comments with bug database

wx will now cross check your bugid comments against the bug database
(through the monaco commandline interface).  This should reduce the number
of typos, cut-and-paste errors, and comment adornment that we've seen
(assuming, of course, that people are using wx pbchk as they should be).

The checks are done in all places where comment checking is done for bugs
(previously limited to consistency and format):

    wx pbcom
    wx bugs
    wx pbchk
    wx comchk
    wx putback
    wx rtichk

For bugs, pbcom, and putback, the lookup can be disabled (but you'll get a
warning) by passing the -N flag, which is useful in a situation where
connections to Monaco hang, or you simply can't wait the extra few seconds
it takes to do the lookup (about three seconds in Menlo Park).  Situations
where the monaco script is simply unavailable (such as when you're
disconnected from SWAN, or NFS client access to /net/monaco.sfbay is
unavailable) will warn without any need for the flag.  For example, with
"wx pbcom" you might get:

    % /tmp/wx pbcom
    Bug 3333333 is not in the database
    Synopsis of 6311077 is wrong:
      should be: Enabling ON compilation with Sun Studio 11 (Venus)
             is: Enabling ON compilation with Sun Studio 11 (Venus)(no space)
    Synopsis of 6452853 is wrong:
      should be: RFE: add bug arg to wx edit for automatic filling of comment
             is: eat my shorts

and with -N you would see

    % /tmp/wx pbcom -N
    Not performing bug synopsis check (be careful)
    3333333 some bogus bugid
    5016238 nightly should be more conservative in clobbering logs (just fine)
    6279148 bfu auto-upgrade
    6311077 Enabling ON compilation with Sun Studio 11 (Venus)(no space)
    6452853 eat my shorts

Note that this check won't complain about follow-up putback comments which
have a parenthesized comment after the bug synopsis.

The updated wx will be in /ws/onnv-tools later tonight, Pacific time.

Thanks,
Danek