IZ1789: Ambiguity in "Administering Policies" doc

[js631]

[Imported from gridengine issuezilla ​http://gridengine.sunsource.net/issues/show_bug.cgi?id=1789]

        Issue #:      1789             Platform:     All      Reporter: js631 (js631)
       Component:     gridengine          OS:        All
     Subcomponent:    doc              Version:      6.0u6       CC:    None defined
        Status:       NEW              Priority:     P3
      Resolution:                     Issue type:    DEFECT
                                   Target milestone: ---
      Assigned to:    andreas (andreas)
      QA Contact:     skonta
          URL:        http://gridengine.sunsource.net/servlets/ReadMsg?list=users&msgNo=12603
       * Summary:     Ambiguity in "Administering Policies" doc
   Status whiteboard:
      Attachments:

     Issue 1789 blocks:
   Votes for issue 1789:


   Opened: Mon Sep 12 08:32:00 -0700 2005 
------------------------


http://docs.sun.com/app/docs/doc/817-5677/6ml49n2bt?a=view#i999558

I just read through the "Sharing Functional Ticket Shares"
section.  In it it says:

  * Selecting the Share Functional Tickets check box means that
functional shares are replicated among jobs.

  * Clearing the Share Functional Tickets check box means that
functional shares are distributed among jobs.

Then in the following paragraph, it seems to contradict the above:

  "Jobs with many siblings that belong to the same category member
receive relatively small share portions if you select the Share
Functional Tickets check box. On the other hand, if you clear the
Share Functional Tickets check box, all sibling jobs receive the same
share amount as their category member."

Before I explain my confusion, the checkbox in the new qmon GUI is
labeled "Share Functional Shares".  Anyway, it would seem that "if you
clear the Share Functional Tickets check box, all sibling jobs receive
the same share amount as their category member" implies the first
bullet point, which requires the checkbox be selected.

   ------- Additional comments from surajp Thu Mar 5 05:15:31 -0700 2009 -------
Reassigning issue to Sandra...

[dlove]

Can't fix manual bugs.