Hello ye Monks!

This isn't strictly a perl question, but it's a pod question so be merciful..

I like writing my docs in pod and I write bash scripts from time to time. I want to keep the pod in the same file as the script 'cause bad things happen when they get separated (at least in my hands bad things happen...) I figured I could put my pod after an exit call in bash and I'd be fine, but it didn't work.

Anyway, the real question isn't a bash question it is: does pod have any magic syntax to fit inside of something like the comments of another language. EG, is there a way to write pod like this...

#! /bin/bash

echo "stupid bash user!  Write perl!"
exit

#=head1 NAME
# 
#Foo
#
#=head1 SYNOPSIS
# 
#Eat 100 pounds of bannanas
[download]

Or like this

#include stdio.h

void main () {
     printf("all that just to say this?  Use perl!\n");
}

/*
=head1 NAME

Foo

=head1 SYNOPSIS

Eat 100 pounds of bannanas
*/
[download]

...er... okay that works out of the box... but anyway, you get my point...

UPDATE: my original bash problem was just me being stupid. You can put pod after the exit in bash. Duh. However! I'm still curious if pod can operate inside another languages arbitrary line-based comments.

Another Update!: Yes. I suck and I waste your time. I admit it freely and accept any punishment you desire to inflict. Achem...

You can put the pod inside a string that does nothing in nearly any language. EG in bash:

#! /bin/bash

echo "Pileofrogs is a jerk!"

FOO=<<ENDOFPOD

=head1 NAME

i_suck

=head1 SYNOPSIS

To increase your overall suckage, simply introduce Pilofrogs into the 
+environment

=cut

ENDOFPOD
[download]