
Headache in debian has some enhancements, patches are waiting to be included in
upstream source, but user should be aware of differences:

- skipping line:
  
It is possible to skip line before pasting the header. This is required because
some files include specific string at the beginning of files:
- "#!/bin/sh" for scripts
- "<?xml" for xml 
- "<?php" for php 

You can use a pattern to match filename and apply a skip procedure, using the
keyword "skip". For example:

| ".*\\.sh" -> skip match:"#!/bin/sh.*"
| ".*\\.xml" -> skip match:"<\\?xml.*>"

There could have as many "match" parameters ias required foreach pattern,
multiple match are combined using an "OR". All the filename pattern that match
will be taken into consideration.

For example:
| ".*" -> skip match:" *" 

will skip line containing line that match the regexp " *" for all files.

- auto width:

The maximal width of the header depends on 2 factors:
- user defined width (using width keyword in the configuration file)
- real width of the header

If the real width of the header is bigger than the user defined width, the real
width will be taken into account.

 -- Sylvain Le Gall, Thu, 24 Apr 2008 22:33:06 +0200
