> - If the first Pod thing is a =head1 NAME, and the next paragraph is short 
> and might even look like "thing -- thing thing thing thing thing", then get 
> the name/description from that.
> 
> - Otherwise if the first pod thing is a =head1 XXXXX where "XXXXX" is some 
> string that doesn't contain lowercase ASCII letters (but may contain 
> spaces, punctuation, Unicode characters, E<...> things, but not formatting 
> codes like B<...>), AND if the next paragraph looks like "thing -- thing 
> thing thing thing thing", then presume that XXXXX is just some-language-ese 
> for "NAME", so get the name/description from the "thing -- thing..." line.
> 
> - Otherwise, if the first pod thing is a =headN Whatever Stuff, then use 
> Whatever Stuff as the title. (N=1-4, and Whatever Stuff meaning any string 
> at all, possibly including formatting codes, E<...> codes, etc)
> 
> - Otherwise, use the file's basename as the title.

So the model is exactly one encoding+language per one pod file?

-- 
Jarkko Hietaniemi <[EMAIL PROTECTED]> http://www.iki.fi/jhi/ "There is this special
biologist word we use for 'stable'.  It is 'dead'." -- Jack Cohen

Reply via email to