[MacPorts] #421: Feature request: bug and user_notes keywords

[MacPorts]

#421: Feature request:  bug and user_notes keywords
--------------------------------------+-------------------------------------
  Reporter:  gwright@…                |       Owner:  macports-tickets@…                   
      Type:  enhancement              |      Status:  new                                  
  Priority:  Normal                   |   Milestone:  MacPorts 1.8.0                       
 Component:  base                     |     Version:                                       
Resolution:                           |    Keywords:                                       
      Port:                           |  
--------------------------------------+-------------------------------------

Comment(by perry@…):

 Replying to [comment:10 raimue@…]:
 > But I don't understand what `bugs` should contain. Port bugs should be
 filed in Trac with a correct 'Port' field. Other stuff can be added as
 comments. If you want to improve/update the Portfile you have to look at
 it anyway.

 That makes sense to me -- should the bugs portion of this ticket be
 removed then?

 For now, I've implemented the following (r45686):
    * I added a new field (notes) to PortInfo in portutil.tcl.
    * I added a new action (action_notes) in port.tcl that displays notes
 set in the Portfile ('''not''' PortIndex, though an option that reads
 notes from the index can be added -- much like in action_info).
    * At the end of activate_main in portactivate.tcl, notes are displayed.
 Note that action_activate does '''not''' call this procedure (it uses
 portimage::activate instead).  This means that notes are only displayed
 when `port install` or `port upgrade` is called -- '''not''' during `port
 activate`.

 To test the implementation, I created an example Portfile (foo) that
 contains the following lines in particular:
 {{{
 notes This message is stored in notes. It is displayed at\
       \nthe end of the activation phase and when action_notes\
       \nis invoked.
 }}}

 When `port install foo` or `port upgrade foo` is called:
 {{{
 --->  Installing foo @0.2.1_0+darwin_9
 --->  Activating foo @0.2.1_0+darwin_9

 This message is stored in notes. It is displayed at
 the end of the activation phase and when action_notes
 is invoked.

 --->  Cleaning foo
 }}}

 When `port notes elinks foo git-core` is called:
 {{{
 elinks has no notes.
 foo has the following notes:
     This message is stored in notes. It is displayed at
     the end of the activation phase and when action_notes
     is invoked.
 git-core has no notes.
 }}}

-- 
Ticket URL: <http://trac.macports.org/ticket/421#comment:11>
MacPorts <http://www.macports.org/>
Ports system for Mac OS