[MacPorts] #15406: Clarify use of modeline and Id tag

[MacPorts]

#15406: Clarify use of modeline and Id tag
-------------------------------------+--------------------------------------
 Reporter:  ryandesign at macports.org  |       Owner:  markd at macports.org     
     Type:  defect                   |      Status:  new                    
 Priority:  Normal                   |   Milestone:  Website & Documentation
Component:  guide                    |     Version:  1.6.0                  
 Keywords:                           |  
-------------------------------------+--------------------------------------
 Section 4.2 ("Creating a Portfile") says "The first line of a new Portfile
 must be set as shown" ("# $Id$") but section 4.7.1 ("Port Style") says
 "the top line of all Portfiles should use a modeline that defines soft
 tabs for the vim and emacs editors". Unify these conflicting directives to
 instead state that a portfile should start with a modeline on the first
 line and the Id tag on the second line.

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