======Synopsis:======
[[on]] [<modes>]dcc_offer [<serial#>] [-|^]<match> { <action> }

======Description:======
This hook is triggered whenever you offer someone else a [[dcc]].  This
could be either a [[dcc chat|DCC CHAT]] or a file transfer.

======Parameters:======
|$0    |person who is being offered the [[DCC]] |
|$1    |type of DCC being offered |
|$2    |filename being offered (if type of [[DCC]] is 'SEND') |
|$3-   |size of file being offered (if type of [[DCC]] is 'SEND') |

======Default Action:======
If you don't suppress this event, the client will display a message to your
screen.

======Examples:======
To alert user of bad DCC's:
   on ^dcc_offer "#*" (target, type, fname, fsize) {
      xecho -b Offering a DCC to an entire channel will not work as
      xecho -b expected. Please direct DCC offers to one person.
   }